Community程式設計與開發github.com

Godot 3D 渲染

在 Godot 4.7 中實現 3D 視覺效果 - 渲染器選擇(Forward+/Mobile/Compatibility 矩陣)、環境(AgX、發光、霧、SSAO/SSR/SDFGI)、光源(含 AreaLight3D)、全域光照(SDFGI、VoxelGI、LightmapGI)、HDR 輸出、材質、glTF/Blender 匯入後綴、LOD 與遮擋剔除。適用於 3D 場景、光照、材質、模型匯入或視覺品質。

Godot 3D 渲染 是什麼?

這個技能提供在 Godot 4.7 中建構高品質 3D 渲染效果的全面指引。它涵蓋了從選擇合適的渲染器(Forward+、Mobile 或 Compatibility)到配置進階環境效果(如 AgX 色調映射、發光、霧、SSAO、SSR 和 SDFGI)的所有內容。此技能詳細說明了光源類型,包括新的 AreaLight3D 以及陰影和全域光照(GI)最佳化的最佳實踐。它還指導開發者完成材質設定(標準材質與 ORM 材質)、glTF 和 Blender 匯入管線,以及透過 LOD、遮擋剔除和 HDR 輸出進行效能縮放。此技能支援所有 Godot 支援的平台,對於使用 Godot 4.7 開發 3D 遊戲或應用程式的任何開發者來說,是一個一站式參考資料。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

3D 渲染 (4.7)

著色器與視覺特效請參考 godot-shaders-vfx,幀時間相關工作請參考 godot-performance。無頭模式不進行渲染,因此請向使用者索取螢幕截圖,或使用已連線的 Godot MCP 螢幕截圖工具。

首先選擇渲染器 (rendering/renderer/rendering_method)

功能特性CompatibilityMobileForward+
目標平台網頁(唯一選項)、低階裝置手機與平板、XR(建議)桌上型電腦與遊戲主機
SDFGI、VoxelGI、SSR、SSIL、體積霧、TAA、FSR2無無有
LightmapGI僅渲染(需在 RD 硬體上烘焙)有有
SSAO有無有
Decals、合成器效果、HDR 2D、景深模糊無有有
發光、霧(深度與高度)、色調映射、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)。將背景模式設為天空,並從天空取得環境光/反射光。
  • 色調映射: 使用 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_mode PSSM 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

Individual skills in this repo

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

相關技能