Formatreferenz zu Total Annihilation und TA: Kingdoms

Ein Praxisführer zu den proprietären Dateiformaten, die Cavedog Entertainment mit Total Annihilation (1997) und Total Annihilation: Kingdoms (1999) ausgeliefert hat, geschrieben aus der Praxis des Reverse Engineerings. Jede Seite stellt den Byte-Aufbau auf der Platte neben einen einzeiligen kbot-Befehl, damit du parallel zum Text an den echten Dateien herumstochern kannst.

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

Formatkatalog#

Container- und Hüllformate#

Grafik und Medien#

Karten und Gelände#

Einheiten, Skripte, Konfiguration#

Oberfläche von TA: Kingdoms#

Tutorials und Nachschlagewerk#

Legende: ✅ volle Unterstützung in kbot · 🟡 dokumentiert, aber von kbot derzeit nicht geparst.

Wie die Formate zusammenhängen#

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

Fast jede Reverse-Engineering-Sitzung beginnt damit, ein HPI einzuhängen – selbst geflattete Installationen sind nichts anderes als ein extrahiertes HPI. Von dort aus verweisen Einheiten (FBI) auf Meshes (3DO), Skripte (COB), Einheitenporträts (PCX) und Animationsteile (GAF). Karten (TNT) werden aus Sektionen (SCT) und platzierten Kartenobjekten zusammengesetzt, die auf Objektdefinitionen in TDF-Dateien verweisen.

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

Byte-Reihenfolge, Zeichensatz und Koordinatenkonventionen#

Diese Regeln gelten für jedes Format dieser Dokumentation, sofern eine Seite nicht ausdrücklich etwas anderes angibt:

Mit dieser Dokumentation arbeiten#

Jede Formatseite ist gleich aufgebaut:

1. Was es ist – Zweck und wo es in einer TA-Installation vorkommt.
2. Aufbau auf der Platte – zuerst das Header-Struct, dann die Nutzdaten-Abschnitte, mit ausgewiesenen Byte-Offsets.
3. Lesereihenfolge – die Abfolge von Seeks und Reads, mit der sich die Datei erfolgreich parsen lässt.
4. Beispiel im Detail – eine echte Cavedog-Datei, Byte für Byte zerlegt.
5. Selbst nachsehen – kbot-Befehle, die du gegen deine eigene Installation laufen lassen kannst, um die Daten live zu sehen.
6. Stolperfallen – undokumentierte Grenzfälle, Versionsunterschiede, Speicherreste, die Cavedogs Werkzeuge in den Dateien hinterlassen haben, usw.

Sieht ein Hinweiskasten so aus:

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

…dann ist der Befehl dafür gedacht, unverändert zu laufen, sobald ein Kontext gesetzt ist.

Danksagungen und Quellen#

Diese Dokumentation fasst Jahrzehnte an Reverse-Engineering-Arbeit der Community zusammen. Die Seiten nennen die Urheber einzelner Erkenntnisse direkt im Text, die Grundlagen aber stammen von:

• Joe D. – die erste Zerlegung des HPI-Formats (1997).
• Saruman & Bobban / dFR Engineering – die erste Beschreibung des TNT-Formats (1997).
• Scott „me22“ McMurray – Präzisierungen zum TNT-Format (2003), gestützt auf den Quellcode von Kinboats Annihilator.
• Kinboat – SCT-Format, GAF-Werkzeuge, der Karteneditor Annihilator.
• Dan Melchione & Dark Rain – 3DO-Format (1998, überarbeitet 2002).
• C_A_P, Switeck, KhalvKalash – Reverse Engineering der COB/BOS-Opcodes und die Scriptor-Werkzeugfamilie.
• Dark Rain – das GUI-Format von TA:K und die Notizen zu den Tücken der TA:K-Formate.
• Cavedog Entertainment – für ein Spiel, das es wert ist, auch nach über 25 Jahren noch am Leben gehalten zu werden.

Widerspricht diese Dokumentation einem dieser Originale, gilt der Quellcode von kbot als maßgeblich – die Formate hier sind im Round-Trip an Tausenden echter Cavedog-Dateien getestet. Wenn du eine Abweichung findest, eröffne ein Issue oder einen PR unter https://github.com/coreprime/kbot.