Skip to content

About

Terminal Tanks for the Nintendo DS: homebrew port of the turn-based tank artillery game, with music and DS-to-DS wireless.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

22 Commits

Folders and files

Repository files navigation

Terminal Tanks DS

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

Title screen Rules Setup
Shop Battle Tournament

Screenshots are recorded from v1.5.0

Repo Directories

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

What works (and how it was checked)

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.

Quick start

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.

Documentation

  • docs/PORTING_SPEC.md – what the original does (read from the source), and the DS mapping
  • docs/ARCHITECTURE.md – how the port is put together
  • docs/CONTROLS.md – buttons and touch
  • docs/BUILDING.md – toolchain and reproducible build
  • docs/TESTING.md – parity tests and emulator tests, what each proves
  • docs/FEATURE_PARITY.md – feature-by-feature status and every deliberate deviation
  • docs/MULTIPLAYER.md – DS-to-DS wireless design
  • docs/ASSETS.md – where every asset comes from, licences
  • docs/DEVELOPMENT.md – working on the code, profiling, adding things
  • PROGRESS.md – status log

Credits

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.

Thank You!!

Genuinely thank you for viewing/using this software.

Have an amazing day!

See you on the battlefield!

About

Terminal Tanks for the Nintendo DS: homebrew port of the turn-based tank artillery game, with music and DS-to-DS wireless.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages