Dynmap

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:

worlds:
  - 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:

worlds:
  - 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:

worlds:
  - 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

to:

  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 Gwgw99 Gwgw99 Jun 28, 2016 at 20:25 UTC - 0 likes

    I found a much easier way to put dynmap on your web server (assuming its hosted on the same mechine). Simply move the web folder somewhere on your web server, and replace it with a simbolic link (to the new location of the web folder)

  • Avatar of Saxion Saxion Apr 11, 2016 at 18:07 UTC - 0 likes

    Could you make it possible so you can only see yourself? So if you login and your username is Saxion it will only show Saxion and not anyone else even if they are online. And if they join and their name is Dave they can only see themselves.

    Galactic factions

  • Avatar of Neosacrifice Neosacrifice Mar 21, 2016 at 12:36 UTC - 0 likes

    @xCaptMorganx: Go

    If you mean to show every chunk in the world, I use WorldBorder and the /wb fill Command to achieve that. Dynmaps render will only render explored chunks (I think) where as WorldBorder, will render all unknown chunks.

  • Avatar of Khay85 Khay85 Feb 07, 2016 at 03:11 UTC - 0 likes

    How do I prevent dynmap from showing players while underground?

  • Avatar of MrsWiccan MrsWiccan Jan 02, 2016 at 21:32 UTC - 0 likes

    Okay so I have limited space and would love how to figure out how to disabled the "surface" rendering. I just need the flat map, no caves or extra crap like the nether and end as well. I want to disable everything but the flat map. can this be done? If so, how?

  • Avatar of xCaptMorganx xCaptMorganx Sep 24, 2015 at 10:41 UTC - 0 likes

    How do I render a multiverse world? For the main world, it renders until the border that I've set. But with the multiverse world it only renders a starting 200x200 and then will only render if it's been explored. How come one map world will get a fullrender yet another does not?

    I'm using /dynmap fullrender Creative:flat,for example, and it finishes right quick, not rendering the full world.

    Last edited Sep 24, 2015 by xCaptMorganx
  • Avatar of cyris69 cyris69 Apr 02, 2015 at 08:22 UTC - 0 likes

    I was wondering if you could help me real quick. I run a custom server with LOTS of mods and was wondering how I can change textures that are used when rendering the map. It says modname textures loaded in server console but seems to be missing objects like from enderio etc but without error. Do I need to do anything else besides unzip the textpack I use personally in the textpack folder where standard is and change the first setting for texturepack in shaders.txt to the name of the folder?

    Any help would be appreciated.

  • Avatar of rostik002 rostik002 Feb 15, 2015 at 03:26 UTC - 0 likes

    @cicatrice74: Go

    if u have dynmap and worldborder, the worldborder should automaticly be shown on the map, to render inside it, do /wb fill this might take a while, after that do /dynmap fullrender <worldname> This will take even longer

  • Avatar of cicatrice74 cicatrice74 Feb 06, 2015 at 08:50 UTC - 0 likes

    is there a way to show the spigot 1.8 worldborder on map and make the plugin only render inside of it?

  • Avatar of dwa1275 dwa1275 Jan 14, 2015 at 13:53 UTC - 0 likes

    I need some help, I've got dynmap working but came across an issue that required me to reload it, now when I look at the map, players don't show, world doesent render, and the maps just flash after loading for a sec or two, any thing I can do