BongBong

BongBong is a simplistic and entertaining modern tank shooter game.

The main goal of this project is to build a fun, entertaining game with retro graphics and an illusion of modern physics, while paying respect to old-school tank games.

Play it live @ bongbong.io or subscribe and follow the progress via the blog.

Build and run

Everything runs from inside the devenv (Nix) shell. just --list has the rest.

Where	One-time setup	Build and run
Desktop	-	just run (or just watch, just run-dev with the dev server)
Web	just setup-web	just build-web then just serve-web
iOS simulator	just ios-setup	just run-ios-sim
iPhone	just ios-setup-device (plus an Apple ID in Xcode)	just run-ios-device
Android emulator / phone	just android-setup	just run-android
Android APK (sideload)	-	download bongbong-aarch64-linux-android.apk from the latest release and allow installs from your browser
macOS app	-	just macos-app builds target/macos/BongBong.app; a release's bongbong-macos.dmg is the signed, notarized one - open it and drag BongBong to Applications

# Options work the same on every desktop run
cargo run                                    # the levels, from the furthest one reached (levels.toml)
cargo run -- --level 5                       # start on level 5 (or by map name: --level carnival)
cargo run -- -e 12 --map=maps/default.toml   # free play: 12 enemies on one map
cargo run -- --tank titan                    # pick the player's chassis
cargo run -- --editor                        # start in the map builder (BUILD/PLAY switch anytime)

The game is a run of levels, listed in order in levels.toml: win one and the next opens, lose and play it again - the end screen counts down to either by itself (docs/levels.md). The furthest level reached is remembered between sessions, and any level up to it can be played again from the level select - the LEVEL button at the left end of the bar, LEVELS on the end screen, or Esc.

The phone lanes are documented in CLAUDE.md (the "iOS simulator build" and "Android build" sections) and in docs/ios-native-port-prd.md / docs/android-port-prd.md. just ios-smoke and just android-smoke are the graphics checks to run after an Xcode or SDK update; just ios-screenshot, just android-screenshot and just android-tap / android-swipe drive a running build from the shell.

Dependencies

• The game is written from scratch with raylib via sola-raylib bindings for Rust.
• The rapier physics engine alleviates some of the physics challenges.
• The game uses the hecs entity-component-system (ECS).
• This game is confined to libraries and tools that compile to WASM, as one of the main distribution channels is the web.

Collaboration

Please feel free to reach out or interact with me if you have any ideas or anything else. ;)

- Oto Brglez