Todas las páginas de formatos ↓
Tutoriales y referencia

Inicio rápido: cinco cosas que probar ahora mismo

Fuente: coreprime/kbot @ 0ab97bf · Editar en GitHub

¿Compraste TA en GoG la semana pasada e instalaste kbot hace cinco minutos, pero no sabes por dónde empezar? Prueba estos cinco comandos: cada uno tarda menos de un minuto y muestra un formato distinto.

Todos suponen que tu instalación de TA está registrada como contexto de kbot (consulta kbot ctx):

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

1. Explorar en el navegador todos los archivos que trae el juego

kbot mount --server

Se abre en http://localhost:8090. Navega por ahí: puedes previsualizar TNT, GAF, PCX, 3DO y FNT sin salir del navegador. Los scripts COB tienen resaltado de sintaxis y un visor del flujo de control. Los archivos TDF/FBI/OTA se muestran como árboles de secciones plegables.

Por qué merece la pena: todos los demás comandos de esta guía son un subconjunto concreto de lo que hace el explorador. Empieza aquí y pasa a la CLI cuando quieras automatizar algo con un script.

2. Renderizar un mapa de campaña

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

El comando superpone los sprites de los elementos (árboles, rocas, yacimientos de metal) al mosaico de casillas y dibuja los marcadores numerados de las posiciones de inicio a partir del .ota que acompaña al mapa. El PNG de 1,7 MB que produce es una vista mucho más rica que el minimapa incrustado de 252×252.

Consulta tnt.md para los detalles del formato: no queda ni un byte sin explicar.

3. Ver lo que hace de verdad una unidad

Descompila su bytecode compilado y obtén de nuevo código fuente BOS legible:

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

…ese es el script de animación del Krogoth. El ciclo de caminar, el retroceso de las armas, la secuencia de muerte: todo está ahí. Desensámblalo para ver el detalle a nivel de opcode:

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

La opción -a dibuja flechas ASCII entre las instrucciones JUMP / JUMP_IF_FALSE que se corresponden, para que la estructura de los bucles se vea de un vistazo.

Consulta cob.md, incluida la referencia completa de opcodes y la tabla de puertos de get_unit_value.

4. Extraer un solo archivo de cualquier archivo comprimido

Sin desempaquetar el juego entero:

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

-p acepta patrones glob: -p "units/*.fbi" saca todos los FBI; -p "*.bos" recoge todo el código fuente de los scripts. El directorio de destino se crea si hace falta.

Si ni siquiera sabes qué archivo comprimido contiene el archivo, pregúntale al resolutor:

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

Consulta hpi.md, que incluye un recorrido hexadecimal completo, byte a byte, de un archivo comprimido pequeño.

5. Volcar la paleta canónica de TA a un PNG que puedas guardar

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

Una cuadrícula de 16 × 16 con todos los colores del juego. Es útil como referencia rápida cuando trabajas en la apariencia de una unidad o intentas elegir el índice de un color para el HUD. La celda rayada de arriba a la izquierda es el índice 0 (negro), rayada para que destaque; el juego la dibuja como un negro normal en el terreno y los fondos, y los sprites eligen su propio color clave transparente en cada fotograma.

Consulta pal.md y, para ver cómo distribuye TA: Kingdoms las paletas mediante PCX portadores de 1×1, pcx.md.

¿Y ahora qué?

  • Modifica una unidad: sigue el tutorial de modding para distribuir una variante propia del Arm Flash en unos 20 minutos.
  • Entiende la fauna de archivos: empieza por el índice de la referencia de formatos.
  • Crea una herramienta: todos los formatos tienen una API de Go. El recuadro «Pruébalo tú mismo» de cada página de formato muestra la ruta de importación formats/<x>.
  • Conecta asistentes de IA: kbot mcp pone todo lo anterior a disposición de Claude Code, Claude Desktop, Cursor, etc. mediante MCP. Consulta la sección de MCP del README.