Communityコーディング&開発github.com

godot-performance

Godot 4.7 のパフォーマンス問題を発見・修正します。プロファイラとモニター、フレームバジェット、数千オブジェクト向けの MultiMesh とサーバー API、WorkerThreadPool とスレッドグループ、GDScript/C# ホットパス、ドローコール、ライト、LOD、物理コスト、ロードとメモリリークに対応。ゲームがカクつく、FPS が低い、ロードが遅い、メモリが増え続けるときに使用します。

godot-performance とは?

このスキルは、Godot 4.7 でゲームのパフォーマンスを測定、分析、最適化するための包括的なガイドです。Editor Debugger の Profiler や Visual Profiler、Monitors を使ってフレームごとのボトルネックを特定し、CPU 負荷(スクリプト、物理)、GPU 負荷(ドローコール、ライト、シェーダー)、メモリリークを診断します。具体的な最適化手法として、`set_process(false)` による不要な処理の停止、`MultiMeshInstance3D/2D` や `RenderingServer` を用いたノードを使わない数千オブジェクトの描画、`WorkerThreadPool` による並列処理、スレッドセーフなデータ共有、LOD やオクルージョンカリングによる詳細度制御、リソースの先読みとキャッシュ管理をカバーします。モバイル、Web、デスクトップ・コンソールそれぞれのプラットフォーム別のフレームバジェット目標も提示し、Godot に組み込みのプロファイリング CLI オプションや Tracy/Perfetto などのネイティブプロファイラの使い方も含まれています。また、GDScript と C# の性能特性の違いや、C# でのインタオペ境界を意識したバッチ処理の重要性についても言及しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EL4CTEO/godot-skills/tree/main/skills/godot-performance

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

ドキュメント

パフォーマンス (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

Individual skills in this repo

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

関連スキル