Back to mods
LightStar project artwork

CurseForge · Minecraft mod

LightStar

lighting calculations are twice as fast, chunk building is 49% faster, exploration is smoother, and stuttering is significantly reduced.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which LightStar release should I use?

Updated yesterday
Latest stable file lightstar-1.1.0.jar
Game version 1.21.1
Loader NeoForge

lightstar-1.1.0.jar targets 1.21.1 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.

Where it goes

Is LightStar required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does lightstar-1.1.0.jar need?

lightstar-1.1.0.jar. Change the file and its required mods may change too.

All 1 required mods have matching files

Install Embeddium first. We found matching files for this game-version and loader setup. 2 come through another mod in the chain.

2 listed on this file 2 pulled in by those mods
Embeddium Needed by lightstar-1.1.0.jar
required
Matching file found Matched file: [1.21.1] Embeddium 1.0.15
Sodium/Embeddium Dynamic Lights Optional for lightstar-1.1.0.jar
optional
Matching file found Matched file: SodiumDynamicLights Neoforge 1.0.10 for 1.21.1
Sodium/Embeddium Options API Needed by Sodium/Embeddium Dynamic Lights
pulled in
Matching file found Matched file: SodiumOptionsAPI Neoforge 1.0.10 for 1.21.1
Sodium Needed by Sodium/Embeddium Dynamic Lights
pulled in
Matching file found Matched file: Sodium 0.8.13 for NeoForge 1.21.1

2 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add LightStar without breaking your instance.

Built for lightstar-1.1.0.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use lightstar-1.1.0.jar. It targets 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Embeddium first. We found matching files for this game-version and loader setup. 2 come through another mod in the chain.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside lightstar-1.1.0.jar. It opens that exact file at the source.

About this project

What does LightStar add?

📖 Overview

This is a client-side lighting computation optimization mod that reduces CPU overhead during chunk loading, camera rotation, and large-scale block changes by caching lighting query results, optimizing data read paths during chunk building, and integrating with Sodium Dynamic Lights to eliminate redundant computations.

In simple terms: lighting calculations are twice as fast, chunk building is 49% faster, exploration is smoother, and stuttering is significantly reduced.


✨ Key Results

Based on 120-second Spark A/B tests, with the only variable being the presence of LightStar:

Metric Without Lightstar With Lightstar Improvement
Total lighting computation time Baseline -52.5% 2x faster
Lighting processing throughput 1.0x 2.1x +110.5%
Embeddium chunk building throughput 1.0x 1.49x +49%
Dynamic light query time 82.3 s 0.05 s -99.94%

Results are equally weighted averages from two test groups (shaders on/off).

Test Configuration: AMD Ryzen 9 9950X3D + NVIDIA RTX 4080 Super OC. In practice, lower-end and mid-range configurations will experience even more noticeable improvements.


🎯 Expected Benefits

  • Reduces redundant lighting queries, coordinate conversions, and array cleanup during Embeddium's async chunk building.
  • Reduces hash lookups and array accesses when sampling the same position repeatedly.
  • Reuses static lighting results from identical immutable chunk snapshots, lowering the cost of repeated chunk builds.
  • Prevents blocks that do not support Forge's external face culling from entering the neighbor face culling query.
  • When Sodium Dynamic Lights is installed, reduces redundant traversal, read-write lock contention, and thread-local state overhead during dynamic light queries.

⚙️ Implementation Details

Lighting Caching

Uses a 4-way set-associative thread-local primitive cache to store recent lighting values, with an additional single-entry fast path for the most recently accessed location. Lighting updates advance a numeric generation counter, immediately invalidating old results. DataLayer nibble reads use direct indexing and bitwise operations to reduce helper method calls and multiplication on the hot path.

Embeddium Chunk Building

  • Reads block light and sky light in a single pass, eliminating a second section lookup for the same coordinates.
  • Block light is fixed in the lower 4 bits and sky light in the upper 4 bits, removing dependency on enum ordering.
  • Uses a 16-bit generation array instead of zeroing out all 8000 cache slots for each build task.
  • Assigns a numeric revision to cloned immutable sections; cross-task caching is reused only when the world, origin, and all section revisions match.
  • Cross-task cache uses access-order eviction and is cleared on world login/logout.

Sodium Dynamic Lights Integration

  • Dynamic light query state and a 4096-entry 4-way set-associative cache are directly owned by the ArrayLightDataCache instance, eliminating ThreadLocalMap lookups.
  • At the start of each build task, a snapshot of dynamic light source references is copied under the SDL read lock. Queries within the task iterate directly over this snapshot, avoiding ReentrantReadWriteLock acquisition per sample.
  • Light source updates advance a generation counter; moving light sources never write to persistent caches or leave static afterimages.
  • Non-chunk-building paths retain full SDL fallback behavior for compatibility.

⚠️ Incompatibilities

  • Starlight — Not compatible.
  • Sodium/Embeddium Options API — Not compatible. This mod serves no meaningful purpose and is not a required dependency for Sodium Dynamic Lights.

Project description from CurseForge.

Pick your setup

LightStar by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

2 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

LightStar versions and loaders

3 of 3 releases match

Looking for an older file? The official CurseForge project page is in Resources.