用途
Skeleton 技能面向 Unreal Engine 中的骨骼(Skeleton,SK_ 资产)与骨骼网格(Skeletal Mesh,SKM_ 资产)编辑,重点补充引擎原生工具未覆盖的部分,包括骨骼变换与层级编辑、重定向模式配置、曲线元数据、混合配置(Blend Profile)、骨骼约束,以及从动画中学习约束。插槽增删改查、骨骼枚举、物理资产指定、材质/LOD/变形目标查看等操作由引擎工具集 editor_toolset.toolsets.skeletal_mesh.SkeletalMeshTools 负责,通过 call_tool 调用。
主要能力
- 骨骼编辑:使用 unreal.SkeletonService.add_bone / remove_bone / rename_bone 等方法增删改骨骼,并支持设置骨骼变换。
- 重定向模式:通过 set_bone_retargeting_mode 为骨骼设置 Animation、Skeleton、AnimationScaled、OrientAndScale 四种模式之一,并可用 add_compatible_skeleton 添加兼容骨架以共享动画。
- 曲线元数据:通过 add_curve_metadata、set_curve_morph_target、set_curve_material 管理变形目标曲线与材质参数曲线。
- 混合配置:通过 create_blend_profile 与 set_blend_profile_bone 按骨骼设置混合权重。
- 骨骼约束:支持 set_bone_constraints 手动设置约束,也可用 learn_from_animations 从动画样本中学习约束,并用 validate_bone_rotation 校验旋转是否越界。
- 骨架信息:get_skeleton_info 返回骨骼数、兼容骨架数、曲线元数据数、混合配置数等信息;create_skeleton_profile 返回包含层级、变换、深度与重定向模式的 BoneNodeInfo 列表。
使用方式
通过 execute_python_code 调用 unreal.SkeletonService 下的方法执行 VibeUE 服务;引擎工具通过 call_tool 调用,并可用 list_toolsets / describe_toolset 查看具体 schema。注意资产路径区分:骨架操作(重定向、曲线、混合配置、约束)使用 SK_ 资产,骨骼网格的骨骼变换/层级编辑也使用 SKM_ 资产但走 SkeletonService。骨骼修改采用事务机制,增删改或重设父级后必须调用 commit_bone_changes 才会生效;修改完成后需调用 save_asset 保存,否则关闭编辑器后丢失。
适用场景
为角色添加扭转骨骼以改善蒙皮;为武器配置插槽(引擎工具完成);为动画共享配置重定向模式与兼容骨架;创建上身混合配置;设置面部表情与材质参数曲线;为动画编辑提供约束校验。
限制与注意事项
- 不要通过 SkeletonModifier 重设骨骼父级:资料指出在 UE 5.7 中该操作已知会失败,并在 commit_bone_changes 时触发层级不匹配校验错误,甚至可能导致提交卡住。需要调整层级时,应在目标父骨骼下新增骨骼并删除旧骨骼。
- 引擎的 add_socket 始终把插槽加到骨骼网格上,已不存在 bAddToSkeleton 标志;若要让多个网格共享插槽,需在每个网格上分别添加,或直接通过 unreal.* 在骨架上添加。
- 已移除 unreal.SkeletonService.add_socket,插槽操作改用引擎 SkeletalMeshTools。
- 若会话中存在 unreal-engine-skills-manager 外部 MCP 工具,可按资料建议加载 animation-system 领域知识;不存在时跳过,不影响本技能使用。
- 关于收费、价格与具体平台支持范围,资料未提供。