How to install Dynmap / BlueMap (interactive web map)

Dynmap and BlueMap are plugins that build an interactive web map of your Minecraft world, viewable in any browser. Players can explore the world, see live positions and discover builds. This guide covers Dynmap vs BlueMap, then shows how to install Dynmap or the BlueMap plugin on a Minecraft server with OuiPanel, the game panel. Last, it explains how to publish the map on your own domain name.

---

Dynmap vs BlueMap

Criterion	Dynmap	BlueMap
Rendering	2D, satellite view	3D, isometric view
Disk space	medium	higher
Performance	good	average
Visual quality	good	excellent
Configuration	simple	very simple
Extensions	many	a few
Resources	light	heavier

Dynmap shows a 2D satellite-style view with zoom.

┌──────────────────────────────┐
│  2D map, Google Maps style   │
│  - Top-down view             │
│  - Multi-level zoom          │
│  - Markers and areas         │
└──────────────────────────────┘

BlueMap shows a 3D isometric view.

┌──────────────────────────────┐
│  3D isometric map            │
│  - Free rotation             │
│  - Buildings in 3D           │
│  - Very detailed             │
└──────────────────────────────┘

Feature	Dynmap	BlueMap
View	2D satellite	3D isometric
Default port	8123	8100
Config files	configuration.txt	core.conf, webserver.conf
Plugin integrations	many	a few
RAM usage	moderate	high
Initial render	fast	slower
Visual quality	good	excellent
Setup	simple	very simple

---

Prerequisites

A compatible server

Software	Dynmap	BlueMap
Paper	yes	yes
Spigot	yes	yes
Purpur	yes	yes
Fabric	yes (mod)	yes (mod)
Forge	yes (mod)	yes (mod)
Vanilla	no	no

An extra port

The web map needs its own HTTP port.

Service	Default port
Minecraft	25565
Dynmap	8123
BlueMap	8100

In OuiPanel, you add this port in Configuration › Port Management, as explained below.

---

Option A: Install Dynmap

Download Dynmap

1. Open the Dynmap page on SpigotMC and click Download.

2. Take the build that matches your Minecraft version.

On Paper, Spigot or Purpur, you can also search for Dynmap on the OuiPanel Plugins page, Catalog tab, then click Install.

Upload the plugin

1. Log in to OuiPanel and select your Minecraft server.

2. In the side menu, open File Manager, then the plugins folder.

3. Drag the Dynmap-*.jar file from your computer onto the page. There is no upload button.

First start

In Console, start the server. Wait for Dynmap to create its configuration files.

[INFO]: [dynmap] Loaded 3 maps of world 'world'
[INFO]: [dynmap] Enabled
[INFO]: [dynmap] Web server started on address 0.0.0.0:8123

Then stop the server to configure it.

Add a port for the map

1. In the side menu, open Configuration › Port Management.

2. Click Assign new port. The panel adds it right away, with no confirmation window.

3. Note the number assigned.

4. With Edit note, name it, for example, "Dynmap port".

Configure Dynmap

In the File Manager, open the file below. The editor opens when you click it, and Save stores your changes.

/plugins/dynmap/configuration.txt

Around line 315, set the web server port.

# Web server listen address
webserver-bindaddress: 0.0.0.0

# Web server port (replace with your assigned port)
webserver-port: 8123

Replace 8123 with the port you got in Port Management.

To avoid overloading the server, lower the render quality, around line 16.

# Render quality (vlowres, lowres, hires)
deftemplatesuffix: lowres

Quality	Detail	Disk space	Performance
vlowres	very low	minimal	excellent
lowres	low	small	very good
hires	high	large	demanding

Start with lowres and move to hires only if your server has enough resources.

Here is a recommended full configuration.

# Render quality
deftemplatesuffix: lowres

# Render messages in chat
renderacceleratethreshold: 60
updaterate: 2000

# Built-in web server
webserver-bindaddress: 0.0.0.0
webserver-port: 8123

# Max queued tiles
parallelrendercnt: 4
tileupdatedelay: 30

# Web chat
allowwebchat: true
webchat-interval: 5

# Player visibility
player-info-protected: false
showplayerfacesinmenu: true

Restart and open the map

Start the server and wait for this message.

[INFO]: [dynmap] Web server started on address 0.0.0.0:8123

In your browser, open the address below, with your server's IP and the map's port.

http://YOUR_IP:YOUR_PORT

For example http://203.0.113.10:8123. The IP is the one in the Main address, in Global View.

Generate the map

The map fills in as players explore. To generate it by hand, run this command.

/dynmap fullrender world

A full render can take a long time and use a lot of resources. Limit the area with a world border (/worldborder).

Dynmap commands

Command	Description
/dynmap fullrender [world]	renders the whole world
/dynmap cancelrender [world]	cancels the current render
/dynmap pause all	pauses all renders
/dynmap pause none	resumes renders
/dynmap stats	shows statistics
/dynmap hide	hides your position on the map
/dynmap show	shows your position
/dmarker add <name>	adds a marker

In the OuiPanel console, type these commands without the slash.

---

Option B: Install BlueMap

Download BlueMap

Download BlueMap from bluemap.bluecolored.de or Modrinth, in the build for your server.

Server	File
Paper, Spigot	BlueMap-*-spigot.jar
Fabric	BlueMap-*-fabric.jar
Forge	BlueMap-*-forge.jar

Upload the plugin

In the File Manager, open the plugins folder and drag the BlueMap-*.jar file into it. On Paper, you can also use the Plugins page.

First start

Start the server. BlueMap creates its files and shows this message.

