Compare commits

...
8 Commits
10 changed files with 147 additions and 36 deletions
+85 -2
View File
@@ -1,3 +1,86 @@
# pong_raylib # PONG 2026
Classic pong implemented in Odin and Raylib A deliberately over engineered Pong clone in [Odin](https://odin-lang.org) with [raylib](https://www.raylib.com).
Retro line-based graphics with a CRT post-processing shader.
## Screenshots
![Main menu](screenshots/main_menu.png)
![Settings menu](screenshots/settings_menu.png)
![Gameplay](screenshots/gameplay.png)
## Why Over-Engineered?
While the game could have been done in a single file, the goal was to structure the project like a small production game instead:
- **Manager-per-subsystem**: audio, input, event, level, particle, and scene managers, each in its own file
- **Event system**: decoupled communication between systems (`event_manager.odin`) instead of direct calls
- **Scene management**: state/scene stack for menus, gameplay, etc. (`scene_manager.odin`)
- **Entity layer**: shared base entity with ball, player, and opponent specializations
- **Input abstraction**: keyboard and gamepad behind one interface
- **Data-driven assets**: audio and shaders loaded from `assets/`, not embedded
The idea behind breaking it into systems is so that it can help build my foundations into more complex games.
## Features
- Single-player vs AI opponent
- CRT fragment shader (`assets/shaders/crt.fs`)
- Particle effects, sound effects, music
- Gamepad support via SDL controller mappings
## Controls
| Action | Keyboard | Gamepad |
|--------|----------|---------|
| Move | W(up) S(down) | Left Joystick |
| Select | Enter | A button |
| Pause | Spacebar | Start button |
## Requirements
Please note, I have not built this on MacOs or Windows, only linux.
While in theory if you have the odin compiler it should just work as there is no external libs besides those bundled with Odin.
- Odin compiler (version dev-2026-10:e87445a58)
- raylib (bundled with Odin as `vendor:raylib`)
- GPU/driver with OpenGL 3.3 support (shader uses `#version 330`)
## Build & Run
./build.sh # see build.sh for flags and options
./out/pong
## Project Layout
assets/
audio/ music, SFX, UI sounds
shaders/ crt.fs
screenshots/ README images
src/
main.odin entry point
game.odin game state and loop
*_manager.odin audio, event, input, level, particle, scene
entity*.odin base entity, ball, player, opponent
out/ build output
build.sh build script
## Credits
Sourced from the web, not mine.
| File | Title | Author | Source | License |
|------|-------|--------|--------|---------|
| `UI, gameplay effects` | Impact Sounds 1.0 + Interface Sounds 1.0 | Kenney | https://www.kenney.nl | [CC0 1.0](http://creativecommons.org/publicdomain/zero/1.0/) |
| `Background Music` | 5 Action Chiptunes By Juhani Junkala | Juhani Junkala | <download page URL> | CC0 1.0 |
### Third-Party
- `gamecontrollerdb.txt`: [SDL_GameControllerDB](https://github.com/mdqinc/SDL_GameControllerDB) (zlib)
- [raylib](https://github.com/raysan5/raylib) by Ramon Santamaria (@raysan5), zlib
- [Odin](https://github.com/odin-lang/Odin), BSD-3-Clause
## License
MIT, see [LICENSE](LICENSE).
Any third-party assets retain their original licenses, listed above.
Binary file not shown.

After

Width:  |  Height:  |  Size: 632 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 400 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 420 KiB

+1
View File
@@ -120,6 +120,7 @@ check_ball_paddle_collision :: proc(ball: ^Entity, paddle: Entity) -> bool {
} }
increment_score :: proc(score_side: ^int, max_score: int, player: bool, ball: ^Entity) { increment_score :: proc(score_side: ^int, max_score: int, player: bool, ball: ^Entity) {
emit_event(.Score_Change)
score_side^ += 1 score_side^ += 1
if score_side^ == max_score { if score_side^ == max_score {
emit_event(Game_Over_Data{player}) emit_event(Game_Over_Data{player})
+3 -8
View File
@@ -58,14 +58,6 @@ process_events :: proc(game: ^Game) {
push_scene(game, make_game_over_overlay(e.winner_is_player)) push_scene(game, make_game_over_overlay(e.winner_is_player))
case Ball_Collision_Data: case Ball_Collision_Data:
// normalize the speed between 0.0 -> 1.0
// map that value to the camera displacement
min_speed: f32 = 200.0
max_speed: f32 = 550.0
speed_factor := clamp((e.speed - min_speed) / (max_speed - min_speed), 0, 1.0)
intensity := 0.5 + (speed_factor * 4.5)
game_trigger_shake(game, intensity, duration = 0.15)
audio_play_sfx(&game.audio, .Ball_Collision) audio_play_sfx(&game.audio, .Ball_Collision)
case Simple_Event: case Simple_Event:
@@ -81,6 +73,9 @@ process_events :: proc(game: ^Game) {
case .Game_Resume: case .Game_Resume:
pop_scene(game) pop_scene(game)
case .Score_Change:
game_trigger_shake(game, 10, duration = 0.20)
case .Game_Settings: case .Game_Settings:
parent: Maybe(Scene_Type) = nil parent: Maybe(Scene_Type) = nil
if active := get_active_scene(game); active != nil { if active := get_active_scene(game); active != nil {
+36 -9
View File
@@ -6,7 +6,7 @@ import rl "vendor:raylib"
VIEWPORT_W :: 640 VIEWPORT_W :: 640
VIEWPORT_H :: 360 VIEWPORT_H :: 360
WINDOW_TITLE :: "Pong" WINDOW_TITLE :: "PONG 2026"
Resolution :: struct { Resolution :: struct {
width: i32, width: i32,
@@ -16,7 +16,11 @@ Resolution :: struct {
// Preset window dimensions // Preset window dimensions
RESOLUTIONS := [?]Resolution{ RESOLUTIONS := [?]Resolution{
{1280, 720, "1280x720"}, {0, 0, "Fullscreen"},
{1024, 768, "1024x768"},
{1280, 720, "1280x720"},
{1366, 768, "1366x768"},
{1600, 900, "1600x900"},
{1920, 1080, "1920x1080"}, {1920, 1080, "1920x1080"},
{2560, 1440, "2560x1440"}, {2560, 1440, "2560x1440"},
{3840, 2160, "3840x2160"}, {3840, 2160, "3840x2160"},
@@ -45,7 +49,11 @@ Game :: struct {
// resolution state // resolution state
window_w: i32, window_w: i32,
window_h: i32, window_h: i32,
res_index: int res_index: int,
// Controller state.
controller_gid: i32,
controller_connected: bool,
} }
// AO: lets me load this at compile time! // AO: lets me load this at compile time!
@@ -55,14 +63,18 @@ gamepad_compat := #load("../gamecontrollerdb.txt", string)
// Game Lifecycle // Game Lifecycle
// ------------------------------------------------------------------------------ // ------------------------------------------------------------------------------
game_init :: proc(game: ^Game) { game_init :: proc(game: ^Game) {
rl.SetConfigFlags({.WINDOW_ALWAYS_RUN, .MSAA_4X_HINT}) rl.SetConfigFlags({.WINDOW_ALWAYS_RUN, .MSAA_4X_HINT, .WINDOW_RESIZABLE})
game.res_index = 2 game.controller_gid = -1
game.res_index = 0
game.window_w = RESOLUTIONS[game.res_index].width game.window_w = RESOLUTIONS[game.res_index].width
game.window_h = RESOLUTIONS[game.res_index].height game.window_h = RESOLUTIONS[game.res_index].height
rl.InitWindow(game.window_w, game.window_h, WINDOW_TITLE) rl.InitWindow(game.window_w, game.window_h, WINDOW_TITLE)
rl.SetTargetFPS(60) rl.SetTargetFPS(60)
rl.SetExitKey(.KEY_NULL) rl.SetExitKey(.KEY_NULL)
rl.HideCursor()
game_set_resolution(game, game.res_index)
gamepad_cstr := strings.clone_to_cstring(gamepad_compat) gamepad_cstr := strings.clone_to_cstring(gamepad_compat)
defer delete(gamepad_cstr) defer delete(gamepad_cstr)
@@ -109,7 +121,7 @@ game_init :: proc(game: ^Game) {
game_update :: proc(game: ^Game) { game_update :: proc(game: ^Game) {
dt := rl.GetFrameTime() dt := rl.GetFrameTime()
input := poll_input() input := poll_input(game)
// ------------------------------------------------------------------------- // -------------------------------------------------------------------------
// Update Camera Shake // Update Camera Shake
@@ -177,8 +189,7 @@ game_render :: proc(game: ^Game) {
render_game_to_window(game) render_game_to_window(game)
// when DEBUG do rl.DrawFPS(10, rl.GetScreenHeight() - 20)
when DEBUG do rl.DrawFPS(10, game.window_h - 20)
rl.EndDrawing() rl.EndDrawing()
} }
@@ -209,6 +220,17 @@ game_trigger_shake :: proc(game: ^Game, intensity: f32, duration: f32 = 0.15) {
game_set_resolution :: proc(game: ^Game, res_index: int) { game_set_resolution :: proc(game: ^Game, res_index: int) {
game.res_index = clamp(res_index, 0, len(RESOLUTIONS) - 1) game.res_index = clamp(res_index, 0, len(RESOLUTIONS) - 1)
borderless := rl.IsWindowState({.BORDERLESS_WINDOWED_MODE})
if game.res_index == 0 {
if !borderless do rl.ToggleBorderlessWindowed()
return
}
if borderless {
rl.ToggleBorderlessWindowed()
rl.RestoreWindow()
}
target_w := RESOLUTIONS[game.res_index].width target_w := RESOLUTIONS[game.res_index].width
target_h := RESOLUTIONS[game.res_index].height target_h := RESOLUTIONS[game.res_index].height
@@ -226,13 +248,18 @@ game_set_resolution :: proc(game: ^Game, res_index: int) {
render_game_to_window :: proc(game: ^Game) { render_game_to_window :: proc(game: ^Game) {
texture := game.viewport.texture texture := game.viewport.texture
w, h := f32(rl.GetScreenWidth()), f32(rl.GetScreenHeight())
s := min(w / VIEWPORT_W, h / VIEWPORT_H)
dst := rl.Rectangle{(w - VIEWPORT_W*s)/2, (h - VIEWPORT_H*s)/2, VIEWPORT_W*s, VIEWPORT_H*s}
rl.BeginShaderMode(game.crt_shader) rl.BeginShaderMode(game.crt_shader)
rl.DrawTexturePro( rl.DrawTexturePro(
texture, texture,
// src: inverted y coordinate flips opengl texture buffer correctly // src: inverted y coordinate flips opengl texture buffer correctly
rl.Rectangle{0, 0, f32(texture.width), -f32(texture.height)}, rl.Rectangle{0, 0, f32(texture.width), -f32(texture.height)},
// dst: scales viewport canvas to fill window resolution // dst: scales viewport canvas to fill window resolution
rl.Rectangle{0, 0, f32(game.window_w), f32(game.window_h)}, // rl.Rectangle{0, 0, f32(game.window_w), f32(game.window_h)},
dst,
rl.Vector2{}, rl.Vector2{},
0, 0,
rl.WHITE, rl.WHITE,
+19 -13
View File
@@ -1,5 +1,6 @@
package game package game
import "core:strings"
import rl "vendor:raylib" import rl "vendor:raylib"
// ------------------------------------------------------------------------------ // ------------------------------------------------------------------------------
@@ -21,35 +22,40 @@ Input_Event :: struct {
} }
// Currently active controller // Currently active controller
active_gamepad_id: i32 = -1 is_real_pad :: proc(i: i32) -> bool {
return rl.IsGamepadAvailable(i) &&
!strings.contains(string(rl.GetGamepadName(i)), "Mouse") &&
!strings.contains(string(rl.GetGamepadName(i)), "Keyboard")
}
update_active_gamepad :: proc() { update_active_gamepad :: proc(game: ^Game) {
// is there currently a controller, if so check if its still connected. // is there currently a controller, if so check if its still connected.
if active_gamepad_id != -1 { if game.controller_gid != -1 {
if rl.IsGamepadAvailable(active_gamepad_id) { if rl.IsGamepadAvailable(game.controller_gid) {
// do nothing still connected // do nothing still connected
return return
} }
// else we lost connection // else we lost connection
active_gamepad_id = -1 game.controller_gid = -1
rl.TraceLog(.WARNING, "Controller disconnected!!") game.controller_connected = false
} }
for i: i32 = 0; i < 4; i += 1 { for i: i32 = 0; i < 4; i += 1 {
if rl.IsGamepadAvailable(i) { if rl.IsGamepadAvailable(i) && is_real_pad(i) {
active_gamepad_id = i game.controller_connected = true
game.controller_gid = i
return return
} }
} }
} }
poll_input :: proc() -> Input_Event { poll_input :: proc(game: ^Game) -> Input_Event {
input_event := Input_Event{} input_event := Input_Event{}
input_dir := rl.Vector2{0, 0} input_dir := rl.Vector2{0, 0}
update_active_gamepad() update_active_gamepad(game)
gamepad_active := active_gamepad_id != -1 gamepad_active := game.controller_connected
gid := active_gamepad_id gid := game.controller_gid
// -------------------------------------------------------------------------- // --------------------------------------------------------------------------
// Continuous Input (keyboard + gamepad d-pad) // Continuous Input (keyboard + gamepad d-pad)
@@ -86,7 +92,7 @@ poll_input :: proc() -> Input_Event {
input_event.right_pressed = rl.IsKeyPressed(.D) || rl.IsKeyPressed(.RIGHT) || input_event.right_pressed = rl.IsKeyPressed(.D) || rl.IsKeyPressed(.RIGHT) ||
(gamepad_active && rl.IsGamepadButtonPressed(gid, .LEFT_FACE_RIGHT)) (gamepad_active && rl.IsGamepadButtonPressed(gid, .LEFT_FACE_RIGHT))
input_event.confirm_pressed = rl.IsKeyPressed(.ENTER) || rl.IsKeyPressed(.SPACE) || input_event.confirm_pressed = rl.IsKeyPressed(.ENTER) ||
(gamepad_active && rl.IsGamepadButtonPressed(gid, .RIGHT_FACE_DOWN)) (gamepad_active && rl.IsGamepadButtonPressed(gid, .RIGHT_FACE_DOWN))
input_event.pause_pressed = rl.IsKeyPressed(.SPACE) || input_event.pause_pressed = rl.IsKeyPressed(.SPACE) ||
+1 -1
View File
@@ -120,7 +120,7 @@ render_hud :: proc(level: Level) {
p1_size := rl.MeasureTextEx(font, "PLAYER 1", HUD_FONT_SIZE, HUD_FONT_SPACING) p1_size := rl.MeasureTextEx(font, "PLAYER 1", HUD_FONT_SIZE, HUD_FONT_SPACING)
p1_pos := rl.Vector2{HUD_PADDING, HUD_PADDING} p1_pos := rl.Vector2{HUD_PADDING, HUD_PADDING}
rl.DrawTextEx(font, "PLAYER 1", p1_pos, HUD_FONT_SIZE, HUD_FONT_SPACING, rl.WHITE) rl.DrawTextEx(font, "PLAYER", p1_pos, HUD_FONT_SIZE, HUD_FONT_SPACING, rl.WHITE)
opp_size := rl.MeasureTextEx(font, "COMPUTER", HUD_FONT_SIZE, HUD_FONT_SPACING) opp_size := rl.MeasureTextEx(font, "COMPUTER", HUD_FONT_SIZE, HUD_FONT_SPACING)
opp_pos := rl.Vector2{f32(VIEWPORT_W) - HUD_PADDING - opp_size.x, HUD_PADDING} opp_pos := rl.Vector2{f32(VIEWPORT_W) - HUD_PADDING - opp_size.x, HUD_PADDING}
+1 -2
View File
@@ -1,6 +1,5 @@
package game package game
import "core:strings"
import "core:fmt" import "core:fmt"
import rl "vendor:raylib" import rl "vendor:raylib"
@@ -251,7 +250,7 @@ render_main_menu :: proc(scene: Scene) {
menu, menu_ok := canvas.menu.? menu, menu_ok := canvas.menu.?
assert(menu_ok, "render_main_menu: Canvas is missing a UI_Menu component") assert(menu_ok, "render_main_menu: Canvas is missing a UI_Menu component")
t_text: cstring = "PONG" t_text: cstring = WINDOW_TITLE
t_width := rl.MeasureText(t_text, UI_TITLE_FONT_SIZE) t_width := rl.MeasureText(t_text, UI_TITLE_FONT_SIZE)
t_x := i32(canvas.bounds.width * 0.5) - (t_width / 2) t_x := i32(canvas.bounds.width * 0.5) - (t_width / 2)
rl.DrawText(t_text, t_x, i32(canvas.padding), UI_TITLE_FONT_SIZE, rl.WHITE) rl.DrawText(t_text, t_x, i32(canvas.padding), UI_TITLE_FONT_SIZE, rl.WHITE)