C Decomp Scaffold

C Decomp Scaffold

MM2 Decomp Scaffold

This directory contains a first-pass C lifting scaffold for the Amiga mm2 executable.

Files

• mm2_types.h
  Runtime structs and offset-based field aliases.
• mm2_lift.c
  Address-anchored function stubs (sub_248ae_startup, sub_256e_load_screen_state, etc.).
• mm2_roster_codec.h / mm2_roster_codec.c
  Struct-backed loader/saver for roster.dat (64 x 130-byte records).
• mm2_monsters_codec.h / mm2_monsters_codec.c
  Struct-backed loader/saver for monsters.dat (256 x 26-byte records).

Goals

1. Keep control-flow anchored to known 68k addresses.
2. Replace unknowns incrementally without breaking the skeleton.
3. Preserve offset-based memory semantics until field meanings are proven.

Naming Style

• sub_<addr>_<purpose> for recovered routines.
• Comments should include original label/address where possible.
• Do not rename offsets to semantic fields unless confidence is high.

Next Lifts

• Complete sub_24928_init_runtime().
• Expand sub_256e_load_screen_state() to all copied pages.
• Implement sub_24c4_overland_loop() key handling and draw calls.
• Model sub_1280_main_loop() dispatch table.