-
Notifications
You must be signed in to change notification settings - Fork 132
Home
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 :)
Always try to clear your browser-cache before anything else! (Ctrl+F5 might not be enough)
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/
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.
Read this: https://github.com/BlueMap-Minecraft/BlueMap/wiki/Configuring-mods
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 :)
- 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 theuseCompression
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)
- JustEnoughIDs (jeid)
- NotEnoughIDs