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!
(English is not my main language. If you find something wrong, please notify me!)

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

Table of contents

1. Installation
   1. As a sponge-plugin
   2. As a spigot/paper-plugin
   3. As a forge/fabric-mod
   4. On the CLI / standalone (WIP)
2. Configuration
   1. General
   2. Web-server
   3. Advanced
   4. Live-Updates
3. Commands and Permissions
4. Installing resource-packs
5. Configuring mods
   1. General
   2. Configs
      1. Block-id config
      2. Block-properties config
      3. Block-colors config
      4. Biomes config
   3. Installing those configs
   4. Infos for modders

FAQ

Always try to clear your browser-cache before anything else! (Ctrl+F5 might not be enough)

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")
• 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 provider if you don't know this.

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, try to clear your browser-cache. (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. 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 add ignoreMissingLightData: true to your map configuration, e.g. right below the useCompression setting. 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