mcpField
A
assemble-scene

assemble-scene

github.com/playcanvas開発31312 回インストール1 週間前に更新
リポジトリ

assemble-scene について

assemble-sceneは、PlayCanvasシーン内のオブジェクトを構成・配置する開発スキルです。ルートとビジュアルの階層、コライダーの寸法、間隔、ライフサイクルの後処理、描画後の配置確認を扱います。

主な機能

  1. 01名前付きルートを基点にオブジェクトを構成
  2. 02測定した描画境界にコライダーを合わせる
  3. 03校正済みの占有範囲に基づく間隔設定
  4. 04UIなどをモデル階層の外に配置
  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

詳細

シーンの組み立て

各シーンオブジェクトには、名前付きのルートが 1 つあります。位置、向き、rigidbody、collision、スクリプトはルートに設定し、その下に calibrate-model で調整したビジュアルを配置します。調整は一度だけ適用してください。調整記録が見つからない場合は、先に調整してください。

  • ルートには役割に応じた名前を付け、繰り返し配置するインスタンスには一貫性のある名前を付けます。
  • コライダーは計測した境界に合わせてサイズを決め、レンダリング境界と位置を揃えます。
  • ルート間の間隔は、ピボット位置ではなく、調整記録にあるスケーリング後の占有範囲を基準にします。90°以外のヨー回転では占有範囲が回転するため、より大きい水平方向の範囲を確保します。
  • UI、エフェクト、カメラ、ライトはモデル階層の外に配置します。
  • ルートを削除する際は、そのサーフェスのライフサイクルを通じて削除し、所有するイベントの登録を解除します。
  • 剛体を使用する場合は、先に Ammo を読み込む必要があります(build-app)。

配置を確認する

レンダリングされたフレームの後、inspect-runtime を通じて読み取ったマウントポイント、レイキャスト、またはジオメトリサンプルを使い、オブジェクトの実際の位置で各支持点や接続点を計測します。隙間が正の値なら浮いており、負の値ならめり込んでいます。無関係なルート間でワールド AABB が重なる場合は、異なる 2 つの視点から重なりが空間であることを確認できない限り、不合格です。

コードに合ったリファレンスだけを参照してください:direct Engine、React、または Web Components。

コメント