Version: Unity 6.3 Beta (6000.3)
Language : English
Adjust Mixed lights at runtime
Configuring lights with the Light Explorer

Troubleshooting objects appearing unlit or darker than intended

Fix issues causing some objects to appear unlit or darker than intended.

 Three images depicting the same scene of a room filled by a 3 by 3 grid of spheres, baked in Shadowmask Lighting Mode. The first image shows that some of the spheres are unlit and appear dark compared to others. The second image shows the same scene in the Light Overlap debug view to highlight overlapping lights in red. The third image shows the same scene in the Shadowmask debug view.
Three images depicting the same scene of a room filled by a 3 by 3 grid of spheres, baked in Shadowmask Lighting Mode. The first image shows that some of the spheres are unlit and appear dark compared to others. The second image shows the same scene in the Light Overlap debug view to highlight overlapping lights in red. The third image shows the same scene in the Shadowmask debug view.

Symptoms

Mixed lights in the sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary
are rendered as baked lightsLight components whose Mode property is set to Baked. Unity pre-calculates the illumination from Baked Lights before runtime, and does not include them in any runtime lighting calculations. More info
See in Glossary
and some objects and areas in the scene appear unlit or darker than intended.

Cause

This issue can occur when Unity converts mixed lights to baked lights during the lighting setup. Baked lights don’t provide real-time lighting, so they don’t illuminate dynamically in the scene. Instead, their contribution is baked into lightmapsA pre-rendered texture that contains the effects of light sources on static objects in the scene. Lightmaps are overlaid on top of scene geometry to create the effect of lighting. More info
See in Glossary
, light probesLight probes store information about how light passes through space in your scene. A collection of light probes arranged within a given space can improve lighting on moving objects and static LOD scenery within that space. More info
See in Glossary
, or reflection probesA rendering component that captures a spherical view of its surroundings in all directions, rather like a camera. The captured image is then stored as a Cubemap that can be used by objects with reflective materials. More info
See in Glossary
. If you don’t properly configure the baked lighting setup, objects may remain dark due to missing or incomplete lighting data during the bake process.

In ShadowmaskA Texture that shares the same UV layout and resolution with its corresponding lightmap. More info
See in Glossary
Lighting Mode, only four mixed lights can overlap. Unity converts lights that exceed this limit into baked lights.

In Subtractive Lighting Mode, no lights (except for directional lights) cast real-time shadows. This is a limitation of this lighting mode.

When you use baked lighting, real-time adjustments (such as changing the light’s color, intensity, or position during runtime) are no longer possible, which may limit dynamic or interactive lighting effects in the scene and cause the objects to appear darker or lit in unintended ways.

Resolution - Change the light placement and radius

To verify that light overlap exceeding the limit is the main issue, switch to the Light Overlap Scene view draw mode after generating lighting. This draw mode highlights overlapping lights in red so you can identify the number of overlapping lights.

Move the affected lights so that they no longer overlap. You can also adjust the Range or Spot Angle properties in the Light component. Generate lighting again after making the changes to check if this fixes the issue.

Resolution - Switch to a different Lighting Mode

Each Lighting Mode has different advantages and limitations. If your project will be lit using a single directional light, then consider the Subtractive Lighting Mode instead of Shadowmask. Refer to Lighting Modes to view the different limits and ways Unity calculates lighting for each mode.

Adjust Mixed lights at runtime
Configuring lights with the Light Explorer