Community编程与开发github.com

Godot 4.7 3D渲染

Godot 4.7 中实现3D视觉效果的技能——涵盖渲染器选择、环境、光照、全局光照、材质、模型导入、LOD与遮挡剔除等。

Godot 4.7 3D渲染 是什么?

该技能为 Godot 4.7 的 3D 渲染提供全面指导。它首先帮助开发者选择合适的渲染器(Forward+/Mobile/Compatibility),并解释各渲染器对不同目标平台的适配。接着,它会详细讲解如何配置环境效果(如 AgX 色调映射、辉光、雾效、SSAO/SSR/SDFGI),并推荐在 4.6+ 版本中使用 AgX 以获得自然的高光效果。在光照方面,技能涵盖了从基本的 DirectionalLight3D 到 4.7 新增的 AreaLight3D 的配置与优化,并指导如何结合 LightmapGI、VoxelGI 和 SDFGI 实现高效的全局光照。此外,它还包含了材质(StandardMaterial3D/ORMMaterial3D)的使用技巧(如透明度与模板模式)、从 Blender 导入 glTF 模型的流程(含后缀名自动节点创建)以及 LOD 和遮挡剔除的细节调整。最后介绍了 HDR 输出的启用方法。这一技能适用于任何需要在 Godot 中构建 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支持不支持支持
贴花、合成器效果、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(HDR)。将背景模式设置为 Sky,环境光和反射光来自天空。
  • 色调映射:使用 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:在导入时启用“光映射 UV”)
中型静态区域中的动态对象VoxelGI(烘焙,Forward+)
大型或开放世界、时间变化、无烘焙SDFGI(Environment,Forward+)
光滑表面上的反射ReflectionProbe(为室内区域设置 interior),配合 SSR
组合使用:静态光照使用光映射、动态对象使用光探针或 VoxelGI,所有光泽表面使用 ReflectionProbes。

材质 (StandardMaterial3D / ORMMaterial3D)

  • ORM 压缩纹理放入 ORMMaterial3D。漫反射贴图为 sRGB。法线、ORM 和粗糙度贴图导入为线性(Godot 在分配法线贴图时会自动检测)。
  • 透明:优先使用 TRANSPARENCY_ALPHA_SCISSOR 或 ALPHA_HASH(植被,自动深度排序)。仅对玻璃和特效使用 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 中,导出 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+ 上、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.

相关技能