Ark-Unpacker:终极明日方舟游戏资源批量解包器,立绘、音频、Spine 模型一键提取完全指南
Ark-Unpacker:终极明日方舟游戏资源批量解包器,立绘、音频、Spine 模型一键提取完全指南
Ark-Unpacker 是一款面向《明日方舟》玩家的开源游戏资源批量解包器,基于 Python 开发。它可以一键批量解包 Unity AssetBundle(.ab)文件,导出立绘 PNG、WAV 音频、Spine 动画模型、3D Mesh 等资源,并自动完成 RGB-Alpha 通道图合并与 FlatBuffers/AES 文本解码,是提取明日方舟游戏资源的完整工具。
核心功能一览 📦
Ark-Unpacker 把"拿到 AB 文件 → 得到可用的图片/音频/模型"这条链路完整打通:
| 功能 | 说明 |
|---|---|
| 🖼️ AB 文件批量解包 | 批量解包 .ab 文件,支持 v2.5.04 及以上版本的特殊解压算法 |
| 🔗 RGB-Alpha 图片自动合并 | 自动识别并合并通道图,输出完整立绘 |
| 📝 文本资源解码 | 自动识别并解码 FlatBuffers / AES 加密文本 |
| 🦴 Spine 模型分类导出 | 准确区分战斗小人正背面、基建小人、动态立绘 |
| 🎬 USM 音视频提取 | 提取 Criware USM 过场动画并转码导出 |
| 🎮 双模式操作 | 交互式命令行界面 + 纯命令行参数两种用法 |
解包支持导出的资源类型:
| 资源类型 | 描述 | 导出格式 |
|---|---|---|
| Sprite | 精灵图 | PNG 图片 |
| Texture2D | 二维纹理图 | PNG 图片 |
| AudioClip | 音频剪辑 | WAV 音频 |
| TextAsset | 文本或字节数据 | 未指定 |
| Mesh | 3D 模型 | OBJ 文件 |
| TypeTree | 对象结构 | JSON 文件 |
资源准备:如何获取明日方舟的 AB 文件
《明日方舟》基于 Unity 开发,游戏资源全部打包在 AssetBundle 文件(后缀 .ab,少数为 .bin)中。以 Android 端为例,资源分两部分:
- 安装包资源:从官网下载
.apk安装包,将后缀改为.zip后解压,取出assets/AB/Android文件夹; - 热更新资源:将手机中
Android/data/com.hypergryph.arknights/files/Bundles文件夹复制到电脑(重命名为Android(2))。
把 Android(2) 中的内容复制进 Android 并覆盖同名文件,即得到完整游戏资源:
你的目录
├─Android
└─Android(2) # 覆盖合并到 Android 中
💡 PC 端思路相同:
StreamingAssets/AB/Windows是初始资源,PersistentData/Bundles是热更新资源,合并即可。各子目录存放的资源类型可参考 docs/zh/AssetsGuide.md。
快速上手:下载与运行
方式一:直接运行发行版(推荐新手)
下载适用于 Windows 64 位系统的可执行文件 ArkUnpacker-vx.x.x_x64.exe,将需要解包的资源文件夹放到程序同目录,直接运行即可:
你的目录
├─chararts # 干员立绘(可选解包部分文件夹)
├─audio # 音频
└─ArkUnpacker.exe
运行后进入交互式命令行界面,按提示操作即可。首次运行会在工作目录生成配置文件 ArkUnpackerConfig.json 与日志文件 ArkUnpackerLogs.log。
方式二:从源码运行
git clone https://gitcode.com/gh_mirrors/ar/Ark-Unpacker
cd Ark-Unpacker
python Main.py
不带任何参数运行 Main.py 即进入交互式 CLI 模式。
各模式功能详解
交互式主菜单提供 8 个模式入口,定义见 Main.py:
1️⃣ 一键执行
对当前文件夹依次执行"资源解包 + 图片合并",解包结果默认导出到 Unpacked_xxxx 文件夹,合并图片导出到 Combined_xxxx 文件夹,是最省事的用法。
⚠️ 不建议用一键执行解包整个游戏资源目录——耗时较长且占用大量内存和存储,建议只针对子目录操作。
2️⃣ 自定义资源解包
解包指定路径的 AB 文件,并选择导出类型(可多选):i = 图片、t = 文本、a = 音频、m = Mesh、j = TypeTree JSON。支持"按来源分组",将文件按源 AB 文件名分目录存放,方便后续查找。
3️⃣ 自定义图片合并
明日方舟的图片解包后是两张:RGB 通道图(有颜色)+ A 通道图(黑白灰,控制透明度)。该模式会自动匹配并合并为完整图片,详见 docs/zh/Essentials.md。
4️⃣ 自定义文本资源解码
解包出的 TextAsset 有三类:纯文本、FlatBuffers 二进制、AES 加密文件。后两类直接打开是乱码,该功能会自动识别格式并解码为可读 JSON。原理详见 docs/zh/TextAssetsDecoding.md。
5️⃣ 自定义 Spine 模型导出
战斗小人分正面/背面,文件名可能完全相同,常规解包容易混淆。专门的 Spine 导出模式会将模型按类型放入独立文件夹:
BattleFront:战斗小人正面BattleBack:战斗小人背面Building:干员基建小人DynIllust/DynIllustStart/DynPortrait:动态立绘系列
6️⃣ 自定义 Criware USM 提取
提取 USM 文件(通常为过场动画)中的音视频,支持"仅音频 / 仅视频 / 合并音视频"三种模式,底层依赖 FFmpeg 进行转码(需提前安装并加入 Path 环境变量)。
7️⃣ / 8️⃣ ArkModels 与 ArkVoice 定制工具
面向特定仓库更新的专用工作流:ArkModels 完成模型提取、分拣与数据集生成;ArkVoice 完成多语言语音的提取、分拣与合并。详细说明分别见 docs/zh/ArkModelsRepoKit.md 和 docs/zh/ArkVoiceRepoKit.md。
命令行参数速查
熟悉命令行的用户可以直接跳过交互界面,运行 ArkUnpacker -h 查看帮助。常用参数:
| 参数 | 说明 |
|---|---|
-m {ab,cb,fb,sp,cu} |
工作模式:AB 解包 / 图片合并 / 文本解码 / Spine 导出 / USM 提取 |
-i / -o |
输入源路径 / 输出目录 |
-d |
先删除已存在的目标目录 |
--image --text --audio --mesh --typetree |
ab 模式下勾选对应导出类型 |
-g |
按来源 AB 文件分目录存放 |
--no-video / --no-audio |
cu 模式下跳过视频 / 音频处理 |
-l {0-4} |
日志等级:0=none 1=error 2=warn 3=info 4=debug |
示例:批量解包立绘目录并只导出图片
ArkUnpacker -m ab -i chararts -o out --image -g
参数解析逻辑见 src/utils/ArgParser.py。
配置文件说明
首次运行后生成的 ArkUnpackerConfig.json 支持按需调整,字段说明详见 docs/zh/ConfigFile.md,常用项:
| 字段 | 作用 |
|---|---|
performance_level |
性能等级 0~3,推荐 Standard(2) |
min_spare_memory_mb |
可用内存下限,低于此值会阻滞新任务;设为 0 可绕开限制 |
usm_export_video_codec |
USM 提取时的视频编码器,如 vp9 |
export_encoding |
导出文本文件的编码 |
⚠️ 修改配置后需重启程序才生效;升级大版本后若程序异常,可删除旧配置文件重新生成。
常见问题与注意事项
- 为什么图片是两张? 明日方舟的立绘等图片被拆分为 RGB 通道图与 A 通道图,需用"图片合并"模式还原;
- 为什么战斗小人导出后分不清正背面? 它们的文件名完全相同,请改用"自定义 Spine 模型导出"模式;
- 电脑配置要求? 程序会根据 CPU 核心数自动调整多进程策略(见 src/mp/WorkerPool.py),配置较低的电脑运行时可能较慢;
- 一键执行为何没解包某些 AB 文件? 一键执行模式只解包子文件夹中的 AB 文件,不包括程序同目录直接放置的文件;
- Windows 命令行小提示:
Ctrl+C用于终止程序;左键单击进入"文本选取"模式(程序会暂停),右键可粘贴文本,拖放文件可直接粘贴路径。
更多技术细节可查阅:
- 必备知识(RGB/A 通道图、Spine 动画小人):docs/zh/Essentials.md
- 游戏资源查找指南:docs/zh/AssetsGuide.md
- 开发者指引:docs/zh/ForDevelopers.md
- 更新日志:CHANGELOG.md
写在最后
Ark-Unpacker 以"批量 + 自动化"为核心理念,把解包、通道合并、文本解码、Spine 分拣这些零散步骤整合进一个工具中,让立绘、音频、模型等资源的一次性批量提取变得简单高效。本项目基于 BSD-3 开源协议发布,感谢开发者的持续维护,也请合理使用解包出的资源~