[MISC] Dynmap v0.32 - Realtime Minecraft maps [1.1-R4]

Dynmap - Realtime Minecraft maps:
Version: v0.32

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

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 (new plugin name, API changes)
• /dynmap reload isn't working right in 0.30.x

Changelog:
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

Version 0.22.1
Thanks to Mikeprimm

• 1.8 compatibility
  • If you are already running an 1.8 build of Bukkit, upgrade to at least CB 1141.
• Added coord component (shows location of cursor)
• Fixed lighting quirks with stairs and slabs
• Fixed lighting issues with cactus
• Added portal and minecart icons for markers.
• Added /dmarker updateicon and /dmarker deleteicon
• Added support for spaces in world names via double-quotes on commands
• Fix for Marker-API users when doing /dynmap reload

Version 0.22
Thanks to Mikeprimm

• Added support for map markers and marker sets, including:
  • Marker API for other plugins
  • Creating and managing markers and marker sets via console commands
  • Defining markers using signs
  • Showing map spawn points with markers
  • Registering custom icons for use as marker
• Add Factions support
• Towny fixes (non-standard town_block_size)
• Custom block model and texture improvements
• Fix for non-rendering of KzedMaps after first (cave)
• Added 'pinned' option for sidebaropened
• Added support for custom http response headers
• Handle background colors on JPEG format maps properly (including day/night)
• Improved error reporting for mismatches on plugin-to-web UI version mismatches, and missing component files

Version 0.21.1
Thanks to Mikeprimm

• Fixed support for Towny Advanced

Version 0.21
Thanks to Mikeprimm

• Added support for Towny
• Added support for Superperms/BukkitPermissions
• Hide/show layer support for player markers and regions (WorldGuard/Residence/Towny)
• Support for JPEG image format option on maps (various qualities) - smaller size and bandwidth vs quality
• Per Region outline and fill tailoring for all regions components (per nation for Towny, also)
• Region hidden list (exclude) for regions components
• Server-side face rendering (works with IE8 and with accessory faces)
• Multi-threaded fullrender option
• Fix for tile rendering on HD maps with chunkgenerate (checkerboard render)
• Option for accelerated render interval when settable backlog of tiles exceeded
• /dynmap reload now works - no duplicate chat messages, event handlers
• Add support for 'explosion' trigger
• Add support for piston rendering, and 'pistonmoved' trigger
• Improved rendering of rails, ladders, redstone, repeaters
• Single-map fullrender (/dynmap fullrender worldname:mapname) and radiusrender (/dynmap radiusrender radius mapname).
• Add progressloginterval setting to control how often progress messages are reported
• Fixes for armor display, alpha blending on textures and models, zoomout processing efficiency, debug code left in UI (IE problems), player list scroll buttons, Residence in JSON File mode, rendering newly generated tiles before they're populated, naming of Residence regions, infowindow processing on region popups.

Version 0.20.1
Thanks to Mikeprimm and FrozenCow

• Fixed (some) leaves not being rendered.
• Fixed worldguard not working when global settings are defined.
• Fixed redstone not being rendered on flatmap.
• Fixed/improved rendering of cacti.
• Fixed configuration option 'sendposition'.
• Added worldguard poly2d-regions once again.
• Throttled tile-loading, so that the browser doesn't request all tiles on screen at once.

Version 0.20
Thanks to Mikeprimm and FrozenCow

• Added HD renderer(s), which can render maps in full detail using Minecraft textures (terrain.png) as well as using existing colorschemes, biomes, or cave views
• Replaced Google Maps with Leaflet, which affects look/feel
• Split configuration in separate files
• Added 'custom-' configuration files, which won't be overwritten each release
• Support '/dynmap cancelrender <world>' to cancel active render operations on a world
• Added '/dynmap radiusrender <radius>' command to render an area around the player
• Made number of levels that the browser can zoom (=digital zoom) configurable
• Added rendertriggers for blockformed, blockfaded, blockspread
• Fixed armor calculation
• Improved render performance
• Improved stability for internal webserver
• Removed references to remote files: Dynmap can now work without internet connection
• Fixed '/reload'
• Updated support for Residence regions (2.3+)
• Support polyline-based region outlines in WorldGuard regions
• Support for blocking banned-ips.txt addresses on internal web server
• Added ability to add logo/link to map (logo component)
• Several fixes/improvements

Version 0.19.2
Thanks to Mikeprimm

• Added support for new 1.7 blocks
• Added workaround for furnace blocks (which threw an exception before CB955).
• Fixed read-timeout for tile files: caused black tiles

Version 0.19.1
Thanks to Mikeprimm

• Added polygon support for WorldGuard
• Added safe symlink support once again (when 'allow-symlinks' is set)
• Fixed handling of in-use files
• Fixed '/reload' handling
• Fixed 'center' configuration
• Fixed 'visibleregions' configuration for Regions-component

Version 0.19
Thanks Mikeprimm and Kilandor

• Fixed security vulnerability
• Added support for biomes
• URL-parameters for opening a the map on a specific location in a specific world
• verbose option for less log on startup
• Added visibilitylimit to restrict which areas of the map are rendered.
• Added chunkgenerated render trigger to keep the world updated when it expands
• Added showform, blockburn, leavesdecay render triggers
• Added bigworld configuration to put tiles in seperate directories
• Added additional (configurable) zoom-out levels
• Added trustclientname configuration to allow users to set their username (only backend, no gui)
• Added icon for skylands
• Reports progress to the initiator of fullrender, instead of only the log
• Dynmap now tries to rewrite a tile a number of times when the file is in use (for example by an external webserver)
• Fixed armor calculation
• Fixed webpath configuration of regions component.
• Fixed chat balloons being shown when player is in other world
• Fix for IE

Version 0.18
Thanks to Mikeprimm, zeeZ, Flames, MiLk

• Added (official) support for skylands.
• Added light/shadows.
• Added night-view.
• Added automatic day-night switching.
• Added 'sidebaropened' option (auto-pin sidebar)
• Added configurable webchat prefix and suffix.
• Added transparency support for flatmap. (nicer maps, less performance)
• Added configurable background colors.
• Added 'hidewebchatip' option to replace IP with alias.
• Made player-information being send configurable per world. (for example for pvp worlds)
• Fixed player positions being send when on disabled worlds.
• Fixed playernames with spaces not being fully shown.
• Fixed encoding in web/chat messages.
• Fullscreen layout for iPhone and iPad.
• Improved performance of flatmap.
• Overal improved performance of rendering.
• Many other fixes.

Version 0.17
Thanks to Mikeprimm, zeeZ and FrozenCow

• Major overhaul of configuration: Dynmap should now work out-of-the-box
• Added world-templates to configuration
• Health and armor indicators for player-markers
• Added shadows to isometric maps
• Greatly optimized rendering
• Added ability to set each url individually for json-file without (Apache) rewrite-rules
• Progress messages for fullrenders
• HeroChat support
• Support for custom display-names of players
• Wool colors for flatmap
• Added ability to set center of map
• Added components for better integration of thirdparty featues

Version 0.16.1

• Fixed markers being positioned incorrectly on flatmap

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.
• Dynmap2CraftIRC3: Integrate Dynmap's web chat with IRC via CraftIRC
• Dynmap-SimpleClans: Integrate SimpleClans with Dynmap