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

godot-3d-rendering

Godot 4.7 における3Dレンダリングの詳細 - レンダラー選択(Forward+/Mobile/Compatibility)、環境(AgX、グロー、フォグ、SSAO/SSR/SDFGI)、ライト(AreaLight3Dを含む)、GI(SDFGI、VoxelGI、LightmapGI)、HDR出力、マテリアル、glTF/Blenderインポートサフィックス、LOD、オクルージョンカリング。3Dシーン、ライティング、マテリアル、モデルインポート、ビジュアル品質に使用。

godot-3d-rendering とは?

このスキルは、Godot 4.7 で3Dレンダリングを設定・最適化するための包括的なガイドです。まず、プロジェクトのターゲットプラットフォームに応じてレンダラー(Forward+、Mobile、Compatibility)を選択する方法を説明します。次に、WorldEnvironmentノードを使った環境設定(スカイ、トーンマッピング、グロー、SSAO/SSIL、SSR、ボリュメトリックフォグ、SDFGI)のレシピを提供します。ライティングでは、DirectionalLight3D、OmniLight3D、SpotLight3Dに加え、4.7で追加されたAreaLight3Dの設定とパフォーマンスの注意点をカバーします。グローバルイルミネーション(GI)については、LightmapGI、VoxelGI、SDFGIの使い分けを詳述し、マテリアル(StandardMaterial3D/ORMMaterial3D)の設定、透明度、ステンシル、デカールについても解説します。さらに、glTF 2.0 / .glb形式の推奨やBlenderからのインポート手順、名前サフィックスを使った自動ノード生成、LOD、オクルージョンカリング、HDR出力(4.7)など、品質とパフォーマンスの詳細スケーリング手法を網羅しています。

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

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

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

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

ドキュメント

3Dレンダリング (4.7)

シェーダーとVFXは godot-shaders-vfx、フレームタイム関連は godot-performance を参照してください。ヘッドレス実行ではレンダリングされないため、ユーザーにスクリーンショットを依頼するか、接続されているGodot MCPスクリーンショットツールを使用してください。

最初にレンダラーを選択する (rendering/renderer/rendering_method)

機能CompatibilityMobileForward+
ターゲットWeb(唯一の選択肢)、ローエンドスマートフォン、タブレット、XR(推奨)デスクトップ、コンソール
SDFGI、VoxelGI、SSR、SSIL、ボリュメトリックフォグ、TAA、FSR2なしなしあり
LightmapGIレンダリングのみ(RDハードウェアでベイク)ありあり
SSAOありなしあり
デカール、コンポジターエフェクト、HDR 2D、DOFブラーなしありあり
グロー、フォグ(深度・高さ)、トーンマッピング、MSAA 3Dありありあり
メッシュあたりのオムニ/スポットライト88(ビュー毎に256)クラスタリング、クラスタ毎に512
AreaLight3Dシャドウなし近似半影PCSS
rendering_method.mobile でプラットフォームごとのオーバーライドを設定します。現在の選択は project_inspect.py で確認できます。Windows はデフォルトでD3D12(4.6+)、macOS/iOS はMetalを使用します。

環境レシピ (WorldEnvironment → Environment)

  • スカイ: Sky + ProceduralSkyMaterial(スタイライズ)、PhysicalSkyMaterial(物理光量と組み合わせてリアル)、PanoramaSkyMaterial(HDRI)。背景モードをSkyに設定し、スカイからのアンビエント/反射光を設定。
  • トーンマップ: TONE_MAPPER_AGX で自然なハイライト(tonemap_agx_white/tonemap_agx_contrast を調整、4.6+)。既存の見た目に合わせる場合のみFilmic/ACESを使用。
  • グロー: 4.6以降はトーンマッピングの前にブレンドされ、デフォルトでScreenモード、低めの強度になります。glow_intensity は低く保ち、ブルームにはエネルギーが1以上のemissiveマテリアルを使用。
  • Forward+ 追加機能: SSAOとSSIL(コンタクトシャドウ、バウンス)、SSR(濡れた床など;4.6で大幅なリワーク、半解像度オプションあり)、ボリュメトリックフォグ + FogVolume(ライトシャフト用)、大規模動的GI用のSDFGI。
  • CameraAttributesPractical(DOF、自動露出)または CameraAttributesPhysical(実際のF値、シャッター、ISO)をWorldEnvironmentまたはCamera3Dに設定。

