Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

{{Plugin|Light Cleaner|Repair glitched lighting in your world|https://www.spigotmc.org/resources/light-cleaner.42469/|https://github.com/bergerhealer/Light-Cleaner}}

<div lang="en" dir="ltr" class="mw-content-ltr">
[[Special:MyLanguage/Main Page|« Go back]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''Light Cleaner''' regenerates the light levels of blocks in your Minecraft world. It can do so around the player or for an entire world. The Spigot page has command instructions and configuration overview information.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Commands==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The main command is <code>/cleanlight</code> with optionally some arguments
<pre>
/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 (can be run from command blocks)
</pre>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Repairing Singleplayer Worlds==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If you have an existing singleplayer Minecraft world you want to repair but you don't have a server, or you want to repair a world on a different server without impacting your main one, read on.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Step 1. Download Paper===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
To run Light Cleaner you do need a paper or spigot server. Download the version compatible with your World from https://papermc.io/downloads/all
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For modded minecraft hybrid servers exist like Arclight and Mohist that light cleaner can also work on, but setting these up with mods is more complicated and this section will not go into that.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Step 2. Installation===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Prepare a new folder on your Desktop or somewhere like your <code>c://</code> drive. In this tutorial I assume you created a folder at <code>c://light-cleaner/</code>. Adjust this based on your operating system. Ideally choose a folder whose path does not include spaces, but generally this should still work OK.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Next, copy the papermc.io jar you downloaded earlier into this folder.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Step 3. Copy your world===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Find where your world data is saved in your Minecraft client. Typically this is in <code>.minecraft/saves</code> located in <code>%appdata%</code> (windows), your user home folder or similar. Copy this save world folder to the root installation folder you created in Step 2.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Rename the folder to "world" so that the server will properly load it on startup.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Step 4. Install Plugins===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Create a "plugins" folder in the root server folder. Download [https://www.spigotmc.org/resources/light-cleaner.42469/ Light Cleaner] and [https://www.spigotmc.org/resources/bkcommonlib.39590/ BKCommonLib] jars and put them inside this folder.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You should now have this folder structure:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:Lightcleaner-setup-state.png|200px]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Step 5. Run the Server===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Make sure you already have a java runtime installed. If you just installed one, restart the PC once to make sure the environment updates.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Run the server once in a terminal window. On windows you do this by right-clicking into the server folder and opening a command prompt there. You might need to use <code>cd C://light-cleaner</code> to go to the right folder first. On linux this is probably easier.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Command (change the jar file name of the server to what you downloaded in step 1):
<pre>
java -jar paper-1.12.2-1620.jar
</pre>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
This will first fail and ask you to agree to the EULA. Open the newly generated <code>eula.txt</code> in Notepad or another text editor and change <code>eula=false</code> to <code>eula=true</code>. Then save.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Run the same command again to start the server for real. It will probably do some Bukkit world migrations here, and it will warn about that in the terminal window.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Step 6. Run Light Cleaner===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can connect to <code>localhost</code> to see your server and confirm it loaded the world. You'll have to run <code>op my_name</code> in the terminal window first to give you access to the plugin.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Then while in the world you want to repair, run:
<pre>
/cleanlight world
</pre>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can also do this from the terminal window without ever logging on, but it's a good idea to check the world was loaded correctly first.
<pre>
/cleanlight world world
</pre>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can periodically run <code>cleanlight status</code> in the terminal window to see how many chunks remain to be processed.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You might want to occasionally restart the server to avoid an out of memory situation. The process will resume automatically.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Step 8. Restructure===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Stop the server by entering the <code>stop</code> command, or ctrl+c keyboard shortcut to send a stop signal. Wait for it to exit.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Now the process is done you need to restructure the world folder to be like Vanilla Minecraft again. Use the terminal commands below. Or do it in your file explorer.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Windows====
<pre>
move ./world_nether/DIM-1 ./world/DIM-1
move ./world_the_end/DIM1 ./world/DIM1
rmdir /s /q ./world_nether
rmdir /s /q ./world_the_end
</pre>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Linux====
<pre>
mv ./world_nether/DIM-1 ./world/DIM-1
mv ./world_the_end/DIM1 ./world/DIM1
rm -rf ./world_nether
rm -rf ./world_the_end
</pre>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
And now it's done. You can rename the <code>world</code> folder back to the original save name and load it into Singleplayer Minecraft.
</div>

Export translations

Navigation menu

Search