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 21, 2012Is it possible to see all ips/player-ids that are currently viewing dynmap?
-
View User Profile
-
Send Message
Posted Aug 20, 2012@Gonzoman10
Beastnode will open a port for dynmap. Although if you want to to host the map on your own site (as I do) this is part of my cfg. As I didn't do this myself, and I don't understand enough to fully explain the setup. The web address for map is http://minecraft.pokebay.com/map (the address was /dynmap by default, but has been redirected to /map).
Hope this helps.
-
View User Profile
-
Send Message
Posted Aug 20, 2012Ok I have tried for two days, googled every question I can think of, tried it every way I can think of.. so I'm going to have to be a newb and ask what seems like should be a simple question. I am trying to change the settings on an area on my dynmap.
Using this page: https://github.com/webbukkit/dynmap/wiki/Using-markers
and this command /dmarker updatearea <area-label> set:<markerset-id>
I have tried it every way I can think of, and I have drawn a complete blank. I keep getting this error..
Error:invalid set - or Error:invalid set - markers or Error:invalid set - color
I just want to change the areas color and line weight etc, currently it is a giant red splotch on my otherwise beautiful map.
/dmarker updatearea <area-label> set:color then a hexidecimal color?
Thank anybody for any help you can offer.
-
View User Profile
-
Send Message
Posted Aug 20, 2012can someone give me a step by step tutorial on how to put this plugin on a godaddy website i have a 40 slot server hosted by beastnode.com and a website by godaddy but i want to put dynmap on it but i dont know how please help im such a newbie at this stuff...visit the server at 173.231.5.149 and website at mc-imperiallegion.us
-
View User Profile
-
Send Message
Posted Aug 20, 2012Blocks on tekkit server are invisible, any fix for this?
-
View User Profile
-
Send Message
Posted Aug 20, 2012@CubieX
Thank you
-
View User Profile
-
Send Message
Posted Aug 20, 2012help i own a server and i have downloaded it i have portforwared the 8123 just in case but it still dose not work is it my host its installed correctly but i cant connect on the web browser help.?
-
View User Profile
-
Send Message
Posted Aug 20, 2012Hi! Can we add new marker icons to customize our maps? If we can't do it... it's an idea for next update, thanks !
-
View User Profile
-
Send Message
Posted Aug 20, 2012is there a way to hide the location of other players, except for the person who is viewing the livemap, so they can see where they are, but not anyone else?
-
View User Profile
-
Send Message
Posted Aug 19, 2012Hi all. Just hit a problem. I seem to have lost my player icons for no reason. 1 minute they were there - then they were gone. :s No settings were changed - I hadn't even rebooted! They just stopped appearing. :s Any ideas?
-
View User Profile
-
Send Message
Posted Aug 19, 2012Hi! I've got a problem with my dynmap. It doesn't create the config.txt file... and gave me this error:
-
View User Profile
-
Send Message
Posted Aug 19, 2012That was fast! 70.3 released a few minutes later. No errors now, thank you!
-
View User Profile
-
Send Message
Posted Aug 19, 2012I get this error on startup of the server (craftbukkit #2343), although the map still works ok.
map URL http://minecraft.pokebay.com/dynmap
2012-08-19 23:28:02 [WARNING] Task of 'dynmap' generated an exception java.lang.NoSuchFieldError: unloadQueue at org.dynmap.bukkit.NewMapChunkCache.loadChunks(NewMapChunkCache.java:712) at org.dynmap.bukkit.DynmapPlugin$BukkitServer$7.call(DynmapPlugin.java:401) at org.dynmap.bukkit.DynmapPlugin$BukkitServer$7.call(DynmapPlugin.java:396) at org.bukkit.craftbukkit.scheduler.CraftFuture.run(CraftFuture.java:34) at org.bukkit.craftbukkit.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:126) at net.minecraft.server.MinecraftServer.q(MinecraftServer.java:510) at net.minecraft.server.DedicatedServer.q(DedicatedServer.java:212) at net.minecraft.server.MinecraftServer.p(MinecraftServer.java:474) at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:406) at net.minecraft.server.ThreadServerApplication.run(SourceFile:539) 2012-08-19 23:28:02 [WARNING] Task of 'dynmap' generated an exception java.lang.NoSuchFieldError: unloadQueue at org.dynmap.bukkit.NewMapChunkCache.loadChunks(NewMapChunkCache.java:712) at org.dynmap.bukkit.DynmapPlugin$BukkitServer$7.call(DynmapPlugin.java:401) at org.dynmap.bukkit.DynmapPlugin$BukkitServer$7.call(DynmapPlugin.java:396) at org.bukkit.craftbukkit.scheduler.CraftFuture.run(CraftFuture.java:34) at org.bukkit.craftbukkit.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:126) at net.minecraft.server.MinecraftServer.q(MinecraftServer.java:510) at net.minecraft.server.DedicatedServer.q(DedicatedServer.java:212) at net.minecraft.server.MinecraftServer.p(MinecraftServer.java:474) at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:406) at net.minecraft.server.ThreadServerApplication.run(SourceFile:539)
-
View User Profile
-
Send Message
Posted Aug 19, 2012@CubieX
you dont need perms if you/admin just registers each user he or she wants to allow access. https://github.com/webbukkit/dynmap/wiki/Web-ui-login-support-and-permissions
-
View User Profile
-
Send Message
Posted Aug 19, 2012@asgard20032
if your worried about bogging down your download speed, that wont be an issue, a server uses your upload speed. my upload speed is only 700Kbps and i run dynmap and minecraft and no one complains about lagg. i've configured apache2 to serve the dynmap files and host a website too and my players have no issues. we get 30Mbps down so everyone in the house can still watch netflix and my friends and i can play minecraft in my server with no lagg.
EDIT: btw ive only changed the dynmap config to use apache2 and use better grass and smooth lighting.
-
View User Profile
-
Send Message
Posted Aug 19, 2012There is no password function afaik. But you can do 2 Things:
The easy way is, to change the standard port "8123" to another free port in the configuration.txt. So only people who know the right port can see the map. (or the have to try thounsands of ports to find the connnection. XD)
The more complicated way, is to use the permissions of dynmap to only grant access to players that should see it. But I've not yet configured this myself... Look at the wiki for an explanation. The needed options are located in the first part of the config file.
We use the first method for its simplicity. ;)
-
View User Profile
-
Send Message
Posted Aug 19, 2012@Maresi
But, can i do so people can't even see the map? i've been loking very much for that :)
-
View User Profile
-
Send Message
Posted Aug 19, 2012Error-Report for CraftBukkit version git-Bukkit-1.3.1-R2.0-12-g2210485-b2342jnks Keep up the great work! Thank you, greetings, snitride
-
View User Profile
-
Send Message
Posted Aug 18, 2012@asgard20032
What do you mean? Do you host a server from your home connection? If so, I would advise you to completely abstain from Dynmap.
If you don't want to: Use the very low resolution templates "vlowres", set render interval from 1 second to 60 seconds or so and deactivate the chat function, health bars and let Dynmap only render the "flatmap", as the tiles are the smallest in file size. Limiting the maximum amount of connections is also important.
By the way: From which connection speed (Upload speed is most important) are we talking here?
--We upgraded to CB 2338 and Dynmap 0.70.2 to fix this "chunks get not saved" bug. But now, there are large areas that do not get loaded at all.
@mikeprimm: We have an issue with the new protected-player-info - function. How to make it, so Admins with the '*' permission (and also OP) are shown on the map, without having manually set /dynmap show PLAYER every time they log in?
We set protected-player-info: false and also includehiddenplayers: true
But, without using the above command, no Admin is shown on the map.
Also, if used with VanishNoPacket, it seems like after toggling to "invisible", the "show PLAYER" command of dynmap is reset. Players that reappear with vanish are not reappearing on the map, until they use the command again.
-
View User Profile
-
Send Message
Posted Aug 18, 2012i have updated to the new release but no worlds are rendering new info its only showing old stuff i added a new world and did a fullrender on that world and it said it had finnished but the map remains black with just the spawn world showing, i even remove the config and reloaded to see if that would fix it but no, whats gone wrong with dynmap it works great till 1.3
Please help