横扫千军与横扫千军：王国格式参考

这是一份关于 Cavedog Entertainment 在《横扫千军》（1997）和《横扫千军：王国》（1999）中所用专有文件格式的实用指南，从实际逆向工程的角度写成。每一页都把磁盘上的字节布局与一条单行 kbot 命令放在一起，让你可以一边读正文，一边动手查看真实文件。

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

格式目录#

容器与封装格式#

图形与媒体#

地图与地形#

单位、脚本与配置#

横扫千军：王国界面#

教程与参考#

图例： ✅ kbot 一等支持 · 🟡 有文档，但 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. 读取顺序——能成功解析该文件的定位/读取步骤序列。
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 界面格式，以及 TA:K 格式难点笔记。
• Cavedog Entertainment——感谢他们做出了一款 25 年多以后仍值得延续下去的游戏。

当本文档与上述原始资料冲突时，以 kbot 源代码为准——这里的格式都经过了针对数千个真实 Cavedog 文件的往返测试。如果你发现不一致之处，请在 https://github.com/coreprime/kbot 提交 issue 或 PR。