How portable light, color and water work

Hold, drop, or wear your light

Supported items give off light when you or a living mob hold them in either hand, and when they are dropped on the ground. A worn, charged headlamp and the Luminous effect also compete to light their holder. Use the 83-rule catalog to look up bundled items, and the headlamp guide for helmet recipes.

Portable light is visual. It does not change world-light data, spawning, crops, AI or F3 light readings. A brighter-looking cave still needs real lighting where gameplay requires it.

Placed item frames, display entities, chests, projectiles and unrelated armor are not scanned as light sources. Being on fire does not by itself create a source. Dropped light ends when the item is picked up, removed, merged away or despawned.

One entity, one winning source

Source-selection diagram. Separate sources use a maximum contribution rather than adding brightness.

For you or a living mob, the game checks these four places in order:

1. Main hand.
2. Offhand.
3. Luminous.
4. Headlamp.

Only a brighter light takes over. If two are equally bright, the earlier one in the list keeps its color. Holding a level-14 torch therefore masks a default level-14 headlamp, including its glass color. Emptying that hand can reveal the headlamp’s light again. A level-10 offhand soul torch also wins a tie with Luminous.

Separate entities can each provide light, but brightness at any point uses the maximum contribution, never a sum. A pile of low-level sources will not add up to a single brighter lamp. Quality settings can also limit which sources are selected.

Match the light to the water

Water-rule illustration using vanilla item artwork. Check the light origin, not the feet; rain does not count. Vanilla artwork © Mojang/Microsoft; original wiki diagram.

Water is checked where the light starts—for example, near your hand or head—not at your feet. The tables call that point the source origin. Rain does not count as submersion.

Held light starts at roughly 65% of the living entity’s height. A winning headlamp starts at eye height. Dropped light starts 0.15 blocks above the item. These positions explain why a partly submerged entity can behave differently from one whose light origin is fully underwater.

Reach fades with distance

Distance comparison from the source formula; each source grows dimmer before this boundary.

The radius is the distance at which that source’s contribution falls to zero, not a circle of full brightness.

Candles can look subtle because their level-3 reach is short. The renderer does not calculate occlusion or shadows, so portable light passes through walls. A small movement trail is a documented limitation.

Understand the color

Portable light adds color to the landscape, players and living mobs where it is brighter than the light already there. Daylight and brighter placed lights retain their appearance. Items drawn in your hands, particles and separately rendered blocks receive extra brightness without that color.

Historical version 1.1 comparison, supplied development record. The candle examples have short reach. It illustrates prior rendering observations, not fresh compatibility testing.

Where lights overlap, their colors blend, with the stronger nearby light having more influence. That color blending does not add brightness. A light standing still can keep an older shade around dusk until the nearby scenery redraws. Shaders can alter, hide or whiten the appearance.

Sources that disappear

Spectators do not give off portable light. Invisible players and mobs are also excluded by default, though the server can change that rule. Distant lights may disappear because of your quality or distance settings, the entities the server sends to your client, or grouping of nearby dropped items.

The setting labeled held sources controls the whole living-source path, including headlamps and Luminous. Disabling it can darken a helmet even when the lamp is charged and on. Settings and troubleshooting explains the checks.