Communitygithub.com

3Dゲームアセット

プリミティブなジオメトリだけでなく、具体的で認識可能なGLBアセットを3Dゲームに生成・統合するためのスキルです。

3Dゲームアセット とは?

このスキルは、3Dゲーム開発において、プレイヤーキャラクター、敵、収集アイテム、乗り物、武器などの具体的な3Dモデル(GLB形式)を生成・統合するためのエンドツーエンドのワークフローを提供します。Tripo3Dへのテキストプロンプトによる高速ルート(`tripo`)と、Geminiで参照画像を生成してからモデル化する高品質ルート(`gemini_reference`)を使い分け、状況に応じて最適な方法を選択します。生成されたアセットは`asset_manifest.json`で管理され、Three.jsの`GLTFLoader`を使用してゲームコードに配線され、GLB読み込み失敗時のプリミティブなフォールバックも自動的に用意します。Claude Code, Cursor, CodexなどのAIエージェント環境で、MCPツールが利用可能な場合はそれを優先し、なければバンドルされたスクリプト経由で同じ操作を実行します。

対応~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add 674345386/agent-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

3Dゲームアセット は何をしますか?

3Dゲームがプリミティブなジオメトリだけでなく、具体的で認識可能なGLBアセットを必要とする場合にこのスキルを使用します。このスキルは、ルートの選択、小さな焦点を絞ったアセットセットの生成、asset_manifest.jsonの書き込み/読み取り、フォールバックを備えたゲームへのGLBの配線まで、エンドツーエンドのワークフローを担当します。

必須動作

  • ゲームプロンプトに、プレイヤー、キャラクター、敵、収集アイテム、乗り物、武器、障害物、ボス、マスコット、キープロップ、環境オブジェクトなどの明示的または暗黙的なエンティティが含まれている場合、ツールが利用可能であればGLB生成は必須の段階です。
  • デフォルトでは1〜3個のキーアセットのみを生成します。プレイヤー/メインキャラクターを最優先し、次にゲームプレイ上重要な敵、収集アイテム、乗り物、危険物、キープロップを優先します。装飾的なフィラーは生成しません。
  • プリミティブなThree.jsジオメトリは、アセットが保留中の間の一時的なプレースホルダー、およびGLBの読み込みに失敗した場合のランタイムフォールバックとしてのみ使用します。
  • ユーザーが明示的に要求しない限り、既存のアセットを再生成してはいけません。asset_manifest.jsonに読み込み可能なアセットがすでにある場合は、それを再利用します。
  • 著作権で保護されたキャラクター、ブランド名、ロゴ、有名人の肖像は避けてください。オリジナルのデザインに書き換えてください。

ルート選択

高速ルートにはtripoを使用します:テキストプロンプトからTripo3Dテキスト-to-モデルへの直接変換。これは、汎用のプロップ、敵、収集アイテム、乗り物、障害物、および高速な反復に最適です。

視覚的なコントロールが重要な場合はgemini_referenceを使用します:Geminiがまず純白の背景の参照画像を作成し、その後Tripo画像-to-モデルがGLBを作成します。ユーザーがGemini、Nano Banana、Tポーズ、白背景、参照画像、画像-to-モデル、キャラクターシート、スタイルの一貫性について言及した場合、または主要キャラクターのシルエットを制御する必要がある場合に、このルートを優先します。

サーバーにプロンプトからの選択を任せても問題ない場合のみautoを使用します。迷った場合は、自分でルートを選択して明示的に渡してください。

環境

生成クライアントはこのスキルにバンドルされており、scripts/game-assets-mcp.mjs(Node >= 20、依存関係なし)にあります。これはデフォルトのリモートアセットAPI http://54.81.110.182:3001 と通信します。

  • GAME_ASSETS_API_URL — アセットAPIベースURLのオプションのオーバーライド
  • GAME_ASSETS_API_TOKEN — ユーザーごとのアクセストークン

トークンがなく、サービスが認証を必要とする場合、生成前にユーザーにGAME_ASSETS_API_TOKENを設定するよう依頼してください。GAME_ASSETS_API_URLについては、ユーザーがデフォルトサービスをオーバーライドする必要がある場合にのみ依頼してください。TripoまたはGeminiのAPIキーを決して尋ねないでください。それらはサーバー上にあります。

ツールワークフロー

mcp__game_assets__*という名前のMCPツールがセッションで利用可能な場合は、それらを優先してください。それ以外の場合は、Bashを介してバンドルされたクライアントを実行します。どちらも同じ2つの操作を公開します。

  1. 現在のワークスペースパスをまだ知らない場合は、pwdを実行します。
  2. 3つ以上のアセットを計画している場合、またはこれがスレッド内で最初のアセット生成である場合は、準備状況を確認します(<skill-dir>はこのスキルのディレクトリです):
