Dynmap®
* MAIN SUPPORT IS NOW ON DISCORD *
For further discussion and announcements, see us on Reddit or Twitter.
A Google Maps-like map for your Minecraft server that can be viewed in a browser. Easy to set up when making use of Dynmap's integrated webserver which works out-of-the-box, while also available to be integrated into existing websites running on Apache and the like. Dynmap can render your worlds using different renderers, some suitable for performance, some for high detail.
Components allow you to add/remove functionality to make Dynmap suit your needs. Using the components Dynmap comes supplied with, there is support for chat balloons, web-to-game chat, and configurable markers, areas, and lines.
Features
- Highly configurable maps per world
- Real-time updates: maps are kept in sync with your world in real-time, updates are shown while your leave your browser open
- Players with their faces are visible on the map
- Chat messages are visible (as balloons or in a chatbox) on the map.
- Map viewers can chat to players in-game.
- Current Minecraft time is visible on the map.
- Current Minecraft weather is visible on the map.
- WorldGuard, Residence, Towny and Factions regions that can be visible on the map (through corresponding Dynmap-* plugins)
- Overall highly configurable and customizable.
Installation
Copy dynmap-*.jar into your plugins directory. If you are upgrading, delete the previous dynmap-*.jar - you do NOT need to delete the plugins/dynmap directory or its contents.
If you are running a separate webserver (like Apache) you may need to copy the files from 'plugins/dynmap/web/' to a directory in your http-root and follow this guide. When upgrading, make sure you also upgrade the copied files.
First time use
When you start CraftBukkit, you should be able to navigate to http://yourserverip:8123/ in your browser. In case you are running CraftBukkit on the PC you are currently working on, you can navigate to http://localhost:8123/. You should be able to see the players who are in-game. Note that the map is not yet rendered, therefore the background will be black.
If you are planning on using the HD renderer, now would be a good time to do so. Enable 'deftemplatesuffix: hires' in the top of configuration.txt. More information about deftemplatesuffix is available at Base plugin settings.
If you just want to see Dynmap work, use the following command in-game: /dynmap fullrender. The wiki contains more information about commands and permissions. The map should reveal itself gradually in the browser, give it some time. Progress messages indicate that Dynmap is working and will show when the render is completed.
Configuration
Dynmap Add-Ons:
Both to demonstrate the API, and to help manage the growth of this already-huge plugin, we've started producing additional plugins for Dynmap. All of these will depend on Dynmap and interface through its APIs, but only need to be added by folks that are interested in the additional function they provide:
- dynmap-mobs: Provides marker layer for real-time position of selected mobs on dynmap maps.
- dynmap-residence: Successor to the 'regions' support for Residence in Dynmap, with live update of Residence changes
- Dynmap-WorldGuard: Successor to the 'regions' support for WorldGuard in Dynmap, with live update of WorldGuard changes
- Dynmap-Towny: Successor to the 'regions' support for Towny in Dynmap, with live update of Towny changes
- Dynmap-Factions: Successor to the 'regions' support for Factions in Dynmap, with live update of Factions changes
- Dynmap-CommandBook: Add support for showing /home and /warp locations defined using CommandBook.
- Dynmap-Essentials: Add support for showing /home and /warp locations defined using Essentials.
- Dynmap-GriefPrevention: Add support for showing Grief Protection claims
- Dynmap2CraftIRC3: Integrate Dynmap's web chat with IRC via CraftIRC
- Dynmap-SimpleClans: Integrate SimpleClans with Dynmap
- Dynmap-HeroChat: Integrate HeroChat v5.5+ with Dynmap
- Dynmap-PhysicalShop
- Dynmap-pyLandmarks
- Dynmap-PreciousStones: Integrate PreciousStones with Dynmap
- Dynmap-AdminCmd: Integrate AdminCmd with Dynmap
- Dynmap-PlayerWarp
- Dynmap-Citizens: Integrate Citizens with Dynmap
Mods integrated with Dynmap:
The following mods are known to support dynmap integration without needing an add-on:
Also, for the best response to questions and such, please post comments to our main forum thread - http://www.minecraftforum.net/topic/1543523-dynmap-dynamic-web-based-maps-for-minecraft/. Once again, having more than one place just isn't helpful, and this is where the 'Dynmap Community' already operates.
Disclosure
This plugin utilizes bStats.org plugin metrics system, which means that the following information is collected and sent to bstats.org:
- A unique identifier
- The server's version of Java
- Whether the server is in offline or online mode
- The plugin's version
- The server's version
- The OS version/name and architecture
- The core count for the CPU
- The number of players online
- The Metrics version
Donations and Tips
Dynmap and my other mods and plugins have always been free, as I work on them as time permits and not as a job - the upside is that the price is good, the downside is they get the time I have left after working, taking care of my family, and other things!
I've set up a coffee-fund jar (I believe in the theory that software developers are machines that turn caffeine into code), for anyone who wants to throw in some tips! For Patreon - https://www.patreon.com/dynmap or for Ko-Fi https://ko-fi.com/michaelprimm
-
View User Profile
-
Send Message
Posted Aug 8, 2012So, I compared 0.60 an 0.70 and they both work without any errors. BUT the 0.60 version is FAR superior performance wise. It seems that 0.70 is really slowing down the whole server. Chunkloading and -unloading especially. But 1.3.1 performance is still kind of bad even without any dynmap version, so the plugin is not totally to blame.
-
View User Profile
-
Send Message
Posted Aug 8, 2012With the current 1.3.1 RB release Dynmap 0.6 runs OK and without any errors.
As I've said before, awsome plugin, your hard work is appreciated!
-
View User Profile
-
Send Message
Posted Aug 8, 2012I agree laggy, needs an update, BUT, keep up the good work. Awesome plugin!
-
View User Profile
-
Send Message
Posted Aug 8, 2012This is lagging everyone servers, needs an update.
Thanks.
-
View User Profile
-
Send Message
Posted Aug 7, 2012Running 0.70 on RB bukkit and the triggered update queue is getting backed up after a few hours (it's gotten up to 100,000). I have update triggers only on block place and destroy. TPS is running near 20. Same config on 0.60 never got behind.
-
View User Profile
-
Send Message
Posted Aug 7, 2012Using the latest 0.70 release of dynmap I get severe lag! I am getting 11-14tps with dynmap installed. My java task (according to top) is around 180% with dynmap loaded, and usually only around 20% when it is not installed. If a regular player warps/teleports anywhere, they will fall out of the world and die because the server can not keep up. This is not the case at all when dynmap is not loaded. I am not sure if this is because my configuration is the same as it was with a previous version, but I have never had lag like this with dynmap before.
I know craftbukkit just came out with a RB, so this is really just a heads up for people that maybe experiencing lag in-game. dynmap seems to be the culprit currently.
Hopefully the wonderful developer of this must have plugin will have an update soon that will fix these glaring performance issues.
thanks so much for your hard work :)
EDIT: a recent dev release of craftbukkit #2322 seems to fix these issues, as it fixes a bug that was causing a low tick rate and double save of player data. Top still reports a higher than average java load (75%) compared to 1.2.5 with v0.50
-
View User Profile
-
Send Message
Posted Aug 7, 2012I have been testing the 0.70 version for some time now, and it seems that it generates abnormly high CPU (and memory) usage. I know a fullrender is hard on the server, but mine is shutting down regularly when rendering the map. Don't worry about me, I just wanted to let you know...
-
View User Profile
-
Send Message
Posted Aug 7, 2012I just updated from 0.3x (can't remember the exact version) to 0.60, by using exactly the same method as before - unzipping the dynmap folder on top of the old one. /dynmap/markers.yml is still there and intact, but none of our markers are seen on the map.
What seems to be the case? I'd hate to lose our carefully designed metro map!
EDIT: Nvmnd; these damn browser cache issues get me every single time! This time it was Chrome's cache, which had to be hard-flushed before the markers came back as usual!
-
View User Profile
-
Send Message
Posted Aug 6, 2012@frenchfries999
Wtf that's exactly what I said! >:/
-
View User Profile
-
Send Message
Posted Aug 6, 2012@godgodgodgo
They fixed it in the devbuilds.
For 1.3.1, use these: http://webbukkit.org:8080/job/dynmap/
-
View User Profile
-
Send Message
Posted Aug 6, 2012Folks, The bullshit nag event being reported has NO functional implications - its just some crap that Bukkit has decided to force before its time (as the new event being pushed was only added a couple days ago, so switching to it also breaks 1.2.5 compatibility which, in the absense of even the first RB for 1.3.1, is more important than supporting a 1.3.1 dev build). That said, I've coded up a workaround in the current development build (0.70) that avoids the nag - feel free to use this as you see fit (http://webbukkit.org/jenkins/public/dynmap/dynmap-0.70-bin.zip), just understand 2 things: 1) Its a development build 2) 1.3.1 ISN'T at RB yet, so I'm not claiming support for it while its such a moving target with serious bugs that have made it unsupportable until the last few hours (including unavoidable memory leaks that we only fixed in CB in the last 24 hours or so)
Once there is an RB for CB, there will be an official release of 0.70, based on testing of that RB.
-
View User Profile
-
Send Message
Posted Aug 6, 2012@dogbig
The PlayerChatEvent has been changed to AsyncPlayerChatEvent just disable the text until they update it
-
View User Profile
-
Send Message
Posted Aug 6, 2012Guys, that ChatEvent error won't actually cause any serious problems.
If you want to get rid of it however, just download the latest dev version.
-
View User Profile
-
Send Message
Posted Aug 6, 2012Houston, We've Got a Problem: with latest bukkit 1.3.1 - API changed 2012-08-06 10:34:39 [WARNING] [dynmap] "dynmap v0.60-1246" has registered a listener for org.bukkit.event.player.PlayerChatEvent on method "public void org.dynmap.bukkit.DynmapPlugin$BukkitServer$3.onPlayerChat(org.bukkit.event.player.PlayerChatEvent)", but the event is Deprecated. Server performance will be affected; please notify the authors [FrozenCow, mikeprimm]. org.bukkit.plugin.AuthorNagException at org.bukkit.plugin.java.JavaPluginLoader.createRegisteredListeners(JavaPluginLoader.java:302) at org.bukkit.plugin.SimplePluginManager.registerEvents(SimplePluginManager.java:507) at org.dynmap.bukkit.DynmapPlugin$BukkitServer.requestEventNotification(DynmapPlugin.java:200) at org.dynmap.common.DynmapListenerManager.addListener(DynmapListenerManager.java:55) at org.dynmap.SimpleWebChatComponent.<init>(SimpleWebChatComponent.java:42) at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method) at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:57) at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45) at java.lang.reflect.Constructor.newInstance(Constructor.java:525) at org.dynmap.ConfigurationNode.createInstance(ConfigurationNode.java:322) at org.dynmap.ConfigurationNode.createInstances(ConfigurationNode.java:336) at org.dynmap.DynmapCore.enableCore(DynmapCore.java:345) at org.dynmap.bukkit.DynmapPlugin.onEnable(DynmapPlugin.java:576) at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:217) at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:357) at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:381) at org.bukkit.craftbukkit.CraftServer.loadPlugin(CraftServer.java:263) at org.bukkit.craftbukkit.CraftServer.enablePlugins(CraftServer.java:245) at net.minecraft.server.MinecraftServer.i(MinecraftServer.java:296) at net.minecraft.server.MinecraftServer.d(MinecraftServer.java:275) at net.minecraft.server.MinecraftServer.a(MinecraftServer.java:225) at net.minecraft.server.DedicatedServer.init(DedicatedServer.java:140) at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:380) at net.minecraft.server.ThreadServerApplication.run(SourceFile:539)
-
View User Profile
-
Send Message
Posted Aug 5, 2012@BobbySoSlo
Same here. I just disabled it until it's updated.
-
View User Profile
-
Send Message
Posted Aug 5, 2012Does anyone have this working for 1.3? My dynmap just shows up as all black and a spawn point when I add it :/
-
View User Profile
-
Send Message
Posted Aug 5, 2012I get the following error with bPermissionsNano (StandAlone):
dynmap works perfectly with bPermissions on the main server.
-
View User Profile
-
Send Message
Posted Aug 4, 2012@dockter
Try Refreshing your browser, ie reload the webpage. Depending on your Browser you can also force a refresh of the cache by holding down the shift key when you click on the refresh button.
-
View User Profile
-
Send Message
Posted Aug 4, 2012Getting error: "Web files are not matched with plugin version: All files need to be the same version (0.60-1246) after upgrading from 0.40
-
View User Profile
-
Send Message
Posted Aug 3, 2012?chatname=PseudoKnight doesn't seem to be working anymore, even right after logging in.
"dynmap: Ignore message from 'PseudoKnight' - no matching player login recorded"
Confirm?