Files

小煜 3bbb46bca7 feat: 添加VRM网格工具插件，支持网格分离和UV边融并功能

添加VRM网格工具插件，包含以下主要功能：
- Body网格分离：将非皮肤材质面分离为独立对象
- UV边融并：根据预定义UV数据将三角面转换为四边面
- 提供独立面板和操作符，与VRM官方插件兼容
- 包含材质处理顺序和自动转换逻辑
- 添加JSON数据文件和工具函数

2026-01-02 14:11:43 +08:00

3.8 KiB

Raw Permalink Blame History

VRM Mesh Tools

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

功能特性

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

系统要求

Blender 4.2.0 或更高版本

安装方法

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

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

方法二：手动安装

下载并解压插件文件
将 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/
重启 Blender
进入 Edit > Preferences > Add-ons，搜索 "VRM Mesh Tools" 并启用

使用方法

访问工具面板

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

Body Mesh Separator（分离非皮肤面）

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

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

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

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

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

与 VRM 官方插件的兼容性

本插件设计为可以与 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。或者私信bilibili用户ID：383687791

3.8 KiB Raw Permalink Blame History Unescape Escape