[MISC] Dynmap v0.39 - Real-time Minecraft maps [1.1-R4+/1.2.5-R2.0]

Dynmap - Real-time Minecraft maps:
Version: v0.39

Quick Links:
Download latest (recommended) version
All stable and unstable releases (thanks flames for hosting)
BukkitDev
Wiki
Issue tracker/Todo list
Source code
IRC: irc.esper.net #dynmap

This plugin was started by k-zed as a plugin for hMod. The plugin was ported to Bukkit soon after Bukkit was released. The current version of Dynmap provides an in-browser map, like Google Maps, of your Minecraft world. It updates the map in realtime while you have your browser opened and shows the current players, regions and in-game messages on top of the map. It also allows viewers of the map to chat from within their browser with players in-game.

Installation
Download the latest recommended version which comes packaged in a zip file. Extract all files from that zip in minecraft_server/plugins/. Run CraftBukkit. Open browser, go to http://localhost:8123/ or http://ip-address-of-server:8123/. Check minecraft_server/plugins/dynmap/ for the configuration files and one of the links below on how to further customize your settings.

FAQ
How to configure Dynmap
How to configure separate webservers
Dynmap Commands

Videos:
Dynmap and add-ons setup guide - Big thanks to deery50!!

Features:

• Configurable maps of different types
• Configurable color-schemes.
• Realtime players (with portraits) on map
• Mark places that will show on the map.
• Two-way chatting through web and Minecraft.
• Time on map
• Weather on map

Known Issues:

• Supported browsers: Firefox 4+, Chrome 10+, Opera 11+, Internet Explorer 9+, Safari 5+. Any older version might not work. The solution is to UPGRADE!
• HeroChat v5.x broke the existing HeroChat support - use Dynmap-HeroChat add-on and upgrade to HeroChat v5.5 or later

Changelog:
Version 0.39

• Make 'logo' component position settable, allow more than one instance
• Add 'hiddenids' setting to HD Cave shader - control which blocks should be treated as solid
• Fix markers when JSON mode, login active, and any protected worlds
• Fix security check for tiles and configuration from night/day worlds
• Add IC2 Compact Solars support
• Do proper escape encoding for string generated into PHP files
• Update jQuery to 1.7.2 - fix IE9 stupidity
• Fix Chrome behavior when login while using URL parameters (bogus configuration error)
• Disable hideifundercover on nether (EVERYTHING is under cover there...)
• Fix lighting above 128 on KzedMap
• Fix preservation of URL parameters when login is driven or forced
• Add touch support for scroll buttons on world, player lists
• Fix hideifundercover on The End
• Add forestry-support flag to configuration.txt

Version 0.38

• Fix various PHP issues with JSON file mode (with and without login enabled)
• Fix integer/double mismatch exception when render seeds set in world data
• Fix session issue in up.php
• Fix up.aspx to work with POSTs (chat messages) (thanks to bytemr!)
• Initialize focus on login.html to user ID field
• Update RailCraft support - new utility blocks

Version 0.37

• Add 'protected-player-info' option for ClientUpdateComponent - enables login protection of player positions and health (only see self except for logins with dynmap.playermarkers.showall permission)
• Set 'blockphysics' and 'blockfromto' triggers to be disabled by default (too many triggers on CB that are not useful)
• Add 'protected' option for worlds - if set, only logins with 'dynmap.world.<world-id>' permission can see maps for given world
• Add 'protected' option for maps - if set, only logins with 'dynmap.map.<world-id>.<map-id>' permission can see given map on given world
• Add LC Trees++ rendering support
• Fix handling of unknown biomes (for mods that add new biomes)
• Add support for KzedMap and FlatMap with 256 high worlds (1.2+)
• Preserve URL parameters when Login/Register is used
• Fix handling of face accessories with no transparency
• Prevent exceptions with markers with deleted marker icons
• Prevent exceptions when directories deleted while rendering
• Fix PHP error when no JSON files and login enabled
• Fix formatting on inactive message panel (Thanks, ST-DDT!)
• Prevent lock conflicts on zoom out files from blanking tiles
• Shift configuration URL processing to main thread (API safety)
• Fix model for cake block

