らぶ2Quad 完整工作记录:从解包到启动补丁
本文是一次性完整说明:做了什么、为什么这么做、补丁具体是怎么做出来的。细节拆解见 ../md/(9 个目录 28 篇);这里按时间线串起来。
0. 起点
| 项 | 值 |
|---|---|
| 游戏 | らぶ2Quad(ま~まれぇど) |
| 引擎 | EntisGLS(l2q.exe,32 位 PE,2,151,424 B) |
| 归档 | .noa,格式名 ERISA-Archive |
| 工作区 | E:\galgame\quad\ |
最初目标只有两个:
- 把每个
xxx.noa解包到dump/<包名>/; - 把引擎格式记录成文档。
后面遇到启动失败,目标扩展成「让游戏能跑起来」。
1. 解包工具(Rust CLI)
源码全部在 src\,无第三方依赖:
src\
├── Cargo.toml
├── main.rs CLI: info / list / unpack / unpack-all
└── noa.rs ERISA 解析与流式解包摸清的 .noa 结构
0x00 "Entis\x1a"
0x10 "ERISA-Archive file"
0x38 u64 filesize - 0x40
0x40 "DirEntry:"
0x48 u64 dir_len(基准 0x50)
0x50 u32 条目数 count
0x54 u64 第一块载荷长度
0x5C u64 恒 0
0x60 u32 编码标志 ← 关键
0x64 u64 dir_len + 0x10
0x6C 条目数组条目:
u64 stamp | u32 0 | u32 name_len(含 NUL)| name
+ 非最后一条:u64 A, u64 B, u64 CA[i]= 下一块载荷长度C[i] + 0x50= 下一块载荷偏移- 最后一条没有 A/B/C
数据区是一串块:
"filedata" + u64 size + payload按条目顺序排列,未压缩。
结果
- 解出 22,604 个文件 / 约 4.1 GB
- 用 7 个以上包做过全链路闭合验证,字节完全一致
quad info会报出编码标志,遇到加密包直接报错退出
2. 启动失败与诊断
现象
启动 → 「ディスクチェックを行います(初回のみ)」→ OK
→ 「Error:ファイルの読み込みに失敗しました。/再度ディスクチェックが必要です。」手段:Frida 运行时探针
写了 md\analysis\frida_probe.py,挂钩:
| RVA | 函数 | 观察 |
|---|---|---|
CreateFileA/W | kernel32 | 路径、access/share/disposition、成败 |
0x44A390 | PPM 解码器 | 解码输出 |
0x44A940 | bshf 解码器 | 解码输出 |
0x4498E0 / 0x501EC0 | 解码器构造 | 实例与缓冲 |
0x449B20 | 绑定源 | 实例 ↔ 句柄 |
0x506C10 | 归档条目查找 | 名字、命中/未命中、条目数 |
0x507810 | 打开归档取条目 | 名字、口令、返回值 |
MessageBoxA/W | user32 | 文案 + 栈扫描 |
定位到的失败链
- 扫描盘符找
l2qdata.noa(C:、D:、E:、%APPDATA%),E: 成功; - 打开全部明文归档,成功;
- 写
%APPDATA%\ま~まれぇど\らぶ2Quad\systea.dat(313 B); - 脚本查找
wm_window.noa→sub_506C10返回 1(miss); - 弹错误框。
关键日志:
[miss] 'wm_window.noa' cnt= 1 names= ['wm_window.noa']
[open2] 'wm_window.noa' pwd= '216236E2939BA0733180C57EC6D33F17' ret= 1条目名就在归档里,却 miss —— 说明问题在条目数据描述符,不是文件名,也不是文件缺失。
此时已确认 l2qsys.noa 头 0x60 = 0x40000000(bshf_crypt)。
3. Cotopha 脚本容器
script.noa(0x60 = 0x80000010,PPM)解出 11,621,590 B 的 script.csx 容器:
0x00 "Entis\x1a"
0x10 "Cotopha Image file"
0x38 u64 总长
0x40 "header "
0x5C "image "
→ 字符串池:u32 长度 + UTF-16 + u32 引用数 + 引用偏移表得到 systea.dat 的两处引用(0x10BC、0x1251)、 l2qsys.noa 引用(0x19766)等,但 VM 指令集没有完全恢复。这部分对最终修复不是必需的,作为背景保留。
4. bshf_crypt 破解(核心)
4.1 先找编码枚举
wchar_t *off_5FDA60[4] = { L"raw", L"erisa_code", L"bshf_crypt", L"erisa_crypt" };
int dword_5C8E38[4] = { 0, 0x80000010, 0x40000000, 0xC0000010 };所以 0x40000000 就是 bshf_crypt。早期曾猜 "bshf" 是 Blowfish,后来被实测否定。
4.2 定位解码链
| 地址 | 作用 |
|---|---|
sub_4498E0 | 建 192 B 解码器对象 |
sub_44A7D0 | 密钥初始化 |
sub_584BC0 | 每个 32 字节块建转置表 |
sub_44A940 | 块解码,输出表 A |
sub_506C10 | 条目查找 + 分块解码主循环 |
sub_507810 | 打开归档并取条目 |
4.3 密钥扩展
sub_44A7D0:
key = password 的 ANSI 字节
if len(key) < 32:
key.append(0x1B)
L = len(key)
while len(key) < 32:
key.append((key[-1] + key[len(key) % L]) & 0xFF)口令为空时用内置 unk_5EAF72 = 单空格 " "。
4.4 每块算法
状态 state 初值 0,每块先加一(模密钥长度),但读取起点用旧值:
C = 0[32]; A = 0[32]; v5 = 0; esi = old_state
for j = 256..1:
v5 = (v5 + key[esi]) & 0xFF; esi = (esi+1) % len(key)
result = (v5 >> 3) & 0x1F
v9 = 0x80 >> (v5 & 7)
while C[result] == 0xFF:
result = (result+1) & 0x1F; v5 = (v5+8) & 0xFF
while C[result] & v9:
bit = v9 & 1
v9 = ((v9 >> 1) | (bit << 7)) & 0xFF
result = (result + 2*bit) & 0x1F
v5 = (v5 + 1 + 8*bit) & 0xFF
idx = 256 - j
inbit = (block[idx>>3] >> (7-(idx&7))) & 1
C[result] |= v9
if inbit: A[result] |= v9得到的 A 就是 32 字节明文块。
本质:每块做一次 256 位、与密钥相关的位转置,不是流密码。佐证:密文比特币密度 0.572,普通明文归档 0.554,几乎一致。
4.5 密钥从哪来(这是最绕的一段)
一开始的思路全错:
| 假设 | 结果 |
|---|---|
口令在外部 l2q.xml 的 [File] 段 | 配置里没有 |
bshf = Blowfish | 算法对不上 |
MD5(Windows ProductId) | 本机三种取值都对不上 |
| 引擎实际传入的第二个 MD5 | 解密是乱码 |
真正的突破口是挂钩脚本原生函数:
| RVA | 函数 | 观察 |
|---|---|---|
0x4A8AF0 | GetWindowsProductID | 本机返回空串 |
0x4A8D40 | MakeMD5Digest | 输入/输出全可打印 |
0x44A7D0 | bshf 密钥初始化 | 抓到引擎实际用的口令 |
抓到两条哈希:
MD5( l2qdata.noa 里 256 字节 ) = 221273D15EF2F6C7606008DBEC27853F
MD5( "221273D15EF2F6C7606008DBEC27853F" ) = 216236E2939BA0733180C57EC6D33F17那 256 字节的出处:在 l2qdata.noa 里搜到了,位置是 0xFF00008 = 文件大小 - 0x100000(末尾 1 MiB 处)。
试出来的结论:
- 第一层哈希
221273D15EF2F6C7606008DBEC27853F才是内嵌条目的密钥。用它解l2qsys的载荷,输出正好以Entis\x1a ... ERISA-Archive file开头。 - 第二层哈希
216236E2...只是引擎后来尝试把wm_window.noa当外置加密归档打开时传的口令,用它解只会得到乱码。
密钥完全由 l2qdata.noa 的内容决定,与机器环境无关,换电脑也能算出来。
4.6 验证
python md/analysis/bshf_fast.py qiguai/l2qsys.noa wm_window.noa 0x9A 0x3B0E24 221273D15EF2F6C7606008DBEC27853F输出:
head b'Entis\x1a\x00\x00\x00\x04\x00\x02\x00\x00\x00\x00ERISA-Archive fi'quad list 解析出 200 个条目(ID_BTN_QSV_*、ID_QS_V_*、 system.inf 87,550 B 等),完全合法。
5. 补丁是怎么做的
5.1 思路
l2qsys.noa 的结构是:
0x6C 条目 "wm_window.noa"(单条目,无 A/B/C)
0x8A "filedata" + u64 0x3B0E24
0x9A 加密载荷 3,870,244 字节
EOF既然能解出明文,就保持原文件不变,只改两处:
- 把
0x9A起 3,870,244 字节换成明文; - 把
0x60的编码标志从0x40000000(bshf_crypt)改成0(raw)。
其余头部字段、条目表、大小全部沿用,兼容性最好。
5.2 制作代码
import struct
src = open('qiguai/l2qsys.noa', 'rb').read() # 原始加密包
dec = open('files/wm_window.noa', 'rb').read() # 已解密明文
assert dec[:6] == b'Entis\x1a' # 必须是 ERISA
assert len(dec) == 0x3B0E24 # 与载荷等长
d = bytearray(src)
d[0x9A:0x9A + len(dec)] = dec
struct.pack_into('<I', d, 0x60, 0) # bshf_crypt -> raw
open('files/l2qsys_raw.noa', 'wb').write(bytes(d))因为明文与密文长度完全相同,文件大小不变(3,870,398 B),所有偏移、大小字段都不需要重算。这是最省事也最不容易出错的做法。
5.3 安装
copy l2qsys.noa <游戏根目录>\l2qsys.noa注意 l2qsys.noa 在游戏根目录,不是 files\ 下:
らぶ2Quad\
├── l2qdata.noa 保持不动(磁盘检查 + 密钥种子)
├── l2qsys.noa 用补丁覆盖
└── files\
├── l2q.exe
└── patch\ 补丁目录5.4 验证
用 Frida 再跑一遍:
[hit] 'ID_BTN_START.eri'
[hit] 'ID_BTN_CONTINUE.eri'
[hit] 'ID_BTN_CONFIG.eri'
[hit] 'ID_TITLE_BG.eri'
...标题画面资源全部命中,没有 MessageBox 错误,游戏可正常进入。
5.5 补丁包内容
files\patch\:
| 文件 | 作用 |
|---|---|
l2qsys.noa | 修补后的归档 |
wm_window.noa | 解出的明文归档(200 条目,参考) |
bshf_fast.py | 快速解密脚本(可复用) |
decrypt_bshf.py | 直译版,便于对照 |
apply.bat | 一键安装,自动备份为 l2qsys.noa.orig |
revert.bat | 一键还原 |
README.md | 说明 |
6. 复现路径(从零开始)
# 1. 解包所有明文包
quad unpack-all --out dump
# 2. 取出 l2qdata 末尾 1 MiB 处的 256 字节,算第一层 MD5
python md/analysis/bshf_fast.py qiguai/l2qsys.noa wm_window.noa 0x9A 0x3B0E24 <第一层MD5>
# 3. 重打包(见 5.2 的 6 行代码)
# 4. 覆盖到游戏根目录密钥计算伪代码:
seed = l2qdata[ size - 0x100000 : +256 ]
key = MD5_HEX_UPPER( seed )7. 产物一览
| 路径 | 说明 |
|---|---|
src\ | Rust 解包工具 |
dump\ | 22,604 个文件 / 4.1 GB |
md\md\ | 28 篇格式与逆向文档(9 个目录) |
md\analysis\frida_probe.py | 运行时探针(含口令追踪钩子) |
md\analysis\bshf_fast.py | bshf 解密(3.87 MB ≈ 5 秒) |
md\analysis\decrypt_bshf.py | bshf 直译版 |
md\analysis\script_container.bin | 11.6 MB 脚本容器 |
files\wm_window.noa | 解出的明文归档 |
files\l2qsys_raw.noa | 重打包结果 |
files\l2qsys.noa.orig | 原始加密包备份 |
<游戏>\files\patch\ | 成品补丁 |
8. 仍未解决
l2qdata.noa本体 256 MiB 的明文内容没还原;它目前只当密钥种子和“磁盘检查”载体用。sub_506C10尾部那段 4 字节异或校验分支语义没完全确认(正确密钥下累加值3553ec0c,文件尾35cc16cf);不影响解密与运行。- Cotopha VM 指令集只解开了一部分,
systea.dat的两处使用点(0x10BC、0x1251)逻辑未还原。 erisa_crypt(0xC0000010)本作没有样本,未验证。
