Dynmap is a powerful plugin that generates a live, Google Maps-style web map of your Minecraft worlds. Players (and you) can view the map in a web browser to explore the server, track bases, and see the world in real time.
Dynmap is a relatively heavy plugin. On larger or actively played worlds, it can cause noticeable lag if left to render tiles on-the-fly. We strongly recommend pre-rendering your worlds after installation so the map is generated in advance. This significantly reduces the impact on server performance.
Follow these steps to install and configure Dynmap:
Download and install the plugin
Download the correct version of Dynmap that matches your server software and Minecraft version (Paper, Purpur, Spigot, etc.). Upload the .jar file to your server’s plugins folder.
Restart the server
Restart your server so Dynmap can generate its configuration files.
Create a port allocation
Dynmap needs its own dedicated port to serve the web map.
Go to the Network tab in the left-hand sidebar of the panel → click Create Allocation. Note the port number that is assigned to you (for example, 25580 or similar).
Configure the webserver port
Navigate to the folder /plugins/dynmap/ and open the file configuration.txt.
Find the line that says webserver-port and change it to the port you just created in the Network tab.
Save the file.
Restart the server again
Restart so Dynmap starts using the new port. If you receive an error that the port is already in use, create a different allocation and update the configuration file again.
Access your map
Open a web browser and go to your server’s IP address followed by a colon and the port you set. It will look something like:123.45.67.89:8034
After the basic setup is working, take some time to go through the rest of the configuration.txt file. You can customize zoom levels, which worlds are shown, player markers, and many other options.
Recommended next step – Pre-render your worlds
Once Dynmap is running, use the in-game or console commands (such as /dynmap fullrender or world-specific render commands) to pre-generate the map tiles. Doing this during a low-player period will prevent most of the lag that Dynmap can otherwise cause while players are exploring new areas.
