MINECRAFTHUB.IO
Java Mods

Starlight

Starlight rewrites Minecraft Java's light engine to fix lighting bugs and lag spikes, but PaperMC archived the project in 2023 at 1.20.4 (Fabric) and 1.20.2 (Forge).

By spottedleaf (PaperMC) via Modrinth.

MinecraftHub-generated editorial cover for the Starlight lighting engine mod
Section
Java Mods
Platform
Java
Checked
Updated
Versions
1.17, 1.18.2, 1.19.2, 1.20.1, 1.20.2, 1.20.4

What Starlight works with.

PlatformJava Edition
LoadersFabric, Forge
Minecraft versions1.17, 1.18.2, 1.19.2, 1.20.1, 1.20.2, 1.20.4
EnvironmentClient, Server

Starlight is a Minecraft Java mod that rewrites the vanilla light engine to fix lighting bugs and cut the lag spikes that come from block updates and chunk loading. PaperMC's spottedleaf built it for Fabric and, separately, for Forge, but both builds stopped receiving updates in late 2023. This page covers what Starlight changes, why development ended, and which Minecraft versions can still run it.

Why development on Starlight stopped

PaperMC archived the Starlight repository on GitHub in March 2024 and said it would not receive further updates for the foreseeable future. Starlight was originally built to solve a server-side problem: vanilla's light engine was too slow for large, high-population servers. Once that rewrite proved itself, its core approach was folded directly into Paper's own chunk system rewrite and into Folia, Paper's regionized multithreading fork. Current Paper and Fabric server software already carries the lighting fix Starlight introduced, which is why the standalone mod became unnecessary and PaperMC stopped maintaining a separate version to keep up with new releases.

Which Minecraft versions Starlight still supports

  • Fabric build: reaches 1.20.4, last published December 10, 2023.
  • Forge build (separate Modrinth listing, starlight-forge): reaches 1.20.2, last published October 27, 2023.
  • Neither build has a Quilt or NeoForge release.
  • Neither build is compatible with or needed on current 26.x Minecraft versions.

Installing Starlight on Fabric or Forge

  1. 1.Confirm the target game version is 1.20.4 or earlier (Fabric) or 1.20.2 or earlier (Forge).
  2. 2.Install Fabric Loader or Forge for that exact game version.
  3. 3.Download the matching Starlight build from the Fabric or Forge Modrinth listing and drop the jar into the mods folder.
  4. 4.Starlight has no dependencies, so no extra library mod is required.
  5. 5.Apply it on both the client and server for a dedicated server, or client-only for singleplayer.

What Starlight changes in-game

Starlight replaces vanilla's light engine end to end rather than patching around it. The rewrite removes the stutter that comes from breaking or placing light-emitting blocks, speeds up chunk loading in already-lit areas, and fixes long-standing lighting errors such as dark patches and incorrect skylight near chunk borders. The mod's own benchmarks, run on a flat test world, show it resolving light updates for a single block change many times faster than vanilla. On a busy multiplayer server that difference is measurable during heavy building or redstone activity; on a normal singleplayer world the correctness fixes matter more than the raw speed gain.

Questions about Starlight.

5 questions

Is the Starlight mod still maintained?

No. PaperMC archived Starlight on GitHub in March 2024 and has said it will not receive further updates. The Fabric build last published on December 10, 2023, and the separate Forge build last published on October 27, 2023.

Does Starlight work on the current Minecraft version?

No. The Fabric build tops out at 1.20.4 and the Forge build tops out at 1.20.2. Neither loader received a build for any release after that, so Starlight is not installable on current 26.x Minecraft versions.

Do I still need Starlight if I run Paper or Fabric server software?

No. Starlight's lighting rewrite is the reason its developer stopped updating the standalone mod: the same light-engine improvements were folded into Paper's own chunk system and into Folia, so current server software already gets the fix without installing anything extra.

What is the difference between Starlight and the Starlight (Forge) listing?

They are two separate Modrinth projects built from the same GitHub repository by the PaperMC organization, one per loader. The Fabric listing reached 1.20.4 and the Forge listing stopped one version earlier at 1.20.2, both in late 2023.

Does Starlight require Fabric API or any other dependency?

No. Every published version of both the Fabric and Forge builds lists zero dependencies, so Starlight installs on its own as a standalone light engine replacement.

More Java Mods like Starlight.

Guides for Java Mods.

Browse all Minecraft Java mods