パフォーマンス (4.7)
まず計測せよ。 決して盲目的に最適化してはいけません。1フレームあたり16.6ms (60 FPS) または8.3ms (120 FPS) の予算が、スクリプト、物理、CPUおよびGPUでのレンダリングをカバーします。
ツール
- エディタデバッガ: プロファイラ (スクリプト関数; 起動し、再生し、セルフタイムで並び替え), ビジュアルプロファイラ (レンダーパスごとのCPU vs GPU), モニター (FPS, プロセス/物理時間, オブジェクト, ノード, オーファンノード, ドローコール, ビデオメモリ), ネットワークプロファイラ, ObjectDBスナップショット (4.6+ : 2つのスナップショットを比較してリークを検出).
- コード:
Performance.get_monitor(Performance.TIME_PROCESS),RENDER_TOTAL_DRAW_CALLS_IN_FRAME,OBJECT_NODE_COUNT,OBJECT_ORPHAN_NODE_COUNT.Performance.add_custom_monitor(&"game/enemies", callable)で独自のモニターを追加できます。 - ネイティブプロファイラ (4.6+): Tracy, Perfetto (Androidデフォルト), Apple Instruments はGDScript, C# および GDExtension のフレームを可視化できます。フレームタイムのスパイク調査に使用します。
- CLI:
--profiling,--gpu-profile,--print-fps,--benchmark. 再現性のある実行には--fixed-fps 60 --quit-after Nを使用します。 - リーク: オーファンノードとは、ツリーから削除されたが解放されなかったノードです。
Node.print_orphan_nodes(),get_orphan_node_ids()(4.5+).
CPU: 作業を減らす
- 不要な処理を無効化: アイドル時に
set_process(false)/set_physics_process(false).VisibleOnScreenEnabler2D/3Dは画面外のアクターを一時停止します。タイマーはフレームごとのポーリングよりも優れています。 - フレームごとのコードがホットパスです。ノードを
@onready/_Readyでキャッシュします。アクション、グループ、メソッド名にはStringNameリテラル (&"jump") を使用します。毎フレームget_tree().get_nodes_in_group()を呼び出さないでください。型付きGDScriptを使用します(型付きオペコードは高速)。 - シグナルと
call_groupはイベントには軽量ですが、数千のエンティティに対してエンティティごとに毎フレーム発行しないでください。 - 数千のもの: ものごとに1ノードを使うのをやめましょう。
- ビジュアル:
MultiMeshInstance3D/2D(1ドローコール;multimesh.bufferに一括書き込み), または GPUパーティクル. - ロジック: エンティティごとのスクリプトではなく、1つのマネージャスクリプト内のプレーンな配列と構造体 (データ指向).
- 物理: ノードを使わない
PhysicsServer2D/3Dのボディとエリア、またはフレームごとの1レイキャストバッチ. - ノードを使わないレンダリング:
RenderingServerのインスタンスとキャンバスアイテム.
- ビジュアル:
- 物理: ゲームが特別に必要としない限り
physics_ticks_per_secondは60に保ちます。単純なプリミティブシェイプを使用し、移動するボディではConcavePolygonShape3Dを避けます。レイヤーとマスクはペアチェックを減らします。ボディをスリープさせます (can_sleep).
スレッド
WorkerThreadPool.add_task(callable)/add_group_task(callable, count)(並列for), その後wait_for_task_completion(id). これはほとんどのジョブで生のThreadよりも優れています。- シーンツリーのルール: ツリー内のノードはメインスレッドからのみ触れることができます。ただし、スレッドグループ 内にある場合は除きます (
process_thread_group = PROCESS_THREAD_GROUP_SUB_THREADはそのサブツリーを並列処理し、グループ間の呼び出しにはcall_deferred_thread_groupを使用します)。ワーカースレッドからは、call_deferred/Callable.call_deferred()で結果をメインスレッドに戻します。Thread.is_main_thread()(4.7) でアサートします。 - 共有データ:
Mutexで保護するか、各ワーカーに独自のスライスを与えてメインスレッドでマージします。 - バックグラウンドロード:
ResourceLoader.load_threaded_request(path, "", true)は依存関係の解決にサブスレッドを使用します。
GPU とレンダリング
- ドローコール: 静的メッシュをマージしマテリアルを共有します。なぜならメッシュサーフェス上のユニークなマテリアルごとにコールが追加されるからです。繰り返しには MultiMesh、2Dではテクスチャアトラスを使用します。
- ライトとシャドウは通常GPUの負荷が高いです。影付きのオムニライトとスポットライトは少数にし、
directional_shadow_max_distanceを小さく保ち、静的ライティングはベイクします (LightmapGI). - オーバードロー: 大きな半透明パーティクルと全画面アルファ。葉や小さなパーティクルクワッドにはアルファシザーまたはハッシュを使用します。
- 詳細のスケーリング: LOD (
mesh_lod_threshold),visibility_range_*, オクルージョンカリング、低スペックGPU向けの解像度スケーリング (FSR, MetalFX). 適切なレンダラーを選択: ローエンドには Mobile または Compatibility (「godot-3d-rendering」を参照). - シェーダーのヒッチ: シェーダーベイカー (エクスポートオプション), マテリアルバリアントの削減.
ロードとメモリ
preloadはスクリプトロード時にブロックします。常に必要な小さなものにのみ使用します。loadは遅延ロードです。スレッドロードはレベルに適しています。ResourceLoaderはリソースをキャッシュします。リソースを再利用し、インスタンスごとの状態が必要でない限り共有リソースをduplicate()しないでください。- テクスチャ: VRAM圧縮インポート (3Dではデフォルト; 大きな2Dでは有効化). 3D用のミップマップ。プラットフォームごとに最大サイズを制限。オーディオ: 長いトラックには Ogg ストリーム。
- 生成したものを解放: 弾には
queue_free()とプールを使用。オーファンカウントが一定であることを確認します。
GDScript vs C#
- GDScriptはゲームプレイに問題ありません。タイトな計算ループ (経路探索、プロシージャル生成、シミュレーション) は C# または GDExtension に移行し、API呼び出しはバッチ処理してください。
- C#: フレームごとのアロケーション (LINQ, クロージャ, 文字列フォーマット,
new Godot.Collections.Array) を避けます。すべての Godot API 呼び出しはインタオプ境界を越えるため、バッチ処理してください。PackedArrayは境界を越えるときにコピーされます。
プラットフォーム予算 (目安)
モバイル: < 100–150 ドローコール, 1つの影付きライト, Mobile または Compatibility レンダラー, 30–60 FPS 目標。Web: Compatibility レンダラー、スレッドを使用するエクスポートでなければシングルスレッド (クロスオリジン分離ヘッダーが必要)、ダウンロードサイズは小さく保つ。デスクトップまたはコンソール: Forward+、最小仕様ハードウェアでプロファイリング。
Perf HUD + カスタムモニター、MultiMesh群衆、並列グループタスク、サーバーサイドの弾丸 (テストでコンパイル): references/patterns.md