Referência de formatos do Total Annihilation e do TA: Kingdoms

Um guia de campo dos formatos de ficheiro proprietários que a Cavedog Entertainment lançou no Total Annihilation (1997) e no Total Annihilation: Kingdoms (1999), escrito do ponto de vista de quem faz engenharia inversa na prática. Cada página junta a disposição dos bytes no disco a um comando kbot de uma linha, para poder mexer nos ficheiros reais enquanto lê o texto.

go install github.com/coreprime/kbot/cmd/kbot@latest
kbot ctx add ~/games/totala --alias ta --game totala

Catálogo de formatos#

Contentores e invólucros#

Gráficos e multimédia#

Mapas e terreno#

Unidades, scripts e ficheiros de configuração#

Interface do TA: Kingdoms#

Tutoriais e referência#

Legenda: ✅ suporte completo no kbot · 🟡 documentado, mas o kbot ainda não o analisa.

Como os formatos se encaixam#

                                ┌───────────────────────────────┐
                                │   HPI / UFO / CCX / GP3       │
                                │   (encrypted, compressed VFS) │
                                └──────────────┬────────────────┘
                                               │ contains
            ┌──────────────────────┬───────────┼───────────────┬──────────────────┐
            ▼                      ▼           ▼               ▼                  ▼
        ┌───────┐             ┌───────┐   ┌───────┐       ┌────────┐        ┌─────────┐
        │  FBI  │ unit stats  │  COB  │   │  3DO  │ mesh  │  GAF   │ sprites│   TNT   │ map
        └───┬───┘             └───┬───┘   └───┬───┘       └────┬───┘        └────┬────┘
            │ references          │ runs on   │ textured by    │ used by         │ built from
            ▼                     ▼           ▼                ▼                 ▼
        ┌───────┐             ┌───────┐   ┌───────┐       ┌────────┐        ┌─────────┐
        │  TDF  │ weapons     │ piece │   │  PCX  │ skins │  PAL   │ colour │   SCT   │ tiles
        │ /OTA  │ /features   │ tree  │   │  unitpic│      │ /ALP/LHT/SHD   │ + heights
        └───────┘             └───────┘   └───────┘       └────────┘        └─────────┘

Quase todas as sessões de engenharia inversa começam por montar um HPI; até as instalações desempacotadas não passam de uma extração de HPI. A partir daí, as unidades (FBI) apontam para malhas (3DO), scripts (COB), retratos de unidades (PCX) e efeitos animados (GAF). Os mapas (TNT) são montados a partir de secções (SCT) e de colocações de elementos que remetem para definições de elementos em TDF.

kbot mount ~/games/totala --server   # opens at http://localhost:8090

Ordem dos bytes, conjunto de caracteres e convenções de coordenadas#

Estas convenções valem para todos os formatos deste documento, a não ser que uma página diga explicitamente o contrário:

Como usar esta documentação#

Todas as páginas de formato seguem a mesma estrutura:

1. O que é — a função e onde aparece numa instalação do TA.
2. Disposição no disco — a estrutura do cabeçalho e depois as secções de dados, com os deslocamentos dos bytes indicados.
3. Ordem de leitura — a sequência de posicionamentos e leituras que analisa o ficheiro com sucesso.
4. Exemplo comentado — um ficheiro real da Cavedog dissecado byte a byte.
5. Inspecione por si — comandos kbot que pode executar na sua própria instalação para ver os dados ao vivo.
6. Armadilhas — casos-limite não documentados, diferenças entre versões, dados de trabalho deixados pelas ferramentas da Cavedog, etc.

Se um destaque tiver este aspeto:

kbot pal swatch palettes/palette.pal --target out.png --cell 24

…então o comando foi feito para funcionar tal como está escrito, depois de definido um contexto.

Créditos e fontes#

Estes documentos reúnem décadas de trabalho de engenharia inversa da comunidade. As páginas atribuem as descobertas específicas no próprio texto, mas os alicerces vêm de:

• Joe D. — dissecação original do formato HPI (1997).
• Saruman & Bobban / dFR Engineering — primeiro percurso pelo formato TNT (1997).
• Scott "me22" McMurray — esclarecimentos sobre o formato TNT (2003), com base no código-fonte do Annihilator, do Kinboat.
• Kinboat — formato SCT, ferramentas GAF, editor de mapas Annihilator.
• Dan Melchione & Dark Rain — formato 3DO (1998, revisto em 2002).
• C_A_P, Switeck, KhalvKalash — engenharia inversa dos opcodes COB/BOS e a família de ferramentas Scriptor.
• Dark Rain — formato GUI do TA:K e as notas sobre as dificuldades dos formatos do TA:K.
• Cavedog Entertainment — por ter feito um jogo que vale a pena manter vivo mais de 25 anos depois.

Quando esta documentação contradiz um desses originais, quem manda é o código-fonte do kbot: os formatos aqui descritos são testados em ida e volta com milhares de ficheiros reais da Cavedog. Se encontrar uma discrepância, abra uma issue ou um PR em https://github.com/coreprime/kbot.