逆向Freelancer数据终极指南:Librelancer如何解码.dll、.3db、.cmp与.sur文件
逆向Freelancer数据终极指南:Librelancer如何解码.dll、.3db、.cmp与.sur文件
Librelancer 是一个开源的 Freelancer 重制项目,其核心价值之一就是完整逆向并解码了 Freelancer 的四种核心数据格式:Windows 资源型 .dll 文件、单部件模型 .3db、多部件复合模型 .cmp,以及碰撞数据 .sur。本文带你从零看懂这些二进制文件的内部结构、解码原理,以及对应的项目源码位置,帮助你快速理解游戏数据是如何被读取、解析并重新生成的。
一、先搞清楚:Freelancer 的 4 种核心数据格式
Freelancer 的数据几乎全部封装在二进制格式里。Librelancer 为每种格式都实现了独立的读取器(Reader),先看一下它们分别负责什么:
| 格式 | 内容 | 典型用途 | 解码器源码 |
|---|---|---|---|
.dll |
字符串、Infocard、对话框 | 游戏资源总仓库 | ResourceDll.cs |
.3db |
单部件模型(UTF 容器) | 小型模型、图标 | ModelFile.cs |
.cmp |
多部件复合模型(UTF 容器) | 飞船等大型模型 | CmpFile.cs |
.sur |
碰撞表面(凸包) | 物理碰撞与护盾 | SurFile.cs |
💡 一个有意思的点:.3db 和 .cmp 其实共享同一套底层容器格式——UTF 树,区别只在于根节点的内容不同。
二、解码 .dll:把 Windows 资源文件当游戏资源包
Freelancer 的 .dll(如 ls2.dll)并不是真正的可执行模块,而是一个"套壳"的资源归档。Librelancer 的解码思路非常直接:
- 用 PE 解析器定位 .rsrc 节:通过
PEReader读取 Windows PE 头,找到资源目录(Resource Directory)的起始位置; - 按资源类型分流:代码里对
RT_RCDATA(Infocard 文本)、RT_STRING(字符串表,每块 16 条)、RT_DIALOG/RT_MENU(二进制界面数据)分别处理,见 ResourceDll.cs; - 解码文本资源:UTF-16 字符串会先剥离 BOM(
FF FE)再解码为 Infocard,损坏的条目会被捕获并记录错误日志而不是让程序崩溃。
解码结果被组织成 Strings、Infocards、Dialogs 等字典和列表,供游戏和编辑器直接查询。每条二进制资源最终封装为轻量的 BinaryResource.cs 对象。
🔍 项目还顺手做了一个"彩蛋检测":ContentDll.cs 会在 .dll 的固定偏移处检查字节特征,识别玩家社区流行的内容 Hack。
三、解码 .3db 与 .cmp:UTF 树状容器的统一解析
UTF 文件头:一次校验,三大区块
所有 UTF 文件(.3db、.cmp、.dfm 等)都以 UTF 魔数开头,格式版本固定为 257。文件头声明了三个区块的位置:
- Node Block:树节点结构(父子关系)
- String Block:所有字符串,按偏移引用
- Data Block:二进制数据(顶点、材质参数等)
统一解析入口在 UtfFile.cs,它负责校验魔数与版本、防止区块越界,然后重建出以 IntermediateNode 为根的节点树。
自动识别文件类型
拿到节点树后,UtfLoader.cs 只需看根节点的子节点名字就能判断文件类型:
- 出现
cmpnd节点 → 构造CmpFile(复合模型) - 出现
vmeshpart→ 构造ModelFile(即.3db单部件模型) - 出现
skeleton/multilevel→ 构造DfmFile(骨骼动画模型)
以 .cmp 为例,CmpFile.cs 会依次提取网格库(vmeshlibrary)、动画(animation)、材质库、纹理库,并把 part_xxx、Root 等子节点解析为部件列表,cons 节点则用于定义复合连接关系。
四、解码 .sur:为物理引擎还原碰撞凸包
.sur 文件是 Freelancer 的碰撞描述格式,结构比 UTF 简单粗暴得多——纯二进制、带魔数:
- 文件魔数
vers(0x73726576)+ 版本标记2.0f,见 SurFile.cs; - 每个 Surface 子块以
surf魔数开头,内部依次是包围球参数(中心、半径、缩放)、hpid(挂点 Hardpoint 列表)和三角形索引数据,格式常量集中在 SurfacePart.cs。
解码后的关键动作在 SurFile.Convert():把点表 + 三角形索引组装成 ConvexMesh 凸包数组,交给物理引擎做碰撞检测和护盾命中判定。这也是为什么 Mod 制作中的碰撞模型必须是凸多面体的原因。
五、动手实践:导入模型并验证解码结果 🛠️
理解解码之后,最快的验证方式是走一遍"生成"路径。LancerEdit 编辑器提供了模型导入器(Tools → Import Model),它能从 glTF 2.0(.glb)、.obj、.dae 反向生成标准 .cmp / .3db,并在检测到 $hull 凸包网格时同步生成 .sur 文件——这相当于对上面三种格式做了一次完整的编解码往返测试:
- 获取项目源码:
git clone https://gitcode.com/gh_mirrors/li/Librelancer - 用 Blender 或任意建模工具制作模型,按 docs/model-importer.md 的要求组织层级(Root 部件、
hardpoint自定义属性、$hull碰撞壳) - 在导入器中勾选 Generate sur,导出后交给解码器验证
完整的导入规则、LOD 命名(如 wing$lod1)和挂点类型(fix / rev)说明都在官方文档 model-importer.md 中。
六、关键路径速查表 📚
| 想了解 | 去哪里看 |
|---|---|
| DLL 资源解码 | src/LibreLancer.Data/Dll/ |
| UTF 容器与节点树 | UtfFile.cs、UtfLoader.cs |
| 模型格式(.3db/.cmp/.dfm) | src/LibreLancer/Utf/Cmp/、src/LibreLancer/Utf/Dfm/ |
| 碰撞格式(.sur) | src/LibreLancer/Sur/ |
| 模型导入与生成 | docs/model-importer.md、ImportModelTab.cs |
| API 参考 | docs/api/api.txt |
掌握这四种格式后,你就拥有了阅读 Freelancer 数据文件的"底层地图"——无论是调试 Mod 数据、编写工具链,还是给 Librelancer 贡献新功能,这份逆向知识都会是你最趁手的地图 🗺️。
