Lumi Lighting Engine Optimizer

Lumi is a complete replacement for Minecraft's original lighting system, equipped with an expandable API. As a base implementation, it uses an enhanced version of Phosphor.

Required Dependencies

For Lumi to work correctly, the following libraries are required:

• ChunkAPI version 0.5.0 or newer
• FalsePatternLib version 1.2.0 or newer
• UniMixins version 0.1.11 or newer

Performance and Optimization

Lumi's primary advantage lies in using a "lazy" approach to lighting calculations. This allows processing multiple lighting updates in a single pass, significantly improving work efficiency.

Test Results

For clear performance demonstration, a special test was conducted:

• World Type: Standard
• World Seed: 123
• Game Mode: Creative
• Render Distance: 16 chunks

Profiling started when creating a new world and continued for 10 seconds of straight flight in creative mode.

Testing Results:

Without Lumi: server time spent on lighting calculations is 34% of total working time (excluding server thread idle periods).

With Lumi: this portion decreases to 13%, providing approximately 2.5-fold performance improvement compared to the standard game.

Performance Visualization

Additional graphs visualize the performance difference:

All blue-highlighted area corresponds to standard lighting engine operation time

Blue areas significantly reduced thanks to Lumi's optimization

Compatibility and Configuration

During installation, conflicts may occur with the following modifications:

ArchaicFix: to resolve conflicts, set the enablePhosphor parameter to false in ArchaicFix configuration. Both modifications replace the same code sections, requiring appropriate settings adjustment.

CoreTweaks: the fix_heightmap_range option is already implemented in Lumi. It's recommended to disable this function in CoreTweaks settings by setting the value to false.

Important: In all the above cases, Lumi will automatically make necessary changes to configuration files when launching the game. Manual configuration editing is usually not required.

Project Authors

• FalsePattern
• Ven

Acknowledgements and Original Sources

We express gratitude to developers whose work formed the basis of Lumi:

embeddedt - for initial adaptation of Phosphor for Minecraft version 1.7.10

CaffeineMC - for creating the original Phosphor version