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.
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.
Put your own dumps of the original cartridges in the project root:
Alien Soldier (J) [!].binAlien 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.
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.
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.
src/main.sis the cartridge's include order. Source layout explains the modules, the standalone Z80 program, DMA alignment and what may move; the subsystem map gives the architecture.- RAM map, naming and unknowns cover names, evidence and open questions.
- Authored data formats covers extracted segments, source tables, editor documents and round-trip constraints.
- Sound driver explains the 68000 and Z80 halves.
- The documentation index lists everything else; contributing describes the change workflow.
- 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
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.