破解明日方舟加密数据文件:Ark-Unpacker 解码 FlatBuffers 与 AES 文本资源的完整指南
破解明日方舟加密数据文件:Ark-Unpacker 解码 FlatBuffers 与 AES 文本资源的完整指南
如果你用 Ark-Unpacker 批量解包明日方舟的 AB 文件后,发现导出的文本资源打开全是乱码,别担心——这正是本文要解决的问题。作为明日方舟游戏资源批量解包器,Ark-Unpacker 内置了「解码文本资源」功能,能自动识别并解码 FlatBuffers 二进制数据与 AES 加密文件,把乱码还原为可读的 JSON。
一、为什么解包出的文本资源是乱码?
解包 AB 文件导出的 TextAsset 文件主要有三种格式:
| 格式 | 说明 | 能否直接打开 |
|---|---|---|
| 纯文本 | 例如某些剧情文本 | ✅ 可以 |
| FlatBuffers | 二进制结构存储 | ❌ 需解码 |
| AES 加密 | 对称加密的二进制数据 | ❌ 需解密 |
其中 FlatBuffers 和 AES 加密文件直接打开都是乱码。好在 Ark-Unpacker 的「解码文本数据」功能会自动识别文件类型,你无需手动判断一个乱码文件到底是 FlatBuffers 还是 AES 加密的。
📄 官方原理文档:docs/zh/TextAssetsDecoding.md
二、准备工作:获取 Ark-Unpacker
程序提供交互式命令行界面与直接命令行两种用法。如果你希望从源码运行,先克隆仓库:
git clone https://gitcode.com/gh_mirrors/ar/Ark-Unpacker
💡 如果你已经通过「资源解包」模式导出了文本文件,接下来只需对已解包出的目录执行文本解码,无需再次解包。
三、FlatBuffers 解码:把二进制数据变成 JSON
FBS Schema 的作用
FlatBuffers 是一种高效的数据存储格式。要把二进制文件转成 JSON 等可读格式,除了原始文件,还需要 FBS(Schema)文件——它定义了哪些数据以什么类型存储。没有 FBS,你只能从二进制里读到一堆孤立的值。
Ark-Unpacker 内置了针对《明日方舟》编译好的 FBS 类库(位于 src/fbs/ 目录),解码时无需你准备任何额外的架构文件。
解码三步走
核心逻辑在 src/DecodeTextAsset.py 中:
- 猜测 Root Type:通过原始二进制文件的文件名匹配对应的 FBS(见 src/DecodeTextAsset.py#L56-L69 的
guess_root_type方法); - 解码为结构数据:使用该 FBS 解析二进制内容,得到结构化对象;
- 保存为 JSON:按配置的编码与缩进写出
.json文件(见 src/DecodeTextAsset.py#L86-L91)。
四、AES 解密:跳过 RSA 签名、推导 IV
解码原理
AES 是一种常见的对称加密算法。解密前需要一个 32 字节的 CHAT_MASK:它的首 16 字节就是 AES 密钥,后 16 字节参与推导初始向量(IV)。注意《明日方舟》各大版本的 CHAT_MASK 可能不同,程序内已内置当前版本的密钥(src/DecodeTextAsset.py#L97-L155)。
完整的解码步骤如下:
- 跳过 RSA 签名:新版游戏的加密文件头部有 128 字节 RSA 签名,解密前先剪掉;
- 取 AES 密钥:CHAT_MASK 的前 16 字节;
- 推导 IV:将文件前 16 字节数据与 CHAT_MASK 的后 16 字节逐位异或;
- AES-CBC 解密:用密钥与 IV 对剩余数据解密并去除填充;
- 格式转换:解密结果可能是 JSON,也可能是 BSON,程序会自动识别并把 BSON 转成 JSON。
对应源码实现见 src/DecodeTextAsset.py#L111-L134 的 aes_cbc_decrypt_bytes 方法。
五、如何一键解码文本资源(操作步骤)
交互式用法(推荐新手)
- 把待解码的已解包目录放到
ArkUnpacker.exe所在目录中; - 直接运行程序,进入交互式命令行界面;
- 选择「自定义文本数据解码」,依次指定输入目录与输出目录;
- 程序会实时显示「累计搜索 / 累计解码」进度,结束后输出统计摘要。
命令行用法(适合进阶用户)
使用 -m fb(decode-flatbuffers)模式,一行命令完成批量解码:
ArkUnpacker -m fb -i 解包后的文本目录 -o 解码结果目录
| 参数 | 说明 |
|---|---|
-m fb |
工作模式:fb = decode-flatbuffers(文本解码) |
-i INPUT |
源文件或目录路径 |
-o OUTPUT |
导出目标目录 |
-d |
先删除已存在的目标目录 |
-l {0-4} |
日志等级,4=debug 便于排查问题 |
⚠️ 运行程序后工作目录会生成配置文件
ArkUnpackerConfig.json,其中export_encoding(导出编码,默认utf-8)和export_json_indent(JSON 缩进)会影响解码结果的可读性,字段说明见 docs/zh/ConfigFile.md。
六、常见问题排查(FAQ)
Q1:某个文件解码失败、日志报 "Failed to guess root type"? 说明程序无法从文件名匹配到对应的 FBS。常见原因是文件被手动改名了——FlatBuffers 解码依赖原始文件名来定位 Schema,请保持解包时的命名不变。
Q2:AES 解密后得到乱码或报错? CHAT_MASK 会随游戏大版本更新而变化。若你解包的是旧版本客户端的资源,可能需要对应旧版本的密钥;升级 Ark-Unpacker 到最新版本通常即可解决。
Q3:解码输出的 JSON 中文显示乱码?
检查 ArkUnpackerConfig.json 中的 export_encoding,将其设为 utf-8 后重启程序再试。
Q4:纯文本文件(剧情文本)会被解码吗?
不会。程序只会处理二进制文件(识别逻辑见 src/utils/GlobalMethods.py#L133 的 is_binary_file),明文文件会被自动跳过,无需担心覆盖原文。
小结
用 Ark-Unpacker 的「解码文本资源」功能,你可以零配置地把明日方舟 AB 文件中解包出的 FlatBuffers 数据与 AES 加密数据批量还原为可读的 JSON 文件:程序自动识别文件格式、匹配 Schema、跳过 RSA 签名并完成 AES-CBC 解密,整个过程无需手动区分文件类型。配合 docs/zh/AssetsGuide.md 中的资源目录指引,找到目标 AB 文件后按本文步骤操作,即可完整掌握明日方舟加密数据文件的解码流程。