Référence des formats de Total Annihilation et TA: Kingdoms

Un guide pratique des formats de fichiers propriétaires que Cavedog Entertainment a livrés avec Total Annihilation (1997) et Total Annihilation: Kingdoms (1999), écrit par quelqu'un qui en fait réellement la rétro-ingénierie. Chaque page associe la disposition des octets sur le disque à une commande kbot d'une ligne, pour que vous puissiez explorer les vrais fichiers au fil de la lecture.

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

Catalogue des formats#

Conteneurs et enveloppes#

Graphismes et médias#

Cartes et terrain#

Unités, scripts, configurations#

Interface de TA: Kingdoms#

Tutoriels et références#

Légende : ✅ prise en charge complète par kbot · 🟡 documenté, mais non analysé par kbot à ce jour.

Comment les formats s'articulent#

                                ┌───────────────────────────────┐
                                │   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
        └───────┘             └───────┘   └───────┘       └────────┘        └─────────┘

Presque toute session de rétro-ingénierie commence par le montage d'un HPI : même les installations aplaties ne sont qu'un HPI extrait. De là, les unités (FBI) renvoient à des maillages (3DO), à des scripts (COB), à des portraits d'unités (PCX) et à des gadgets d'animation (GAF). Les cartes (TNT) sont assemblées à partir de sections (SCT) et de placements d'éléments de décor, qui renvoient à des définitions d'éléments en TDF.

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

Boutisme, jeu de caractères et conventions de coordonnées#

Ces conventions valent pour tous les formats de cette documentation, sauf quand une page indique explicitement le contraire :

Utiliser cette documentation#

Chaque page de format suit la même structure :

1. Ce que c'est — son rôle et l'endroit où il apparaît dans une installation de TA.
2. Disposition sur le disque — la structure d'en-tête, puis les sections de charge utile, avec les offsets en octets indiqués.
3. Ordre de lecture — la suite de déplacements (seek) et de lectures qui permet d'analyser correctement le fichier.
4. Exemple commenté — un vrai fichier Cavedog disséqué octet par octet.
5. Examinez-le vous-même — des commandes kbot à lancer sur votre propre installation pour voir les données en direct.
6. Pièges — cas limites non documentés, différences entre versions, octets de travail laissés par les outils de Cavedog, etc.

Si un encadré ressemble à ceci :

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

…alors la commande peut être lancée telle quelle une fois un contexte défini.

Remerciements et sources#

Cette documentation fait la synthèse de plusieurs décennies de rétro-ingénierie menée par la communauté. Chaque page attribue dans le texte les découvertes particulières à leurs auteurs, mais les fondations viennent de :

• Joe D. — première dissection du format HPI (1997).
• Saruman & Bobban / dFR Engineering — première description détaillée du format TNT (1997).
• Scott « me22 » McMurray — précisions sur le format TNT (2003), en s'appuyant sur le code source d'Annihilator de Kinboat.
• Kinboat — format SCT, outils GAF, éditeur de cartes Annihilator.
• Dan Melchione & Dark Rain — format 3DO (1998, révisé en 2002).
• C_A_P, Switeck, KhalvKalash — rétro-ingénierie des opcodes COB/BOS et la famille d'outils Scriptor.
• Dark Rain — format GUI de TA:K et les notes sur les difficultés des formats de TA:K.
• Cavedog Entertainment — pour avoir créé un jeu qui mérite d'être maintenu en vie plus de 25 ans après.

Quand cette documentation contredit l'un de ces documents d'origine, c'est le code source de kbot qui fait foi : les formats décrits ici sont testés en aller-retour sur des milliers de vrais fichiers Cavedog. Si vous trouvez une divergence, ouvrez une issue ou une PR sur https://github.com/coreprime/kbot.