FAQ - webbukkit/dynmap GitHub Wiki

1) I did a `/dynmap fullrender` but the map is pretty much empty?

A) Dynmap only renders the map based on generated chunks, what this means is as you explore Dynmap will render the areas you explore or have already explored. If you want the full map shown, you can either walk/fly around to generate new chunks or use a plugin that pre-generates chunks, like FastChunkPregenerator, or ChunkyBorder. Dynmap does not modify world data so we have no plans to implement a chunk-generation feature at this time. WARNING Some hosting services don't allow chunk pre-generating plugins. Please read the ToS of your hosting service to make sure you don't unknowingly violate any rules.

2) How do I delete a map, like "cave"?

A) Run /dmap mapdelete worldname:mapname To find a map name run /dmap maplist worldname, finally, run /dmap purgemap worldname:mapname to completely delete the old map files.

3) My Dynmap is of a completely different server or map?

A) You are likely on a hosting service that uses shared IPs. The port for your map is likely in use by another server and you are likely seeing their map as they were there first- Change the port Dynmap uses in the config and enter that port in the web address instead.

4) The website isn't working but the server log says the web server started?

A) This usually happens when the port in the Dynmap config is not open. Go to https://www.canyouseeme.org/ and enter your server IP and port. If it says open contact the Dynmap team and we will assist you. If it says the port is closed you either need to forward a port in your router's firewall or add a port to your server panel. For more information check the host-specific guides on the Installation Page.

5) My Dynmap doesn't show modded blocks?

A) Modded blocks aren't supported out of the box, here are two tools that can help!

Dynmap-BlockScan: This mod scans the block textures and model files for "most" mods and allows Dynmap to render them. The most common use case is to render the definitions once, then place the files generated at dynmap/renderdata/modsupport into the dynmap/renderdata folder directly then remove the Dynmap-BlockScan plugin. This speeds up server start times and should only need to be run once per server.
Dynmap-BlockScanData Repo: We created a github repo for data generated by the Dynmap-BlockScan mod. This repo gives instruction where to place the data and puts the definition files in a easy-to-find location and can be less work than running blockscan yourself. This repo is entirely community driven and needs your help to generate mod definition files for those that we don't have already. Most* definition files are version agnostic (1.12.2 files will work on 1.16 and vice versa) but you obviously won't get new textures added in later versions.

6) How can I stop the fullrender status messages from spamming the chat?

A) There are two ways to do this- 1. You can disable the messages for the duration of the render using /dynmap quiet WARNING You can't turn the messages back on once you run that command. 2. In the configuration.txt edit this line

# Progress report interval for fullrender/radiusrender, in tiles.  Must be 100 or greater
progressloginterval: 100

I recommend setting this to 1,000 for mid-size server maps and 10,000 or greater for large server maps. You will need to restart your server for this to take affect.

7) What does 'Invalid plugin.yml' mean

A) Joined with 'Could not load x plugin' and 'ZipException' - this usually means that the file was downloaded badly or corrupted in some way.

Re-download a fresh version and confirm it looks complete. This is a good time to check what the latest version is too

8) How do I disable chat?

A) If you want to disable chat either because you use another system or simply do not wish to use it, you can disable the webchat by editing configuration.txt and commenting out all of the chat plugins. Here is an example of what that would look like, the lines numbers may be different for you and we only included the parts of the config relating to chat.

Original (Click to expand)

043|  - class: org.dynmap.InternalClientUpdateComponent
046|    allowwebchat: true

101|  - class: org.dynmap.SimpleWebChatComponent
102|    allowchat: true
103|    # If true, web UI users can supply name for chat using 'playername' URL parameter.  'trustclientname' must also be set true.
104|    allowurlname: false
135|  - class: org.dynmap.ClientComponent
136|    type: chat
137|    allowurlname: false
138|  - class: org.dynmap.ClientComponent
139|    type: chatballoon
140|    focuschatballoons: false
141|  - class: org.dynmap.ClientComponent
142|    type: chatbox
143|    showplayerfaces: true
144|    messagettl: 5
145|    # Optional: set number of lines in scrollable message history: if set, messagettl is not used to age out messages
146|    #scrollback: 100
147|    # Optional: set maximum number of lines visible for chatbox
148|    #visiblelines: 10
149|    # Optional: send push button
150|    # sendbutton: false

With all Chat Disabled (Click to Expand)

043|  - class: org.dynmap.InternalClientUpdateComponent
046|   #  allowwebchat: true

101| #  - class: org.dynmap.SimpleWebChatComponent
102|   #  allowchat: true
103|   #  # If true, web UI users can supply name for chat using 'playername' URL parameter.  'trustclientname' must also be set true.
104|   #  allowurlname: false
135| #  - class: org.dynmap.ClientComponent
136|   #  type: chat
137|   #  allowurlname: false
138| #  - class: org.dynmap.ClientComponent
139|   #  type: chatballoon
140|   #  focuschatballoons: false
141| #  - class: org.dynmap.ClientComponent
142|   #  type: chatbox
143|   #  showplayerfaces: true
144|   #  messagettl: 5
145|   #  # Optional: set number of lines in scrollable message history: if set, messagettl is not used to age out messages
146|   #  #scrollback: 100
147|   #  # Optional: set maximum number of lines visible for chatbox
148|   #  #visiblelines: 10
149|   #  # Optional: send push button
150|   #  # sendbutton: false

If you are noticing strange messages such as:{jdni} / IaM5uchA1337Haxr-Ban Me! Some hacker online realized Dynmap webchat can be used to send messages to a Minecraft server log. These messages exploit a vulnerability called Log4J or Log4Shell. For sake a brevity these are exploits which allow hackers to run code on your server without your permission. If you haven't heard of these attacks recently here is more reading. If you are running the most up to date version of your server you are safe. I want to be very clear that Dynmap will not make you more vulnerable or protect you from this vulnerability. The only way to protect yourself it to patch your minecraft server. If you want to make these messages go away you can disable the webchat by following the above instructions.