Light-Cleaner - Revision history

RyanDo at 09:37, 12 October 2025

2025-10-12T09:37:04Z

← Older revision		Revision as of 09:37, 12 October 2025
Line 4:		Line 4:
	{{Plugin\|Light Cleaner\|Repair glitched lighting in your world\|https://www.spigotmc.org/resources/light-cleaner.42469/\|https://github.com/bergerhealer/Light-Cleaner}}		{{Plugin\|Light Cleaner\|Repair glitched lighting in your world\|https://www.spigotmc.org/resources/light-cleaner.42469/\|https://github.com/bergerhealer/Light-Cleaner}}
	<translate>		<translate>

	<!--T:2-->		<!--T:2-->
	'''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.		'''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.

RyanDo at 09:31, 12 October 2025

2025-10-12T09:31:53Z

← Older revision		Revision as of 09:31, 12 October 2025
Line 4:		Line 4:
	{{Plugin\|Light Cleaner\|Repair glitched lighting in your world\|https://www.spigotmc.org/resources/light-cleaner.42469/\|https://github.com/bergerhealer/Light-Cleaner}}		{{Plugin\|Light Cleaner\|Repair glitched lighting in your world\|https://www.spigotmc.org/resources/light-cleaner.42469/\|https://github.com/bergerhealer/Light-Cleaner}}
	<translate>		<translate>

	~~<!--T:1-->~~
	~~[[Special:MyLanguage/Main Page\|« Go back]]~~

	<!--T:2-->		<!--T:2-->

Bergerkiller: Marked this version for translation

2025-05-27T07:22:40Z

Marked this version for translation

Show changes

Bergerkiller at 07:22, 27 May 2025

2025-05-27T07:22:34Z

← Older revision		Revision as of 07:22, 27 May 2025
Line 8:		Line 8:

	'''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.		'''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.


	==Commands==		==Commands==
Line 22:		Line 21:
	/cleanlight at [chunk_x] [chunk_z] [chunk_radius] (world) - regenerate lighting remotely (can be run from command blocks)		/cleanlight at [chunk_x] [chunk_z] [chunk_radius] (world) - regenerate lighting remotely (can be run from command blocks)
	</pre>		</pre>


	==Repairing Singleplayer Worlds==		==Repairing Singleplayer Worlds==
Line 34:		Line 32:

	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.		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.


	===Step 2. Installation===		===Step 2. Installation===
Line 41:		Line 38:

	Next, copy the papermc.io jar you downloaded earlier into this folder.		Next, copy the papermc.io jar you downloaded earlier into this folder.


	===Step 3. Copy your world===		===Step 3. Copy your world===
Line 48:		Line 44:

	Rename the folder to "world" so that the server will properly load it on startup.		Rename the folder to "world" so that the server will properly load it on startup.


	===Step 4. Install Plugins===		===Step 4. Install Plugins===
Line 57:		Line 52:

	[[File:Lightcleaner-setup-state.png\|200px]]		[[File:Lightcleaner-setup-state.png\|200px]]



Line 74:		Line 68:

	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.		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.


	===Step 6. Run Light Cleaner===		===Step 6. Run Light Cleaner===
Line 89:		Line 82:
	/cleanlight world world		/cleanlight world world
	</pre>		</pre>


	===Step 7. Wait===		===Step 7. Wait===
Line 96:		Line 88:

	You might want to occasionally restart the server to avoid an out of memory situation. The process will resume automatically.		You might want to occasionally restart the server to avoid an out of memory situation. The process will resume automatically.


	===Step 8. Restructure===		===Step 8. Restructure===
Line 103:		Line 94:

	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.		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.


	====Windows====		====Windows====

	<pre>		<pre>
	move ./world_nether/DIM-1 ./world/DIM-1		move ./world_nether/DIM-1 ./world/DIM-1
Line 113:		Line 102:
	rmdir /s /q ./world_the_end		rmdir /s /q ./world_the_end
	</pre>		</pre>


	====Linux====		====Linux====

	<pre>		<pre>
	mv ./world_nether/DIM-1 ./world/DIM-1		mv ./world_nether/DIM-1 ./world/DIM-1

Bergerkiller: Prepared the page for translation

2025-05-27T07:22:03Z

Prepared the page for translation

← Older revision		Revision as of 07:22, 27 May 2025
Line 1:		Line 1:
			<languages/>
			<translate>
			</translate>
	{{Plugin\|Light Cleaner\|Repair glitched lighting in your world\|https://www.spigotmc.org/resources/light-cleaner.42469/\|https://github.com/bergerhealer/Light-Cleaner}}		{{Plugin\|Light Cleaner\|Repair glitched lighting in your world\|https://www.spigotmc.org/resources/light-cleaner.42469/\|https://github.com/bergerhealer/Light-Cleaner}}
			<translate>

	[[Special:MyLanguage/Main Page\|« Go back]]		[[Special:MyLanguage/Main Page\|« Go back]]

	'''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.		'''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.


	==Commands==		==Commands==

	The main command is <code>/cleanlight</code> with optionally some arguments		The main command is <code>/cleanlight</code> with optionally some arguments
	<pre>		<pre>
Line 16:		Line 22:
	/cleanlight at [chunk_x] [chunk_z] [chunk_radius] (world) - regenerate lighting remotely (can be run from command blocks)		/cleanlight at [chunk_x] [chunk_z] [chunk_radius] (world) - regenerate lighting remotely (can be run from command blocks)
	</pre>		</pre>


	==Repairing Singleplayer Worlds==		==Repairing Singleplayer Worlds==

	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.		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.


	===Step 1. Download Paper===		===Step 1. Download Paper===

	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		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

	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.		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.


	===Step 2. Installation===		===Step 2. Installation===

	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.		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.

	Next, copy the papermc.io jar you downloaded earlier into this folder.		Next, copy the papermc.io jar you downloaded earlier into this folder.


	===Step 3. Copy your world===		===Step 3. Copy your world===

	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.		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.

	Rename the folder to "world" so that the server will properly load it on startup.		Rename the folder to "world" so that the server will properly load it on startup.


	===Step 4. Install Plugins===		===Step 4. Install Plugins===

	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.		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.

Line 41:		Line 57:

	[[File:Lightcleaner-setup-state.png\|200px]]		[[File:Lightcleaner-setup-state.png\|200px]]



	===Step 5. Run the Server===		===Step 5. Run the Server===

	Make sure you already have a java runtime installed. If you just installed one, restart the PC once to make sure the environment updates.		Make sure you already have a java runtime installed. If you just installed one, restart the PC once to make sure the environment updates.

Line 56:		Line 74:

	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.		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.


	===Step 6. Run Light Cleaner===		===Step 6. Run Light Cleaner===

	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.		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.

Line 69:		Line 89:
	/cleanlight world world		/cleanlight world world
	</pre>		</pre>


	===Step 7. Wait===		===Step 7. Wait===

	You can periodically run <code>cleanlight status</code> in the terminal window to see how many chunks remain to be processed.		You can periodically run <code>cleanlight status</code> in the terminal window to see how many chunks remain to be processed.

	You might want to occasionally restart the server to avoid an out of memory situation. The process will resume automatically.		You might want to occasionally restart the server to avoid an out of memory situation. The process will resume automatically.


	===Step 8. Restructure===		===Step 8. Restructure===

	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.		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.

	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.		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.


	====Windows====		====Windows====

	<pre>		<pre>
	move ./world_nether/DIM-1 ./world/DIM-1		move ./world_nether/DIM-1 ./world/DIM-1
Line 87:		Line 113:
	rmdir /s /q ./world_the_end		rmdir /s /q ./world_the_end
	</pre>		</pre>


	====Linux====		====Linux====

	<pre>		<pre>
	mv ./world_nether/DIM-1 ./world/DIM-1		mv ./world_nether/DIM-1 ./world/DIM-1
Line 97:		Line 125:

	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.		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.
			</translate>

Bergerkiller: /* Step 5. Run the Server */

2025-05-06T16:57:20Z

Step 5. Run the Server

← Older revision		Revision as of 16:57, 6 May 2025
Line 53:		Line 53:
	</pre>		</pre>

	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>.		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.

	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.		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.

Bergerkiller: /* Step 5. Run the Server */

2025-05-06T16:56:55Z

Step 5. Run the Server

← Older revision		Revision as of 16:56, 6 May 2025
Line 46:		Line 46:
	Make sure you already have a java runtime installed. If you just installed one, restart the PC once to make sure the environment updates.		Make sure you already have a java runtime installed. If you just installed one, restart the PC once to make sure the environment updates.

	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 `cd C://light-cleaner` to go to the right folder first. On linux this is probably easier.		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.

	Command (change the jar file name of the server to what you downloaded in step 1):		Command (change the jar file name of the server to what you downloaded in step 1):

Bergerkiller: /* Step 5. Run the Server */

2025-05-06T16:56:38Z

Step 5. Run the Server

← Older revision		Revision as of 16:56, 6 May 2025
Line 44:		Line 44:

	===Step 5. Run the Server===		===Step 5. Run the Server===
	Make sure you already have a java ~~JDK~~ installed. If you just installed one, restart the PC once to make sure the environment updates.		Make sure you already have a java runtime installed. If you just installed one, restart the PC once to make sure the environment updates.

	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 `cd C://light-cleaner` to go to the right folder first. On linux this is probably easier.		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 `cd C://light-cleaner` to go to the right folder first. On linux this is probably easier.

Bergerkiller: /* Step 8. Restructure */

2025-05-06T16:55:14Z

Step 8. Restructure

← Older revision		Revision as of 16:55, 6 May 2025
Line 76:		Line 76:

	===Step 8. Restructure===		===Step 8. Restructure===
			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.

	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.		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.

Bergerkiller at 16:54, 6 May 2025

2025-05-06T16:54:09Z

← Older revision		Revision as of 16:54, 6 May 2025
Line 93:		Line 93:
	rm -rf ./world_the_end		rm -rf ./world_the_end
	</pre>		</pre>

			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.