为什么选错游戏就提取失败?AnimeStudio内置50+款解密方案详解

原创2026-10-13 23:02:591,648 阅读

为什么选错游戏就提取失败?AnimeStudio内置50+款解密方案详解

AnimeStudio 是一款面向 Unity 游戏的资源提取工具,内置 50 多款游戏的解密方案。它支持浏览、预览并导出贴图、网格、动画、音频、着色器等内容。很多新手提取失败,第一步就错在"选错了游戏":每个游戏有专属的加密方式,选错解密方案,结果要么直接报错,要么导出一堆乱码。这篇文章带你弄懂内置的 50+ 款解密方案是怎么分组的、又该如何正确选择。


先搞懂原理:为什么"选错游戏"就会失败

绝大多数被加密的游戏,其资源包并不是标准的 UnityFS 文件,而是被厂商做了三层"包装":

  1. 文件级加密:整个文件被自定义算法处理,连文件头都认不出来;
  2. 包内块级加密:包里的每个数据块用不同的密钥或算法解密;
  3. 特殊压缩:例如米哈游系游戏使用的 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)由独立原生库完成,对应模块:

动画资产则走 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):

  1. 在启动时的 Game Selector 里先选大类(Hoyoverse / Unity / Other),再选具体游戏和版本;
  2. 拖入文件或文件夹,按类型/名称过滤,预览后导出。

选择器界面逻辑见 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 里的类型标记找到对应的解密函数即可,所有方案都开源可查。

登录后查看全文
AnimeStudio