Fabric setup guide
Match the correct loader, game version, and mod file before testing.
Read the Fabric guideMinecraft Lighting Engine Guide
Starlight Mod: versions, setup and lighting-engine context.
A compatibility-first resource for the archived Starlight project, with practical guidance for Fabric and Forge users, safer installation checks, troubleshooting, and technical context for how the rewrite changes Minecraft lighting work.
Upstream: archived March 2024Fabric: official line through 1.20.4Forge: official line through 1.20.2
About / What Is
What Starlight actually changes
Starlight is a Minecraft Java Edition performance mod that replaces the vanilla light engine rather than layering a small optimization on top of it. The project was created for demanding chunk and lighting workloads, especially where light updates could become a server-side bottleneck.
The archived project documentation describes a light-section model tied directly to chunk data and designed to avoid separate persistent light-engine state. That architecture is one reason Starlight could simplify light handling around chunk load, unload and parallel work.
The original repository was archived on March 8, 2024. Public release listings show the historical Fabric line through Minecraft 1.20.4 and the Forge line through 1.20.2. Newer 1.21.x searches should therefore be treated as compatibility research, not proof of a new original release.
Features
What made the Starlight rewrite different
The important features are architectural rather than visual: light propagation, section management, chunk interaction and loader-specific compatibility.
ENGINE-01
Full light-engine rewrite
Starlight replaces major vanilla lighting paths instead of acting as a small patch, which is why version and mod compatibility matter so much.
DATA-02
Chunk-bound light sections
The project ties light sections to chunk-access data, reducing separate engine state that otherwise complicates chunk loading and unloading.
FLOW-03
Vanilla-like light result
The technical design aims for the same final lighting result as vanilla while changing how increases, decreases and section data are processed.
SCALE-04
Parallel-work friendliness
Its stateless approach was designed to make coordinated chunk generation and lighting easier to schedule in high-scale server systems.
LOAD-05
Fabric and Forge history
Official historical builds exist across both loaders, but their release ceilings differ and the files are never interchangeable.
DEPLOY-06
Client or server deployment
Supported builds can operate on client or server setups; however, exact behavior still depends on Minecraft version, loader and the rest of the mod stack.
How It Works
A safer compatibility-first workflow
Because Starlight changes low-level lighting behavior, installation should be treated as an environment-matching task before it is treated as a performance tweak.
Identify the exact Minecraft patch
Write down the complete version number. A 1.20.4 Fabric file is not a generic “1.20” file, and a 1.21 keyword does not imply availability.
Match the loader and release line
Fabric and Forge builds are separate. Use only a file explicitly built for the loader and game version in your profile.
Remove direct lighting-engine conflicts
The original project states that Phosphor is incompatible with Starlight. Also review mods that depend on or modify lighting internals.
Back up, launch and inspect logs
Test on a copied world first. Confirm loader resolution, look for mixin or dependency errors, then verify chunk and lighting behavior before regular play.
What happens internally
1Block or chunk changes create light-update work.
2Starlight processes propagation with its rewritten algorithms and section rules.
3Light data remains associated with available chunk sections rather than detached engine state.
4The target is a vanilla-equivalent final lighting result with different performance characteristics.
Compatibility
Version and loader reality check
Use release history to rule versions in or out before you install anything. The original project is archived, so “latest Starlight” depends on the loader and historical release line.
| Target | Status | Practical guidance |
|---|---|---|
| Fabric 1.20.4 | Official historical release | The public Fabric line reached Starlight 1.1.3 for Minecraft 1.20.4. |
| Forge 1.20.2 | Official historical release | The public Forge line reached Starlight 1.1.3 for Minecraft 1.20.2; its release notes specify Forge 48.0.33+. |
| 1.17.x–1.19.x | Historical builds | Both Fabric and Forge histories include releases in these generations. Match the exact file and patch version. |
| Minecraft 1.16.5 | Early project era | 1.16.5 appears in the project’s early issue and build history, but treat surviving files as legacy and test only with backups. |
| Minecraft 1.21.10 / 1.21.11 | No original release | The original Starlight mod line was discontinued; avoid assuming that unrelated projects or forks are the same software. |
| Phosphor + Starlight | Incompatible | Do not install both lighting-engine replacements in the same environment. |
Installation / Setup
Install with a controlled four-step checklist
1. BackupCopy your world and key configuration files.
2. MatchConfirm Minecraft patch version and mod loader.
3. PlaceAdd the compatible mod file to the mods folder.
4. TestLaunch, inspect logs, and test a copied world.
Use Cases
Where a lighting rewrite can matter most
01
Chunk-heavy servers
High player counts, world exploration and chunk generation can make lighting work part of a wider server tick or chunk pipeline bottleneck.
02
Frequent block updates
Large builds, redstone-heavy areas and repeated source changes create more opportunities for light propagation work than a static scene.
03
Legacy modded profiles
For supported historical versions, Starlight can still be relevant when a stable modpack is pinned to an older loader and exact Minecraft build.
Download
Download the provided Starlight source archive
This is the archived Fabric-branch source package from the original project. It is useful for source inspection and development context, but it is not a compiled mod JAR that can be dropped directly into a mods folder.
Download Starlight ModImportant: a source ZIP is not the same as a ready-to-drop mod JAR. Do not place a source archive in the mods folder and expect it to load.
Safety Notice
Back up first and avoid unsupported version claims.
Starlight changes low-level lighting behavior. Use only a version-and-loader match, keep a world backup, avoid direct lighting-mod conflicts, and treat unofficial “1.21.x Starlight” claims with caution because the original project is archived.
Pros and Cons
Practical trade-offs
Potential advantages
- Targets expensive lighting calculations
- Historical Fabric and Forge availability
- Can be useful in server and client contexts
- No extra blocks or gameplay systems added
Important limitations
- Original project is archived
- Incompatible with Phosphor
- Low-level rewrite can conflict with other mods
- No official original release for current 1.21.x keywords
Release Information
ARCHIVEDOriginal upstream status
Know what “latest” means here
The original repository was archived in March 2024 after the maintainer stopped publishing new standalone mod versions. Historical public listings show Fabric 1.20.4, Forge 1.20.2 and NeoForge 1.20.4 releases in the final 1.20-era line. The maintainer later directed server users toward Paper derivatives and Moonrise for newer server-side optimization work.
- Fabric history reaches Minecraft 1.20.4 in the original listing.
- Forge history reaches Minecraft 1.20.2; the final 1.20.2 Forge release notes require Forge 48.0.33+.
- Searches for 1.21.x should distinguish the archived original mod from unrelated forks, ports and modpacks that reuse the Starlight name.
Troubleshooting
Common setup problems
Loader says the mod is incompatible
Check that Fabric files are used only with Fabric and Forge files only with Forge, then verify the exact Minecraft patch version.
Game crashes during startup
Temporarily remove other lighting or rendering mods, review the crash log, and reintroduce mods one at a time.
World lighting looks wrong
Test a backup copy without Starlight and without other lighting mods to isolate whether the issue is a conflict or world-specific behavior.
A “1.21.x” file appears online
Do not assume it is an official Starlight release. The original project is archived; verify provenance before opening or running files.
Guides Preview
Focused Starlight Mod guides
Common errors
Resolve crashes, mismatched loaders, and lighting-mod conflicts methodically.
Read troubleshooting guide1.21.11 compatibility
Understand why this popular search does not map to an original official Starlight release.
Read compatibility guideFAQ
Starlight Mod questions
Exactly 20 software-specific answers, grouped into two documentation categories.
Starlight is a Minecraft Java Edition lighting-engine rewrite designed to improve light update behavior and reduce lighting-related performance cost on supported versions.
The original PaperMC/Starlight repository is archived and read-only. Historical Fabric and Forge builds remain relevant only for the Minecraft versions they were released for.
There is no official 1.21.11 release in the original archived Starlight project. Treat pages mentioning that version as compatibility guidance, not as confirmation of an official build.
The archived Starlight release line does not provide an official 1.21.10 build. Verify your exact Minecraft version and use only a matching, trusted release.
Starlight had historical builds for older Minecraft versions, including the 1.16 era. Match the mod file, loader, and Minecraft version exactly before launching.
Yes, historical Starlight releases were published for Fabric. The latest Fabric listing for the original project is tied to the 1.20.x generation rather than current 1.21.x releases.
Yes, historical Forge releases were also published. Forge and Fabric files are not interchangeable, so use the loader-specific build that matches your installation.
Supported Starlight builds can be used on dedicated servers, and the original project documentation states that installation does not have to be mirrored on both client and server in every setup.
No. The original project documentation states that Starlight and Phosphor are incompatible because both replace major lighting-engine behavior.
For a standard modded client or server, place the correct loader-compatible JAR in that installation’s mods folder, then launch with the matching mod loader profile.
It rewrites Minecraft lighting logic to reduce lighting bottlenecks and address certain lighting errors on versions supported by the project.
Not necessarily. Lighting improvements can help in workloads limited by light updates, chunk work, or server processing, but overall frame rate depends on hardware, world conditions, and the rest of the mod stack.
No. It is a performance-oriented lighting-engine modification rather than a content pack, texture pack, or block-expansion mod.
No. Searches for “Starlight Mod Among Us” can mix unrelated terms. This site covers the Minecraft lighting-engine project, not an Among Us modification.
Common causes include a loader mismatch, a wrong Minecraft version, another incompatible lighting mod, or a conflict with a mod that expects vanilla lighting behavior.
Yes. Backups are a sensible precaution before changing a mod set, especially when adding or removing low-level performance mods.
Confirm that the loader starts without a mod-resolution error, review the launcher or server log for successful mod loading, and test a copied world before relying on the setup.
Usually you can remove a performance mod by taking its file out of the mods folder, but test a backup first because mod combinations and version changes can produce unexpected behavior.
The original repository is archived and the published release listings stop in the 1.20.x generation. This site avoids presenting unsupported version keywords as official releases.
No. This is an independent informational website and is not affiliated with Starlight Mod or other third-party platforms.