
BattleTech: The Crescent Hawk's Inception engenharia reversa
Engenharia reversa de BattleTech: The Crescent Hawk's Inception (1988, MS-DOS; publicado pela Infocom, engine da Westwood Associates) — e uma recriação em Godot 4 / C# em andamento.
Leia esta seção antes de confiar em qualquer outra coisa neste repositório. O projeto consiste em dois esforços com níveis de maturidade muito diferentes, e a palavra "fase" em outros lugares nos documentos significa código escrito, não comportamento comprovado.
Este projeto produz dois artefatos ao mesmo tempo, e o segundo se apoia no primeiro:
(1) A engenharia reversa documentada. A descompilação em reko/, as especificações em docs/, o
emulador Spice86 com ferramentas MCP específicas para BattleTech, e o ferramental em Python. Este é o trabalho real de RE:
formatos de arquivo, texto da história, mapa de memória e grande parte da lógica da engine estão documentados e
verificados cruzadamente com a saída do descompilador e com traces do emulador em execução. É um entregável por si
só, e também é a especificação para (2).
(2) A recriação (BattleTechCHI/). Um programa em Godot 4 C# que deriva de (1): ele lê
os arquivos de dados originais (.BLD, .MTP, .ANM, saves GAME*) e reimplementa o comportamento da engine
conforme documentado por (1). É fiel aos dados, não fiel ao comportamento, e nunca foi
validado de ponta a ponta contra o original.
Eles rodam em paralelo, mas a direção da dependência é fixa:
(2) só pode ser tão fiel quanto (1) for completo e verificado. Onde (1) diz inferido ou em aberto, (2) é um palpite.
É por isso que o roteiro coloca o fechamento das lacunas de RE (Trilha 1) e a validação diferencial de (2) contra o emulador (Trilha 3) à frente do trabalho de funcionalidades. Uma recriação só é tão boa quanto a engenharia reversa que a apoia.
Se você procura um port bit-exato, ele ainda não existe. Se você procura um ambiente de RE assistido por ferramentas mais uma reconstrução orientada a dados que roda sobre os assets originais, é isso que está aqui.
Legenda: ✅ verdadeiro / concluído · ⚠️ parcial, aproximado ou com lacunas silenciosas · ❓ desconhecido / não verificado · ❌ ausente
| Sistema | Lê os ficheiros originais em tempo de execução | O comportamento corresponde ao original | Validação |
|---|---|---|---|
| Desencriptação BLD + texto cifrado | ✅ BldLoader.cs | ✅ (texto) | ✅ round-trip BLD↔JSON byte-idêntico (tools/bld) |
| Interpretador de opcodes BLD (28 slots 0xE4–0xFF) | ✅ | ⚠️ parcial | ❓ nunca executado de ponta a ponta; tamanhos de operandos fixos (EB/EC/F6/F7 e ED: 4 bytes idx/thresh/LE-target, match→jump); todos os slots tratados (sem descarte silencioso) |
Despacho Fn1CD3 (47 casos) | ✅ | ⚠️ parcial | ❓ implementado a partir da decompilação; vários casos são aproximações; sabidamente errado: 0x23 é a configuração de combate de arena/sala (1CD3:1062 → fn0FDC_0629(8)), não a inicialização de novo jogo — o NewGameInit da reconstrução apagaria uma partida se um combate de arena o acionasse; ED UnitCheckLoop consome 2 bytes em vez de 4 e ignora a verificação de perícia + salto |
| Cabeçalho/tiles do mapa MTP | ✅ MapLoader.cs / LocalMapView.cs | ✅ (estrutura) | ⚠️ layout descodificado, não comparado frame a frame |
| Animação ANM (RLE com delta XOR) | ✅ em tempo de execução, fallback PNG | ⚠️ | ❓; o repositório não tem spritesheets ANM (Assets/Animations/ vazio) |
| Tiles ICN/CMP | ❌ (pré-convertidos) | — | TileManager carrega BMP; Assets/Tilesets/ vazio |
Ficheiros de save GAME1–6 (4096 B) | ✅ parser SaveManager.cs | ❓ | ❌ round-trip não verificado contra saves originais |
Estado da história (b0057, props) | ✅ (leituras) | ❓ significado inferido | ❓ semântica não confirmada em jogo |
| Combate (to-hit, dano, IA, calor, munição, névoa) | — (lógica própria) | ❌ aproximado | ❌ RNG/fórmulas nunca comparados com o original |
| Viewport / layout de ecrã | — | ⚠️ aproximado | ❓ nenhuma struct de viewport canónica localizada |
| Som / música | ❌ | ❌ | ❌ formato não descodificado |
| Mapeamento de triggers mapa→BLD | ✅ descodificado | ✅ ([0x5460]:0x4602 + tabelas de posição de edifícios → lista de nomes MTP; docs/formats/map-bld-triggers.md) | ⚠️ entradas verificadas manualmente apenas no MAP1 até agora |
.BLD reais e interpretá-los (diálogo, menus, lojas, muitos casos
de despacho) — com lacunas silenciosas em opcodes não implementados..MTP reais e ler/escrever o layout real de save de 4096 bytes.| Área | Estado | Documento canónico |
|---|---|---|
| Formato BLD, cifra, opcodes | 🟢 sólido | docs/formats/bld-bytecode.md |
| Texto da história (todos os 26 BLD) | 🟢 extraído | docs/story/STORY_TEXT.txt |
| Mapa de memória (100+ endereços, segmentos) | 🟢 sólido | docs/formats/memory-map.md |
| Mapa-múndi / mapas locais | 🟢 sólido | docs/world-map.md |
| Modelo de combate | 🟡 ~90%, alguns inferidos | docs/combat-system.md |
| Economia / lojas / stock | 🟡 fluxo de UI agora observado ao vivo | docs/story/story-system.md |
| Formato ANM | 🟢 documentado | docs/formats/anm-format.md |
| Abstração de viewport | 🔴 incompleto | docs/engine/viewport.md |
| Som | 🔴 0% | — |
Estes são os bloqueadores reais; o roadmap em §6 depende deles.
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.