Community画像github.com

Blenderゲームキット(コードからモデル生成)

Blender上でPythonスクリプトを使い、ゲーム用の即戦力3Dモデルを構築。モジュラーレベルキット(壁、床、ドア、階段、足場、天井)、小物、シンプルなキャラクターを作成し、プロシージャルマテリアルをテクスチャにベイク、低ポリゴンLODコピーを生成し、そのままUnityなどのエンジンに取り込めるFBXを出力します。ユーザーがBlenderで3Dモデルやレベルを欲しいとき、「Blender MCP」「モジュラーキットを作って」「部屋/ダンジョン/家/廊下/小道具をモデリング」「Unityにエクスポート」「三角ポリゴンが多すぎる」と言ったとき、あるいは手作業モデリングではなくコードで再生成可能なアートを求めるときに使います。

Blenderゲームキット(コードからモデル生成) とは?

Blenderゲームキットは、Blender内でPythonスクリプトを実行してゲーム用の3Dモデルを体系的に構築するスキルです。ダンジョン、家、宇宙ステーション、都市ブロックなど、グリッドベースのモジュールと小物からなる世界全体をコードで生成できるため、変更はスクリプトの編集と再実行だけで済み、何時間もの手作業による再モデリングを不要にします。このスキルは、Blender MCPアドオンを使ったライブBlender操作(ビューポートでの確認やPoly Haven/Sketchfabアセットの検索・インポート)と、ヘッドレスモード(`blender -b --factory-startup -P build_kit.py`)での確定的なエクスポートの両方をサポートしており、UnityなどへのFBX出力時にプロシージャルマテリアルをテクスチャにベイクし、トライアングル予算管理やLODコピー作成も行います。ワークフローは、ヘルパー関数を使ったモジュール構築、1メッシュ・複数マテリアルスロットの原則、ベイク処理、Unity軸に合わせたFBXエクスポート、検証ファイルの生成で構成され、コードから再生成可能なアートを実現します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Maimuzamilhu/claude-code-gamedev-pipeline/tree/HEAD/skills/blender-game-kit

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

ドキュメント

Blenderゲームキット(コードからモデル生成) は何をしますか?

Blenderで実行するPythonスクリプトからゲームの世界を構築します。ダンジョン、家、宇宙ステーション、都市ブロック——すべてはグリッド上のモジュールと小物です。変更は編集と再実行だけで、何時間もの再モデリングは不要です。

例(HOLD STILL): 2階建て工場全体(壁、床、ドア、階段、実験室家具、ロボット、がれき)は、約20個のBlenderスクリプトから生成されました。

エージェントによるBlenderの実行方法

  • ライブBlender(Blender MCPアドオン): ユーザーの開いているBlender内でPythonを実行し、ビューポートを確認、Poly Haven / Sketchfabアセットを検索・インポートします。見た目の確認や探索に最適です。
  • ヘッドレス(実際のエクスポート用): blender -b --factory-startup -P build_kit.py。実行ごとに同じ結果が得られ、UI状態の混入がありません。ゲームに出荷するものにはこちらを使ってください。

シェーダーノードの検索はタイプで行ってください(名前は他のUI言語で翻訳される可能性があります): next(n for n in mat.node_tree.nodes if n.type == "BSDF_PRINCIPLED")。

グリッドが設計の基本

最初にモジュールサイズを決め、それを絶対に変更しないでください。キャラクターに合わせます:ドアはプレイヤーカプセルより少し広く高く、階段の段差はキャラクターのステップ高より低くします。人間サイズのキャラクターに適した初期値(HOLD STILLの数値):

パーツサイズ
壁モジュール幅4.0m、厚さ0.12m
床から天井まで3.2m
床タイル2.0m
ドア開口部1.1m x 2.2m
階段段差0.18m(キャラクターのステップ高未満に保つ)

ピボットはモジュールの床面中心に設定し、Unityで整数メートル単位でスナップできるようにします。

ワークフロー

  1. 最初にヘルパー関数: box()、cyl()、assign(material)、finish()(トランスフォーム適用、角度によるスムージング、UV)。scripts/modular_kit.py を参照してください。これは出発点となる小さな動作キットです。
  2. モジュールごとに1関数(build_wall、build_floor、build_doorway)。バリエーション用のパラメータ(排水溝あり/なし、ハザードストライプ、窓など)。
  3. モジュールごとに1メッシュ、複数のマテリアルスロット。 パーツを結合してください。各モジュールは1オブジェクト、1テクスチャセットになります:ドローコールが減ります。
  4. ベイク プロシージャルマテリアル(ノイズ、汚れ、バンプ)を BaseColor、Normal、MetalSmooth(R = メタリック、A = スムーズネス)、Emission に。プロシージャルノードはFBXエクスポートで保持されません。ベイクしないと、Unityはフラットカラーしか認識しません。
  5. FBXをエクスポート Unityの軸設定で: axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'。
  6. エクスポート後に検証ファイルを書き込む: モジュールごとに、トライアングル数、バウンド、マテリアル数。前回の実行結果と比較し、数値でリグレッションを検出します。

トライアングル予算(重要事項)

  • 最適化する前に、トライアングルがどこに使われているかを数えてください。例:HOLD STILLでは、3つの天井タイルがシーン内の全トライアングルの38.6%を占めていました。これは、2m下から誰も見えない2mmのベベルが原因です。平面デシメーション(UVシームとマテリアルで区切られた、ほぼ同一平面の面を50度で溶解)により、見た目の変化なく大幅に削減できました。references/budgets.md を参照してください。
  • 小さなベベルはクローズアップのヒーロー小道具専用で、繰り返し使用するモジュールには使わないでください。
  • ソースキットを編集する代わりに、遠景や繰り返し使用するパーツ用に _Lite コピーを作成してください。

Unityへの引き渡し

  • インポート設定:コライダーはプレイヤーが触れるパーツにのみ生成し、残りはシンプルなボックスコライダーを使用します。
  • ベイクしたテクスチャを、FBXの横に書き出された materials.json を読み取る小さなエディタスクリプトで、モジュール名ごとにURP Litマテリアルにバインドします。
  • .blend ファイルとスクリプトをバージョン管理に保持してください。FBXはビルド成果物です。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル