mcpField
A
assemble-scene

assemble-scene

github.com/playcanvas开发31312 次安装1 周前更新
代码仓库

关于 assemble-scene

assemble-scene 是用于组织和放置 PlayCanvas 场景对象的开发技能,涵盖根节点与视觉层级、碰撞体尺寸、间距、生命周期清理及渲染后的放置检查。

主要功能

  1. 01以命名根节点组织每个对象
  2. 02使碰撞体贴合测量到的渲染边界
  3. 03依据校准后的占地范围安排间距
  4. 04将 UI 等场景元素置于模型层级之外
  5. 05渲染后检查支撑点和附着点
  6. 06移除根节点并注销其事件

适用场景

  1. 01组装含重复对象实例的场景
  2. 02设置碰撞体尺寸和对象间距
  3. 03检查对象是否悬空或穿透表面

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/playcanvas/skills --skill assemble-scene

安装后在 Claude Code 中输入/assemble-scene确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
direct-engine.md
react.md
web-components.md

详细介绍

场景组装

每个场景对象都有一个命名根节点。将位置、朝向、rigidbody、collision 和脚本放在根节点上,并将经过校准的视觉模型放在其下方,使用 calibrate-model 完成校准。只需应用一次校准;如果缺少调校记录,请先进行校准。

  • 按角色命名根节点,并为重复实例采用可预测的名称。
  • 根据测量得到的边界确定碰撞体的尺寸,并使其与渲染边界对齐。
  • 根据调校记录中的缩放后占地尺寸为根节点留出间距,而不是根据枢轴位置。非 90° 的偏航会旋转占地范围,因此应按更大的水平尺寸预留空间。
  • 将 UI、特效、摄像机和灯光放在模型层级之外。
  • 通过根节点所在表面的生命周期移除根节点,并注销其拥有的事件。
  • 刚体需要先加载 Ammo(build-app)。

检查放置情况

在完成一帧渲染后,使用安装点、射线投射或通过 inspect-runtime 读取的几何采样,在对象的实际位置测量每个支撑点或连接点。正间隙表示悬空;负间隙表示穿透。 如果无关根节点的世界 AABB 相交,则判定为失败,除非通过两个不同视图证明相交部分为空。

只阅读与代码相匹配的参考文档:direct Engine、 React 或 Web Components。

评论

支持 Markdown