Torch pack命令深度解析目录如何变成lighthouse.o2r【免费下载链接】Lighthouse项目地址: https://gitcode.com/GitHub_Trending/lighthouse26/LighthouseTorch pack命令是 Lighthouse《班卓熊大冒险》PC 移植版资产打包的核心环节一条命令就能把整个port/资源目录压缩成游戏启动时加载的lighthouse.o2r档案。本文将带你完整看懂 Torch 的o2r与pack两条命令弄明白一个普通文件夹是如何一步步变成游戏可读取的资产包的。Torch 是什么Lighthouse 的压缩打包工具Torch 并非 Lighthouse 本体的一部分而是一个以git 子模块方式引入的独立资产工具仓库 Torch/ 目录子模块定义见 .gitmodules。它的职责很纯粹提取从 N64 ROM 二进制中还原出模型、纹理、音频、对话等资产打包把目录中的文件按 o2r 格式重新归档供引擎在运行时按需读取。Lighthouse 在 CMakeLists.txt 中通过add_subdirectory(Torch)引入 Torch 库并以外部工程方式编译出torch可执行文件CMakeLists.txt。两条核心命令一次提取一次打包命令一torch o2r baserom.z64—— 从 ROM 提取 bk.o2r构建时 CMake 会先调用这条命令CMakeLists.txttorch o2r baserom.z64它解析官方 ROM 的全部资产写出bk.o2r——这是游戏的数据底座包含关卡、怪物、模型与多语言对话。Torch 还会把 ROM 的 CRC 写入 o2r 的版本文件Lighthouse 启动时据此判断基础数据版本见 src/port/GameVersion/BaseGameVersion.h。命令二torch pack 目录 lighthouse.o2r o2r—— 目录变成档案这是本文的主角对应GeneratePortO2R构建目标CMakeLists.txt流程为把 port/ 目录字体、纹理、模型、动画暂存到port_staging并入 libultraship 的着色器目录fast/shaders执行torch pack port_staging lighthouse.o2r o2r——第三个参数指定输出格式为 o2r生成结果回拷到源码目录与构建目录。port/里都有什么比如 port/fonts/ 中的 Montserrat 等 UI 字体、port/models/lighthouse 灯塔模型、port/textures/buttons/ 下的按键贴图——它们全部会被 pack 进同一个档案。构建系统如何自动调用 Torch两条命令都由 CMake 自定义目标封装好开发者无需手动输入| 构建目标 | 实际执行的 Torch 命令 | 产物 | | - | - | - | |ExtractAssets|torch o2r baserom.z64|bk.o2rROM 资产 | |GeneratePortO2R|torch pack ... lighthouse.o2r o2r|lighthouse.o2r移植资产 |完整步骤在官方文档 docs/BUILDING.md 中也有记录。Linux/macOS 打包时lighthouse.o2r会被一并安装进发布包CMakeLists.txt。引擎如何消费 lighthouse.o2r游戏启动后Lighthouse 在 src/port/Engine.cpp 中定位并挂载lighthouse.o2r随后加载其中的资产清单src/port/ResourceHelpers.cpp。若文件缺失或版本过旧启动流程会给出明确提示src/port/Extractor/ExtractFlow.cpp。同一个 o2r 格式还支撑了 Lighthouse 的 MOD 生态自定义资产放入mods/目录的.o2r/.otr文件即可覆盖游戏资源语言包用其他地区的 ROM 生成bkregion.o2r精简档案docs/modding/LANGUAGE PACKS.mdRomhack从修改版 ROM 提取出的 o2r 可叠加加载支持-hack启动参数直接进档src/port/LaunchArgs.cpp。上手实践手动生成一次 lighthouse.o2r想亲手体验完整流程只需三步按 docs/BUILDING.md 配置 CMake记得初始化子模块以拉取 Torch 源码准备一份校验通过的baserom.z64构建ExtractAssets目标得到bk.o2r构建GeneratePortO2R目标观察 Torch 把port_staging目录逐个文件写入lighthouse.o2r。小结Torch 是 Lighthouse 的资产打包引擎通过子模块管理Torch/torch o2r负责ROM → bk.o2r的提取torch pack 目录 lighthouse.o2r o2r负责目录 → o2r 档案的打包正是lighthouse.o2r的出生方式两个 CMake 目标ExtractAssets与GeneratePortO2R让这一切全自动完成。理解了 pack 命令你就掌握了 Lighthouse 资产管线的最后一块拼图——无论是做 MOD、语言包还是二次开发都绕不开它。【免费下载链接】Lighthouse项目地址: https://gitcode.com/GitHub_Trending/lighthouse26/Lighthouse创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
