Starlight (Forge) Mod (1.20.2) – Rewriting the Vanilla Light Engine

Starlight (Forge) is an optimization mod that completely rewrites Minecraft's light engine to fix lighting performance issues and lighting errors for Minecraft Forge. Developed by spottedleaf, it delivers dramatically faster light calculations on both dedicated servers and client installations.

Minecraft's vanilla light engine has long been a bottleneck — especially on larger multiplayer servers where thousands of block updates happen every second. Each time a torch is placed, a block is broken, or a chunk loads in, the light engine must recalculate lighting values across potentially hundreds of blocks. On high-scale dedicated servers, this process can consume a staggering amount of tick time, leading to TPS drops and visible lag. Starlight was built specifically to solve this problem by throwing out the vanilla lighting code entirely and replacing it with a far more efficient implementation. Originally developed for the Paper server software, the Forge port brought these same benefits to the wider modded Minecraft community. With over 10.5 million downloads on Modrinth alone, Starlight has earned its reputation as one of the most essential performance mods available for Forge players.

Key Features of Starlight (Forge)

• Complete Light Engine Rewrite — Rather than patching the vanilla system, Starlight replaces the entire light engine from the ground up. This means lighting calculations are rebuilt using more efficient algorithms, resulting in significantly faster processing times for both block light and sky light propagation across your world.
• Faster Block Light Updates — Placing or breaking light-emitting blocks like torches, glowstone, or lava triggers immediate recalculations. Starlight handles these updates far more quickly than vanilla, which means less stuttering when you are building or mining in areas with many light sources.
• Improved High Y-Level Performance — Block edits at high altitudes are particularly expensive in vanilla Minecraft because sky light recalculations cascade downward. Starlight optimizes this specific scenario, making building at high elevations noticeably smoother — a real benefit for players constructing sky bases or working in amplified worlds.
• Server-Side and Client-Side Flexibility — You can install Starlight on just the server, just the client, or both. It is not required on both sides, which means server owners can boost performance without forcing every player to install additional mods. Clients connecting to a Starlight-enabled server can run vanilla, Phosphor, or Starlight themselves.
• Reduced Chunk Generation Lag — When new chunks are generated, the light engine must calculate initial lighting for every block. Starlight speeds up this step considerably, which is especially noticeable when exploring new terrain or preloading chunks on a server.
• No Configuration Needed — Starlight works immediately after installation with no config files to tweak. Drop it into your mods folder and the rewritten light engine takes over automatically, making it one of the simplest performance mods to set up.
• Open Source Under LGPL-3.0 — The full source code is available on GitHub under the LGPL-3.0 license, meaning the community can audit, contribute to, and fork the project. This transparency builds trust and allows other mod developers to check compatibility directly.

Screenshots

How to Install Starlight (Forge)

1. Download and install Minecraft Forge for your target Minecraft version (1.17.1 through 1.20.2). Make sure your Forge version is up to date — for 1.20.2, use Forge version 48.0.33 or newer.
2. Download the Starlight (Forge) file matching your Minecraft version from the download section below.
3. Open your Minecraft installation directory and navigate to the mods folder. If the folder does not exist, launch Minecraft with Forge once to generate it automatically.
4. Place the downloaded Starlight .jar file into the mods folder. Make sure you do not have Phosphor installed — Starlight and Phosphor are completely incompatible and cannot run together.
5. Launch Minecraft using your Forge profile. Starlight will activate automatically with no additional configuration required.

Requirements & Compatibility

What's New

• Updated for Minecraft 1.20.2 — requires Forge version 48.0.33 or newer for full compatibility.
• Improved mod compatibility through multiple patches, reducing conflicts with other Forge mods that interact with the light engine.
• Fixed a bug where mushrooms were not generating properly in dark biomes due to incorrect light level calculations.
• Future updates beyond 1.20 are being integrated into the Moonrise project, which continues Starlight's development under a broader scope.

Pros and Cons

Alternatives to Starlight (Forge)

• Sodium — A broader rendering optimization mod that improves overall frame rates and visual performance, often used alongside lighting mods for maximum client-side FPS gains.
• Embeddium — A Forge-compatible fork of Sodium that brings similar rendering optimizations to the Forge ecosystem, making it a strong companion or alternative for Forge players seeking better performance.
• OptiFine — The long-standing all-in-one optimization and shader mod for Minecraft that includes its own lighting improvements, though it takes a less targeted approach than Starlight's dedicated light engine rewrite.

Download Starlight (Forge)

Always download mods from official sources to stay safe.

Frequently Asked Questions

Is Starlight compatible with Phosphor?

No — Starlight and Phosphor are completely incompatible and cannot be installed together. Both mods modify the light engine, and their changes directly conflict. You must choose one or the other. If you are looking for the best lighting performance, Starlight's complete rewrite generally offers greater improvements than Phosphor's more conservative patches.

Do both the server and client need Starlight installed?

No — Starlight can be installed on just the server, just the client, or both sides independently. A server running Starlight will work with clients using vanilla, Phosphor, or Starlight. Similarly, a client running Starlight can connect to any server regardless of whether it uses Starlight.

Will Starlight be updated beyond Minecraft 1.20.2?

No — Starlight as a standalone mod is not receiving updates past 1.20. The developer has merged the project's improvements into Moonrise, a broader performance project. Players on newer Minecraft versions should look into Moonrise for continued light engine optimizations.

Does Starlight work with other optimization mods?

Yes — Starlight is generally compatible with most optimization mods like Sodium, Embeddium, and Entity Culling. The main exception is Phosphor, which directly conflicts. Because Starlight is an invasive light engine rewrite, some mods that hook into lighting internals may have issues, so check Starlight's GitHub issue tracker if you encounter problems with specific mods.

Does Starlight improve FPS on the client side?

Yes — while Starlight primarily targets server-side tick performance, client-side players also benefit from faster light calculations. This is most noticeable when placing or breaking blocks in areas with many light sources, loading new chunks during exploration, or building at high altitudes where sky light recalculations are expensive in vanilla Minecraft.

You May Also Like

Crash Exploit Fixer Mod (1.21.11) – Keep Your Server Running Smoothly

1 month ago

Forager's Insight Mod (1.20.1) – Wild Foraging & Nature Expansion

7 days ago

Log Begone Mod (1.21.1, 1.20.6) – Remove Annoying Logs

4 days ago

YUNG's Better Mineshafts Mod (1.21.4, 1.20.4) – Gameplay Upgrade

4 weeks ago

Lightman's Currency Mod (1.21.11, 1.20.1) – A New Simple Money System

1 week ago

Repurposed Structures Mod (1.21.11) – New Terrain, Village, Dungeon

2 weeks ago