3bbb46bca75125a95f2510f340595236370cde47
添加VRM网格工具插件,包含以下主要功能: - Body网格分离:将非皮肤材质面分离为独立对象 - UV边融并:根据预定义UV数据将三角面转换为四边面 - 提供独立面板和操作符,与VRM官方插件兼容 - 包含材质处理顺序和自动转换逻辑 - 添加JSON数据文件和工具函数
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/
- Windows:
- 重启 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
Description
VRM Mesh Tools v1.0.0
Latest
Languages
Python
100%