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 | 支持 | 不支持 | 支持 |
| 贴花、合成器效果、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(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_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:在导入时启用“光映射 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