.MOD 里到底装了什么 —— Torchlight II 打包格式完全解析
从一个 mod 文件夹到一个能进游戏的 .MOD,中间发生的每一件事:容器怎么装、五种二进制格式各是什么、游戏究竟校验哪一个哈希、寻路走格怎么烘出来。附上那些看起来玄学的故障(能勾选却没效果 / 头像变成别的图 / 进副本走不动)背后的真实机理。
MIKURO · TORCHLIGHT II DEVWORKS
余烬工坊
Emberworks 重制 · 模组 · 工具
拆解一盏旧灯,点亮一炉新火。这里存放 Torchlight II 的逆向研究与重制开发日志、挑战者大陆 MOD 的更新记录,以及一整套自研第三方工具 —— 从打包器到启动器。
◆ ◆ ◆
指南 Field Manual
安装说明、完整配方与排错手册 —— 进图之前先看这里。
◆ ◆ ◆
更新日志 Changelog
挑战者大陆与 Mikuro 启动器的版本记录,条目按物品稀有度着色 —— 一眼扫出这版掉了什么好东西。
◆ ◆ ◆
开发日志 Dev Journal
逆向、复刻、踩坑与回填 —— 决不写推断当结论。
2026-07-24
TL2 TAG 系统逆向:引擎零校验,与 property key 排查
引擎按 rghash 匹配 tag、运行时零校验 TAGS.DAT —— mod 里任意 tag 都能用;附 GUTS 那条刷屏 no-match 警告的真相,与两个整合 mod 的 property key 实测排查。(2026-07-25 追加第 9 节勘误:名字分两个命名空间,「引擎硬编 tag = 0」的搜法失效。)
2026-06-20
TL2 EditorGuts 逆向 — MOD 打包与读取内部结构
从 EditorGuts.dll 导出函数逆向 .MOD 打包与读取的完整内部结构。(2026-07-25 已由《TL2 .MOD 打包完全解析》取代 —— 本文若干结论被后续实证推翻,见顶部说明。)
2023-11-28
火炬之光2 MOD开发 测试日志
MOD 开发过程中的实测记录与踩坑笔记。
2023-08-30
TL2 MPP Research
Why cleaning up .MPP files breaks dungeon walkability — repro steps and findings.(2026-07-25:下面的黑箱模型是对的,机理现已逆完,见顶部说明。)
全部日志
◆ ◆ ◆
工具库 The Armory
自研第三方工具,每一件都按装备陈列 —— 词缀是它的能力,品质是它的成熟度。
Mikuro 启动器
传奇 · 游戏增强 · MOD 启动器
- MIKURO X 增强层:掉落过滤 / 存档崩溃修复 / WASD 移动,一个开关全开
- 突破官方 10 个 MOD 加载上限,想挂多少挂多少(内存解限,不改 exe)
- DXVK 双版本按显卡驱动自动选择,Direct3D 9 翻成 Vulkan 跑
- 存档工具:洗点退点、按 MOD 精确解绑、双击一键选中该存档的 MOD
- 一键连接 MIKURO 爱发电联机服务器(广州 / 澳洲)
- 启动即环境自检:系统 / 首次运行 / MOD 目录 / VC++ 运行库
“上限只存在于旧启动器的一条指令里。”
■ 已发布 · v1.1.9
windows 10 / 11 · 整合包内置
MIKURO 游戏增强 · 内容
传奇 · 运行时内容 MOD · 青莲灵石体系
- 青莲灵石:三阶冷却主线(聚灵 / 凝华 / 太虚)+ 四颗「属性 + 上限」双效突破石 + 嗜血
- 镶嵌孔悬浮显示 5 → 10(引擎无 5 孔上限,对 5 孔内装备无影响)
- 御兽嘲讽:项圈 + 嘲讽令,宠物拉 10m 仇恨 4 秒
- 游戏内物品描述刻意精简,完整机制与获取方式以本页为准
“刷图凝玉,熔铸成灵。”
■ 随「游戏增强」常开
运行时挂载 · 单人 / 房主
火炬之光2 MOD 打包/解包工具
传奇 · MOD 打包 / 解包 CLI
- 3 秒初始化 —— 无需忍受编辑器 20 秒加载
- 直调 EditorGuts.dll 导出函数打包 / 解包
- 适合保持 workspace 干净的开发流
“每次打包,不必再等编辑器苏醒。”
■ 已发布
github.com/heiybb/TL2-Mikuro
挑战者大陆 · 装备图鉴
稀有 · 在线装备图鉴 · 数据浏览
- 收录 9 个组件 MOD 共 7000+ 件装备与镶嵌物,标注来源组件
- 自带效果 / 固定词缀 / 套装件数加成,按游戏内文案渲染
- 镶嵌石 / 骷髅头 / 余烬按镶嵌目标(武器 / 护甲 / 饰品)分列效果
- 装备 3D 模型在线预览,按品质 / 类型 / 来源 MOD 筛选
“每一件传奇,都摊开在灯下。”
■ 已上线
web · 直接在浏览器打开
原版 + 挑战者大陆 · 怪物图鉴
稀有 · 在线怪物图鉴 · 数据浏览
- 原版 800+ 与挑战者大陆 2300+ 怪物条目,BOSS / Champion / 普通 / 宠物召唤分类标色
- 生命 / 伤害 / 护甲 / 元素护甲以引擎真实语义呈现:等级曲线倍率(×1.0 = 基准)
- 内置原版与挑战者两套等级曲线,拖等级滑条按难度换算实战生命 / 伤害 / 经验
- 怪物技能表(含 AI 触发)、特性与 BOSS 控制抗性,按游戏内文案渲染
- 3D 模型在线预览,按来源 / 类别 / 家族筛选,同名随机变体自动折叠
“每一双在黑暗里亮起的眼睛,都记录在册。”
■ 已上线
web · 直接在浏览器打开
挑战者大陆 · 熔铸配方图鉴
稀有 · 在线配方图鉴 · 数据浏览
- 455 条配方直接提取自 MOD 数据文件,配料与产物均带物品图标和品质配色
- 随机产物按引擎加权 Roll 算法展开:137 条随机配方逐项标注概率
- 会空手的赌博配方(如传奇换碎片)明确标出空手概率
- 游戏内不显示的隐藏配方、产物显示为 ? 的配方,全部收录并标注
- 按配方分组 / 来源组件筛选,可搜索配方名、配料名、产物名
“倒进炉里的是运气,写在纸上的是概率。”
■ 已上线
web · 直接在浏览器打开
.MOD UN/PACKER · 网页版
魔法 · 网页版 MOD UN/PACKER · WebAssembly
- 与桌面版 tl2-mikuro-mod-packer 同一套 Rust 代码编译成 wasm,DAT / LAYOUT 编译与 .MOD 封装逐字节一致
- 纯客户端:选文件夹 → 打包 → 下载,文件不上传、无需安装,资源加载后断网也能用
- 附带全量 Runic base 数据(UNITS 模板 + 关卡碰撞几何),BASEFILE 继承与 MPP 走格都在浏览器内烘焙
- 跨源隔离环境走 wasm threads 多线程,大 mod 打包约为单线程的 1/4 ~ 1/6
- 反向解包:.MOD 还原成可编辑源目录,BINDAT / BINLAYOUT 反编译回文本源;Chrome / Edge 直接写出文件夹,其余走 ZIP
- 键名恢复:内置 46.5 万条分层反查表 + 文件自身上下文,救回的名字标绿、仍未知的标红;20 个第三方 MOD 实测 UNK_ 从 972 降到 871,零回归
- 要更快或处理几百 MB 整合包,用原生 Rust 版 tl2-mikuro-mod-packer-rs —— 多核并行、不受浏览器内存上限约束
“同一座熔炉,换了一扇窗。”
■ 已上线
web · chrome / edge / firefox