Outdated documentation
This documentation page refers to Godot
4.3,
and may be outdated or incorrect.
Additionally, this engine version is
no longer supported.
Check this page in the stable branch for the latest additions and corrections.
LightmapProbe
Inherits: Node3D < Node < Object
Represents a single manually placed probe for dynamic object lighting with LightmapGI.
Description
LightmapProbe represents the position of a single manually placed probe for dynamic object lighting with LightmapGI. Lightmap probes affect the lighting of GeometryInstance3D-derived nodes that have their GeometryInstance3D.gi_mode set to GeometryInstance3D.GI_MODE_DYNAMIC.
Typically, LightmapGI probes are placed automatically by setting LightmapGI.generate_probes_subdiv to a value other than LightmapGI.GENERATE_PROBES_DISABLED. By creating LightmapProbe nodes before baking lightmaps, you can add more probes in specific areas for greater detail, or disable automatic generation and rely only on manually placed probes instead.
Note: LightmapProbe nodes that are placed after baking lightmaps are ignored by dynamic objects. You must bake lightmaps again after creating or modifying LightmapProbes for the probes to be effective.