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 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 199.96.84.21:8123 : 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 0.0.0.0 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?

  • Avatar of ruggerbuns ruggerbuns Aug 03, 2013 at 04:27 UTC - 0 likes

    I'm getting a white screen when i go to myserverip:8123, what is the problem here?

  • Avatar of progenocide progenocide Aug 02, 2013 at 12:49 UTC - 0 likes

    Is there anyway to give new players like a 24 hour timer before they show up on map?

  • Avatar of N3SLO N3SLO Aug 01, 2013 at 21:10 UTC - 0 likes

    Been trying for 3 days to figure out a simple (to me) change so that only 1 map, or is it layer, or is it template.. idk, is shown. But the instructions I find have changing naming conventions that just leave me bewildered. Some consistency would be a good thing. And I really liked this plugin too. Shame

  • Avatar of ekul6547 ekul6547 Jul 21, 2013 at 13:38 UTC - 0 likes

    What if your server is on a custom port? cause i type our ip :8123 and it comes up with a different server, and i have changed the webserver port in the config, but it doesnt work

  • Avatar of TCLG TCLG Jun 16, 2013 at 09:17 UTC - 0 likes

    does it fully support the FTB modpack? its just like tekkit but with a few more mods