# VRM Mesh Tools

独立的 Blender 网格工具插件，提供 VRM 模型的网格分离和 UV 边融并功能。

## 功能特性

- **Body Mesh Separator（模型分离）**: 将 Body 网格中非皮肤材质（CLOTH 等）的面分离为独立对象
- **UV Edge Merger（四边面转换）**: 根据 UV 坐标将三角面转换为四边面

## 系统要求

- Blender 4.2.0 或更高版本

## 安装方法

### 方法一：通过扩展管理器安装（推荐）

1. 下载插件的 zip 文件
2. 打开 Blender，进入 `Edit > Preferences > Get Extensions`
3. 点击右上角的下拉菜单，选择 `Install from Disk...`
4. 选择下载的 zip 文件
5. 安装完成后，插件会自动启用

### 方法二：手动安装

1. 下载并解压插件文件
2. 将 `vrm_mesh_tools` 文件夹复制到 Blender 的扩展目录：
   - Windows: `%APPDATA%\Blender Foundation\Blender\4.2\extensions\user_default\`
   - macOS: `~/Library/Application Support/Blender/4.2/extensions/user_default/`
   - Linux: `~/.config/blender/4.2/extensions/user_default/`
3. 重启 Blender
4. 进入 `Edit > Preferences > Add-ons`，搜索 "VRM Mesh Tools" 并启用

## 使用方法

### 访问工具面板

1. 在 3D 视图中，按 `N` 键打开侧边栏
2. 找到 "VRM Tools" 标签页
3. 选中包含 Body 网格的 Armature 对象（或其子网格对象）

### Body Mesh Separator（分离非皮肤面）

此功能将 Body 网格中的非皮肤材质面（如 CLOTH）分离为独立对象。

1. 选中 VRM 模型的 Armature
2. 在 "VRM Tools" 面板中查看材质列表
   - `[保留]` 标记的材质（SKIN、HAIR）将保留在原网格中
   - `[分离]` 标记的材质（CLOTH 等）将被分离
3. 点击 "分离非皮肤面" 按钮
4. 分离后的面将创建为名为 "Body_Separated" 的新对象

### UV Edge Merger（根据 UV 转四边面）

此功能根据预定义的 UV 坐标数据，将三角面转换为四边面。

1. 确保模型同时包含 Body 和 Face 网格
2. 选中 VRM 模型的 Armature
3. 点击 "根据UV转四边面" 按钮
4. 插件将自动处理所有支持的材质

## 与 VRM 官方插件的兼容性

本插件设计为可以与 [VRM-Addon-for-Blender](https://github.com/saturday06/VRM-Addon-for-Blender)（VRM 官方插件）同时安装和使用。

### 命名空间隔离

为确保兼容性，本插件使用完全独立的命名空间：

| 组件 | VRM 官方插件 | VRM Mesh Tools |
|------|-------------|----------------|
| 插件 ID | `vrm` | `vrm_mesh_tools` |
| 操作符前缀 | `vrm.` | `vrm_tools.` |
| 面板前缀 | `VRM_PT_` | `VRM_TOOLS_PT_` |
| 侧边栏分类 | `VRM` | `VRM Tools` |

### 注意事项

- 两个插件可以同时启用，不会产生冲突
- 本插件不依赖 VRM 官方插件的任何模块
- 如果同时安装了两个插件，它们会在侧边栏显示为不同的标签页

## 支持的材质

插件内置了以下 VRoid 模型材质的 UV 边数据：

- `N00_000_00_Body_00_SKIN (Instance)` - Body 皮肤
- `N00_000_00_Face_00_SKIN (Instance)` - Face 皮肤
- `N00_000_00_FaceMouth_00_FACE (Instance)` - 嘴部
- `N00_000_00_FaceEyeline_00_FACE (Instance)` - 眼线
- `N00_000_00_FaceEyelash_00_FACE (Instance)` - 睫毛
- `N00_000_00_hH_00_FACE (Instance)` - 面部细节
- `N00_000_00_EyeIris_00_EYE (Instance)` - 虹膜
- `N00_000_00_EyeWhite_00_EYE (Instance)` - 眼白
- `N00_000_00_EyeHighlight_00_EYE (Instance)` - 眼部高光
- `N00_000_00_HairBack_00_HAIR (Instance)` - 后发

## 错误处理

- 如果未找到 Body 网格，面板将显示错误提示
- 如果未找到 Face 网格，"根据UV转四边面" 按钮将被禁用
- 如果某个材质的 JSON 数据文件缺失，该材质将被跳过并显示警告

## 许可证

MIT License

## 问题反馈

如果您遇到任何问题或有功能建议，请在项目仓库中提交 Issue。