node <skill-dir>/scripts/game-assets-mcp.mjs readiness --cwd "$(pwd)"
  1. 1〜3個のアセットを生成します(バッチ最大4)。パラメータを1つのJSONオブジェクトとして渡します:
node <skill-dir>/scripts/game-assets-mcp.mjs generate --cwd "$(pwd)" --params '{
  "gamePrompt": "...",
  "route": "tripo",
  "assets": [{ "id": "...", "role": "player", "name": "...", "prompt": "..." }]
}'
  • route: tripo、gemini_reference、またはauto。
  • assets: 1〜3個のオブジェクト。安定したケバブケースのid、role、name、prompt、およびオプションでassetKindを含みます。
  • force: ユーザーが明示的にアセットの再生成を要求した場合のみ。
  • このコマンドはリモートジョブをポーリングしながらブロックし(通常バッチあたり1〜3分)、JSON結果を出力します。終了コード1はバッチの失敗を意味します。
  1. コマンドが戻った後、cwdからasset_manifest.jsonを読み取ります。そのファイルを信頼できる情報源として扱います。
  2. manifest.assetsをThree.jsのGLTFLoaderを使用してゲームコードに配線します。
  3. 生成されたすべてのアセットに対してローカルのプリミティブフォールバックを保持します。GLBの読み込みに失敗してもゲームはプレイ可能でなければなりません。

--params JSONの例:

{
  "cwd": "/absolute/path/to/project",
  "gamePrompt": "3Dランナー、宇宙飛行士の猫がクリスタルを集めてパトロールロボットを避けるゲーム",
  "route": "gemini_reference",
  "assets": [
    {
      "id": "astronaut-cat",
      "role": "player",
      "name": "宇宙飛行士の猫",
      "assetKind": "character",
      "prompt": "オリジナルのローポリ宇宙飛行士の猫のヒーロー、丸いヘルメット、コンパクトで読みやすいシルエット、青と白のスーツ、フレンドリーなアーケードゲームキャラクター"
    },
    {
      "id": "energy-crystal",
      "role": "collectible",
      "name": "エネルギークリスタル",
      "assetKind": "prop",
      "prompt": "明るいシアンのファセットカットエネルギークリスタルピックアップ、クリーンなシルエット、ゲーム収集アイテム"
    }
  ]
}

ランタイム統合ルール

  • 読み込まれたすべてのGLBをTHREE.Box3().setFromObject()で正規化します:ターゲットサイズにスケーリング、水平方向に中央揃え、底部をy = 0に配置し、安定した向きのオフセットを適用します。
  • ビジュアルとゲームプレイのヒットボックスを分離します。衝突判定には、生のモデル境界やメッシュ原点ではなく、安定したゲームプレイ寸法を使用します。
  • manifest.assetsにrigged、rigType、またはanimationsが含まれている場合、ネイティブアニメーションが存在すると主張する前に、読み込まれたgltf.animationsを検査します。
  • ネイティブクリップが存在する場合は、THREE.AnimationMixerを作成し、idle、walk、run、jumpなどの大文字小文字を区別しないサブ文字列でクリップをマッピングし、毎フレームmixer.update(delta)を呼び出します。
  • ネイティブクリップが存在しない場合は、グループ全体のボブ/ティルト/ローテーション、または明示的にラベル付けされた手続き型クリップをフォールバックアニメーションとして使用します。
  • どのアセットが生成されたか、どのルートが使用されたか、ランタイムアニメーションソースが何かを説明する、3D Asset Pipelineまたは3D 素材流水線という名前の短いREADME.mdセクションを追加します。

障害処理

  • アセットAPIに到達不能(readinessがunreachableを報告):リモートモデル生成が利用できないことを説明し、ユーザーにデフォルトのアセットサービス、ネットワークアクセス、および必要な場合はGAME_ASSETS_API_TOKENを確認するよう依頼します。GAME_ASSETS_API_URLについては、デフォルトサービスをオーバーライドする場合にのみ依頼します。プリミティブフォールバックを維持し、プレイ可能なゲームを継続します。
  • gemini_referenceルートでサーバーにGeminiキーがない場合:許容可能であればtripoに切り替えるか、サーバーオペレーターがGeminiキーを設定する必要があることをユーザーに伝えます。
  • Tripo残高がゼロの場合:ループで再試行しないでください。フォールバックを維持し、スキップされた段階をREADMEに記録します。
  • 部分的な成功:成功した生成アセットを使用し、残りはフォールバックジオメトリを使用します。

関連スキル