逆向Freelancer数据终极指南:Librelancer如何解码.dll、.3db、.cmp与.sur文件

原创2026-11-16 16:52:071,450 阅读

逆向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 的解码思路非常直接:

  1. 用 PE 解析器定位 .rsrc 节:通过 PEReader 读取 Windows PE 头,找到资源目录(Resource Directory)的起始位置;
  2. 按资源类型分流:代码里对 RT_RCDATA(Infocard 文本)、RT_STRING(字符串表,每块 16 条)、RT_DIALOG / RT_MENU(二进制界面数据)分别处理,见 ResourceDll.cs;
  3. 解码文本资源: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 节点则用于定义复合连接关系。

Librelancer模型导入器输出节点层级:展示Freelancer数据格式解码生成的cmp部件树结构

四、解码 .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 文件——这相当于对上面三种格式做了一次完整的编解码往返测试:

  1. 获取项目源码:git clone https://gitcode.com/gh_mirrors/li/Librelancer
  2. 用 Blender 或任意建模工具制作模型,按 docs/model-importer.md 的要求组织层级(Root 部件、hardpoint 自定义属性、$hull 碰撞壳)
  3. 在导入器中勾选 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 贡献新功能,这份逆向知识都会是你最趁手的地图 🗺️。

登录后查看全文
Librelancer