ライトとシャドウ

  • DirectionalLight3D(太陽): directional_shadow_mode PSSM 4分割。directional_shadow_max_distance はゲームで許容される最小限(100~200m)に保つとシャドウ解像度が向上。
  • オムニ/スポットライト: 重要なライトにのみシャドウを有効化。遠くのライトには distance_fade_* を使用。
  • AreaLight3D(4.7): スクリーン、窓、ネオンからの矩形ソフトライト。area_size、オプションで area_texture と area_normalize_energy を設定。オムニ/スポットよりもコストが高いため、少数に抑える。
  • 静的ライトは LightmapGI に light_bake_mode = BAKE_STATIC でベイクされる。動的ライトは BAKE_DYNAMIC のまま。

グローバルイルミネーションの選択

ニーズ使用
静的なレベル、最高品質、Compatibilityのベイク以外のレンダラーLightmapGI(エディタでベイク;UV2が必要:インポート時に「Lightmap UV」を有効化)
中規模静的区域にある動的オブジェクトVoxelGI(ベイク、Forward+)
広大またはオープンワールド、時間帯変化、ベイク不要SDFGI(Environment、Forward+)
光沢のある表面の反射ReflectionProbe(屋内エリアでは interior を設定)、+ SSR
組み合わせ例: 静的ライティングはライトマップ、動的オブジェクトはライトプローブまたはVoxelGI、光沢面は全所にReflectionProbe。

マテリアル (StandardMaterial3D / ORMMaterial3D)

  • ORMパックテクスチャは ORMMaterial3D に。AlbedoはsRGB。Normal、ORM、ラフネスマップは線形でインポート(Godotはノーマルマップを割り当て時に自動検出)。
  • 透明度: TRANSPARENCY_ALPHA_SCISSOR または ALPHA_HASH(草や葉など、深度ソート不要)を推奨。ALPHA はガラスやVFXのみに使用(ソート問題とシャドウなしのため)。
  • material_override(メッシュ全体)と set_surface_override_material(i, m)(インスタンス毎)を使用。共有マテリアルは、全ユーザーが変更すべき場合を除き、実行時に直接編集しない。まず duplicate() すること。
  • ステンシル(4.5+): stencil_mode = STENCIL_MODE_OUTLINE または STENCIL_MODE_XRAY で、カスタムシェーダーなしでアウトラインや透視表示を実現。
  • Decal ノードはあらゆる表面に投影可能(Compatibilityでは不可)。

インポート (glTF 2.0 / .glb 推奨)

  • Blenderでは、GLBを+Y上、トランスフォーム適用済みでエクスポート。Godotは .godot/imported にインポート。インポートドックまたは「高度なインポート設定」(メッシュ毎のLOD、コリジョン、マテリアル、アニメーションクリップ)で設定。
  • ソースファイル内の名前サフィックスで自動的にノードが作成: -col、-convcol、-colonly、-convcolonly(コリジョン)、-rigid、-navmesh、-occ/-occonly(オクルーダー)、-noimp(スキップ)、-loop/-cycle(ループアニメーション)。
  • .blend を直接インポートするにはBlenderのインストールと filesystem/import/blender/enabled が必要。CIではGLBを使用。
  • 再インポート時に編集済みマテリアルを保持するには、シーンインポートオプション materials/extract = 1(一度抽出)を使用、または高度なインポート→マテリアル毎に「ファイルに保存」。全インポートオプションは api_lookup.py ResourceImporterScene で確認。
  • Blenderからのアセット作成とエクスポートについては、blender-export-pipelines スキルがインストールされていれば参照。

詳細スケーリング

  • 自動メッシュLODはインポート時に生成。ビューポート毎に mesh_lod_threshold で調整(数値が大きいほど強力)。
  • visibility_range_begin/end(+フェード)でHLODとインプスターを処理し、遠くのプロップをカリング。
  • オクルージョンカリング: rendering/occlusion_culling/use_occlusion_culling を有効化、OccluderInstance3D を追加し、ベイク。屋内や都市シーンで効果的。
  • 解像度スケーリング: Viewport.scaling_3d_mode(FSR 1、FSR2(Forward+)、MetalFX(Apple))+ scaling_3d_scale。アンチエイリアシング: MSAA 3D、screen_space_aa(FXAA、SMAA 4.5+)、TAA(Forward+)。

HDR出力 (4.7)

display/window/hdr/request_hdr_output(または Window.hdr_output_requested)を有効化。Windows、macOS、iOS、visionOS、Linux Waylandでサポートされ、自動的にSDRにフォールバック。DisplayServer.window_is_hdr_output_supported() で確認し、設定にトグルと明るさオプションを公開。

環境、ライティングプリセット、マテリアル、LODコード(テストでコンパイル済み): references/recipes.md

Individual skills in this repo

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

関連スキル