3Dレンダリング (4.7)
シェーダーとVFXは godot-shaders-vfx、フレームタイム関連は godot-performance を参照してください。ヘッドレス実行ではレンダリングされないため、ユーザーにスクリーンショットを依頼するか、接続されているGodot MCPスクリーンショットツールを使用してください。
最初にレンダラーを選択する (rendering/renderer/rendering_method)
| 機能 | Compatibility | Mobile | Forward+ |
|---|---|---|---|
| ターゲット | Web(唯一の選択肢)、ローエンド | スマートフォン、タブレット、XR(推奨) | デスクトップ、コンソール |
| SDFGI、VoxelGI、SSR、SSIL、ボリュメトリックフォグ、TAA、FSR2 | なし | なし | あり |
| LightmapGI | レンダリングのみ(RDハードウェアでベイク) | あり | あり |
| SSAO | あり | なし | あり |
| デカール、コンポジターエフェクト、HDR 2D、DOFブラー | なし | あり | あり |
| グロー、フォグ(深度・高さ)、トーンマッピング、MSAA 3D | あり | あり | あり |
| メッシュあたりのオムニ/スポットライト | 8 | 8(ビュー毎に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_modePSSM 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