FAQ
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.
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
is there a way to show the spigot 1.8 worldborder on map and make the plugin only render inside of it?
@cicatrice74
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
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.
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.
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?
How do I prevent dynmap from showing players while underground?
@xCaptMorganx
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.
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.
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)
Could you make it possible so that players can only see themselves on the dynmap, perhaps via ip match?
To remove the maps I did make another file called custom-normal-hires and removed the maps I didn't want, but it still loads, do I have to rename the old normal-hires to custom-hires too?
And I found the problem, but dont know how to fix, in the config.txt I set hires, but it loads the lowres, how to fix?
The explanation is so unclear, i am not a mod maker. i want to disable the cave maps and 2 extra dimentions my world has. but the explanation is so unclear, how do i know what resolution file dynmap uses by default.
according to the text above i need to add or remove pieces of text. but all option have " #" in front of them
so all is disabled.
but it still works, the configuration of the plugin is so vage , why not have the renderd worlds listed in a file seperate.
the text suggest that worlds are there but there is nothing about them in the text files unless you add them.
my map is default qua graphics , but dont know with file the default is !
(why are the best plugins / mods always the most annoying to setup ! )
Help me please :(
Hi i was wondering if anyone could help me out. i am trying to make my dynmap where people have to login using webregister in order to acces the dynmap, however they are only allowed to see themselves.
when i use protected-player-info: true, they cannot see anyone when i make it false they can see everyone i do not understand whats going wrong here.
how can i create more than 1 dynmap?
aternos??