Live Web Maps (Dynmap, BlueMap, squaremap)
Show a live map of your Minecraft server in the browser with Dynmap, BlueMap or squaremap. Open the web port, render the world and add your domain on RealisticNode.
A web map shows your world in a browser, like Google Maps for Minecraft. Players can explore builds, see who's online and where they are, without joining the game.
Which map should I use?
| Dynmap | BlueMap | squaremap | |
|---|---|---|---|
| Style | 2D and 3D-like views | Full 3D, you can fly around | 2D from above |
| Server types | Paper, Spigot, Forge, Fabric | Paper, Spigot, Fabric, Forge, NeoForge | Paper, Fabric (check its page for other loaders) |
| Default port | 8123 | 8100 | 8080 |
| Speed and disk use | Slowest, uses the most disk | Medium | Fastest and lightest |
| Best for | Lots of addons and markers | Beautiful 3D views | Small servers, low resources |
Install only one web map. Running several at the same time uses a lot of CPU and disk space.
Install and open your map
Install the plugin or mod
Install your map from Plugins (or Mods on a modded server). See Install plugins. Start the server once so the config files are created.
Create a port
Open Network and click Create Allocation:
- Servers with a dedicated IP: choose the Dynmap (8123) or Bluemap (8100) preset. For squaremap, use Custom Port.
- Standard servers: choose a random port and write down the number.
See Network & Ports.
Set the port in the config
Open plugins/dynmap/configuration.txt and change:
webserver-port: 8123Click Save Content and restart the server.
Render the world
The map renders new chunks as players explore. To render everything that already exists, type in the Console:
| Map | Command |
|---|---|
| Dynmap | dynmap fullrender world |
| BlueMap | bluemap update (starts automatically after the first start) |
| squaremap | squaremap fullrender world |
Replace world with your world name. A full render of a big world can take hours and uses a lot of CPU, so start it when few players are online.
Open the map
In your browser, open your server IP with the map port, for example:
http://123.45.67.89:8123Use your own domain with HTTPS
Instead of an IP and a port, you can open your map at an address like https://map.myserver.com. Follow Reverse Proxy & SSL: create a DNS record for your domain and select the map's port in Proxy.
Save disk space
Map tiles can take many gigabytes on big worlds. Some tips:
- Limit the map size: pre-generate a world border, or set render limits in the map's config.
- Disable maps you don't need, like the Nether or the End.
- Exclude the tiles from backups. They can always be rendered again. Add the tiles folder to
.pteroignore(see Exclude files from backups):
plugins/dynmap/web/tiles/
bluemap/web/maps/
plugins/squaremap/web/tiles/Folder locations can change between versions and server types. Check them in Files before adding them.
Troubleshooting
Check that the port in the config is the same as in Network, that you restarted, and that you're using http:// (not https://) with the IP. Look in the Console for a web server error.
The world hasn't been rendered yet. Run the full render command and wait. On BlueMap, check that accept-download is true.
Rendering uses a lot of CPU. Let it finish at a quiet time, or pause it (dynmap pause all on Dynmap). See Lag & performance.