Home

Welcome to the BlueMap wiki!

BlueMap is a tool that generates 3d-maps of your Minecraft (Java-Edition) worlds and displays them in your browser.

In this wiki, i try to explain everything you might need to use BlueMap!

If you need more help, you can always join the Discord-Server for BlueMap or r/BlueMap and ask there :)

FAQ

Q: Where can i open my map?

By default it's your servers public ip-address (e.g. 123.45.67.8) and the port (8100) like this: http://123.45.67.8:8100/

Q: I still can't access the website!

Here is a checklist:

• Have you set the correct public ip of your server in the configuration? (E.g. ip: "123.45.67.8")
  Also try to use the default ip setting! (Have a # in front of the line to comment it out) This works on almost all servers!
• Do you get a message saying Webserver started... in your server-console/log? If not, check the configuration again.
• Is the port (8100 by default) open and forwarded correctly? Or is your firewall blocking incoming connections on the port? Ask your server-host if you don't know this.

Q: I am getting 404 - Not Found when i open the map

Check your core.conf configuration file, did you set accept-download to true?
If yes, check if your webroot settings in render.conf and webserver.conf are set to the correct (same) folder.

Q: My map isn't updating!

BlueMap needs to wait until the server saves the world data to disk, so it may take some time for changes to appear on the map. Also make sure to click clear tile cache in the menu on the left to make your browser fetch a fresh copy.

Q: I have black/pink-checkered blocks on my map!

Read this: https://github.com/BlueMap-Minecraft/BlueMap/wiki/Configuring-mods

Q: My block-textures are messed up when i zoom in on the map!

First, press the clear tile cache button in BlueMap's menu. This updates all tiles from the server and makes sure your browser has not cached anything weird.
You can also try to clear your browser-cache completely. (Ctrl+F5 might not be enough)
If that doesn't help you might have changed some bluemap-settings that require a complete re-render of the map: Delete the whole folder that contains your rendered map data (including the textures.json, bluemap/web/data by default), and use /bluemap render <world> to render the maps again. Then clear your browser-cache again and it should be fixed :)

Q: I have a black map / a lot of the map is missing!

• Have you used /bluemap render <world> yet? If not, do that! :D
• Press the clear tile cache button in BlueMap's menu. This updates all tiles from the server and makes sure your browser has not cached anything weird.
• Use the command /bluemap debug block. If that is throwing an error, it is likely that you have a mod installed that is not compatible with bluemap. Check the incompatibilities-list below.. If you don't have any mod from the list, please report the error here.
• Have you pregenerated your world? The pregenerated chunks that have not been visited by a player might not have their light-data generated yet. BlueMap needs the light data and ignores chunks that don't have it. So it will only render chunks that have been loaded by a player at least once.
• Are you using mods? Some mod might prevent minecraft from generating and storing the light-data. BlueMap needs the light data and ignores chunks that don't have it. As a workaround, try to set ignoreMissingLightData: true in your map configuration (render.conf). This will ignore missing light data with some drawbacks:
  • Cave-rendering will be always enabled, because it is using the sun-light data to detect the "caves"
  • Everything on the map will be rendered fully lit .. (sun-light value of 15, looks similar to having night-vision)

Known incompatibilities with other mods

• JustEnoughIDs (jeid)
• NotEnoughIDs