[BlueMap] BlueMap needs to download some resources from Mojang.
[BlueMap] Please accept the Minecraft EULA and change 'accept-download' to 'true' in config.

Then stop the server.

Accept the resource download

1. Open the /plugins/BlueMap/ folder (or /config/bluemap/ on Fabric).

2. Open the core.conf file.

3. Set the line below to true, then click Save.

accept-download: true

Add a port for the map

In Configuration › Port Management, click Assign new port and note the number, as for Dynmap.

Configure the web server

Open webserver.conf in /plugins/BlueMap/ and edit it as follows.

# Enable the built-in web server
enabled: true

# Listen address
ip: "0.0.0.0"

# Web server port (your assigned port)
port: 8100

# Maximum connections
max-connections: 100

Set up worlds (optional)

Open maps/world.conf to customize the display.

# Name shown on the map
name: "My World"

# Starting position
start-pos: {x: 0, z: 0}

# Map limits (optional)
min-x: -5000
max-x: 5000
min-z: -5000
max-z: 5000

# Cave rendering
render-caves: true

# Sky color
sky-color: "#7dabff"

Restart and open the map

Start the server and wait for these messages.

[BlueMap] WebServer started!
[BlueMap] Loaded 1 map(s)

Then open the map in your browser.

http://YOUR_IP:YOUR_PORT

BlueMap commands

Command	Description
/bluemap render [world]	starts rendering a world
/bluemap pause	pauses rendering
/bluemap resume	resumes rendering
/bluemap cancel	cancels the current render
/bluemap reload	reloads the configuration
/bluemap maps	lists maps
/bluemap version	shows the BlueMap version

---

Publish the map on a domain name

The OuiPanel Proxy Manager gives access to the map through a domain name over HTTPS, instead of an IP and a port.

Without Proxy Manager	With Proxy Manager
http://203.0.113.10:8123	https://map.myserver.com
a port to remember	a simple address
unencrypted HTTP	encrypted HTTPS

1. In the side menu, open Proxy Manager.

2. The This server's DNS target card shows the record to create: type A, name @ and an IP address. At your domain registrar, create the same record for your subdomain, for example map.

3. Click Add a domain. The New connection form opens.

4. Enter the full Domain name, for example map.myserver.com.

5. In Port, choose your map's port.

6. Leave HTTPS ticked to get a Let's Encrypt certificate, renewed automatically.

7. Click Check DNS. The panel should answer "The DNS points here".

8. Click Create the redirection.

The domain shows up under Connected domains, with the Open the site button. The map is then reachable at https://map.myserver.com. DNS propagation takes from 5 minutes to 48 hours depending on your registrar. How to configure a reverse proxy (Proxy Manager) covers each step in detail.

---

Customization

Add markers in Dynmap

In game, add a marker with /dmarker add.

/dmarker add "Main Spawn" icon:tower
/dmarker add "Shop" icon:chest
/dmarker add "PvP Arena" icon:skull

Icon	Name
house	house
chest	chest
skull	skull
tower	tower
minecart	minecart
star	star
red flag	redflag

Add markers in BlueMap

Create the file /plugins/BlueMap/markers/markers.json.

{
  "markers": [
    {
      "id": "spawn",
      "type": "poi",
      "label": "Spawn",
      "position": {"x": 0, "y": 64, "z": 0},
      "icon": "assets/poi.svg"
    },
    {
      "id": "shop",
      "type": "poi",
      "label": "Shop",
      "position": {"x": 100, "y": 64, "z": -50}
    }
  ]
}

Link Dynmap to other plugins

Dynmap can show areas from common plugins through add-ons.

Plugin	Dynmap add-on
WorldGuard	Dynmap-WorldGuard
Towny	Dynmap-Towny
Factions	Dynmap-Factions
GriefPrevention	Dynmap-GriefPrevention
Residence	Dynmap-Residence

Download the add-on and put it in /plugins/.

---

Tune performance

Limit the render area

Before a full render, set a world border.

/worldborder set 10000

The world, and so the render, is then limited to a square 10,000 blocks wide.

Lighter Dynmap configuration

# Reduce update frequency
updaterate: 3000
tileupdatedelay: 60

# Limit parallel renders
parallelrendercnt: 2

# Turn off heavy features
smooth-lighting: false
better-grass: false

Lighter BlueMap configuration

In core.conf, set these values.

# Render threads (adjust to your RAM)
render-threads: 2

# Update interval (in seconds)
update-interval: 300

---

If the map does not load

Cause	Solution
Wrong port	compare the port in the configuration with the one in Port Management
Missing port	add it with Assign new port
Web server not started	read the startup logs in Console

"Port already in use" error

The port is already taken. Change the port in the configuration, or use another port from Port Management.

Black or empty map

The map has not been generated yet. Explore the world in game, or start a render with /dynmap fullrender world or /bluemap render world.

The server lags during rendering

• Switch to lowres or vlowres quality.

• Lower parallelrendercnt to 1 or 2.

• Raise tileupdatedelay.

• Run renders during off-peak hours.

Not enough disk space

High-definition maps take a lot of room.

• Use lowres instead of hires.

• Limit the area with a world border.

• Delete old renders in /plugins/dynmap/web/tiles/.

To go further, see the Dynmap wiki or the BlueMap wiki. Both projects have a Discord (discord.gg/dynmap and discord.gg/bluemap).

---

Need help?

Open a ticket from Tickets › Open a Ticket, or from the Contact support tile at the bottom of your server's page in the client area. You can also ask your question on the OuiHeberg Discord.

Open a ticketDiscord