diff --git a/community/FixLighting.md b/community/FixLighting.md new file mode 100644 index 0000000..c1e34aa --- /dev/null +++ b/community/FixLighting.md @@ -0,0 +1,39 @@ +--- +layout: page +title: Fixing world lighting issues +parent: Community Guides +nav_order: 10 +--- + +# Fixing world lighting issues + +Sometimes, your map has some lighting issues... +For example, if it's a world that has been upgraded from a very old Minecraft version. +Or many Earth Maps also have this issue. They are usually not created in Minecraft itself, but rather by third party tools such as WorldPainter, which create minimal chunk data, so they often lack important components such as lighting information. + +Normally, you won't notice this, because the server automatically fixes lighting data when players load the chunks. +However, BlueMap directly reads chunk data from disk, instead of via the server. This is much more efficient and allows BlueMap to easily support many platforms, but also means the chunk data needs to be complete before BlueMap can read it properly. + +This is why it can be useful to run a tool to fix the data in these chunks first before we start rendering the map. +We recommend using Chunky since it is supported on most platforms that BlueMap runs on, but for Bukkit-based servers Light Cleaner is also an option. + +## Chunky Instructions +First make sure you have Chunky installed. You can download it at [modrinth.com/plugin/chunky](https://modrinth.com/plugin/chunky) +Now to fix lighting issues in the world, we will want to force re-loading of all of the chunks in the world. This can be done using the steps outlined below: +1. Open the config file for Chunky: `Chunky/config.yml` +2. Set the option `force-load-existing-chunks` to `true`, and save the file +3. Restart the server, or run `chunky reload` to reload the configuration file on the server +4. Set the world using `/chunky world ` +5. Set the radius using `/chunky radius 100000` (or large enough to cover the entire world) +6. Set the world pattern using `/chunky pattern world` which will specify re-loading only existing chunks in the world +7. Run `/chunky start` to start the loading process. This may take a long time, so patience is required. +8. Restart the server when this completes. This is important to make sure all fixed chunks have been saved properly. +9. Run `/bluemap purge ` to re-render your world, this time hopefully with fixed lighting! + +## Light Cleaner Instructions +First make sure you have Light Cleaner installed. You can download it at [spigotmc.org/resources/light-cleaner.42469/](https://www.spigotmc.org/resources/light-cleaner.42469/) +Now to fix lighting issues in the world, we will want to run the light cleaner: +1. Run `/cleanlight world earth` (or the name of the world if not named "earth") +2. Check `/cleanlight status` for progress. This may take a long time so patience is required. +3. Restart the server when this completes. This is important to make sure all fixed chunks have been saved properly. +4. Run `/bluemap purge ` to re-render your world, this time hopefully with fixed lighting! diff --git a/community/MCEarthMap.md b/community/MCEarthMap.md deleted file mode 100644 index 36eb9f2..0000000 --- a/community/MCEarthMap.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -layout: page -title: Pre-Configuration for Minecraft Earth maps -parent: Community Guides -nav_order: 10 ---- - -Before using Bluemap (or any map plugin) with Minecraft Earth maps, you need to do some pre-configuration. This is due to lighting and rendering issues with WorldPainter as a whole due to it depending on chunks being loaded. - -You'll need some plugins: [Chunky](https://www.spigotmc.org/resources/chunky.81534/), [ChunkyBorder](https://www.spigotmc.org/resources/chunkyborder.84278/), and [Light Cleaner](https://www.spigotmc.org/resources/light-cleaner.42469/). - -Make sure you've frozen and purged the map first (`/bluemap freeze ` to pause any automatic rendering, and `/bluemap purge ` to clean up old chunks) - -First off, **set the world border.** This will ensure that players cannot escape the earth map and helps with Chunky and Light Cleaner later. Open this link and follow the steps for your worldmap size: [docs.apocmc.us/minecraft-earth-map/map-borders](https://docs.apocmc.us/minecraft-earth-map/map-borders) -This will also prerender the map to remove some extra issues. Wait for it to finish before proceeding. - -Next, do `/cleanlight world `. This will clean up the bugged lighting on these maps, letting BlueMap properly render the map. Wait for it to finish (you can check with `/cleanlight status`, it's going to take a while). - -Now that preconfiguration is done, unfreeze the world with `/bluemap unfreeze `, and do `/bluemap update ` to start rendering the world again!