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 shalivahan shalivahan Nov 24, 2014 at 06:07 UTC - 0 likes

    manchiga undichhinna thanksgiving

  • Avatar of Skykros Skykros Jul 28, 2014 at 04:23 UTC - 0 likes

    Hey mate first time user on this and it looks great, only noob problem, I cannot login to my own server it just hangs at logging in, other than that all is a-okay. Any suggestions?

  • Avatar of AspenTheWolf AspenTheWolf Mar 18, 2014 at 23:04 UTC - 0 likes

    @auranore: Go

    Use the command, as listed in the main page, /dynmap fullrender.

    This will take a while, but it will render the entire map (as far as has been explored) in the world you were in when running the command. You can specifically render any world with /dynmap fullrender <world>

  • Avatar of auranore auranore Mar 13, 2014 at 17:53 UTC - 0 likes

    have it installed, when i start my server, it loads it but every world it says dynmap is disabled?

    and the browser is just black with a small earth icon called spawn, the map doesnt render.

    can we not use this with multiverse?


  • Avatar of Annepyr Annepyr Feb 18, 2014 at 18:15 UTC - 0 likes

    Apologies if this has been asked before but.... how do I enable login support? :O

  • Avatar of xcchuck xcchuck Feb 14, 2014 at 22:14 UTC - 0 likes

    The Dynmap plugin I installed was the Dynmap Mod 1.6.4 to be placed on my Bukkit server 1.6.4.

    Problem: Dynmap on web browser shows up but as a black screen (not the map), however it shows the players online and the players moving around and all the tool bars. The map will just not appear.

    What do i need to change or do to get the map to show up or render

  • 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 - 1 like

    @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.