
BattleTech: The Crescent Hawk's Inception ingeniería inversa
Ingeniería inversa de BattleTech: The Crescent Hawk's Inception (1988, MS-DOS; publicado por Infocom, motor de Westwood Associates) — y una recreación en Godot 4 / C# del mismo, en curso.
Lee esta sección antes de confiar en cualquier otra cosa de este repositorio. El proyecto son dos esfuerzos con madurez muy distinta, y la palabra "fase" en el resto de la documentación significa código escrito, no comportamiento demostrado.
Este proyecto produce dos artefactos al mismo tiempo, y el segundo se apoya sobre el primero:
(1) La ingeniería inversa documentada. La descompilación de reko/, las especificaciones de docs/, el
emulador Spice86 con herramientas MCP específicas de BattleTech, y las utilidades en Python. Este es el trabajo real de RE:
los formatos de archivo, el texto de la historia, el mapa de memoria y una gran parte de la lógica del motor están documentados y
verificados cruzadamente contra la salida del descompilador y las trazas del emulador en vivo. Es un entregable por derecho
propio, y también es la especificación de (2).
(2) La recreación (BattleTechCHI/). Un programa en Godot 4 C# que deriva de (1): lee
los archivos de datos originales (.BLD, .MTP, .ANM, partidas guardadas GAME*) y reimplementa el comportamiento del motor
según lo documentado por (1). Es fiel a los datos, no fiel al comportamiento, y nunca ha sido
validada de extremo a extremo contra el original.
Se ejecutan en paralelo, pero la dirección de la dependencia es fija:
(2) solo puede ser tan fiel como (1) sea completo y verificado. Donde (1) dice inferido o abierto, (2) es una conjetura.
Por eso la hoja de ruta coloca el cierre de las lagunas de RE (Vía 1) y la validación diferencial de (2) contra el emulador (Vía 3) por delante del trabajo de funcionalidades. Una recreación es tan buena como la ingeniería inversa sobre la que se apoya.
Si buscas un port bit a bit, todavía no existe. Si buscas un entorno de RE asistido por herramientas más una reconstrucción basada en datos que se ejecuta sobre los recursos originales, eso es lo que hay aquí.
Leyenda: ✅ verdadero / hecho · ⚠️ parcial, aproximado o con lagunas silenciosas · ❓ desconocido / no verificado · ❌ ausente
| Sistema | Lee los archivos originales en tiempo de ejecución | El comportamiento coincide con el original | Validación |
|---|---|---|---|
| Descifrado BLD + texto cifrado | ✅ BldLoader.cs | ✅ (texto) | ✅ ida y vuelta BLD↔JSON byte a byte idéntica (tools/bld) |
| Intérprete de opcodes BLD (28 slots 0xE4–0xFF) | ✅ | ⚠️ parcial | ❓ nunca ejecutado de principio a fin; tamaños de operando fijados (EB/EC/F6/F7 y ED: 4 bytes idx/thresh/LE-target, match→jump); todos los slots gestionados (sin descartes silenciosos) |
Despacho Fn1CD3 (47 casos) | ✅ | ⚠️ parcial | ❓ implementado a partir de la descompilación; varios casos son aproximaciones; se sabe que está mal: 0x23 es la configuración de combate de arena/sala (1CD3:1062 → fn0FDC_0629(8)), no la inicialización de partida nueva — el NewGameInit de la reconstrucción borraría una partida si se dispara un combate de arena; ED UnitCheckLoop consume 2 bytes en lugar de 4 y omite la comprobación de habilidad + salto |
| Cabecera/teselas de mapa MTP | ✅ MapLoader.cs / LocalMapView.cs | ✅ (estructura) | ⚠️ diseño decodificado, no comparado fotograma a fotograma |
| Animación ANM (RLE con delta XOR) | ✅ en tiempo de ejecución, respaldo PNG | ⚠️ | ❓; el repositorio no tiene hojas de sprites ANM (Assets/Animations/ vacío) |
| Teselas ICN/CMP | ❌ (preconvertidas) | — | TileManager carga BMP; Assets/Tilesets/ vacío |
Archivos de guardado GAME1–6 (4096 B) | ✅ analizador SaveManager.cs | ❓ | ❌ ida y vuelta no verificada contra guardados originales |
Estado de la historia (b0057, props) | ✅ (lecturas) | ❓ significado inferido | ❓ semántica no confirmada en juego |
| Combate (impacto, daño, IA, calor, munición, niebla) | — (lógica propia) | ❌ aproximado | ❌ RNG/fórmulas nunca comparados con el original |
| Viewport / disposición de pantalla | — | ⚠️ aproximado | ❓ no se localizó ninguna estructura de viewport canónica |
| Sonido / música | ❌ | ❌ | ❌ formato sin decodificar |
| Mapeo de disparadores mapa→BLD | ✅ decodificado | ✅ ([0x5460]:0x4602 + tablas de posición de edificios → lista de nombres MTP; docs/formats/map-bld-triggers.md) | ⚠️ entradas verificadas manualmente solo en MAP1 hasta ahora |
.BLD reales e interpretarlos (diálogos, menús, tiendas, muchos casos de despacho) — con vacíos silenciosos en opcodes no implementados..MTP reales y leer/escribir la disposición real de guardado de 4096 bytes.| Área | Estado | Documento canónico |
|---|---|---|
| Formato BLD, cifrado, opcodes | 🟢 sólido | docs/formats/bld-bytecode.md |
| Texto de la historia (los 26 BLD) | 🟢 extraído | docs/story/STORY_TEXT.txt |
| Mapa de memoria (100+ direcciones, segmentos) | 🟢 sólido | docs/formats/memory-map.md |
| Mapa del mundo / mapas locales | 🟢 sólido | docs/world-map.md |
| Modelo de combate | 🟡 ~90%, algo inferido | docs/combat-system.md |
| Economía / tiendas / stock | 🟡 flujo de UI ahora observado en vivo | docs/story/story-system.md |
| Formato ANM | 🟢 documentado | docs/formats/anm-format.md |
| Abstracción de viewport | 🔴 incompleto | docs/engine/viewport.md |
| Sonido | 🔴 0% | — |
Estos son los bloqueadores reales; la hoja de ruta de la §6 depende de ellos.