Dynmap and BlueMap: add a live web map of your world
Install Dynmap or BlueMap, set its web server port to an extra port from the Network tab, and open http://your-server-address:port in a browser to see a live map.
- Difficulty:
- Intermediate
- Time:
- 15 minutes
On this page
Dynmap and BlueMap turn your world into a map that anyone can open in a web browser. Both run a small web server inside your Minecraft server, so they need an extra port from the Network tab. Install one of them, set its port, and open http://your-address:port.
Which one should I use?
Feature | Dynmap | BlueMap |
|---|---|---|
Look | Classic flat and angled 2D map, live player markers and chat | Full 3D map you can fly around, plus a flat view |
Config file |
|
|
Default port | 8123 | 8100 |
Runs on | Paper/Spigot, Fabric, Forge | Paper/Spigot, Fabric, Forge, Sponge |
Use only one at a time. The default ports above won't work on a hosted server; you must use your own extra port.
Step 1: Get an extra port
In the Game Panel, open your server and go to Network.
Click Create Allocation and note the new port number. Type what it is for in the Notes column. See How to add extra ports.
Step 2: Install the map
On Paper or Purpur use Plugins → Browse Plugins; on Fabric, Forge or NeoForge use Mods → Browse Mods. Search for Dynmap or BlueMap, click Install, then start the server once so the config files are created. Stop it again before editing.
Step 3a: Set up Dynmap
Open Files and edit
configuration.txt. On plugin servers it is inplugins/dynmap/; on modded servers it is in thedynmap/folder in the main server folder.Find
webserver-port: 8123and change it to your extra port, for examplewebserver-port: 45572.Save and start the server. The console shows that the Dynmap web server started on your port.
To draw the whole existing world, run
dynmap fullrender worldin the console (replaceworldwith your world's folder name). New areas are added as players explore.
Step 3b: Set up BlueMap
Open the BlueMap folder:
plugins/BlueMap/on plugin servers, orconfig/bluemap/on Fabric and Forge.Edit
core.confand changeaccept-download: falsetoaccept-download: true. This allows BlueMap to download the Minecraft textures it needs. BlueMap will not render until you do this.Edit
webserver.confand setportto your extra port, for exampleport: 45572.Save and start the server (or run
bluemap reloadif it is already running). Runbluemapto see render progress.
Step 4: Open the map
In any browser, go to http:// + your server address + : + the map port. Use the hostname from the panel header or the Server IP on the Dashboard, for example:
http://in6.endercloud.in:45572Use http://, not https://. Share this link with your players.
Rendering a big world uses a lot of CPU and can take hours, and map tiles take up disk space. Start a full render when few players are online, and keep an eye on your disk usage in the panel header. Pre-generating and limiting your world size helps; see Pre-generate your world with Chunky.
Frequently asked questions
The map page won't open
Check that the server is online, that the port in the config exactly matches a port in your Network tab, and that you used http://. Also make sure no other plugin (Geyser, voice chat) is using the same port.
The BlueMap page opens but the map is empty
Rendering has not finished, or accept-download is still false. Set it to true, restart, and check progress with bluemap.
Can I use my own domain for the map?
Yes: point a domain or subdomain to your server's IP with an A record, then open http://your-domain:port. The port is still needed.
Was this article helpful?
Related articles
No domain? Open your website, API or bot dashboard over HTTPS with a free SSL certificate from Endercloud. Port first, a dash, then your node name, always on ender.co.in, like https://25808-agni.ender.co.in.
On an offline-mode server, install a login plugin such as AuthMe or LibreLogin so nobody can join as you, and SkinsRestorer so players get skins back with /skin.
Install Geyser and Floodgate from the Plugins tab, add a port with Create Allocation in Network, set it as Geyser's Bedrock port, and Bedrock players can join your Java server.
Stop the server, delete or rename the world folder(s), set a new level-seed in Properties if you want, and start the server to generate a fresh world.
