Unity 2022.3 编辑器工具,用于删除、重命名、新建空形态键、混合形态键及调整形态键上限。 入口:LGC > 形态键编辑器。无需 VRCFury、Modular Avatar 或 VRChat SDK。
合集地址:https://lgcchina.github.io/LGC-VRC-Packages/index.json。
在 VCC / ALCOM 添加该合集,然后为项目安装 LGC 形态键编辑器(com.lgcchina.blend-shape-editor)。Unity 编译后,从 LGC > 形态键编辑器 打开。
需要 Unity 2022.3;不依赖 VRChat SDK、VRCFury 或 Modular Avatar。自动组合窗口已在 Unity 2022.3.22f1 验证。 包源码与版本发布:https://github.com/LgcChina/BlendShapeEditor。
从 Assets 手动版迁移时,VPM 迁移配置仅替换原工具的 Editor 子目录,保留 Meshes 等生成文件与其他目录。若之前复制过其他脚本副本,请移除重复代码后等待 Unity 编译。生成网格继续保存到 Assets 下,不写入包目录。
.meta,等待 Unity 编译;请勿同时保留两份工具脚本。默认 100,范围 −1000~1000。界面直接输入熟悉的 Unity 权重数值,内部按“输入值 ÷ 100”缩放形态键数据。
面板说明:形态键上限 100 为基准:例如填 62,生成后拉到 100 就是到 62 的效果;填 180 就是突破上限到 180 的效果。范围 −1000~1000,负数将反向执行顶点。
| 形态键上限 | 生成后拉到 100 的效果(单帧线性形态键) |
|---|---|
| 62 | 相当于修改前拉到 62 |
| 100 | 保持原效果 |
| 180 | 相当于修改前拉到 180 |
| 0 | 不产生变形 |
| −100 | 原效果反向 |
| 1000 | 原效果的 10 倍 |
例如原眨眼拉到 62 就是想要的闭合程度,将形态键上限填为 62,应用后常用权重仍是 0~100。 批量上限是直接设置所选项,不是在当前草稿上再次相乘;预览滑条和混合权重仍使用各自的 0~100 范围。 再次应用以最新网格为基准,修改会叠加:连续两次应用 180,最终为最初的 3.24 倍。
这是缩放网格变形数据,不是运行时参数钳制。其他脚本仍可传入超过 100 的权重。 多帧形态键保留各帧权重并统一缩放帧位移;如果原多帧变化不是线性的,结果不等于重新采样原曲线在该输入权重处的形状。 负值反转相对基础形状的位移,不保证自然的反向效果,请检查穿模和光照。
点击主工具中的 预览模型2,模型2会自动停靠在主工具右侧,组成同一 Unity 窗口中的左右分栏。首次组合主工具约占 2/3、模型2约占 1/3,实际比例受各面板最小宽度限制;可以拖动中间分隔线调整。
预览使用临时 Mesh,不保存资产。锁定预览、修改形态定义、切换目标、保存场景、进入运行、重编译或关闭窗口时,恢复预览前的网格、权重和包围盒。 预览权重与人物原有权重独立;修改形态定义后会锁定滑条,需要重新点击“解锁预览”。首次加载大网格可能短暂等待,后续拖动只更新权重。测试时请避免 Animator 或其他预览争用权重。
输出默认保存到工具的 Meshes 子目录,首次生成前,点击“选择文件夹”打开系统文件夹选择窗口,可选择当前项目 Assets 或其子目录,路径自动转换为 Unity 资源路径;选择项目外目录时保留原路径并在面板提示。首次生成后,本次目标的输出文件和目录固定,选择按钮禁用;若要另存其他目录,请结束本次目标会话后重新选择。点击“定位输出文件夹”在 Unity Project 窗口选中并高亮目录;默认目录尚未创建时会提示,应用保存后再定位。生成 Mesh 内部名称与文件名一致,采用本次拖入时的原网格名称加本机日期和时间,例如 Body_261110_214830.asset。首次生成同秒重名时自动追加序号,不覆盖源 FBX、源 Mesh 或之前会话的文件;后续应用仅覆盖本次创建的输出。
应用时按源索引迁移保留项原权重,新形态键默认为零。网格替换和本次输出的内容覆盖支持 Ctrl+Z / Ctrl+Y,记录 Prefab 覆盖并标记场景修改;Undo 不删除输出资产。恢复原始网格后继续应用仍更新本次输出;切换目标、清空目标或关闭窗口结束该输出会话,下一次创建新文件。若本次输出被手动删除,恢复有效网格后再应用会重新创建输出。
“恢复到原始网格-未修改”按钮下方提供 稀疏生成 复选框,默认不勾选。
恢复到原始网格-未修改:恢复本窗口本次拖入目标时记录的 Mesh、原权重和包围盒,支持 Undo。首次点击变红,提示“此操作不会删除已生成的文件”,5 秒内再次点击才恢复,超时自动取消;继续编辑或切换其他操作会取消确认。
当前编辑网格或生成文件被误删后,工具禁用依赖当前网格的编辑和保存,仍保留原始网格恢复入口。恢复优先使用拖入时的原始资源;如果该资源也被删除,则将独立的初始快照按当前输出目录另存为新 Mesh,再恢复到场景目标,不会在原文件路径重建或删除其他已生成文件。快照来自拖入时的网格,不包含之后的编辑。
关闭窗口先退出预览、恢复预览前网格,然后清空目标、原始与当前网格引用、原权重、编辑草稿和临时快照。重新打开时目标为空,需要重新拖入。已生成文件和已应用的网格保持不变。
独立快照仅用于本次窗口会话,切换目标或关闭窗口会释放,不是永久备份;请保留原资产或场景备份。工具不会自动寻找原始 FBX,选入时已经修改过的网格仍会成为这次恢复基准。重新读取当前网格和 Undo / Redo 不会重设拖入时的恢复基准。
恢复默认参数:只清除尚未应用的草稿,恢复当前编辑源网格的形态键列表;恢复批量上限为 100、新名称为 NewShape。已保存的网格和输出路径保留。第一次点击按钮变红,5 秒内再次点击才执行;超时自动恢复普通按钮,继续编辑、切换目标或切换预览也会取消确认,无弹窗。
FBX 备用恢复:当前网格或初始快照丢失时,在右侧“FBX 备用恢复”区域使用。
从主工具“预览”区域点击 预览模型2,打开普通 Unity 编辑器窗口,支持停靠或独立摆放;拖入另一个普通场景实例的 SkinnedMeshRenderer。
#if UNITY_EDITOR 隔离,不安装运行脚本;运行模式禁用编辑。版本 1.6.1。脚本注释、窗口、README 与 CHANGELOG 同步;运行资源名称保持稳定。
com.lgcchina.blend-shape-editor
https://github.com/LgcChina/BlendShapeEditor#readme
1.6.1 (変更履歴)
2022.3 以降
なし
なし
なし