Open Lights

Open Lights adds handheld flashlights and placeable lighting to Minecraft Forge 1.20.1, with visible light beams, block shadows, and colored light passing through stained glass.

Carry a flashlight while exploring, aim a spotlight down a hallway, or light a room with point and rectangular area lights.

Features

• Handheld flashlight: works in either hand. Right-click to toggle; no batteries required.
• Placeable lights: craft point lights, directional spotlights, and rectangular area lights. Toggle them, adjust their range, and apply dyes to change their color.
• Volumetric beams: visible fog and floating dust inside flashlight beams.
• Colored transmission: clear glass lets light through, stained glass colors it, and tinted glass blocks it. Water and ice also affect transmission.
• Block shadows: walls and other block shapes obstruct light. Entity models do not currently cast shadows.
• Custom beam profiles: configure inner and outer beam colors, brightness, angles, range, softness, and falloff independently.

Configuration and performance

Set beam defaults in the server config, or use datapacks to customize individual light profiles. Profiles synchronize when players join and update through /reload.

Client settings control rendering resolution, shadow quality, beam range, dust, and light limits. Cached geometry and reusable shadow maps reduce repeated work. The renderer supports up to eight nearby lights, with shadows on up to four.

TaCZ integration

The optional TACZ Open Lights addon connects TaCZ weapon flashlight attachments to Open Lights, including animated attachment positioning and synchronized toggles.

Requirements and compatibility

Requires **Forge 47.4.10 or newer, *Minecraft 1.20.1*, and *Java 17*. Install Open Lights on both the client and server.

Tested with Embeddium 0.3.31, Oculus 1.8.0, and Complementary Reimagined r5.9.3. Other shader packs, OptiFine, and Distant Horizons are currently untested.

Modpacks and source

Modpack and server use is permitted, including monetized packs and servers, under the license terms.

Source code · Beam configuration guide · Developer API