CurseForge · Minecraft mod

Lumi Lighting Engine Optimizer

Improves world generation speed, reduces server lag, and fixes lag spikes on client by optimizing the Minecraft lighting engine. Based on Phosphor.

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

Quick answer

Which Lumi Lighting Engine Optimizer release should I use?

Updated 3 months ago

Latest stable file 1.2.2

Game version 1.7.10

Loader Forge

Lumi Lighting Engine Optimizer 1.2.2 targets 1.7.10 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 4 required mods have matching files.

Where it goes

Is Lumi Lighting Engine Optimizer 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 Forge

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.

Understand client and server requirements Read the Minecraft installation guide

What else does Lumi Lighting Engine Optimizer 1.2.2 need?

1.2.2. Change the file and its required mods may change too.

All 4 required mods have matching files

Install FalsePatternLib, UniMixins, ChunkAPI, FalsePatternLib first. We found matching files for this game-version and loader setup.

FalsePatternLib Needed by Lumi Lighting Engine Optimizer 1.2.2

required

Matching file found Matched file: 1.12.2

UniMixins Needed by Lumi Lighting Engine Optimizer 1.2.2

required

Matching file found Matched file: UniMixins 0.3.1

ChunkAPI Needed by Lumi Lighting Engine Optimizer 1.2.2

required

Matching file found Matched file: 0.8.4

FalsePatternLib Needed by Lumi Lighting Engine Optimizer 1.2.2

required

Matching file found Matched file: 1.12.2

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Lumi Lighting Engine Optimizer without breaking your instance.

Built for Lumi Lighting Engine Optimizer 1.2.2. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use 1.2.2. It targets 1.7.10 with Forge; another release may have different loader, side or dependency requirements.
02
Bring the mods it needs

Install FalsePatternLib, UniMixins, ChunkAPI, FalsePatternLib first. We found matching files for this game-version and loader setup.
03
Put it on the correct side

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

Use the “Get this file” button beside 1.2.2. It opens that exact file at the source.

About this project

What does Lumi Lighting Engine Optimizer add?

A full replacement of the Minecraft lighting engine with an extendable API, shipping with Phosphor as a reference implementation.

Join us on Discord

Dependencies

Performance

The main performance improvement comes from the fact that the lighting engine is evaluated "lazily", thus it is able to batch more lighting updates into a single pass.

Here are some simple to understand values, generated via profiling a pre-set test case:

World Type: Default
World Seed: 123
Game Mode: Creative
Render Distance: 16

Profiler is started right before clicking Create New World, and stopped after 10 seconds of flying in a straight line in creative mode.

Without Lumi, the active server time spent in lighting engine is 34% of the total active server time (not counting when the server thread is sleeping).

With Lumi, this fraction goes down to 13%, or an approximately 2.5x performance increase over vanilla.

Horizontal axis is time, vertical axis is the call stack. The blue highlighted parts are calls to the lighting engine update method.

Flame Graph Without Lumi

Flame Graph With Lumi

Incompatibilities

ArchaicFix: Config Change Needed
- As both mods replace the same parts of code, naturally you will need to set enablePhosphor to false in the ArchaicFix config.
CoreTweaks: Config Change Needed
- The fix_heightmap_range feature is already implemented in Lumi's lighting engine. Set it to false in the CoreTweaks config.

Both of these configs will be automatically modified by Lumi automatically when you launch the game, so you shouldn't even need to edit the config files manually.

Authors

Credits

embeddedt
- The initial port of Phosphor into 1.7.10
CaffeineMC
- Creating the original Phosphor

Project description from CurseForge.

Pick your setup