
BattleTech: The Crescent Hawk's Inception Reverse Engineering
Reverse Engineering von BattleTech: The Crescent Hawk's Inception (1988, MS-DOS; veröffentlicht von Infocom, Engine von Westwood Associates) — und eine sich in Arbeit befindliche Godot 4 / C#-Nachbildung davon.
Lies diesen Abschnitt, bevor du irgendetwas anderem in diesem Repo vertraust. Das Projekt besteht aus zwei Bestrebungen mit sehr unterschiedlicher Reife, und das Wort „Phase" an anderer Stelle in den Dokumenten bedeutet Code geschrieben, nicht Verhalten bewiesen.
Dieses Projekt erzeugt zwei Artefakte zur gleichen Zeit, und das zweite baut auf dem ersten auf:
(1) Das dokumentierte Reverse Engineering. Die reko/-Dekompilierung, die docs/-Spezifikationen, der
Spice86-Emulator mit BattleTech-spezifischen MCP-Tools und die Python-Tooling. Dies ist die eigentliche RE-Arbeit:
Dateiformate, Story-Text, Speicherkarte und ein großer Teil der Engine-Logik sind dokumentiert und
gegen Dekompiler-Ausgaben und Live-Emulator-Traces gegengeprüft. Es ist ein Ergebnis für sich
selbst, und es ist zugleich die Spezifikation für (2).
(2) Die Nachbildung (BattleTechCHI/). Ein Godot 4 C#-Programm, das sich aus (1) ableitet: Es liest
Originaldatendateien (.BLD, .MTP, .ANM, GAME*-Spielstände) und implementiert das Engine-Verhalten
wie von (1) dokumentiert neu. Es ist datentreu, nicht verhaltenstreu, und wurde niemals
End-to-End gegen das Original validiert.
Sie laufen parallel, aber die Abhängigkeitsrichtung ist festgelegt:
(2) kann nur so treu sein, wie (1) vollständig und verifiziert ist. Wo (1) abgeleitet oder offen sagt, ist (2) eine Vermutung.
Deshalb stellt die Roadmap das Schließen der RE-Lücken (Track 1) und die differentielle Validierung von (2) gegen den Emulator (Track 3) vor die Feature-Arbeit. Eine Nachbildung ist nur so gut wie das Reverse Engineering, auf dem sie aufbaut.
Wenn du einen bit-exakten Port suchst, den gibt es noch nicht. Wenn du eine toolgestützte RE-Umgebung plus eine datengetriebene Rekonstruktion suchst, die auf Original-Assets läuft, dann ist das hier das Richtige.
Legende: ✅ wahr / erledigt · ⚠️ teilweise, annähernd oder mit stillen Lücken · ❓ unbekannt / unverifiziert · ❌ fehlend
| System | Liest Originaldateien zur Laufzeit | Verhalten entspricht dem Original | Validierung |
|---|---|---|---|
| BLD-Entschlüsselung + Chiffretext | ✅ BldLoader.cs | ✅ (Text) | ✅ Round-Trip BLD↔JSON byte-identisch (tools/bld) |
| BLD-Opcode-Interpreter (28 Slots 0xE4–0xFF) | ✅ | ⚠️ teilweise | ❓ nie durchgängig gespielt; Operandengrößen festgelegt (EB/EC/F6/F7 und ED: 4 Bytes idx/thresh/LE-target, match→jump); alle Slots behandelt (kein stilles Verwerfen) |
Fn1CD3-Dispatch (47 Fälle) | ✅ | ⚠️ teilweise | ❓ aus Dekompilat implementiert; mehrere Fälle sind Näherungen; bekannt fehlerhaft: 0x23 ist Arena-/Raumkampf-Setup (1CD3:1062 → fn0FDC_0629(8)), nicht New-Game-Init — das NewGameInit des Rebuilds würde einen Spielstand löschen, wenn ein Arena-Kampf es auslöst; ED UnitCheckLoop verbraucht 2 Bytes statt 4 und überspringt den Skill-Check + Sprung |
| MTP-Kartenheader/-Tiles | ✅ MapLoader.cs / LocalMapView.cs | ✅ (Struktur) | ⚠️ Layout dekodiert, nicht Frame-für-Frame verglichen |
| ANM-Animation (XOR-Delta-RLE) | ✅ zur Laufzeit, PNG-Fallback | ⚠️ | ❓; Repo enthält keine ANM-Spritesheets (Assets/Animations/ leer) |
| ICN/CMP-Tiles | ❌ (vorkonvertiert) | — | TileManager lädt BMP; Assets/Tilesets/ leer |
Speicherdateien GAME1–6 (4096 B) | ✅ Parser SaveManager.cs | ❓ | ❌ Round-Trip nicht gegen Original-Speicherstände verifiziert |
Story-Zustand (b0057, Props) | ✅ (liest) | ❓ Bedeutung abgeleitet | ❓ Semantik nicht im Spiel bestätigt |
| Kampf (Trefferchance, Schaden, KI, Hitze, Munition, Nebel) | — (eigene Logik) | ❌ näherungsweise | ❌ RNG/Formeln nie gegen das Original verglichen |
| Viewport / Bildschirmlayout | — | ⚠️ näherungsweise | ❓ keine kanonische Viewport-Struktur gefunden |
| Sound / Musik | ❌ | ❌ | ❌ Format nicht dekodiert |
| Map→BLD-Trigger-Zuordnung | ✅ dekodiert | ✅ ([0x5460]:0x4602 + Gebäudepositions-Tabellen → MTP-Namensliste; docs/formats/map-bld-triggers.md) | ⚠️ Eingänge bisher nur auf MAP1 manuell verifiziert |
.BLD-Skripte laden und entschlüsseln und interpretieren (Dialoge, Menüs, Shops, viele Dispatch-
Fälle) — mit stillen Lücken bei nicht implementierten Opcodes..MTP-Karten parsen und das echte 4096-Byte-Speicherlayout lesen/schreiben.| Bereich | Zustand | Kanonisches Dokument |
|---|---|---|
| BLD-Format, Chiffre, Opcodes | 🟢 solide | docs/formats/bld-bytecode.md |
| Story-Text (alle 26 BLD) | 🟢 extrahiert | docs/story/STORY_TEXT.txt |
| Speicherkarte (100+ Adressen, Segmente) | 🟢 solide | docs/formats/memory-map.md |
| Weltkarte / lokale Karten | 🟢 solide | docs/world-map.md |
| Kampfmodell | 🟡 ~90 %, teils abgeleitet | docs/combat-system.md |
| Wirtschaft / Shops / Bestand | 🟡 UI-Ablauf inzwischen live beobachtet | docs/story/story-system.md |
| ANM-Format | 🟢 dokumentiert | docs/formats/anm-format.md |
| Viewport-Abstraktion | 🔴 unvollständig | docs/engine/viewport.md |
| Sound | 🔴 0 % | — |
Dies sind die echten Blocker; die Roadmap in §6 hängt von ihnen ab.