모든 형식 페이지 ↓
튜토리얼·참고 자료

빠른 시작 — 지금 바로 해 볼 다섯 가지

출처: coreprime/kbot @ 0ab97bf · GitHub에서 편집

지난주에 GoG에서 TA를 사고 5분 전에 kbot을 설치했는데, 어디서부터 시작해야 할지 모르겠다면 다음 명령 다섯 개를 실행해 보세요. 각각 1분도 걸리지 않으며, 저마다 다른 형식을 보여 줍니다.

모든 명령은 TA 설치본이 kbot 컨텍스트로 등록되어 있다고 가정합니다(kbot ctx 참고).

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

1. 게임에 들어 있는 모든 파일을 웹 브라우저에서 둘러보기

kbot mount --server

http://localhost:8090에서 열립니다. 이곳저곳 눌러 보세요 — 브라우저를 떠나지 않고 TNT, GAF, PCX, 3DO, FNT를 미리 볼 수 있습니다. COB 스크립트에는 구문 강조와 제어 흐름 뷰어가 제공되고, TDF/FBI/OTA 파일은 접을 수 있는 섹션 트리로 렌더링합니다.

왜 이것부터일까요? 이 안내의 다른 명령은 모두 탐색기가 하는 일 가운데 일부만 떼어 낸 것입니다. 여기서 시작한 다음, 스크립트로 무언가를 자동화하고 싶을 때 CLI로 넘어가세요.

2. 캠페인 맵 렌더링하기

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

이 명령은 타일 모자이크 위에 지형지물 스프라이트(나무, 바위, 금속 매장지)를 합성하고, 짝이 되는 .ota에서 가져온 번호 붙은 시작 위치 표시를 그립니다. 이렇게 만들어진 1.7 MB짜리 PNG는 내장된 252×252 미니맵보다 훨씬 풍부한 모습을 보여 줍니다.

형식의 세부 사항은 tnt.md를 참고하세요. 쓰임새가 없는 바이트는 하나도 없습니다.

3. 유닛이 실제로 하는 일 보기

컴파일된 바이트코드를 읽을 수 있는 BOS 소스로 디컴파일하세요.

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

…이것이 Krogoth의 애니메이션 스크립트입니다. 걷기 동작, 무기 반동, 파괴 시퀀스가 모두 들어 있습니다. 옵코드 수준까지 보려면 디스어셈블하세요.

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

-a 플래그는 짝이 맞는 JUMP / JUMP_IF_FALSE 명령어 사이에 ASCII 화살표를 그려 주므로, 반복 구조가 한눈에 보입니다.

cob.md를 참고하세요. 전체 옵코드 레퍼런스와 get_unit_value 포트 표도 들어 있습니다.

4. 아무 아카이브에서나 파일 하나만 추출하기

게임 전체를 평탄화하지 않고도 파일 하나만 꺼낼 수 있습니다.

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

-p는 글롭 패턴을 받습니다: -p "units/*.fbi"는 모든 FBI를, -p "*.bos"는 모든 스크립트 소스를 꺼냅니다. 대상 디렉터리는 필요하면 만들어집니다.

어느 아카이브에 그 파일이 있는지조차 모를 때는 리졸버에게 물어보세요.

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

hpi.md를 참고하세요 — 작은 아카이브 하나를 바이트 단위로 따라가는 헥스 분석도 들어 있습니다.

5. 표준 TA 팔레트를 PNG로 덤프해 간직하기

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

게임의 모든 색을 담은 16 × 16 격자입니다. 유닛 스킨을 작업하거나 HUD 색상 인덱스를 고를 때 빠른 참고 자료로 쓸 수 있습니다. 왼쪽 위의 빗금 친 칸은 인덱스 0(검은색)으로, 눈에 띄도록 빗금을 쳤습니다. 게임은 지형과 배경에서 이를 평범한 검은색으로 그리며, 스프라이트는 프레임마다 각자의 투명 키를 고릅니다.

pal.md를 참고하세요. TA: Kingdoms가 1×1 PCX 파일에 팔레트를 담아 배포하는 방식은 pcx.md에 있습니다.

다음은?

  • 유닛 모딩하기 — 모딩 튜토리얼을 따라 약 20분 만에 커스텀 Arm Flash 변형을 만들어 배포해 보세요.
  • 다양한 파일 형식 이해하기 — 형식 레퍼런스 목록에서 시작하세요.
  • 도구 만들기 — 모든 형식에 Go API가 있습니다. 각 형식 페이지의 "직접 해 보세요" 안내 상자에 formats/<x> import 경로가 나와 있습니다.
  • AI 어시스턴트 연결하기 — kbot mcp는 위의 모든 기능을 MCP를 통해 Claude Code, Claude Desktop, Cursor 등에 제공합니다. README의 MCP 절을 참고하세요.