Ark-Unpacker:终极明日方舟游戏资源批量解包器,立绘、音频、Spine 模型一键提取完全指南

原创2026-10-31 09:05:481,103 阅读

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 端为例,资源分两部分:

  1. 安装包资源:从官网下载 .apk 安装包,将后缀改为 .zip 后解压,取出 assets/AB/Android 文件夹;
  2. 热更新资源:将手机中 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 用于终止程序;左键单击进入"文本选取"模式(程序会暂停),右键可粘贴文本,拖放文件可直接粘贴路径。

更多技术细节可查阅:

写在最后

Ark-Unpacker 以"批量 + 自动化"为核心理念,把解包、通道合并、文本解码、Spine 分拣这些零散步骤整合进一个工具中,让立绘、音频、模型等资源的一次性批量提取变得简单高效。本项目基于 BSD-3 开源协议发布,感谢开发者的持续维护,也请合理使用解包出的资源~

登录后查看全文
Ark-Unpacker