为什么选错游戏就提取失败?AnimeStudio内置50+款解密方案详解
为什么选错游戏就提取失败?AnimeStudio内置50+款解密方案详解
AnimeStudio 是一款面向 Unity 游戏的资源提取工具,内置 50 多款游戏的解密方案。它支持浏览、预览并导出贴图、网格、动画、音频、着色器等内容。很多新手提取失败,第一步就错在"选错了游戏":每个游戏有专属的加密方式,选错解密方案,结果要么直接报错,要么导出一堆乱码。这篇文章带你弄懂内置的 50+ 款解密方案是怎么分组的、又该如何正确选择。
先搞懂原理:为什么"选错游戏"就会失败
绝大多数被加密的游戏,其资源包并不是标准的 UnityFS 文件,而是被厂商做了三层"包装":
- 文件级加密:整个文件被自定义算法处理,连文件头都认不出来;
- 包内块级加密:包里的每个数据块用不同的密钥或算法解密;
- 特殊压缩:例如米哈游系游戏使用的 Oodle 变体压缩,普通解压库根本打不开。
AnimeStudio 的加载流程正是围绕这三步设计的,全部逻辑集中在核心工程 AnimeStudio/ 中:
| 阶段 | 负责模块 | 做了什么 |
|---|---|---|
| ① 识别文件类型 | FileReader.cs | 通过文件头签名(UnityFS、ENCR、mhy0、Blb2 等)判断是 Bundle、Block、VFS 还是普通 assets 文件 |
| ② 按游戏解密 | ImportHelper.cs | 的 PreProcessing 会根据你选中的游戏,对应用对应的解密函数(DecryptPack、DecryptMark、RC4、XOR 等) |
| ③ 解析并解压数据块 | BundleFile.cs | 逐块解密(LZ4 系 / Oodle 系)并解压,还原出包内文件列表 |
关键点在于:②③ 两步都依赖你选中的游戏条目。选错了,密钥不对、分支走错,轻则解压失败报错 Lz4 decompression error,重则"成功"导出但内容全是乱码。
内置 50+ 款解密方案都藏在哪儿
游戏列表由 GameManager.cs 统一维护,启动时一次性注册所有条目,并按"游戏名 + 版本号"区分。你在 GUI 里看到的下拉列表,来源就是这份注册表。CLI 里的 --game 参数也是校验同一份列表——传错名字会直接提示 Invalid game 并打印全部可用选项(见 CommandLine.cs)。
整个列表可以分成四大类:
一、米哈游(HoYoverse)系:版本区分最细
这一类的解密参数(密钥、SBox、初始向量等)在 CryptoHelper.cs 中集中定义。同一个游戏的不同版本用完全不同的加密方案,这也是最容易选错的一类:
| 游戏 | GUI 可选版本 | 内部类型 | 解密方案 |
|---|---|---|---|
| 原神 Genshin Impact | Live / Pack / CBT 1~3 | GI 系列 | Mr0k / Blk / Mhy 三套块加密 |
| 崩坏3 Honkai Impact 3rd | Live / Pre / Pre Pre | BH3 系列 | Mr0k 块加密 + XORShift128 头部混淆 |
| 崩坏:星穹铁道 HSR | Live / CBT 2 | SR 系列 | Mr0k + Oodle 变体压缩,ENCR 多包容器 |
| 绝区零 ZZZ | Live / CBT 1 / CBT 2 | ZZZ 系列 | Mhy / Mr0k,mhy0、Blb2 等容器 |
一个典型的坑:原神 CBT 版本的文件用 Live 的密钥解,会"解压成功"但全是坏数据。所以提取前请先确认文件来自哪个版本。
二、UnityCN 国产游戏:密钥可配置
国内大量游戏使用 Unity 中国(UnityCN)加密,AnimeStudio 通过 UnityCNManager.cs 内置了 20 多款游戏的解密密钥,例如:
- Punishing: Gray Raven(分全球/韩服 与 中/日/台服两套密钥)
- Neural Cloud、White Chord(绝对音律)、Higan: Eruthyll、Mecharashi(苍翼:混沌效应)
- Castlevania: Moon Night Fantasy(恶魔城:月下迷城)、Frostpunk: Beyond the Ice(冰汽时代:冰封之地)等
这部分密钥会同步到运行目录的 CNKeys.json 中。如果某款游戏没内置密钥,可以选 UnityCN Custom Key 手动填入,或打开 UnityCNEdit 编辑密钥表。
三、其他加密游戏:一家一套算法
ImportHelper.cs 中为每款游戏单独实现了解密函数,方案五花八门,这也是 50+ 方案的主要来源:
| 游戏 | 解密方案 | 源码位置 |
|---|---|---|
| Ensemble Stars | 自定义步进 XOR | DecryptEnsembleStar |
| Shining Nikki / OPFP | 伪文件头(Fake Header)偏移定位 | ParseFakeHeader |
| Anchor Panic | 按文件名单 MD5 派生密钥的 RC4 | DecryptAnchorPanic |
| Project Sekai | 头部 8 字节固定 XOR | DecryptProjectSekai |
| Girls Frontline | 前 16 字节反推 XOR 密钥 | DecryptGirlsFrontline |
| Reverse: 1999 | 文件名求和字节作为 XOR 密钥 | DecryptReverse1999 |
| NetEase 系 | 首块自定义解密 + LZMA | NetEaseUtils.cs |
| Arknights Endfield | FairGuard 首块解密 + 变体 LZ4 | FairGuardUtils.cs |
四、标准 Unity 游戏:不需要密钥
如果文件本身就是标准 UnityFS 包,选 Unity 条目即可,直接跳过解密环节。
解密之后的重活:Oodle 与动画压缩
选对游戏只是第一步,数据块还原后还要解压。米哈游系使用的 Oodle 压缩(Kraken/Mermaid/Leviathan)由独立原生库完成,对应模块:
- 解压器封装:OodleHelper.cs → 调用
AnimeStudio.Ooz.dll - 原生实现:AnimeStudio.Ooz/(含 kraken.cpp、compr_kraken.cpp 等)
动画资产则走 ACL 反压缩路线,按游戏版本拆成多个原生库(AnimeStudio.ACL.DB.dll、AnimeStudio.ACL.ZZZV2.dll 等),源码见 AnimeStudio.ACL/。这些库以预编译形式放在 AnimeStudio.Libraries/。
提取失败排查:对号入座找原因
| 症状 | 最可能的原因 | 处理建议 |
|---|---|---|
报 Unsupported compression type / Invalid decompressed block size |
游戏条目和文件实际版本不匹配(如 CBT 文件选了 Live) | 回到游戏选择器,换成对应版本条目 |
解压错误 write N bytes but expected M bytes |
密钥错误导致块解密失败 | 确认文件来源版本;UnityCN 游戏核对密钥 |
| 文件能打开但资源全是坏图/坏模型 | 加密层"侥幸"通过,块层密钥不对 | 换同一游戏的其他版本条目再试 |
CLI 报 Invalid game. Supported games: ... |
--game 参数写错 |
参数必须是列表中的游戏名,如 GI、SR、ZZZ(Program.cs 中 GameManager.GetGame 按精确名称查找) |
| 提示找不到文件/无输出 | 选了 Block 类游戏但传入单个非容器文件 | Block 类游戏需加载其容器文件(.block、Blb2 等) |
最快配置方法:3 步选对游戏并提取
GUI 用法(AnimeStudio.GUI.exe):
- 在启动时的 Game Selector 里先选大类(Hoyoverse / Unity / Other),再选具体游戏和版本;
- 拖入文件或文件夹,按类型/名称过滤,预览后导出。
选择器界面逻辑见 GameSelector.cs,HoYoverse 游戏会列出全部版本子项供你切换。
CLI 用法(AnimeStudio.CLI.exe,适合批量导出):
AnimeStudio.CLI.exe <input> <output> --game GI --types Texture2D,Sprite --export_type convert
常用参数:--game(必填,游戏名)、--types(类型过滤)、--names / --containers(正则过滤)、--group_assets(输出目录结构)、--silent(静默)。不带参数运行一次即可看到完整参数列表。
结语
AnimeStudio 把 50+ 款游戏的解密知识沉淀成了可维护的游戏注册表,"选对游戏条目"本质上就是为文件配上正确的密钥和压缩参数。记住三件事:先确认文件来自哪个游戏和哪个版本、优先匹配 Live 与 CBT 条目、CLI 的 --game 要用准确的游戏名。做到这三点,绝大多数"提取失败"问题都能在第一步化解。想深入了解某个游戏的实现,直接顺着 GameManager.cs 里的类型标记找到对应的解密函数即可,所有方案都开源可查。