Version 0.36.3

• Fix login registration process in json file mode
• Add 'chatlengthlimit' setting - limit size of chat messages from web
• Preserve login user ID case (don't make lowercase all the time)
• Protect against exception when player skin is invalid size
• Fix typos on login web page

Version 0.36.2

• Fix bPermissions and PermissionsBukkit support
• Add 'webchat-permisisons' setting - disable checking for dynmap.webchat permission by default
• Add model for chests

Version 0.36.1

• Fix handling of lighting of custom Spout blocks, new world height with Spout custom blocks
• Avoid issues when Spout fails to load
• Fix chatbox.js exception with scrollback+webchat-requires-login
• Remove extra comma from map.js (KenanY)
• Support proper rendering of v1.2.x door positions
• Remove worlds with no maps from map menu
• Fix potential out of order update of json file configuration and world updates
• Add gettiles.php script - option to avoid logging 404 errors on external servers

Version 0.36

• Add user-ID based login for web interface, including in-game registration command /dynmap webregister
• Add dynmap.webchat permissions to allow permission-based restriction of web chat (login and ID-by-IP based user IDs)
• Option for mandatory login for web access (login-required) and option for mandatory login for web chat (webchat-login-required)
• Avoid potential thread safety issues with JVM's ImageIO class
• Add specific support for PermissionsEx, bPermissions, PermissionsBukkit
• Update textures and add new blocks for 1.2.4 (colored planks, new sandstone)
• Prevent traps with some spout custom blocks
• Fix CF Foam texture for IndustrialCraft 2 - was indexing into terrain.png!
• Handle zero map worlds more cleanly
• Add misc/swampgrasscolor.png and misc/swampfoliagecolor.png support
• Handle custom water color shading (misc/watercolorX.png) (e.g. Misa texture)
• Fix thread safety issue in JSONFileUpdate (rare exception)
• Fix client IP on up.php forwarded chat messages
• Make fillOpacity=0 areas/circles polylines versus area
• Fix circle marker - was ignoring x,z coord of center
• Make it possible to override the sidebaropened option from the URL
• Fix /dynmap updaterender <mapname> - only render selected map

Version 0.35

• Add support for Circle/Ellipse Area Markers (/dmarker addcircle/updatecircle/deletecircle/listcircles)
• Update to 1.2-style biome shading (1.1 will do this too - sorry)
• Retire old beta render options (correct-biome-shading, smooth-biome-shading, waterbiomeshaded, swampshaded, fence-to-block-join)
• Fix problem with hiding all-glass chunk sections when they are top of chunk
• Fix coordinate screw up on spawn marker (thanks, fernferret!)
• Add 'visiblelines' setting for 'chatbox' - control visible space for chat history
• Add option to add maps to other world's map list (append_to_world attribute on HDMaps)
• Add 'hiddenids' option to control hiding of blocks in topographic renderer, add topo-noplants shader to hide trees/plants
• Fix coloring range on topo shaders : add topo256 shader for worlds generated with 256-high terrain
• Make coord box grow when needed
• Prevent very rare null exception in render
• Support newer custom water/lava layout in texture packs (anim/ directory in texture packs)
• Add circle marker APIs
• Fix marker API and command line behavior with normalized world names
• Handle lighting checks above world top

Version 0.34

• Finish support for CB 1.2.3 (CB 1.1-R3 or later still supported)
• Very large performance boost on rendering, both on CB 11 and CB 1.2 worlds (50-100% faster)
• Fix render of nether in 1.2
• Drop listeners on disabled triggers, where possible (help performance on big servers on busy triggers)
• Add support for 'blockgrow' trigger - various plant growth events
• Support world names containing '/' in name
• Add jungle saplings, top-half slabs, new stone brick blocks
• Add CB 1.2 blocks on legacy renderers
• Add jungle and jungle-hills biome support
• Add support for rendering ComputerCraft blocks
• Fix port binding issue on some Windows boxes


Version 0.33

• Update to new 1.1 event system (1.1-R5 ready)
• Update internal web server (Jetty v8.1.1)
• Add disable API for internal chat-to-web processing (prep for Dynmap-HeroChat)
• Disable existing HeroChat component (incompatible with new event model - Dynmap-HeroChat will support HeroChat v5.5)
• Make UI handle non-standard world heights and sea level values
• Big improvements in performance on 'blockphysics' and 'blockfromto' triggers - much fewer unneeded render triggers
• Add optional send message push button for web UI (chatbox component)
• Delay player join web message reporting slightly, so that player hiding mods like VNP have time to hide player before we report
• Add global setting for image-format - changes all HDMaps that don't have their own image-format setting
• Add support for current 1.2-prerelease blocks, including inverted stairs, redstone lamps.
• Add default shader 'lit-cave' for cave view that only shows caves with lighting
• Fix problem with texture packs with custom_water_still.png but no custom_water_flowing.png
• Add smooth movement of player icons on map view
• Fix problem with /dmap worldset <world> center:here
• Fix error with not listing players on disabled worlds
• Fix 'stokeWeight' typo in Area and Polyline markers - kept custom stroke weight from being preserved properly

Version 0.32

• Added 'structuregrow' trigger - update on sapling growing to tree, mushroom growing giant
• Add assertPlayerVisbility() API (for other plugins)
• Add Poly-Line Markers - multi-line-segment map markers (for marking things like raile routes, roads, etc)
• Migrate event handling to new 1.1 event system (breaks compatibility with CB 1.0.1 and earlier)
• Add 'maxofflinetime' setting to 'markers' component - age out old 'offline player' markers
• Add smooth lighting support (via 'smooth-lighting' setting - global setting and per-lighting setting) - makes lighting and shadows very smooth (no blocky edges)
• Make smooth swamp biome shading 'extra smooth' (like smooth lighting - no block edges)
• Add support for /dmarker add and /dmarker update supporting explicit coordinates (x, y, z, world)
• /dmarker add corner command now requires Y coordinate when adding using explicit coordinates
• Some initial support for Forestry mod rendering (resources, ores)
• Add support for controlling show/hide of marker labels per marker set (versus just globally), via 'showlabels' atttribute
• Fix 'includehiddenplayers: true' problem - caused all player markers to be hidden
• Add default lighting definitions for using smooth lighting (shadows-smooth, night-smooth, etc)

Version 0.31:

• Add map/world configuration commands - /dmap commands (see https://github.com/webbukkit/dynmap/wiki/Configuring-Maps-and-Worlds-using-dmap)
• Retire/remove 'chunkloaded' trigger, add warning for 'playermove' trigger
• Fix break in update/event processing on 1.1 when using /dynmap reload
• Fix incorrect reporting of cancelled chat messages to web
• Add assertPlayerInvisibility API (allow other plugins to hide/show players)
• Add 'show-mcr' option for 'coord' control (show MCR file names)
• Fix HeroChat v4.x support
• Fix/improve Spout custom block support - more than just SpoutMaterials support
• Add support for greater-than-128 high worlds (on modded CBs)
• Add render support for Kaevator's SuperSlopes
• Add render support for RailCraft blocks
• Fix rare error with JSON file update (concurrent modification error)
• Limit wait on graceful shutdown of web server to 10 seconds
• Fix message duplication on JSON web messages when sendmessage.php run by different server
• Fix counting logic on 'fullrenderplayerlimit'
• Add 'grid-scale' option on TexturePackHDShader - optionally draw grid on maps
• Fix occasional exceptions in web server during shutdown
• Fix problem with handling some non-alphanumeric characters in web path or tiles path on Windows
• Fix occasional edge-of-tile artifacts on HD renders (missing partial water blocks)

Version 0.30.1:

• Prevent display of unnecessary jetty exceptions in server console
• Workaround bizarre custom block texture handling in some versions of Spout and SpoutMaterials
• Add preliminary support for MC v1.2 blocks - jungle trees and leaves

Version 0.30:

• Replace internal web server with Eclipse Jetty (Thanks to FrozenCow!!)
• Fully support 1.1.0 features: New smooth swamp biome shading (set smooth-biome-shading: true), 5 new biomes
• Add support for Industrial Craft 2 Power Converters mod
• Add support for Industrial Craft 2 Charging Bench mod
• Add support for Industrial Craft 2 Advanced Machines mod
• Add support for NetherOres mod
• Add option for whole-body player icons (showplayerbody: true)
• Support Spout custom blocks (SpoutMaterials)
• Keep JSON config and updates in sync - avoid GUI cycling bug when server shutdown
• Change lowres surface map template to 'shadows' lighting
• Fix popup text for area markers on IE9
• Huge code refactor - split code to allow porting to other servers

Version 0.29.2:

• Fix for problem with 0.29.1 render settings not being reloaded properly during /dynmap reload - can screw up active renders that depend on them being set 'true'.
• Minimize event processing done on main thread - queue processing to another thread
• Fix race condition on web configuration cache that could cause web UI to cycle
• Fix UI exception when 'showlayercontrol' is false.

Version 0.29.1

• Make new render improvements, which require full map renders to make the maps look right, disabled by default on existing installs (the default configuration.txt will enable them, as will adding the following settings to configuration.txt):
  
  Code:

    use-generated-textures: true
    correct-water-lighting: true
    correct-biome-shading: true
    

Version 0.29

• Add a bunch of render improvements and options, to make maps better match native client:
  - Add texture generators for fire, lava, water
  - Fix water lighting and biome shading to match MC client
  - Fix lily, birch, pine leaf shading to match client
  - Add 'better-grass' setting - allows grass and snow to be rendered as done by BetterGrass mod
  - Generate lily pads with same orientation pattern as native UI
• Add support for RedPower2 blocks
• Add support for tailoring block IDs in RedPower2, IndustrialCraft2, and BuildCraft support with configuration.txt settings
• Add /dynmap updaterender command - renders starting at selected location and continuing until tiles not needing update are reached
• Added support for correlating player logins with their IP addresses, and using this to label (and even block) web chat (via use-player-login-ip, require-player-login-ip, block-banned-player-chat settings)
• Add /dynmap add-id-for-ip and /dynmap del-id-for-ip to allow manual add and remove player ID to IP mappings, and /dynmap ids-for-ip and /dynmap ips-for-id to query the data.
• Added 'link' UI component - adds 'link' button to generate URL for current window view, with all view-sensitive parameter (world, map, zoom, position)
• Add 'blockfromto' and 'blockphysics' triggers - needed for lava and water flowing driven updates
• Add hideifsneaking option for hiding players that are sneaking/crouching
• Add support for optional spawn-bed layer (show player's spawn beds) (showspawnbeds, spawnbed* settings)
• Made the sidebar use clicking instead of hovering for mobile devices (thanks FrozenCow!)
• Add 'followmap' and 'followzoom' to allow setting of map and zoom when a user is selected to be followed
• Added 'hidechat' URL parameter - turns off all chat components on loaded window
• Add 'pinned' choice for showlayercontrol: setting - show expanded layer selection all the time
• General code structure work, prepping code for other server ports
• Updated sample maps in worlds.txt to be HD maps
• Add customization/translation for "Players" and "Map Types" UI labels
• Fix jQuery problem with double questionmarks (??) in web chat
• Improve browser cache behavior with tiles (cache more often)
• Prevent caching of configuration URL on JSON file mode
• Make 2D outlines support Y coordinates other than y=64
• Reconnect active command output to player after restart, logoff/logon

Version 0.28

• Fix for slow memory leak in chunk snapshot cache (IMPORTANT FIX for folks with large maps) - thanks to @snowleo (in @essentialsteam) for getting me looking the right place for this!
• Add 'minzoom' setting for marker sets - allows markers in set to only be visible at settable minimum zoom in level.
• Corresponding API support for 'minzoom'
• Add 'chatname' URL parameter, to allow web chat name to be supplied by web user (requires 'trustclientname: true' setting, as well as new 'allowurlname: true' on 'chat' compnent)
• Add 'playername' URL parameter, to allow web to be launched following a given player
• Fix handling of cases when biome texture pack images (grasscolor.png, foliagecolor.png, watercolor.png) are transparent (as in Painterly texture packs)
• Handle issues with border tiles sometimes showing as white with JPG image-format
• Add handling of Essential /nick style color coding in player display names (&0-&f codes are stripped)
• New default shaders, perspectives, and lightings are now merged with existing shaders.txt, perspectives.txt, and lightings.txt - adds missing ones, but doesn't overwrite existing (possibly tailored) ones.

Version 0.27

• Fix for serious lag issue when rendering nether on current CB builds
• Add /dynmap radiusrender <world> <x> <z> <radius> - console-runnable radius render
• Make markers and area-markers not have popup when label set to "" (blank)
• Add 'grayplayerswhenhidden' option to allow disable of player graying in player list
• Add additional example topological map shader - thanks to TerraNetworkOrg!
• Speed up rendering of water, and blocks models that fill block after scaling
• Support automatic cleanup of stale map tiles at end of successful fullrender runs
• Add 'usenormalthreadpriority' option to allow render threads on Windows to run with normal priority
• Add 'showlayercontrol' option to allow hiding of layer control, even when marker layers are defined
• Fix problem with scaling of faces in chat box

Version 0.26

• Add support for topographical maps shader (TopoHDShader)
• RETIRED regions component (old Residence, Factions, WorldGuard, Towny support) - switch to add on plugins (Dynmap-<mod>).
• Add workarounds for 1.0.0 issues with excessive backlogs with TickList
• Add tiles-rendered-at-once setting to control number of triggered update tiles to process concurrently
• Various rendering performance tweaks
• Improve efficiency of marker update events - better support large marker populations
• Add 'fullrenderplayerlimit' - pause fullrender processing when number of active players is above set limit
• Add '/dynmap pause' command to allow pausing and resuming of fullrender and/or update render processing
• Support IP banning of messages from external web servers (proxied with internal - not JSON)
• Add 'hidey' option to 'coords' component to hide Y coordinate
• Fix playermarker component so that player's location is middle of icon (was top-left corner)
• Add support for 8x8 and 32x32 markers (in addition to existing 16x16 support)
• Add '/dynmap triggerstats' to view details of tile updates caused by various triggers
• Add additional performance metrics to '/dynmap stats'
• Automatically reload UI when configuration changes, server restarts, new worlds added
• Fix problem with handling worlds with periods in name
• Fix problem with dropping of some points in complex border outlines at some zoom levels
• Make compass rose smaller on mobile devices
• Add APIs for pausing/resuming render processing
• Publish DynmapWebChatEvent custom event, method for sending chat messages
• Publish hide/show player API

Version 0.25.1

• Fix build FUBAR that resulted in PermissionsEx breaks
• Include build number in version (help track dev builds better)
• Texture fixes for webs, iron fences, redstone repeaters

Version 0.25

• Finished support for 1.0.0 GA
• Deprecated 'regions' component (still functional for 0.25, but being removed in 0.26), in favor of new Dynmap-Residence, Dynmap-WorldGuard, Dynmap-Towny, and Dynmap-Factions plugins
• Revamped biome color schemes, including adding new 1.0.0 biomes
• Optimize marker JSON and persistence file updates - improve performance of large marker sets
• Switch default compass-mode for new installs to 'newnorth' (optimal for 1.0.0 map orientation)
• Add trigger statistics, viewable by /dynmap triggerstats command
• Fix bug with new sign-based markers showing <br/>
• Fix various texture mappings on some blocks (rails, stairs)
• Handle some special-case renders for non-standard block data (invisible stairs, single and double slabs)
• Add new templates for 1.0.0 world type "The End", and handle it's special lighting behaviors
• Add 'webpage-title' setting to control title of web page: default to server-name setting
• Fix problem with Area Markers being left around after switching to new maps, and with label markup and descriptions not being properly updated (Marker API)
• Split programming API into its own project and JAR file, to simplify use by plugin developers (see https://github.com/mikeprimm/dynmap-api)
• Make hidden players not generate join/quit messages on web chat

Version 0.24
Thanks to Mikeprimm

• Added support for 1.9-pre5
• Support IndustrialCraft 2 and BuildCraft 2.x blocks (ic2-support and buildcraft-support settings)
• Added 'very low res' HD perspectives (vlowres), and set default configuration.txt to use them instead of FlatMap/KzedMap (only impacts clean installs)
• Added 'fetchskins' and 'refreshskins' controls to allow options on player skin loading by server
• Handle issues with improper rendering of some HD tiles on edge of word
• Add controls for adjusting new 1.9-style rendering options (waterbiomeshaded, swampshaded, fence-to-block-join)
• default off for 1.8, on for 1.9
• Added east and west facing default perspectives
• Prevent big tile queue from starving fullrenders/radiusrenders, and make fullrender/radiusrenders clear tiles from update queue, when appropriate
• Enhanced Marker API to include descriptions for markers (optional HTML popup)
• Enhanced Marker API to support 'areas'
• like the outlines for the 'regions' components
• Added 'onlyiflit' option for cave renderer
• only shows caves lit by a light source
• Add 'compass-mode' to allow options for handling changes to world compass (sunrise moved in 1.9...)
• Add command-line commands for marker areas
• Added /dynmap sendtoweb command to send messages to just web users, and associated API
• Added API to allow other plugins to drive re-renders of regions of maps
• Add support for hiding individual subareas in the Residence component
• Added 'hideifundercover' and 'hideifshadow' options to hide player markers when player is under blocks and/or in low light
• Added 'webmsgformat' (replacement for webprefix/websuffix
• more flexible)
• Added support for scrolling with world list
• Added support for preserving map center when switching between worlds
• Fix problem with caching of updates in standalone/JSON mode
• Fix problems in scaling of transparent textures (made flat map in HD look bad)
• Make trapdoors render properly
• Fix 'defaultworld' setting

Version 0.23
Thanks to Mikeprimm, FrozenCow, Klowner and Godsyn

• Added support for 1.9 rendering
• Added save/resume support for fullrender and radiusrenders (to be able to stop and resume later with rendering
• Made the world spawn-point now the center-point (instead of 0,0)
• Added 'hideores' to make ore blocks look like plain stone
• Added scrollback option to webchat.
• Added support for HTML-markup-encoded marker labels, with associated API for developers
• Added 'nethershadows' lighting (use 'lighting: nethershadows' in your templates)
• Added support for optional 'offline players' markers
• Added URL-option 'nopanel' to remove sidebar (use http://yourserver:8123/?nopanel=true)
• Added 'inactive'-component to redirect or stop users when they are not using the map for some time (thanks godsyn!)
• Fixed support for Residence 2.4.2
• Fixed support for Towny outposts
• Fixed rendering of redstone torches, jack-o-lanterns and vines.
• Fixed markers not showing label in Chrome

Dynmap API:
For plugin programmers that want to integrate with Dynmap, we now offer a simple JAR containing the published interfaces - this is only intended for building code that uses the API (in the same way that bukkit.jar is used for building to craftbukkit). The API information:

Download latest (recommended) version
Source code

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

Mods integrated with Dynmap:
The following mods are known to support dynmap integration without needing an add-on:

• DeathTPPlus
• xWarp
• Vanish No Packet