Frequently Asked Questions

The configuration I just changed is not being used?

Use '/reload', '/dynmap reload' or restart your server. If this does not help, look in server.log for errors.

How can I host Dynmap on my webserver (which is on the same machine)?

Presuming your webserver is on the same machine as CraftBukkit is, use the guide to make Dynmap work without the internal webserver.

I don't have a webserver, how can I show the map to others?

Portforward TCP-port 8123 on your CraftBukkit server, so that everyone can visit Dynmap.

For better security, you might want to use a webserver (like Nginx) that proxies traffic to Dynmap. Do this if you know how to do so.

How can I host Dynmap on my webserver (which is on another machine)?

Portforwarding, like above, might still be a good solution. If it is impossible to portforward, or you want to offload your CraftBukkit server, you can still periodically synchronize 'plugin/dynmap/web' between CraftBukkit and your webserver using RSync or FTP. However, you won't have any of the 'real-time' features that Dynmap provides (players, map-updates, chat, etc).

If you don't mind tinkering a bit on Linux, you can still get the real-time features by using sshfs or fuseftp to mount the (remote) 'web/standalone' directory from your webserver onto your CraftBukkit server 'plugins/dynmap/web/standalone'.

How can I integrate Dynmap on my website?

Make sure Dynmap is available for anyone on a certain URL. If you've done portforwarding, this will likely be something like http://youripaddress:8123. If you've hosted Dynmap on your webserver, this will likely be something like http://yourwebsite/map/.

Then you can use an iframe to integrate Dynmap in your website. You might need some HTML knowledge, but if you're using a CMS there will likely be an option to add an iframe. The HTML-code of that iframe will look like:

<iframe src="http://youripaddress:8123/" width="800" height="600" />

How can I get high detailed maps?

You must make use of the HD renderer. To do this, simply open 'plugins/dynmap/configuration.txt' and uncomment the line:

#deftemplatesuffix: hires

So that you get:

deftemplatesuffix: hires

How can I change the order in which the worlds are shown?

Open 'plugins/dynmap/worlds.txt' and add world-sections right after the line 'worlds:' in the order you want to have them in the sidebar. You should get something like the following:

  - name: world
  - name: nether
  - name: skylands

In this example, the names of your worlds are 'world', 'nether' and 'skylands'.

How can I change the name that is shown for each world?

Open 'plugins/dynmap/worlds.txt' and add/change the world-sections right after the line 'worlds:', so that you get the following:

  - name: world
    title: "My Awesome World"
  - name: nether
    title: "My Awesome Nether"
  - name: skylands
    title: "My Awesome Skylands"

In this example, the names of your worlds are 'world', 'nether' and 'skylands'.

How can I hide a world from being listed?

Open 'plugins/dynmap/worlds.txt' and add/change the world-section for the world you want to hide. Add the value 'enabled: false' to that world-section, so that you get something like the following:

  - name: world
    title: "My Awesome World"
  - name: nether
    title: "My Awesome Nether"
    enabled: false
  - name: skylands
    title: "My Awesome Skylands"
    enabled: false

In this example both 'nether' and 'skylands' will be hidden, since they have 'enabled: false' in their world-section.

How can I remove the cave map?

Copy the appropriate template file to make a custom one. For example, copy 'plugins/dynmap/templates/normal-vlowres.txt' to 'plugins/dynmap/templates/custom-normal-vlowres.txt'. Open the copied file and remove the following section:

      - class: org.dynmap.hdmap.HDMap
        name: cave
        title: "Cave"
        prefix: ct
        perspective: iso_SE_60_lowres
        shader: cave
        lighting: default
        mapzoomin: 3

How can I hide certain players on the map?

Use the command '/dynmap hide PlayerName', where 'PlayerName' is the name of the player to hide.

How can I hide everyone except certain players?

Open 'plugins/dynmap/configuration.txt' and set 'display-whitelist' to false. This will look like:

# Treat hiddenplayers.txt as a whitelist for players to be shown on the map? (Default false)
display-whitelist: false

Now everyone is hidden. You can use '/dynmap show PlayerName' to show certain players.

How can I disable chat balloons?

Open 'plugins/dynmap/configuration.txt' and place '#' in front of the following lines:

  - class: org.dynmap.ClientComponent
    type: chatballoon
    focuschatballoons: false

So that you get:

  #- class: org.dynmap.ClientComponent
  #  type: chatballoon
  #  focuschatballoons: false

How can I enable night/day on my maps?

