Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update and rename MCEarthMap.md to FixLighting.md #61

Merged
merged 9 commits into from
Mar 1, 2024
33 changes: 33 additions & 0 deletions community/FixEarthLighting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
layout: page
title: Fixing lighting issues with Chunky
TechnicJelle marked this conversation as resolved.
Show resolved Hide resolved
parent: Community Guides
nav_order: 10
---

TechnicJelle marked this conversation as resolved.
Show resolved Hide resolved
Earth maps are usually created using third party tools such as WorldPainter, which create minimal chunk data, often missing important components such as lighting information.
Normally, you won't notice this, because the server will automatically fix lighting data when players load the chunks.
However, BlueMap directly reads chunk data from disk. 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.
But due to this, the server doesn't fix a chunk's lighting data before BlueMap renders it. This is why we need to use a tool like Chunky to fix them!
TechnicJelle marked this conversation as resolved.
Show resolved Hide resolved

So, firstly, make sure you have Chunky installed. You can download it here: [modrinth.com/chunky](https://modrinth.com/plugin/chunky)

Now, to fix the lighting issues in your world:
1. Shut down your server
2. Open Chunky's config file: `Chunky/config.yml`
3. Set `force-load-existing-chunks:` to `true`, and save and close the file
4. Start your server back up again
5. Run this command: `/chunky radius 1000k`
- Or use an even bigger number. Just make sure that your whole world is enveloped by this.
- This sets Chunky to (re)generate a million radius (But don't worry! It won't _actually_ do that, due to the next step!)
6. Run this command: `/chunky pattern world`
- This sets Chunky to only go over and fix the chunks that have already been generated. This prevents it from going all the way out to the 1000k blocks!
7. Run this command: `/chunky start`
- This starts the cleanup process. This may take a while, so be patient!
8. Once it is done, **restart your server!**
- This is very important, to force Minecraft to acknowledge the fixed chunks.
9. And finally run `/bluemap purge <map-id>` to rerender your world! This time with all cleaned-up lighting :D

If you want a border around your map and if you got your Earth map from [earth.motfe.net](https://earth.motfe.net/), then you can install ChunkyBorder: [modrinth.com/chunkyborder](https://modrinth.com/plugin/chunkyborder).
You can then find the exact commands and coordinates to add your border at, on this website: [docs.apocmc.us/minecraft-earth-map/map-borders](https://docs.apocmc.us/minecraft-earth-map/map-borders#id-1-500-scale-map)
Please note that you do _not_ have to run `/chunky start`, though, like this website suggests!
TechnicJelle marked this conversation as resolved.
Show resolved Hide resolved
19 changes: 0 additions & 19 deletions community/MCEarthMap.md

This file was deleted.

Loading