
Reverse engineering di BattleTech: The Crescent Hawk's Inception
Reverse engineering di BattleTech: The Crescent Hawk's Inception (1988, MS-DOS; pubblicato da Infocom, motore di Westwood Associates) — e una ricreazione in Godot 4 / C# in corso d'opera.
Leggi questa sezione prima di fidarti di qualsiasi altra cosa in questo repo. Il progetto è composto da due sforzi con maturità molto diversa, e la parola "fase" altrove nei documenti significa codice scritto, non comportamento dimostrato.
Questo progetto produce due artefatti contemporaneamente, e il secondo si basa sul primo:
(1) Il reverse engineering documentato. La decompilazione reko/, le specifiche in docs/, l'
emulatore Spice86 con strumenti MCP specifici per BattleTech, e il tooling Python. Questo è il vero lavoro di RE:
formati di file, testo della storia, mappa di memoria, e gran parte della logica del motore sono documentati e
verificati incrociando l'output del decompilatore e le tracce dell'emulatore in esecuzione. È un deliverable a sé
stante, ed è anche la specifica per (2).
(2) La ricreazione (BattleTechCHI/). Un programma Godot 4 C# che deriva da (1): legge
i file dati originali (.BLD, .MTP, .ANM, salvataggi GAME*) e re-implementa il comportamento del motore
come documentato da (1). È fedele ai dati, non al comportamento, e non è mai stato
validato end-to-end rispetto all'originale.
Essi procedono in parallelo, ma la direzione della dipendenza è fissa:
(2) può essere fedele solo nella misura in cui (1) è completo e verificato. Dove (1) dice inferito o aperto, (2) è una congettura.
Ecco perché la roadmap mette la chiusura delle lacune di RE (Track 1) e la validazione differenziale di (2) rispetto all'emulatore (Track 3) prima del lavoro sulle funzionalità. Una ricreazione vale solo quanto il reverse engineering su cui si basa.
Se stai cercando un port bit-exact, non esiste ancora. Se stai cercando un ambiente di RE assistito da strumenti più una ricostruzione data-driven che gira sugli asset originali, ecco cosa c'è qui.
Legenda: ✅ vero / fatto · ⚠️ parziale, approssimativo, o con lacune silenziose · ❓ sconosciuto / non verificato · ❌ assente
| Sistema | Legge i file originali a runtime | Comportamento corrisponde all'originale | Validazione |
|---|---|---|---|
| Decrypt BLD + testo cifrato | ✅ BldLoader.cs | ✅ (testo) | ✅ round-trip BLD↔JSON identico byte per byte (tools/bld) |
| Interprete opcode BLD (28 slot 0xE4–0xFF) | ✅ | ⚠️ parziale | ❓ mai eseguito end-to-end; dimensioni operandi fisse (EB/EC/F6/F7 e ED: 4 byte idx/thresh/LE-target, match→jump); tutti gli slot gestiti (nessun drop silenzioso) |
Dispatch Fn1CD3 (47 casi) | ✅ | ⚠️ parziale | ❓ implementato dal decomp; diversi casi sono approssimazioni; noto errato: 0x23 è il setup del combattimento arena/stanza (1CD3:1062 → fn0FDC_0629(8)), non l'init di nuova partita — il NewGameInit della ricostruzione cancellerebbe una partita se venisse attivato da un incontro in arena; ED UnitCheckLoop consuma 2 byte invece di 4 e salta il controllo abilità + jump |
| Header/tile mappa MTP | ✅ MapLoader.cs / LocalMapView.cs | ✅ (struttura) | ⚠️ layout decodificato, non confrontato frame per frame |
| Animazione ANM (XOR-delta RLE) | ✅ runtime, fallback PNG | ⚠️ | ❓; il repo non contiene spritesheet ANM (Assets/Animations/ vuota) |
| Tile ICN/CMP | ❌ (pre-convertiti) | — | TileManager carica BMP; Assets/Tilesets/ vuota |
File di salvataggio GAME1–6 (4096 B) | ✅ parser SaveManager.cs | ❓ | ❌ round-trip non verificato rispetto ai salvataggi originali |
Stato della storia (b0057, props) | ✅ (letture) | ❓ significato inferito | ❓ semantica non confermata in gioco |
| Combattimento (to-hit, danno, AI, calore, munizioni, nebbia) | — (logica propria) | ❌ approssimativo | ❌ RNG/formule mai confrontati con l'originale |
| Viewport / layout schermo | — | ⚠️ approssimativo | ❓ nessuna struct canonica del viewport individuata |
| Suoni / musica | ❌ | ❌ | ❌ formato non decodificato |
| Mappatura trigger mappa→BLD | ✅ decodificata | ✅ ([0x5460]:0x4602 + tabelle posizione edifici → lista nomi MTP; docs/formats/map-bld-triggers.md) | ⚠️ ingressi verificati manualmente solo su MAP1 finora |
.BLD reali e interpretarli (dialoghi, menu, negozi, molti casi
di dispatch) — con lacune silenziose sugli opcode non implementati..MTP reali e leggere/scrivere il layout reale dei salvataggi da 4096 byte.| Area | Stato | Doc canonico |
|---|---|---|
| Formato BLD, cifrario, opcode | 🟢 solido | docs/formats/bld-bytecode.md |
| Testo della storia (tutti i 26 BLD) | 🟢 estratto | docs/story/STORY_TEXT.txt |
| Mappa di memoria (100+ indirizzi, segmenti) | 🟢 solido | docs/formats/memory-map.md |
| Mappa del mondo / mappe locali | 🟢 solido | docs/world-map.md |
| Modello di combattimento | 🟡 ~90%, alcuni inferiti | docs/combat-system.md |
| Economia / negozi / scorte | 🟡 flusso UI ora osservato dal vivo | docs/story/story-system.md |
| Formato ANM | 🟢 documentato | docs/formats/anm-format.md |
| Astrazione viewport | 🔴 incompleto | docs/engine/viewport.md |
| Suono | 🔴 0% | — |
Questi sono i veri blocchi; la roadmap del §6 dipende da essi.