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で整数メートル単位でスナップできるようにします。
ワークフロー
- 最初にヘルパー関数:
box()、cyl()、assign(material)、finish()(トランスフォーム適用、角度によるスムージング、UV)。scripts/modular_kit.pyを参照してください。これは出発点となる小さな動作キットです。 - モジュールごとに1関数(
build_wall、build_floor、build_doorway)。バリエーション用のパラメータ(排水溝あり/なし、ハザードストライプ、窓など)。 - モジュールごとに1メッシュ、複数のマテリアルスロット。 パーツを結合してください。各モジュールは1オブジェクト、1テクスチャセットになります:ドローコールが減ります。
- ベイク プロシージャルマテリアル(ノイズ、汚れ、バンプ)を
BaseColor、Normal、MetalSmooth(R = メタリック、A = スムーズネス)、Emissionに。プロシージャルノードはFBXエクスポートで保持されません。ベイクしないと、Unityはフラットカラーしか認識しません。 - FBXをエクスポート Unityの軸設定で:
axis_forward='-Z', axis_up='Y', apply_scale_options='FBX_SCALE_ALL', use_tspace=True, mesh_smooth_type='FACE', path_mode='STRIP'。 - エクスポート後に検証ファイルを書き込む: モジュールごとに、トライアングル数、バウンド、マテリアル数。前回の実行結果と比較し、数値でリグレッションを検出します。
トライアングル予算(重要事項)
- 最適化する前に、トライアングルがどこに使われているかを数えてください。例:HOLD STILLでは、3つの天井タイルがシーン内の全トライアングルの38.6%を占めていました。これは、2m下から誰も見えない2mmのベベルが原因です。平面デシメーション(UVシームとマテリアルで区切られた、ほぼ同一平面の面を50度で溶解)により、見た目の変化なく大幅に削減できました。
references/budgets.mdを参照してください。 - 小さなベベルはクローズアップのヒーロー小道具専用で、繰り返し使用するモジュールには使わないでください。
- ソースキットを編集する代わりに、遠景や繰り返し使用するパーツ用に
_Liteコピーを作成してください。
Unityへの引き渡し
- インポート設定:コライダーはプレイヤーが触れるパーツにのみ生成し、残りはシンプルなボックスコライダーを使用します。
- ベイクしたテクスチャを、FBXの横に書き出された
materials.jsonを読み取る小さなエディタスクリプトで、モジュール名ごとにURP Litマテリアルにバインドします。 .blendファイルとスクリプトをバージョン管理に保持してください。FBXはビルド成果物です。