[UnityLive2DExtractor]使用指南：Live2D资源提取完全掌握

一款专为从Unity资源打包文件（AssetBundle）中提取Live2D Cubism 3格式文件的实用工具，支持图形界面拖放与命令行两种操作方式，帮助开发者高效获取Live2D资源。

🔧 环境准备

环境检查清单

⏱️ 预计耗时：5分钟
本节要点：

• 确认操作系统为Windows（工具仅支持Windows环境）
• 安装.NET Framework 4.7.2或更高版本（运行时依赖）
• 获取UnityLive2DExtractor可执行文件

1. 🔍 运行时环境安装
   前往微软官方网站下载并安装.NET Framework 4.7.2（确保选择与操作系统匹配的版本）

2. 🔍 工具获取
   通过以下命令克隆工具仓库：

git clone https://gitcode.com/gh_mirrors/un/UnityLive2DExtractor

克隆完成后，在项目根目录中找到UnityLive2DExtractor.exe文件

🚀 快速上手

图形界面模式

⏱️ 预计耗时：2分钟
本节要点：

• 无需命令输入，通过拖放操作即可完成提取
• 输出目录自动生成在源文件同级目录
• 支持包含多层级Live2D文件的文件夹处理

1. 🔍 文件准备
   将包含Live2D资源的文件夹整理好（确保文件夹内包含Unity打包的资源文件）

2. 🔍 拖放提取
   直接将准备好的文件夹拖拽到UnityLive2DExtractor.exe图标上，工具将自动：

• 创建Live2DOutput目录（位于源文件夹同级）
• 解析资源文件并提取Cubism 3格式内容
• 所有提取结果将保存在Live2DOutput目录中

⚙️ 进阶操作

命令行使用详解

⏱️ 预计耗时：3分钟
本节要点：

• 支持自定义输出路径和日志级别
• 可集成到自动化工作流中
• 提供详细的错误信息便于调试

1. 🔍 基础命令格式
   打开命令提示符，导航到工具所在目录，执行：

UnityLive2DExtractor.exe [输入目录] [可选参数]

2. 🔍 参数说明表

参数名称	必选	说明	示例
input-dir	是	包含Live2D资源的文件夹路径	C:\live2d_files
--output	否	指定输出目录路径	--output D:\extracted
--verbose	否	显示详细提取过程	--verbose
--overwrite	否	覆盖已存在的输出文件	--overwrite

3. 🔍 命令示例
   提取D:\game_assets\live2d目录并指定输出到E:\projects\live2d_data：

UnityLive2DExtractor.exe D:\game_assets\live2d --output E:\projects\live2d_data

❓ 常见问题

故障排除

本节要点：

• 解决运行时错误的3种常见方案
• 输出文件不完整的排查步骤
• 权限问题的快速处理方法

1. 🔍 "缺少.NET Framework"错误
   症状：双击exe后提示"无法启动此应用程序"
   解决方案：重新安装.NET Framework 4.7.2，确保安装过程无错误提示

2. 🔍 提取文件为空
   症状：输出目录生成但没有文件
   排查步骤：

• 确认输入文件夹包含有效的Unity资源打包文件（.asset或.bundle扩展名）
• 检查源文件是否加密或使用了工具不支持的Unity版本
• 尝试使用--verbose参数查看详细日志

3. 🔍 权限被拒绝
   症状：提取过程中出现"访问被拒绝"错误
   解决方案：

• 将工具和源文件移动到非系统盘（如D盘）
• 右键UnityLive2DExtractor.exe选择"以管理员身份运行"
• 确保输出目录不存在只读属性