Total Annihilation & TA: Kingdoms 파일 형식 레퍼런스

Cavedog Entertainment가 Total Annihilation(1997)과 Total Annihilation: Kingdoms(1999)에 담아 출시한 독자 파일 형식을 실제 리버스 엔지니어링 작업의 관점에서 정리한 실전 안내서입니다. 모든 페이지는 디스크상의 바이트 구조와 한 줄짜리 kbot 명령을 짝지어 보여 주므로, 본문을 읽으면서 실제 파일을 직접 들여다볼 수 있습니다.

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

형식 목록#

컨테이너·래퍼 형식#

그래픽·미디어#

맵·지형#

유닛·스크립트·설정#

TA: Kingdoms GUI#

튜토리얼·참고 자료#

범례: ✅ kbot 1급 지원 · 🟡 문서화되어 있으나 현재 kbot이 파싱하지 않음.

형식들이 서로 맞물리는 방식#

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

거의 모든 리버스 엔지니어링 작업은 HPI를 마운트하는 데서 시작합니다. 평탄화한 설치본도 결국 HPI를 풀어 놓은 것일 뿐입니다. 거기서부터 유닛(FBI)은 메시(3DO), 스크립트(COB), 유닛 초상화(PCX), 애니메이션 장치(GAF)를 가리킵니다. 맵(TNT)은 섹션(SCT)과 지형지물 배치로 조립되며, 각 배치는 TDF의 지형지물 정의로 연결됩니다.

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

엔디언, 문자 집합, 좌표 규약#

페이지에서 명시적으로 달리 정하지 않는 한, 이 문서의 모든 형식에 다음 규약이 적용됩니다.

이 문서 활용하기#

형식별 페이지는 모두 같은 구조로 되어 있습니다.

1. 무엇인가 — 용도와 TA 설치본에서 나타나는 위치.
2. 디스크상의 구조 — 헤더 구조체, 이어서 페이로드 섹션. 바이트 오프셋을 명시합니다.
3. 읽는 순서 — 파일을 제대로 파싱하는 탐색(seek)/읽기 순서.
4. 실제 예제 — 실제 Cavedog 파일을 바이트 단위로 분석합니다.
5. 직접 확인하기 — 자신의 설치본에 실행해 데이터를 바로 볼 수 있는 kbot 명령.
6. 주의할 점 — 문서화되지 않은 예외 사례, 버전별 차이, Cavedog 도구가 남긴 쓰레기 바이트 등.

다음과 같은 안내 상자가 있다면

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

…컨텍스트를 설정한 뒤 그 명령을 그대로 실행할 수 있다는 뜻입니다.

크레딧과 원자료#

이 문서는 수십 년에 걸친 커뮤니티의 리버스 엔지니어링 성과를 종합한 것입니다. 개별 발견은 각 페이지 본문에서 출처를 밝히며, 토대가 된 작업은 다음과 같습니다.

• Joe D. — 최초의 HPI 형식 분석(1997).
• Saruman & Bobban / dFR Engineering — 최초의 TNT 해설(1997).
• Scott "me22" McMurray — TNT 형식 보충 설명(2003). Kinboat의 Annihilator 소스를 참고했습니다.
• Kinboat — SCT 형식, GAF 도구, Annihilator 맵 에디터.
• Dan Melchione & Dark Rain — 3DO 형식(1998, 2002년 개정).
• C_A_P, Switeck, KhalvKalash — COB/BOS 옵코드 리버스 엔지니어링과 Scriptor 도구 계열.
• Dark Rain — TA:K GUI 형식과 TA:K 형식 난제에 관한 노트.
• Cavedog Entertainment — 25년이 넘게 지난 지금도 지켜 나갈 가치가 있는 게임을 만들어 준 데 감사합니다.

이 문서가 위 원자료와 어긋날 때는 kbot 소스 코드가 기준입니다. 여기 실린 형식들은 수천 개의 실제 Cavedog 파일로 왕복 변환(round-trip) 테스트를 거쳤습니다. 불일치를 발견하면 https://github.com/coreprime/kbot에 이슈나 PR을 올려 주세요.