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 Feb 11, 2012Anyone know why my dynmap looks like this? I haven't done anything to it except change a couple of world titles, but have since reset the world.txt, and then reinstalled dynmap when that didn't fix it.
http://46.105.113.15:8123/
Isn't loading a map it just says the following on a blank white page:
Directory: /
tiles/ 4096 bytes Feb 6, 2012 5:09:58 PM
-
View User Profile
-
Send Message
Posted Feb 11, 2012@kamuel87
Yep - 'includehiddenplayers: true' is broken in 0.31 - its fixed in the current 0.32 development code.
-
View User Profile
-
Send Message
Posted Feb 11, 2012@rsmKaelub You need to uncomment the ClientConfigurationComponent (first thing in the components section) - that one is mandatory, and nothing will work without it.
Also, I'd suggest commenting 'chunkloaded' and 'playermove' - very expensive and largely unnecessary triggers, unless you know you really want them.
-
View User Profile
-
Send Message
Posted Feb 11, 2012@MachetePanda
Its a shader setting - and there is a default one in 'shaders.txt' named 'stdtexture-mcr-grid', which corresponds to 512x512 (the MCR file grid). You can copy, rename, and modify this one - then, you would switch the shader for the specific maps you want to use it on, and rerender.
-
View User Profile
-
Send Message
Posted Feb 11, 2012@Fafane67
I just fixed a problem yesterday that was causing the players to not be shown if the 'showhiddenplayers' setting was set to true. Fix is in the 0.32 development build - or you can turn off 'showhiddenplayers'.
-
View User Profile
-
Send Message
Posted Feb 10, 2012I have the same problem as some others. Since 0.31 players no longer show on map. The whole "Players" layer is missing.
-
View User Profile
-
Send Message
Posted Feb 10, 2012How do I turn on the new grid system and how do I set grid size? I have towny set to a 16x16 grid and I would like to use this to help players plan their towns and cities. Thank you!
-
View User Profile
-
Send Message
Posted Feb 10, 2012I've been trying to utilize dynmap for the past 2 weeks and have been failing. My dynmap url is: Mynecrapht.com/web
(if you went to the link) You can see I have a completely blank and black dynmap. I'm not sure if I understand what I'm doing wrong.
Here is my configuration.txt AND the config.js: (btw, I'm running centos 6.0 and my webserver is the same server that runs my minecraft server)
Configuration.txt
Config.js
-
View User Profile
-
Send Message
Posted Apr 9, 2012This would have to be done within the web-server itself, since the program is just feeding information to it. While I would prefer a database hook to store / retrieve passwords, you can achieve this in apache using htpasswd. I have previously automated this in the past (not for this specifically) using expect scripts.
-
View User Profile
-
Send Message
Posted Feb 10, 2012is there a way to password protect the map so that only admin can use it? seems like its very easy for anyone to find and servers map.
-
View User Profile
-
Send Message
Posted Feb 10, 2012@mikeprimm
uhm yes the /hide/show works if "includehiddenplayers: false" but if its true, then the player become light gray on the player list and thats forever and the /show have no more effect (if i change the config on this point to false, the player are white and its works how it should)
-
View User Profile
-
Send Message
Posted Feb 9, 2012@mikeprimm
Updated just now. everything seams to be fine compared to .30!
-
View User Profile
-
Send Message
Posted Feb 9, 2012@mikeprimm
Yeah, I feel kind of scammed right now. I can not change anything about my partition right now, as it is a virtual server. I have no idea though, what they were thinking.
So I will have to look into the virtual file system inception thingy. Thanks for your help!
-
View User Profile
-
Send Message
Posted Feb 9, 2012@shintarutaru
0.30.1 had problems on 1.1-R3 with losing its event handling after a /dynmap reload. I just confirmed the scenario you described (/dynmap hide, /dynmap show, repeat) working correctly on 0.31. I HAVE heard a report of problems with CraftBukkitPlusPlus (which I don't specifically test on) that are addressed by using vanilla 1.1-R3 - I still need to investigate this.
-
View User Profile
-
Send Message
Posted Feb 9, 2012@Fr0zenFr0g
0.31 has 10 second limit on how long it will wait for the graceful shutduwn to finish.
-
View User Profile
-
Send Message
Posted Feb 9, 2012@KillahKiwi
Not sure why you'd have a 1 million inode limit on a modern file system - most ext4 file systems I've checked default to about 1 inode per 16k of space: 1M for a partition as big as yours seems like a bad call. Unfortunately, we cannot do anything about that - we support being served by external file servers, so our tiles need to be image files, one per tile, and bigger tiles would smash performance on tile update processing.
Without fixing the inode limit of your existing partition, the only other trick I can think of is to create an addition, file-backed partition with more sensible inode limits - take a look at this (http://www.debuntu.org/how-to-create-a-filesystem-within-another-partition-s-file) for an example of how to do this. It will not be as fast as a normal partition, but I suspect it'd be fast enough for a tile store.
-
View User Profile
-
Send Message
Posted Feb 9, 2012@genesis_aix
Not presently - there is an opened feature request for this, so its under consideration.
-
View User Profile
-
Send Message
Posted Feb 9, 2012Is there any way to show a players heading on the map? e.g. a degree number or/and arrow
-
View User Profile
-
Send Message
Posted Feb 9, 2012@shintarutaru
same here, with bukkit 1846 and dynmap 0.31 and the /hide command hiding a player, thats works fine.. but the /show command say ingame it works, but it have no effect on the map (the player is still hidden)
-
View User Profile
-
Send Message
Posted Feb 9, 2012I'm on a debian system. I let it render my world from four perspectives and it takes up 9 gigabytes which is absolutely okay, but it also used all of the inodes left on my partition o.O
Now, my server will not do anything saying there would not be any space left on the device. But there is:
Did I do something wrong, I mean is there any settings to decrease the amount of files created? Here is my worlds config: