Starlight (Fabric) is an optimization mod that completely rewrites Minecraft's light engine to fix lighting performance issues and lighting errors for Fabric mod loader. Developed by spottedleaf, it delivers dramatic improvements to how the game calculates and updates light, making it one of the most impactful performance mods available for Fabric users.
Minecraft's vanilla light engine has long been a performance bottleneck, particularly on larger dedicated servers and in worlds with complex builds at high Y-levels. Every time you place a torch, break a block near a light source, or load a new chunk, the game must recalculate light values across potentially hundreds of blocks. The vanilla implementation handles this inefficiently, causing noticeable lag spikes and even persistent lighting glitches where chunks appear darker or brighter than they should. Starlight was originally built to solve this exact problem for high-scale dedicated servers running Paper, and was later ported to Fabric so all players could benefit. With over 13 million downloads, it has become one of the most trusted optimization mods in the Minecraft community.
Key Features of Starlight (Fabric)
- 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 fundamentally restructured for efficiency, resulting in far fewer lag spikes during chunk generation and block updates compared to what the vanilla engine delivers.
- Faster Block Light Updates — Placing or breaking light-emitting blocks like glowstone or torches triggers a cascade of recalculations. Starlight handles these updates significantly faster, which is especially noticeable when building with redstone lamps or other dynamic light sources in large builds.
- Improved Performance at High Y-Levels — Block updates at elevated positions in the world are particularly expensive for the vanilla light engine. Starlight optimizes these calculations so that building tall structures or working in mountainous terrain no longer causes the same degree of performance degradation.
- Lighting Error Fixes — Beyond raw speed, Starlight also corrects persistent lighting glitches that plague vanilla Minecraft. Those dark spots in caves or incorrectly lit chunks that sometimes appear after world generation are addressed by the rewritten engine, giving you a visually cleaner experience.
- Flexible Server-Client Installation — Starlight does not need to be installed on both the server and client simultaneously. You can run it on just the server or just the client, and players using Vanilla or other lighting mods can still connect without issues. This flexibility makes it easy to adopt on multiplayer servers without requiring every player to install it.
- Lightweight and Focused — Starlight does one thing and does it well. It focuses exclusively on the light engine, which means it pairs cleanly with other optimization mods like Sodium or Lithium without trying to do too much at once. The mod appears to be lightweight in terms of its resource footprint since it replaces rather than layers on top of existing code.
- Moonrise Integration for Newer Versions — For Minecraft versions past 1.20, Starlight's improvements have been incorporated into the Moonrise project. This means the technology continues to evolve and benefit the community even as the standalone Fabric mod's version support has stabilized at 1.20.4.
Screenshots
How to Install Starlight (Fabric)
- Download and install Fabric Mod Loader for your Minecraft version (1.17 through 1.20.4 supported).
- Download the correct Starlight (Fabric) file for your Minecraft version from the download section below.
- Open your Minecraft installation directory and navigate to the
modsfolder. If it does not exist, create it. - Place the downloaded Starlight
.jarfile into themodsfolder. Make sure you do not have Phosphor installed, as the two mods are completely incompatible and cannot run together. - Launch Minecraft with the Fabric profile and verify that Starlight is loaded by checking the mod list in-game.
Requirements & Compatibility
| Requirement | Details |
|---|---|
| Mod Loader | Fabric |
| Minecraft Versions | 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19 – 1.19.4, 1.20 – 1.20.4 |
| Side | Client or Server (not required on both) |
| Incompatible With | Phosphor (cannot be installed together) |
| License | LGPL-3.0-only |
What's New
- Updated to support Minecraft 1.20.4 — only a version compatibility bump was needed, indicating the core engine rewrite remains stable.
- For versions beyond 1.20, Starlight's technology has transitioned into the Moonrise project for continued development.
- Performance benchmarks for 1.20 show Starlight and Vanilla are closer in chunk generation speed, though Starlight still leads in block update scenarios.
- Block updates at high Y-levels and glowstone-style light updates remain significantly faster than vanilla in 1.20.
Pros and Cons
Pros
- Dramatically faster light calculations for block updates and chunk generation
- Fixes persistent vanilla lighting glitches and dark spots
- Flexible installation — works on server-only or client-only setups
- Over 13 million downloads with proven reliability
- Pairs well with other optimization mods like Sodium and Lithium
Cons
- Incompatible with Phosphor — you must choose one or the other
- Invasive rewrite may break some mods that interact with the light engine
- No updates planned past 1.20.4 for the standalone Fabric version (succeeded by Moonrise)
- Fabric-only — no Forge or NeoForge support in this version
Alternatives to Starlight (Fabric)
- Phosphor — A less invasive lighting optimization mod for Fabric that patches the vanilla engine rather than replacing it, offering better mod compatibility at the cost of smaller performance gains. Cannot be used alongside Starlight.
- Sodium — A comprehensive client-side rendering optimization mod for Fabric that dramatically improves frame rates. Pairs well with Starlight since Sodium focuses on rendering while Starlight handles the light engine.
- Lithium — A general-purpose server and game logic optimization mod for Fabric that improves tick performance, AI pathfinding, and world generation. Complements Starlight by optimizing different subsystems of the game.
Download Starlight (Fabric)
| Minecraft Version | Fabric |
|---|---|
| For Minecraft 1.20.4 | Download |
| For Minecraft 1.20.3 | Download |
| For Minecraft 1.20.2 | Download |
| For Minecraft 1.20.1 | Download |
| For Minecraft 1.20 | Download |
| For Minecraft 1.19.4 | Download |
| For Minecraft 1.19.3 | Download |
| For Minecraft 1.19.2 | Download |
| For Minecraft 1.19.1 | Download |
| For Minecraft 1.19 | Download |
| For Minecraft 1.18.2 | Download |
| For Minecraft 1.18.1 | Download |
Always download mods from official sources to stay safe.
Frequently Asked Questions
Is Starlight compatible with Sodium?
Yes — Starlight and Sodium work together without issues. Starlight optimizes the light engine while Sodium focuses on rendering, so they complement each other and can be installed side by side for maximum performance improvement.
Can I use Starlight 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 for your Fabric setup.
Do both the server and client need Starlight installed?
No — Starlight can be installed on just the server or just the client. Players using Vanilla, Phosphor, or Starlight on their client can connect to a Starlight server, and vice versa. This makes it easy to deploy on servers without requiring players to install anything extra.
Will Starlight be updated past Minecraft 1.20.4?
No — the standalone Starlight Fabric mod will not receive updates beyond 1.20.4. The developer has transitioned Starlight's technology into the Moonrise project, which continues development for newer Minecraft versions under a broader scope.
Does Starlight fix lighting glitches in caves and chunks?
Yes — Starlight addresses many of the persistent lighting errors found in vanilla Minecraft. Dark spots in caves, incorrectly lit chunks after world generation, and other visual glitches caused by the vanilla light engine's limitations are corrected by Starlight's complete rewrite of the lighting system.
