UnityLive2DExtractor：Live2D资源提取工具使用指南

1. 环境配置

1.1 系统要求

依赖项	版本要求
操作系统	Windows
.NET Framework	4.7.2 或更高版本

1.2 安装步骤

1. 安装.NET Framework
   请确保系统已安装.NET Framework 4.7.2或更高版本。

2. 获取工具程序
   从项目仓库获取UnityLive2DExtractor.exe可执行文件，放置于任意工作目录。

💡 提示：程序运行需依赖Libraries目录下的相关组件，请勿单独移动可执行文件。

2. 快速上手

2.1 图形界面操作

1. 直接将包含Live2D资源的文件夹拖放到UnityLive2DExtractor.exe上
2. 程序将自动在原文件夹目录创建Live2DOutput文件夹
3. 提取完成的Cubism 3格式文件将保存至该目录

2.2 命令行参数详解

# 基本语法
UnityLive2DExtractor.exe [source_directory]

# 参数说明
[source_directory]  - 包含Live2D资源的目标文件夹路径

# 示例
UnityLive2DExtractor.exe D:\Projects\Live2DResources

执行命令后将在源目录同级生成Live2DOutput文件夹，内含提取后的资源文件。

3. 进阶操作

3.1 输出目录结构

提取完成后生成的典型目录结构：

Live2DOutput/
├── Models/        # 模型数据文件
├── Textures/      # 纹理资源
└── Motions/       # 动作数据

3.2 支持的文件类型

程序自动识别并处理以下类型资源：

• Unity AssetBundle文件
• Live2D Cubism 3模型数据
• 相关纹理和动画资源

4. 常见问题排查

4.1 安装验证

执行以下命令验证安装是否成功：

UnityLive2DExtractor.exe --version

正常情况下将显示当前程序版本信息。

4.2 错误处理

• 缺少运行时：提示".NET Framework未安装"时，请检查4.7.2或更高版本框架是否正确安装
• 提取失败：确保源文件夹包含有效的Live2D资源，且具有读写权限
• 组件缺失：若提示缺少dll文件，请检查Libraries目录是否完整

5. 技术说明

5.1 核心功能模块

• CubismModel3Json.cs：模型数据解析处理
• Texture2DConverter.cs：纹理资源转换
• CubismMotion3Converter.cs：动作数据转换

5.2 API说明

本工具为独立可执行程序，不提供外部调用接口，所有功能通过命令行参数或拖放操作触发。

💡 提示：如需二次开发，可基于源码修改Program.cs中的入口逻辑实现自定义功能。