A native Nintendo DS port of Terminal Tanks v2.0.1 (by ethanlabs101): the turn-based terminal artillery game,
rewritten in C for the DS with the BlocksDS SDK. The original game (terminaltanks.py and its tanks/ package) is
kept, unmodified, in reference/ and is the source of truth for every rule, table and number.
If you haven't already, check out Terminal Tanks website here
Compile yourself or download the compiled .nds game in the Release page.
Thanks for playing :)
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Screenshots are recorded from v1.5.0
terminaltanks.nds the ROM (build it with `make`, see docs/BUILDING.md)
core/ portable game simulation (C11, no DS code) – bit-exact with the Python original
source/ DS frontend: terminal renderer, scenes, input, saves, local wireless
tests/parity/ parity tests: the C core vs. the Python original, same seeds, compared value by value
tests/harness/ emulator tests: scripted play in headless melonDS, including two linked consoles
tools/ content/font generators and the melonDS harness
docs/ spec, architecture, controls, building, testing, parity, multiplayer, assets, development
| Area | State | Evidence |
|---|---|---|
| Simulation (terrain, ballistics, wind, every ammo mechanic incl. the 2.0 ones, UFOs, specials, Blessing, AI) | ported, value-for-value | tests/parity against PC 2.0.1: world+shot 300/300, AI 24/24, whole AI-vs-AI matches 6/6, plus one match per 2.0 mechanic 10/10 (run_battle_parity.py new) |
| All content (123 tanks, 123 ammo + 18 Martyr ammo, 147 maps, 100 home screens, 12 animated paints, 314 shop items, 20 levels, 50 missions, 10 tickets, 24 cheats, 514 unlockables) | generated from the Python objects | tools/gen_content.py |
| Saves from Terminal Tanks DS 1.5.0 | migrated by name | tests/save_migration/run.sh: 200/200 random 1.5.0 saves load identical by name; the original is kept as <profile>.sav.v1.bak |
| Every scene of the original (title → menus → battle → results, tournament, missions, co-op, shop, workshop + studio, tickets, Martyr, cinematics, profiles, tutorial/practice, settings, cheats, links, LAN) | ported | every main-menu screen rendered in melonDS (tests/harness/tour.py); single-player and tournament battles played in the emulator; tickets, the Martyr, cinematics and the studio were not reached in emulator runs |
| Local wireless, two DS consoles, no router | working in emulation | tests/harness/run_lan_versus.py: host, join, RPS, ~30 shots across 2 rounds, identical state hashes on both consoles |
| Saves (3 profiles) on the SD/flashcart FAT | working in emulation | profile written to an emulated SD card and read back after a reboot |
| Music and sound effects (the PC soundtrack, 277 songs, and every effect) | rendered from the original's mixer, streamed from the ROM | checked in the emulator against the expected audio (docs/TESTING.md); not yet heard on a real DS |
| Real hardware | the 2.0 test ROM boots on the user's DS; full hardware test pending | see PROGRESS.md |
Known gaps are listed honestly in docs/FEATURE_PARITY.md.
scripts/setup_toolchain.sh # once: GCC 14 + picolibc + BlocksDS 1.17.1 (from GitHub)
export WONDERFUL_TOOLCHAIN=/opt/wonderful BLOCKSDS=$HOME/deps/blocksds
make audio # once: renders the soundtrack (Python 3 + numpy + scipy)
make -j8 # -> terminaltanks.nds (about 240 MB, mostly music)Copy terminaltanks.nds to a flashcart (or run it in melonDS / no$gba). Saves go to /data/TerminalTanks/
on the card. Controls: d-pad aims (← → angle, ↑ ↓ power), A fires, hold L/R for big steps,
B back, START menu, or use the touch screen. Full list in docs/CONTROLS.md.
docs/PORTING_SPEC.md– what the original does (read from the source), and the DS mappingdocs/ARCHITECTURE.md– how the port is put togetherdocs/CONTROLS.md– buttons and touchdocs/BUILDING.md– toolchain and reproducible builddocs/TESTING.md– parity tests and emulator tests, what each provesdocs/FEATURE_PARITY.md– feature-by-feature status and every deliberate deviationdocs/MULTIPLAYER.md– DS-to-DS wireless designdocs/ASSETS.md– where every asset comes from, licencesdocs/DEVELOPMENT.md– working on the code, profiling, adding thingsPROGRESS.md– status log
Game design, content and original code: ethanlabs101 (Terminal Tanks). DS port: this repository. Font: Spleen 5x8 by Frederic Cambus (BSD-2-Clause). Built with BlocksDS (libnds, dswifi), tested with melonDS.
Genuinely thank you for viewing/using this software.
Have an amazing day!
See you on the battlefield!





