Game Asset Vrm Wardrobe

---
name: game-asset-vrm-wardrobe
description: 给 VRM 角色制作普通服装并传递蒙皮，处理松量、衣下隐藏面、裙摆链和导出验证，适用于穿衣角色的离线渲染与引擎准备。
---

# VRM 服装与二次运动

先确定服装款式、换装需求、身体是否允许删面、目标引擎和离线/运行时物理。优先使用 VRoid/XWear 或已授权衣服，Blender 原生权重转移、布料与引擎 SpringBone；程序服装仅作快速款式及技术原型。

## 执行

1. 从实际身体截面确定衣服范围和松量，保留肩顶与关节弯曲余量。贴皮法线外推不是垂坠衣服；需要垂坠时用截面凸包/自上而下外包轮廓，腰带与裙腰共用实际连接面。
2. 服装继承/转移身体权重后，检查和为 1、关节局部变形和不受影响区域。UV 缝导致的重复顶点不能产生裂开的几何边，焊接时保留正确 UV。
3. 删衣下皮肤必须证明被衣服覆盖并远离开口；裙下会露出的腿、可换装后会露出的面不能一并删除。先保留完整身体副本。
4. 裙腰固定，裙摆沿环分骨链；髋部附近权重可混入大腿跟随。碰撞检查覆盖链节点及段中点，链太稀会从链间穿出。不要把“链越多越好”当普遍规则，先量目标动作与性能。
5. 导出 VRM 时核对 springs、joints、碰撞组、半径、偏移单位和骨骼存在。离线烘焙模拟、VRM SpringBone 描述及引擎实现分别验证；不能因导出 JSON 正确就宣布实时物理可用。
6. 材质若带纹理，图元必须有对应 UV。纯色材质不应遗留复制来的法线/自发光贴图。导出前移除源动捕骨架并明确静止姿势/动画的交付方式。

## 附带入口

进入 `assets/workspace/`：

```sh
blender -b --python scripts/vrm-dress.py -- work/rest --vrm model.vrm --no-render
blender -b work/rest/dressed.blend --python scripts/vrm-export.py -- work/character.vrm
```

`vrm-dress.py` 提供历史原型的款式、松量、链数和颜色参数。它针对 VRoid 兼容骨架与材质，不是任意拓扑的一键换装服务。新角色先用静态四视图，再接动作。

## 验收

用同一动作、同一碰撞代理比较刚性/模拟，不混用改了松量与裙宽的不同版本；输出逐帧穿入比例、最深接触与可见画面。历史“12 链后为 0”只对单段 105 帧及当时代理指标成立，不保证所有布面无碰撞。

完整检查蹲、转身、走跑、急停、手臂抬起及衣服开口。VRM 导出后的运行时 SpringBone、极限姿势腋下穿模和正式引擎交付在源项目尚未完成，不作为本技能已有验收结果。

资源获取见 [sources.md](references/sources.md)，附带代码及适配边界见 [implementation.md](references/implementation.md)。