Toutes les pages de formats ↓
Tutoriels et références

Démarrage rapide — cinq choses à essayer tout de suite

Source : coreprime/kbot @ 0ab97bf · Modifier sur GitHub

Vous avez acheté TA sur GoG la semaine dernière et installé kbot il y a cinq minutes, mais vous ne savez pas par où commencer ? Essayez ces cinq commandes : chacune prend moins d'une minute et fait découvrir un format différent.

Toutes supposent que votre installation de TA est enregistrée comme contexte kbot (voir kbot ctx) :

kbot ctx add /path/to/total-annihilation --alias ta --game totala

1. Parcourir dans un navigateur web tous les fichiers livrés avec le jeu

kbot mount --server

L'explorateur s'ouvre sur http://localhost:8090. Cliquez un peu partout : vous pouvez prévisualiser les TNT, GAF, PCX, 3DO et FNT sans quitter le navigateur. Les scripts COB ont droit à la coloration syntaxique et à une visionneuse du flot de contrôle. Les fichiers TDF/FBI/OTA s'affichent sous forme d'arbres de sections repliables.

Pourquoi commencer par là : chacune des autres commandes de ce guide est un sous-ensemble ciblé de ce que fait l'explorateur. Commencez ici, puis passez à la CLI quand vous voulez automatiser quelque chose avec un script.

2. Générer le rendu d'une carte de campagne

kbot tnt preview "maps/sub hunting.tnt" -t /tmp/sub-hunting.png
open /tmp/sub-hunting.png      # macOS — use `xdg-open` on Linux

La commande compose les sprites des éléments de décor (arbres, rochers, gisements de métal) par-dessus la mosaïque de tuiles et dessine les marqueurs numérotés des positions de départ tirés du .ota associé. Le PNG de 1,7 Mo qu'elle produit est une vue bien plus riche que la minicarte intégrée de 252×252.

Voir tnt.md pour les détails du format : chaque octet a sa place.

3. Voir ce que fait réellement une unité

Décompilez son bytecode pour retrouver un code source BOS lisible :

kbot cob decompile scripts/armkrog.cob | head -80

…c'est le script d'animation du Krogoth. Cycle de marche, recul des armes, séquence de mort : tout y est. Désassemblez-le pour voir le détail au niveau des opcodes :

kbot cob disassemble scripts/armkrog.cob -s Walk -a

L'option -a dessine des flèches ASCII entre les instructions JUMP / JUMP_IF_FALSE correspondantes, pour que la structure des boucles saute aux yeux.

Voir cob.md, y compris la référence complète des opcodes et la table des ports de get_unit_value.

4. Extraire un seul fichier de n'importe quelle archive

Sans aplatir tout le jeu :

kbot hpi extract totala1.hpi -p "units/ARMCOM.FBI" -t /tmp/out
cat /tmp/out/units/ARMCOM.FBI | head

-p accepte des motifs glob : -p "units/*.fbi" extrait tous les FBI ; -p "*.bos" récupère toutes les sources de scripts. Le répertoire de destination est créé si nécessaire.

Quand vous ne savez même pas quelle archive contient le fichier, demandez au résolveur :

kbot mcp --game-data $(kbot ctx path) &     # if MCP is configured
# or use the web UI's search box

Voir hpi.md, y compris un parcours hexadécimal complet, octet par octet, d'une petite archive.

5. Exporter la palette de référence de TA dans un PNG à garder

kbot pal swatch palettes/palette.pal -o /tmp/ta-palette.png --cell 24
open /tmp/ta-palette.png

Une grille de 16 × 16 de toutes les couleurs du jeu. Pratique comme référence rapide quand vous travaillez sur la texture d'une unité ou cherchez un index de couleur pour l'interface. La case hachurée en haut à gauche est l'index 0 (noir), hachurée pour bien ressortir ; le jeu la dessine comme un noir ordinaire dans le terrain et les fonds, et les sprites choisissent leur propre clé de transparence frame par frame.

Voir pal.md, ainsi que pcx.md pour la façon dont TA: Kingdoms distribue ses palettes au moyen de PCX de 1×1 qui leur servent de porteurs.

Et ensuite ?

  • Modder une unité — suivez le tutoriel de modding pour livrer en une vingtaine de minutes une variante personnalisée de l'Arm Flash.
  • Comprendre la ménagerie de fichiers — commencez par l'index de la référence des formats.
  • Écrire un outil — chaque format a une API Go. L'encadré « Essayez vous-même » de chaque page de format indique le chemin d'import formats/<x>.
  • Brancher des assistants IA — kbot mcp expose tout ce qui précède à Claude Code, Claude Desktop, Cursor, etc. via MCP. Voir la section MCP du README.