RealisticNode Docs

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?

DynmapBlueMapsquaremap
Style2D and 3D-like viewsFull 3D, you can fly around2D from above
Server typesPaper, Spigot, Forge, FabricPaper, Spigot, Fabric, Forge, NeoForgePaper, Fabric (check its page for other loaders)
Default port812381008080
Speed and disk useSlowest, uses the most diskMediumFastest and lightest
Best forLots of addons and markersBeautiful 3D viewsSmall 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:

plugins/dynmap/configuration.txt
webserver-port: 8123

Click 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:

MapCommand
Dynmapdynmap fullrender world
BlueMapbluemap update (starts automatically after the first start)
squaremapsquaremap 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:8123

Use 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):
.pteroignore
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

On this page