3D 渲染 (4.7)
著色器與視覺特效請參考 godot-shaders-vfx,幀時間相關工作請參考 godot-performance。無頭模式不進行渲染,因此請向使用者索取螢幕截圖,或使用已連線的 Godot MCP 螢幕截圖工具。
首先選擇渲染器 (rendering/renderer/rendering_method)
| 功能特性 | Compatibility | Mobile | Forward+ |
|---|---|---|---|
| 目標平台 | 網頁(唯一選項)、低階裝置 | 手機與平板、XR(建議) | 桌上型電腦與遊戲主機 |
| SDFGI、VoxelGI、SSR、SSIL、體積霧、TAA、FSR2 | 無 | 無 | 有 |
| LightmapGI | 僅渲染(需在 RD 硬體上烘焙) | 有 | 有 |
| SSAO | 有 | 無 | 有 |
| Decals、合成器效果、HDR 2D、景深模糊 | 無 | 有 | 有 |
| 發光、霧(深度與高度)、色調映射、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)。將背景模式設為天空,並從天空取得環境光/反射光。 - 色調映射: 使用
TONE_MAPPER_AGX呈現自然高光(調整tonemap_agx_white/tonemap_agx_contrast,4.6+)。僅在需要匹配現有外觀時使用 Filmic/ACES。 - 發光: 自 4.6 起,它在色調映射前進行混合,預設為螢幕模式且強度較低。保持
glow_intensity較低,並使用能量高於 1 的發光材質來產生泛光效果。 - Forward+ 進階功能: SSAO 和 SSIL(接觸陰影、反射)、SSR(濕地板;在 4.6 中進行了重大重構,具有半解析度選項)、體積霧加上用於光柱的
FogVolume,以及用於大型動態全域照明的 SDFGI。 CameraAttributesPractical(景深、自動曝光)或CameraAttributesPhysical(實際 f-stop、快門和 ISO)可載入 WorldEnvironment 或 Camera3D。
光源與陰影
DirectionalLight3D(太陽):directional_shadow_modePSSM 4 個分割區。將directional_shadow_max_distance保持在遊戲允許的最小值(100–200 公尺),因為這能提升陰影解析度。- 點光源與聚光燈: 僅對重要的光源開啟陰影。對遠處的光源使用
distance_fade_*。 AreaLight3D(4.7): 來自螢幕、窗戶和霓虹燈的矩形柔光。設定area_size、可選的area_texture和area_normalize_energy。它的效能成本高於點光源或聚光燈,因此請少量使用。- 靜態光源會以
light_bake_mode = BAKE_STATIC烘焙到LightmapGI中。動態光源保持BAKE_DYNAMIC。
全域照明選擇
| 需求 | 使用方案 |
|---|---|
| 靜態場景,最佳品質,任何渲染器(除 Compatibility 烘焙外) | LightmapGI(在編輯器中烘焙;需要 UV2:在匯入時啟用「Lightmap UV」) |
| 中型靜態區域中的動態物件 | VoxelGI(烘焙,Forward+) |
| 大型或開放世界,日夜循環,無需烘焙 | SDFGI(Environment,Forward+) |
| 光滑表面上的反射 | ReflectionProbe(為室內區域設定 interior),加上 SSR |
| 組合使用:靜態光照使用光照貼圖,動態物件使用光照探針或 VoxelGI,所有光滑表面使用 ReflectionProbe。 |
材質 (StandardMaterial3D / ORMMaterial3D)
- ORM 壓縮紋理載入
ORMMaterial3D。Albedo 為 sRGB。法線貼圖、ORM 和粗糙度貼圖以線性方式匯入(Godot 在指定法線貼圖時會自動偵測)。 - 透明度: 偏好使用
TRANSPARENCY_ALPHA_SCISSOR或ALPHA_HASH(植被,自動深度排序)。僅對玻璃和 VFX 使用ALPHA,因為它會造成排序問題且無陰影。 - 使用
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 中,以 +Y 向上並套用變換的方式匯出 GLB。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為每個視口進行調整,數值越高,LOD 切換越積極。 visibility_range_begin/end(+ 淡入淡出)處理 HLOD 和代理物件,並剔除遠距離道具。- 遮擋剔除: 啟用
rendering/occlusion_culling/use_occlusion_culling,新增OccluderInstance3D,然後進行烘焙。它有助於室內和城市場景。 - 解析度縮放:
Viewport.scaling_3d_mode(FSR 1、Forward+ 上的 FSR2、Apple 上的 MetalFX)加上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