Copy the appropriate template file to make a custom one. For example, copy 'plugins/dynmap/templates/normal-vlowres.txt' to 'plugins/dynmap/templates/custom-normal-vlowres.txt'. Open the copied file and change all instances of the following line:

  lighting: shadows


  lighting: nightandday

Now reload the plugin and do a fullrender.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Willcomputerguy79 Willcomputerguy79 Feb 07, 2014 at 21:19 UTC - 0 likes

    Hello, I have a Minecraft server with multiple worlds but I only want to enable a couple worlds. When I go into worlds.txt I see a world portion of the file and config options:

    1. - name: world
    2. title: "World"
    3. Use 'enabled: false' to disable a certain world.
    4. enabled: false

    What I do is: - Remove the hashtags - Put the actual world name in -name: (e.g. name: world_nether) - enabled: false

    I do this multiple times for all the worlds on my server. I put enabled: false and enabled:true depending upon the world I want enabled or disabled. Now, when I do this and reload my server and go to my map, it's completely black and there is no DynMap options like players online, worlds, etc when you move your mouse to the right side. To fix this, I deleted my worlds.txt folder and when I reloaded the server it re-installed. How do I disable certain worlds? And what am I doing to make DynMap not work? Any help would be appreciated!


  • Avatar of deancohen1994 deancohen1994 Jan 21, 2014 at 12:13 UTC - 0 likes

    @ShellGecko: Go

    not sure if yours the same as mine but my host told me not to add teh server port in the ip https://www.beastnode.com/portal/knowledgebase/41/How-to-Install-DynMap.html

    Site: www.WarBlock.Com
    IP: Mc.WarBlock.Com

  • Avatar of ShellGecko ShellGecko Jan 20, 2014 at 08:48 UTC - 0 likes

    I put in my ip, which is s18.hosthorde.com:25579:8123, but it takes me to nowhere.

    I did it without the :25579 and it takes me to some other server!


  • Avatar of MUNNNATHAN MUNNNATHAN Jan 18, 2014 at 09:48 UTC - 0 likes

    my ip is port forwarded on all the proper ports but i can only view the map locally. i am running 1.7.4 i also have a web-server doing the same thing. i don't know if my sub-domain is the problem or the fact that there routed together through and ip and domain. help would be appreciated.

  • Avatar of Levieye Levieye Jan 03, 2014 at 22:25 UTC - 0 likes

    @fixneat: Go

    Change the port used

  • Avatar of fixneat fixneat Nov 23, 2013 at 07:26 UTC - 0 likes

    I'm using a host and it says 23.11 07:19:41 [Server] SEVERE Failed to start WebServer on address : Address already in use is there any way to change this?

  • Avatar of Cubby219 Cubby219 Nov 10, 2013 at 05:54 UTC - 0 likes

    hello, i have your plugin installed. However i have edited all the config ip spots and my server ip spots and your plugin insists on going on the ip Unfortunately most developers dont keep up with their dev page so i posted it in the bukkit forums under bukkit help. Thier is a server log and config their

  • Avatar of MissIju MissIju Oct 06, 2013 at 17:59 UTC - 0 likes

    @GalenGhostbane: Go

    I had a similar issue, and it actually turned out to be an issue with my host company. Another server on the same node as mine was forcing all Dynmap IPs to redirect to their server. Check with your host company to see if they have an idea or fix.

  • Avatar of GalenGhostbane GalenGhostbane Sep 18, 2013 at 17:05 UTC - 0 likes

    @ekul6547: Go

    N3SLO, I'm havng the same issue on our server. We had been running Dynmap just fine for ages, as it was configured by one of my former Admins. However, last Friday, we had a major technical issue which required me having to restore a lot of things from backups I'd made. Dynmap stopped working, so I deleted the old Dynmap folder, restarted, re-rendered the major maps on the server, and carefully walked through the configuration settings, while checking against an old copy of the configuration.txt that I had. Our IP is specified correctly, and I tried using the :8123 default port, but that was displaying someone else's server! I triec changing it to :8124 and :8125, but each of those ports are ALSO displaying totally different servers On OUR IP address. Did you ever get the issue sorted out, and how did you fix it?

  • Avatar of 14zelliott 14zelliott Aug 13, 2013 at 22:30 UTC - 0 likes

    Hello, I'm having some issues with my Dynmap.

    Recently we got a new server and had to transfer all our files over, coming with the new server came a new IP. Currently the IP that we obtained from moving is already in use?

    Help please?