Skip to content

About

Byte-identical source reconstruction of Alien Soldier for Sega Mega Drive/Genesis, with reverse-engineering documentation and runtime validation.

Topics

Resources

Contributing

Stars

8 stars

Watchers

1 watching

Forks

Repository files navigation

Alien Soldier source reconstruction

Assembly source for Treasure's Alien Soldier (Mega Drive, 1995). One shared, address-ordered 68000 source reproduces both the Japanese and the European cartridges byte for byte, and the Z80 sound program inside them is assembled from its own source. Every pointer is symbolic, so code and data can move.

Source Reconstruction 1.0 (tag source-reconstruction-1.0) rebuilt the Japanese cartridge. 2.0 added the European cartridge, the Z80 source and fixed-format content editing. The 3.0 release brings these together with Retrolarium Studio and Kit editing through alien_soldier.rlj, source relocation checks, and game-owned names, reader catalogs and regression references.

Release scope

This working tree targets one Source Reconstruction 3.0 release. It includes both cartridge builds, the reconstructed Z80 program, content editing and its fixed-capacity codecs, the game-owned metadata and tests' reference data, and the checks listed below. Authored data formats describes the layouts and the limits of editing them.

MAME coverage currently consists of the Japanese attract movie on the relocated build: menus, sound tests and the four in-game demos. It does not establish a full-game replay or European runtime coverage. Porting the remaining historical runtime scenarios, longplay and tool-assisted inputs fully to MAME, and further simplifying the test suite, are planned for 3.1. The existing checks remain the 3.0 baseline; the plan does not mean those migrations are complete.

Build and verify

Put your own dumps of the original cartridges in the project root:

  • Alien Soldier (J) [!].bin
  • Alien Soldier (E) [!].bin

ROMs, extracted data and edited outputs are private and never go into Git. The build needs Python and Retrolarium Kit (rltool on PATH, or RLTOOL=...), which brings the AS assembler and p2bin.

make split               # cut the data out of both ROMs, once
make verify-revisions    # both cartridges, byte for byte

make build and make verify take REVISION=eu for the European cartridge (jp is the default); revisions lists their identities and what differs.

Checks

make lint                # assembly layout and the shared formatters
make test                # unit tests, both ROMs, the moved build, the studio check
make test-full           # test, then the attract run in MAME on the moved build
make play                # watch that run in a MAME window

make test-full and make play need MAME (MAME=..., or the one rltool movie mame remembers); the movies describes the run.

Edit content

Alien Soldier is edited in Retrolarium Studio: open alien_soldier.rlj and choose a revision. The studio copies this repository into the ignored .retrolarium/<revision>/ and rebuilds the edited ROM from the source; editing in Retrolarium lists what it edits.

Find your way around

Credits

  • Original game by Treasure (1995)
  • Disassembly work using IDA Pro
  • Alien Soldier SMPS/Treasure format research and sound data mapping by Valley Bell and the SMPS Research project
  • AS Macro Assembler by Alfred Arnold
  • Gens automation, with which the earlier releases were researched and the movies recorded
  • Inspired by lab313ru's Quackshot disassembly

License

This is a work of reverse engineering for educational and preservation purposes. The original game is copyright Treasure and Sega. This repository grants no license to the game itself.

About

Byte-identical source reconstruction of Alien Soldier for Sega Mega Drive/Genesis, with reverse-engineering documentation and runtime validation.

Topics

Resources

Contributing

Stars

8 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages