How to Set Up BlueMap on a Minecraft Java Server
BlueMap creates a 3D web map of your Minecraft server that you can view in a browser. The map is rendered as a textured mesh and allows you to fly through the world with a camera.
Warning
BlueMap requires its own port for the web server. Do not use your server's default port!
Step 1: Install the Mod/Plugin
Download mod
Download BlueMap for your server version.- For Fabric/Forge: Download the mod version and place it in the
modsfolder. - For Paper/Spigot/Bukkit: Download the plugin version and place it in the
pluginsfolder.
- For Fabric/Forge: Download the mod version and place it in the
Restart server
Restart your server so the config files are created.
Step 2: Open a Port
Open network section
Open the Network section in your dashboard. There you will find an overview of all available ports.Choose a port
Choose an available port and note it down.
Important
Do not use your server's default port! BlueMap requires a separate port.
Step 3: Configure the Config File
Open config file
Navigate to the BlueMap webserver config in the file browser.- Fabric/Forge:
config/bluemap/webserver.conf - Paper/Spigot/Bukkit:
plugins/BlueMap/webserver.conf
- Fabric/Forge:
Find port line
Open the file and look for the line:port: 8100port: 8100Replace port
Replace8100with your chosen port from Step 2.port: YOUR_PORTport: YOUR_PORTSave changes
Save the file.
Step 4: Restart the Server
Restart server
Restart your server for the changes to take effect.Open the map
Open the web map in your browser at:http://YOUR_SERVER_IP:YOUR_PORThttp://YOUR_SERVER_IP:YOUR_PORT
Tip
On first start, BlueMap renders the entire world — depending on world size this can take many hours. In core.conf you can adjust the render performance if your server gets too loaded.