Light Cleaner 1.14.4-v1

Regenerates light levels in your world, fixing bugged lighting such as black cliffs

  1. TeamBergerhealer
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    Source Code:
    Requires BKCommonLib for the low-level API's. (please use 1.13.1-v4 or later)

    Join our discord for plugin help

    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.

    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.

    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
    The following permissions apply:
    Code (Text):
    Allows the player to regenerate lighting (around him)

    Allows the player to also specify a chunk area to clean

    Allows the player to regenerate for entire worlds (that's a lot of chunks!)

    Allows the player to abort all lighting operations

    Allows the player to check up on the status
    To turn on automatic cleaning of newly generated chunks, set the following in the config.yml:
    Code (Text):

    autoCleanEnabled: true
    Unfixable lighting glitches
    Minecraft completely deletes chunk slices (16x16x16 blocks) when all blocks in it are air. As a result, no lighting information can be stored in there. Blocks that touch these 'no-light' zones show up as very dark lighting sometimes. This is a Minecraft bug that can't easily be fixed. You can work around it by moving the surface touching this empty slice by one block, or by placing a block in the empty slice so it is no longer empty. A single barrier block can make minecraft see it as non-empty, allowing light to be saved.

    This is primarily a problem in nether worlds where empty slices default to a dark color, instead of light like in overworlds.

    • This plugin is a continuation of "NoLagg Lighting", a component held back by issues that stall the main plugin from release.
    • Care has been 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.

    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! :)

    AmWalky, Tackleza, RedYoshi and 16 others like this.

Recent Reviews

  1. Arcanum
    Version: 1.14.4-v1
    First I got an error but the Developer helped me within 2 minutes to fix this problem, amazing support! Now i'm going to fix the light :D
  2. priceless0
    Version: 1.14.4-v1
    dont use!
    no folder created after reload. bkcommonlib was installed.
    Both plugins showup red, multiple errors in console. finally entire server crashed by the plugin.
    1. TeamBergerhealer
      Author's Response
      Can you send me a private message with the errors you see in the console?
  3. grizzlymc
    Version: 1.14.4-v1
    05.10 07:55:20 [Server] ERROR Could not load 'plugins/LightCleaner-1.14.4-v1.jar' in folder 'plugins'

    the plugin won't produce folder and it's not showing up in command either...
    console error message showed up.. please fix this for paper 1.14.4
    1. TeamBergerhealer
      Author's Response
  4. SharpGamer
    Version: 1.14.4-v1
    This plugin works just as told. It's a huge need for any bigger servers.

  5. Azen0x
    Version: 1.14.4-v1
    This plugin fix torch lights in 1.14 ! THANK YOU <3

    this message needs 80 characters
  6. NomadMC
    Version: 1.14.4-v1
    Excellent plugin, does exactly what it says on the tin.
    Lighting broke by new chunk rendering? Fixes it.
    Lighting broke by WorldEdit / FAWE? Fixes it.
    Lighting broke by weird lighting glitches? Fixes it, unless the glitch is your fault.
    What's more, this plugin doesn't just fix bad lighting; it can also just help with making existing shadows smoother. If you're working on a map with a lot of height differences between sections or buildings, for example, I highly recommend using this plugin's commands frequently to keep stuff nice and smoothed out.
  7. superboy9
    Version: 1.13.1-v1
    Never seen such that useful plugin in my life :D
  8. MMCraftin
    Version: 1.13.1-v1
    Absolutely Amazing plugin. My world edit messed up a bunch of lighting and this is the ONLY thing that works for 1.13 great plugin 5 stars.
  9. MLGWafflIron
    Version: 1.13.1-v1
    It works. I have nothing else to say. Does spigot really expect me to write a 100 word review for a plugin that only does one thing?
  10. MajorLOLGaming
    Version: 1.13.1-v1
    Idk how it works, but it does. But please update to 1.14.2, since thats the only 1.14 version thats actually somewhat playable