How to Install and Configure Dynmap Plugin for Live Server Maps
Dynmap transforms your Minecraft server into an interactive web-based experience by creating live, Google Maps-style views of your worlds that players can access through any web browser. This comprehensive guide covers everything from basic installation to advanced reverse proxy configuration for custom domains. There are more optimized alternatives like BlueMap and squaremap, but Dynmap is still a popular choice for many Minecraft servers.This guide will walk you through installation and usage of Dynmap on your Minecraft server!
Installation
You will need a public IP or a port forwarding service to allow other people to use your Dynmap, if you’re running your Minecraft server locally.
- Download the latest version of the Dynmap plugin from SpigotMC or the Dynmap mod from CurseForge (if you’re running a modded server).
- Place the downloaded JAR file in the
plugins
/mods
(depends on your server software;plugins
for Bukkit-based servers,mods
for Forge and Fabric) folder of your Minecraft server. Refer to this guide for help. - Restart the server. The plugin will automatically be installed and activated
- When the server has fully started, stop the server to start configuring the plugin
- Create a port in the “Network” on the game panel
- Navigate to the
plugins/dynmap
folder in your server’s directory - Edit the
configuration.txt
file and set the port to the one created in the 5th step, and a URL path you want to use for the Dynmap web interface (e.g. /dynmap), and save - Start the server again. Dynmap will now be fully installed and configured
Reverse proxy
To use a custom domain for Dynmap instead of a long numerical IP, you can use a reverse proxy which allows you to access Dynmap using a custom domain name!With Lime at BerryByte
If you have a Minecraft server from BerryByte, we’ve simplified all steps below to a few buttons on Lime, where you can easily set up a reverse proxy for Dynmap using the Proxies Manager tool. We take care of SSL certificates and all the configuration for you.- Create a DNS record for your custom domain to point to
cotton.api.berrybyte.network
. If you’re using Cloudflare, make sure to set the proxy status to DNS only. - Head to the Proxies Manager tool and click on the “Create Proxy” button.
- In
Source
, input the domain used in step 1. InAllocation
, input the allocation you created for Dynmap in the installation steps and press “Create”.
Locally or at another provider (Advanced)
This part of the guide presumes you have a Debian/Ubuntu-based server, steps may differ for other OSs.
dynmap.conf
- Set up a server to act as the reverse proxy. This can be a dedicated physical or virtual machine from a public cloud provider (order one at https://berrybyte.net/vps ;) ).
- Install a web server on the machine which you intend to run the reverse proxy on (e.g. Nginx, Apache, etc.):
sudo apt update && sudo apt -y install nginx
- Set up a DNS record for your custom domain to point to the IP address of the reverse proxy server.
- Configure the web server on the reverse proxy server to act as the proxy for Dynmap. This will involve adding a configuration block to the web server’s configuration file that specifies the custom domain you want to use for Dynmap and the IP address and port of the Minecraft server where Dynmap is running.
dynmap.conf
- Restart the web server to apply the changes:
- Test the reverse proxy by accessing Dynmap using your custom domain.
Usage
To view the Dynmap map, open a web browser and go to the IP address of the server, followed by the port and thewebprefix
path (if you’ve set one in the configuration file), e.g. http://yourdomain.com:20029/dynmap; this will launch Dynmap’s web interface!
On the left side of the interface, you will see a list of available maps. You can switch between these maps using the dropdown menu at the top. On the right side of the interface, you will see a list of players currently online on the server. You can click on a player’s name to view their location on the map. You can also use the search bar at the top of the interface to search for specific locations or players on the map.
Customization
Dynmap has a wide range of customization options, which can be accessed by clicking on the “Configure Dynmap” button at the top of the web interface. From here, you can adjust settings such as the map’s zoom level, the visibility of players and markers on the map, and the appearance of the map itself. For more advanced customization options, you can edit the configuration.txt file in theplugins/dynmap
folder on your server. This file contains detailed documentation for all available customization options.
Troubleshooting
If you are having trouble using Dynmap, here are a few common issues and their solutions:- If the Dynmap web interface is not loading, check the
server.log
file in the logs folder of your server for any error messages related to Dynmap. This can help identify the cause of the issue. - If the map is not showing the correct area, check the
worlds.txt
file in theplugins/dynmap
folder to ensure that the correct world is being mapped. - If the map is not updating in real-time, check the
updaterate
option in the configuration.txt file. This setting determines how often the map is updated, and can be adjusted as needed.
Common Issues
-
Dynmap web interface won’t load: Usually caused by port configuration or firewall issues
- Solution: Verify the port is correctly configured and accessible, check server firewall settings
-
Map shows blank or doesn’t update: World mapping configuration or permissions issue
- Solution: Check
worlds.txt
file and ensure correct world is mapped, verify plugin permissions
- Solution: Check
-
Players can’t access Dynmap externally: Network configuration or port forwarding issue
- Solution: Ensure port is properly forwarded and accessible from external networks
-
High server resource usage: Dynmap can be resource-intensive during initial map generation
- Solution: Consider using alternatives like BlueMap or squaremap for better performance
Related Guides
- Server Network Configuration - Learn about server networking features
- Installing Plugins - General plugin installation guide
- Server Performance Optimization - Optimize server for plugin usage
- Chunky Plugin - Pre-generate chunks for better map performance
- Server Backups - Backup before installing plugins