Skip to content

Document LightmapGI rendering limits in Mobile and Compatibility renderers #11013

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions tutorials/3d/global_illumination/using_lightmap_gi.rst
Original file line number Diff line number Diff line change
Expand Up @@ -645,6 +645,14 @@ Reducing LightmapGI artifacts

If you notice LightmapGI nodes popping in and out of existence as the camera
moves, this is most likely because the engine is rendering too many LightmapGI
instances at once. Godot is limited to rendering 8 LightmapGI nodes at once,
which means up to 8 instances can be in the camera view before some of them will
start flickering.
instances at once.

Here are the limits for each renderer:

- **Forward+**: Up to 8 LightmapGI nodes can be rendered at once.
- **Forward Mobile**: Up to 2 LightmapGI nodes can be rendered at once.
- **Compatibility**: An unlimited number of LightmapGI nodes can be rendered at once.

If this limit is exceeded, meshes that use lightmaps from extraneous LightmapGI
nodes will not display lightmaps on them. Dynamic objects within their bounds also
won't receive lighting.