Installing Dynmap on Your Minecraft Server

This guide explains how to install, configure, and access Dynmap on your Minecraft server using our game panel. Follow the steps in order; everything you need (file paths, ports, and commands) is covered here.

What Dynmap Does

Dynmap generates a real-time, web-based map of your world with:

• An interactive map viewable in any web browser
• Live updates as players explore and build
• Multiple map styles (flat, isometric, cave views, and more)
• Player tracking and markers
• Extensive configuration options

Once set up, your players will be able to visit a URL like http://YOUR_SERVER_IP:PORT to see your world in real time. Or if you own a domain you can use our reverse proxy feature to serve it from there (e.g. https://map.yourdomain.com).

File Layout After Installation

After Dynmap is installed and your server has been started once, you will see a folder layout similar to this in your server files:

• Dynmap.jar - the plugin file
• configuration.txt - main Dynmap configuration, including the web server port
• web - files served by the built-in Dynmap web server
• worlds - render configuration and map data for each world

Step 1 - Download Dynmap

You should now have a file similar to Dynmap-<version>.jar on your computer.

Step 2 - Upload Dynmap to Your Server

After the restart completes, return to the File Manager and verify that a new dynmap folder has appeared inside plugins.

Step 3 - Configure Dynmap's Web Server Port

Dynmap includes its own built-in web server. To reach it from a browser, you must:

1. Choose or create a network port for Dynmap on your server.
2. Set that port number in Dynmap's configuration.txt.

3.1 - Add a Port Allocation in the Panel

Use the Network or Ports section of your panel to create a dedicated port for Dynmap's web server.

You now have a dedicated port on your server that Dynmap can listen on.

3.2 - Set webserver-port in configuration.txt

Next, point Dynmap's internal web server at the port you just allocated.

webserver-port: 8123
webserver-bindaddress: 0.0.0.0
allow-symlinks: true

Replace 8123 with the exact port number you were given in the Network/Ports tab. Save the file when you're done.

Step 4 - Restart the Server and Verify Dynmap

If the server starts without errors and Dynmap reports that the web server is running, you're ready to open the map.

Step 5 - Access the Dynmap Web Interface

In your browser, use the server's IP address and the Dynmap port:

http://YOUR_SERVER_IP:YOUR_DYNMAP_PORT

• Replace YOUR_SERVER_IP with the IP address shown for your server in the panel.
• Replace YOUR_DYNMAP_PORT with the port number you set in configuration.txt.

If everything is configured correctly, you should see the Dynmap interface load. At first, it may appear mostly blank while the world is rendering.

Step 6 - Render Your World

Dynmap needs to render map tiles before the world appears fully.

Run these commands from the in-game chat (as an operator) or from the server console (without the leading /).

/dynmap fullrender world

• Replace world with the exact name of the world folder if needed (for example, world_nether, world_the_end, or a custom world name).

Useful control commands:

# Check render status
/dynmap radiusrender status

# Cancel a running render
/dynmap cancelrender world

# Render around a player in a radius (blocks)
/dynmap radiusrender <player> <radius>

Rendering a large world can take time and will use CPU and disk. It is normal to see increased resource usage while a full render is running.

Performance and Optimization Tips

For larger servers or worlds, you may want to tune Dynmap for performance.

• In plugins/dynmap/configuration.txt, adjust renderinterval to balance render speed and server load.
• Lower updaterate to reduce how often tiles are updated.
• Disable unused map types in the worlds configuration files inside plugins/dynmap/worlds.
• Use lower-detail templates (for example, deftemplatesuffix: lowres) if you want to reduce CPU and disk usage.

Dynmap is now installed and running on your server. You can share the Dynmap URL with your players, adjust the configuration as your server grows, and use the web map to monitor activity and showcase your world.