ModsJava
Light Cleaner
Java mod listed for Minecraft 1.8–1.19. Downloads from the MC Java Mods app on Android.
⬇ Download on SpigotRequires BKCommonLib for the low-level API's
Join our discord for plugin help https://discord.gg/wvU2rFgSnw
Light cleaner is a simple plugin fulfilling a very powerful task: regenerating lighting. It does so running on a dedicated thread, using it's own optimized methods to minimize performance loss for the server. By operating on raw data it is easily capable of chomping through 200 chunks a second!
As of 1.12-v2, it is now also possible to let the plugin automatically clean up light for newly generated chunks. This way there is no need to use the commands while players explore new areas of the world.
Motivation
A bug that has haunted minecraft forever is the infamous dark lighting found all over the place when chunks are generated. You'll find them in caves, against canyon walls, in the nether and even underground! All of this buggy-looking light ruins the aesthetics that makes Minecraft nature beautiful. Worse, the constant client-side fixing of this lighting drags client-side performance down, especially in the nether or extreme biomes.
No more! With a simple command this plugin will eagerly chomp away at millions of blocks, recalculating their light levels completely from scratch. It uses vanilla Minecraft block information for this, which means it will look just as intended.
Another use is repairing light levels after plugins alter blocks in "fast" ways, such as WorldEdit. If blocks are altered while executing the slow server light regeneration function, it would take ages to change blocks. This plugin offers best of both worlds, allowing repairs after the fact.
By utilizing a powerful algorithm combined with smart caching it is capable of regenerating this lighting much faster and more accurately. Lighting can be repaired for all the chunks in your view, or for all the chunks of a world. The main server thread is not stalled while doing these calculations.
Commands
This plugin offers the following commands:
Permissions
Configuration
To turn on automatic cleaning of newly generated chunks, set the following in the config.yml:
To turn on automatic cleaning after players perform WorldEdit/
FastAsyncWorldEdit operations, set the following in the config.yml:
When remaining available memory (in MB) on the server drops too low, light cleaner will pause and save worlds to reduce memory until it can continue. If you run into out of memory problems, raise this value. If you feel it stalls for too long, lower it.
When processing the plugin has to load large areas of chunks as fast as possible. With high concurrency it will queue a lot of chunks for loading at the same time, while with low it may wait a longer time. If you find the plugin affecting server performance too much, lower this value.
If you have worlds that aren't persistently saved to disk, you may want to disable saving on these worlds. This also prevents the plugin from continueing lighting operations when the server is restarted.
FAWE
FastAsyncWorldEdit has had some issues with glitched lighting after making changes to the world. You can turn on automatic cleaning after performing changes using FAWE in the config.yml. Please make sure to also disable the builtin cleaning in FAWE's config.yml if you do (mode: 0)!
Notes
Donate
If you really like my work and want to give something in return, feel free to donate something small to me using the link down below. Thank you!
![[IMG]](//proxy.spigotmc.org/3b1c47e37c25be91c1d8806db63fe17814d9df7f/68747470733a2f2f7777772e70617970616c6f626a656374732e636f6d2f656e5f55532f692f62746e2f62746e5f646f6e6174655f4c472e676966)
Join our discord for plugin help https://discord.gg/wvU2rFgSnw
Light cleaner is a simple plugin fulfilling a very powerful task: regenerating lighting. It does so running on a dedicated thread, using it's own optimized methods to minimize performance loss for the server. By operating on raw data it is easily capable of chomping through 200 chunks a second!
As of 1.12-v2, it is now also possible to let the plugin automatically clean up light for newly generated chunks. This way there is no need to use the commands while players explore new areas of the world.
Motivation
A bug that has haunted minecraft forever is the infamous dark lighting found all over the place when chunks are generated. You'll find them in caves, against canyon walls, in the nether and even underground! All of this buggy-looking light ruins the aesthetics that makes Minecraft nature beautiful. Worse, the constant client-side fixing of this lighting drags client-side performance down, especially in the nether or extreme biomes.
No more! With a simple command this plugin will eagerly chomp away at millions of blocks, recalculating their light levels completely from scratch. It uses vanilla Minecraft block information for this, which means it will look just as intended.
Another use is repairing light levels after plugins alter blocks in "fast" ways, such as WorldEdit. If blocks are altered while executing the slow server light regeneration function, it would take ages to change blocks. This plugin offers best of both worlds, allowing repairs after the fact.
By utilizing a powerful algorithm combined with smart caching it is capable of regenerating this lighting much faster and more accurately. Lighting can be repaired for all the chunks in your view, or for all the chunks of a world. The main server thread is not stalled while doing these calculations.
Commands
This plugin offers the following commands:
Code (Text):
/cleanlight - regenerate lighting for all chunks you can see
/cleanlight 12 - regenerate lighting 25x25 chunks around you
/cleanlight world - regenerate lighting in the current world
/cleanlight world world1 - regenerate lighting for world1
/cleanlight abort - cancels any ongoing lighting operations
/cleanlight status - checks up on the status of the repairs
/cleanlight at [chunk_x] [chunk_z] [chunk_radius] (world) - regenerate lighting remotely (command blocks)
/cleanlight 12 - regenerate lighting 25x25 chunks around you
/cleanlight world - regenerate lighting in the current world
/cleanlight world world1 - regenerate lighting for world1
/cleanlight abort - cancels any ongoing lighting operations
/cleanlight status - checks up on the status of the repairs
/cleanlight at [chunk_x] [chunk_z] [chunk_radius] (world) - regenerate lighting remotely (command blocks)
Code (Text):
Allows the player to regenerate lighting within player view radius
lightcleaner.clean.view
Allows the player to clean at any radius, even beyond view radius
lightcleaner.clean.any
Allows the player to regenerate for entire worlds (that's a lot of chunks!)
lightcleaner.clean.world
Allows the player to only clean an area of a specific radius or less.
For example, radius 5 allows command /cleanlight 5 and /cleanlight 4, but not /cleanlight 6.
lightcleaner.clean.radius.[radius]
lightcleaner.clean.radius.5
Allows the player to abort all lighting operations
lightcleaner.abort
Allows the player to check up on the status
lightcleaner.status
lightcleaner.clean.view
Allows the player to clean at any radius, even beyond view radius
lightcleaner.clean.any
Allows the player to regenerate for entire worlds (that's a lot of chunks!)
lightcleaner.clean.world
Allows the player to only clean an area of a specific radius or less.
For example, radius 5 allows command /cleanlight 5 and /cleanlight 4, but not /cleanlight 6.
lightcleaner.clean.radius.[radius]
lightcleaner.clean.radius.5
Allows the player to abort all lighting operations
lightcleaner.abort
Allows the player to check up on the status
lightcleaner.status
To turn on automatic cleaning of newly generated chunks, set the following in the config.yml:
Code (Text):
autoCleanEnabled: true
Code (Text):
autoCleanWorldEditEnabled: true
Code (Text):
minFreeMemory: 400
Code (Text):
asyncLoadConcurrency: 50
Code (Text):
unsavedWorldNames:
- worldname1
- worldname1
FastAsyncWorldEdit has had some issues with glitched lighting after making changes to the world. You can turn on automatic cleaning after performing changes using FAWE in the config.yml. Please make sure to also disable the builtin cleaning in FAWE's config.yml if you do (mode: 0)!
Code (Text):
lighting:
# If packet sending should be delayed until relight is finished
delay-packet-sending: true
async: true
# The relighting mode to use:
# - 0 = None (Do no relighting)
# - 1 = Optimal (Relight changed light sources and changed blocks)
# - 2 = All (Slowly relight every blocks)
mode: 0
# If existing lighting should be removed before relighting
remove-first: false
# If packet sending should be delayed until relight is finished
delay-packet-sending: true
async: true
# The relighting mode to use:
# - 0 = None (Do no relighting)
# - 1 = Optimal (Relight changed light sources and changed blocks)
# - 2 = All (Slowly relight every blocks)
mode: 0
# If existing lighting should be removed before relighting
remove-first: false
- This plugin requires BKCommonLib to be installed
- This plugin is a continuation of "NoLagg Lighting", a component held back by issues that stall the main plugin from release.
- Care was taken to not write any block information to the chunks. This is to prevent catastrophic losses of world data. Only light levels are updated.
- Repairing worlds does incur a potential tick rate drop while loading and saving chunks from/to disk. This tick rate drop is minimized by limiting the amount of chunks loaded at once.
- Do not enable the automatic cleaning function if your server is Minecraft version 1.14 or newer. Not only is it no longer required, it will cause endless chunks to be generated well past your world border. This is because the server generates 3-deep neighbouring chunks in the background for every chunk that is loaded.
Donate
If you really like my work and want to give something in return, feel free to donate something small to me using the link down below. Thank you!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Light Cleaner is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 51,793 times (via Spigot). Download it and open it directly in the game.