关于 assemble-scene
assemble-scene 是用于组织和放置 PlayCanvas 场景对象的开发技能,涵盖根节点与视觉层级、碰撞体尺寸、间距、生命周期清理及渲染后的放置检查。
主要功能
- 01以命名根节点组织每个对象
- 02使碰撞体贴合测量到的渲染边界
- 03依据校准后的占地范围安排间距
- 04将 UI 等场景元素置于模型层级之外
- 05渲染后检查支撑点和附着点
- 06移除根节点并注销其事件
适用场景
- 01组装含重复对象实例的场景
- 02设置碰撞体尺寸和对象间距
- 03检查对象是否悬空或穿透表面
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ playcanvas/ skills --skill assemble-scene安装后在 Claude Code 中输入/assemble-scene确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/direct-engine.mdreact.mdweb-components.md详细介绍
场景组装
每个场景对象都有一个命名根节点。将位置、朝向、rigidbody、collision 和脚本放在根节点上,并将经过校准的视觉模型放在其下方,使用 calibrate-model 完成校准。只需应用一次校准;如果缺少调校记录,请先进行校准。
- 按角色命名根节点,并为重复实例采用可预测的名称。
- 根据测量得到的边界确定碰撞体的尺寸,并使其与渲染边界对齐。
- 根据调校记录中的缩放后占地尺寸为根节点留出间距,而不是根据枢轴位置。非 90° 的偏航会旋转占地范围,因此应按更大的水平尺寸预留空间。
- 将 UI、特效、摄像机和灯光放在模型层级之外。
- 通过根节点所在表面的生命周期移除根节点,并注销其拥有的事件。
- 刚体需要先加载 Ammo(
build-app)。
检查放置情况
在完成一帧渲染后,使用安装点、射线投射或通过 inspect-runtime 读取的几何采样,在对象的实际位置测量每个支撑点或连接点。正间隙表示悬空;负间隙表示穿透。
如果无关根节点的世界 AABB 相交,则判定为失败,除非通过两个不同视图证明相交部分为空。
只阅读与代码相匹配的参考文档:direct Engine、 React 或 Web Components。
评论
支持 Markdown