破解明日方舟加密数据文件:Ark-Unpacker 解码 FlatBuffers 与 AES 文本资源的完整指南

原创2026-10-31 15:43:511,609 阅读

破解明日方舟加密数据文件: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 中:

  1. 猜测 Root Type:通过原始二进制文件的文件名匹配对应的 FBS(见 src/DecodeTextAsset.py#L56-L69 的 guess_root_type 方法);
  2. 解码为结构数据:使用该 FBS 解析二进制内容,得到结构化对象;
  3. 保存为 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)。

完整的解码步骤如下:

  1. 跳过 RSA 签名:新版游戏的加密文件头部有 128 字节 RSA 签名,解密前先剪掉;
  2. 取 AES 密钥:CHAT_MASK 的前 16 字节;
  3. 推导 IV:将文件前 16 字节数据与 CHAT_MASK 的后 16 字节逐位异或;
  4. AES-CBC 解密:用密钥与 IV 对剩余数据解密并去除填充;
  5. 格式转换:解密结果可能是 JSON,也可能是 BSON,程序会自动识别并把 BSON 转成 JSON。

对应源码实现见 src/DecodeTextAsset.py#L111-L134 的 aes_cbc_decrypt_bytes 方法。

五、如何一键解码文本资源(操作步骤)

交互式用法(推荐新手)

  1. 把待解码的已解包目录放到 ArkUnpacker.exe 所在目录中;
  2. 直接运行程序,进入交互式命令行界面;
  3. 选择「自定义文本数据解码」,依次指定输入目录与输出目录;
  4. 程序会实时显示「累计搜索 / 累计解码」进度,结束后输出统计摘要。

命令行用法(适合进阶用户)

使用 -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 文件后按本文步骤操作,即可完整掌握明日方舟加密数据文件的解码流程。

登录后查看全文
Ark-Unpacker