Help CenterThis guide is designed to help you install the Dynmap plugin on your server. It provides a step-by-step walkthrough for downloading and configuring the plugin, offers troubleshooting tips, and explains how to add a texture pack to enhance your Dynmap experience.
Looking for how to install the mod (Forge/Fabric) version of Dynmap? Click HERE!
🌎 INSTALLING DYNMAP ON YOUR SERVER 🌎
First, login to your game panel account, open the console tab for your server, and turn the server offline. Note the installed game version, as you'll need it for the next step.
💡 Tip: When downloading the plugin, ensure you choose the version that matches your server setup. For example, if your server uses PurPur 1.22.1, download the plugin version compatible with 1.22.1. This can be found running the /version command when your server is online.
1. Find and download the verison of Dynmap compatible with your server HERE.
2. Once the plugin is downloaded, go to your server's File Manager and find the 'plugins' folder, open it then place the Dynamp plugin into your server's 'plugins' folder. Then go turn the server online using the console.
3. After the server successfully turns online. If the plugin was successfully installed, you'll see in your server's console that Dynmap is 'enabled'. Now turn the server back offline then head to your file manager and look for the 'plugins' folder and open it. Open the Dynmap folder, then look for the file named 'configuration.txt' and open that file.
⚠️ Note: You will need an additional port assigned to your server for the next step, you can reach out to our support team by submitting a Support Ticket or contacting us directly via LiveChat!
4. Once you have your additional port and have the 'configuration.txt' file open, you'll look for the following line to edit:
- Line 357, where it says 'webserver-port: 8123'. Change the port number to the additional port you were provided. In the example provided below, the additional port added was 29495.
5. Save the file at the top right of the page using the 'Save Content' button. Then head back over to your console and turn the server back online.
6. Locate your server's IP address, which is displayed in the top right corner of your console page where you control the server's on/off status. You only need the IP address itself, not the port number (the numbers following the ':' symbol is the port).
💡 Example: If your server address in the top right of your console shows '299.212.246.22:25793', the numbers before the ':' symbol are your IP address. You should copy '299.212.246.22' only, and then proceed to the next step.
7. Take only your server's IP address and the additional port you set up earlier, and combine them into a single server address. Enter this address into your browser's search bar. If successful, you will see a black screen. Remember, no world data will appear until you log in to the server.
💡 Example: http://yourserverip:8123/ replace where it says 'yourserverip' with your server's IP address you copied from Step 6 above, then replace where it says '8123' with your addtional port. Then paste that address into your browser search bar.
8. After confirming that your Dynmap URL is working, log in to your server using the address at the top right of your console to start generating world data. Then, go back to your Dynmap, and you will see it update to reflect your in-game world.
9. Dynmap is now successfully set up on your server! 🥳 For further configuration options such as the type of database the Dynamp is using, the quality of the map, and the size of the map. Please vist the Dynamp Wiki for more instructions on how to accomplish that.
You can also refer to the Dynamp Installation Guide for more detailed instructions!
🚧TROUBLESHOOTING TIPS🚧
- Check Server Compatibility: Ensure that you are using a compatible version of Minecraft and Dynmap. Each version of Dynmap is designed to work with specific versions of Minecraft. Verify that your server's Minecraft version matches the version supported by the Dynmap plugin you're installing
- Check File Placement: Confirm that you have placed the Dynmap plugin file (.jar file) in the correct folder location on your server. The plugin should be placed into the server's 'plugins' folder. Restart your server after placing the plugin in the server's 'plugins' folder.
- Check the Port: Ensure that you replace the default port with the additional port you were provided by our Support Staff in the 'configuration.txt' file, as specified in Step 4 of the setup instructions above.
🔨 If you need help, don't hesitate to reach out to our support team by submitting a Support Ticket or contacting us directly via LiveChat!
🌎 ADDING A TEXTUREPACK TO YOUR DYNMAP 🌎
💡 Tip: Before adding a texturepack to your Dynmap, make sure the texturepack is compatible with the version of Minecraft installed on the server. Texture Packs can be found on CurseForge or Modrinth.
1. Head to your server's console and make sure the server is turned offline before making any changes. You will also need to connect to your server using SFTP which allows the transfer of larger files to your server. Here is our guide for How To Use SFTP to Connect to a Minecraft Server.
2. Once you're connected to your server using SFTP, in the right window find the 'plugins' folder and open it. Then find the 'Dynamp' folder and open that folder. Look for the folder named 'texturepacks' then open that folder.
3. Once the 'texturepacks' folder is open in your SFTP, drag the texture pack you downloaded earlier into this folder. Wait for the transfer to complete before proceeding.
4. After adding the texture pack successfully, go to your game panel and open the file manager tab. From there find the 'plugins' folder, open the 'Dynmap' folder, and then find the folder named 'shaders.txt' then open it.
5. Select and delete all the contents of the file that you see and replace it with the following text:
💡 Tip: When filling out the 'texturepack' line of text, be sure to include the file extenstion as well if it's included in the name of the folder.
shaders:
- class: org.dynmap.hdmap.TexturePackHDShader
name: stdtexture
texturepack: Faithful 32x - 1.20.1For example, if you want to set the server up with the with the 'Faithful 32x - 1.20.1' texturepack you would use the following:
shaders:
- class: org.dynmap.hdmap.TexturePackHDShader
name: stdtexture
texturepack: Faithful 32x - 1.20.1
6. When you're done editing the 'shaders.txt' file, be sure to click the 'Save Content' button at the top right of the file before closing that page.
7. Go to the console tab and turn the server online. If the texture pack has been successfully installed, you will see a confirmation in your console logs.
8. Use the following command in your console or in-game to fully render your worlds.
/dynmap fullrender [worldname] command, replacing [worldname] with your actual world folder name.
For more Dynmap add-ons, click HERE!
🚧TROUBLESHOOTING TIPS🚧
- Texturepack Compatibility: Ensure the texturepack you're adding to the server is compatible with the version of Minecraft installed on the server. Also check that the format of the file is correct. Most texturepacks come as .zip files.
- Ensuring File Location: Make sure that you have added the texturepack to the Dynmaps 'texturepack' folder.
- Checking Spelling/Naming: When naming the texturepack to be used, as mentioned in step 5. Double check that the spelling and the name of the file matches exactly the folder name of the texturepack you added.