dynmap configuration files (0.22)

configuration.txt

# All paths in this configuration file are relative to Dynmap's data-folder: minecraft_server/plugins/dynmap/

# All map templates are defined in the templates directory
# By default, the 'classic' FlatMap and KzedMap templates are used, which can be found in normal.txt, nether.txt, and skylands.txt
#
# To use the HDMap low-res map templates as world defaults (normal-lowres, nether-lowres and skylands-lowres), uncomment the following line
#   The definitions of these templates are in normal-lowres.txt, nether-lowres.txt, and skylands-lowres.txt
#deftemplatesuffix: lowres
# To use the HDMap hi-res map templates (these can take a VERY long time for initial fullrender), comment the following line
#   The definitions of these templates are in normal-hires.txt, nether-hires.txt, and skylands-hires.txt
#deftemplatesuffix: hires
# Other values will search for templates named normal-<value>, nether-<value>, skylands-<value>

components:
  - class: org.dynmap.ClientConfigurationComponent
 
  - class: org.dynmap.MarkersComponent
    type: markers
    showlabel: false
    enablesigns: false
    showspawn: false
    spawnicon: world
    spawnlabel: "Spawn"
 
  - class: org.dynmap.InternalClientUpdateComponent
    sendhealth: true
    sendposition: true
    allowwebchat: true
    webchat-interval: 5
    hidewebchatip: false
    trustclientname: false
  #- class: org.dynmap.JsonFileClientUpdateComponent
  #  writeinterval: 1
  #  sendhealth: true
  #  sendposition: true
  #  allowwebchat: false
  #  webchat-interval: 5
  #  hidewebchatip: false
  
#  - class: org.dynmap.SimpleWebChatComponent
#    allowchat: true
  - class: org.dynmap.herochat.HeroWebChatComponent
    # Control which HeroChat channel messages from web are directed to 
    herochatwebchannel: dynmap
    # Control which channels are monitored and reported to the web
    herochatchannels:
      - dynmap
  
  - class: org.dynmap.ClientComponent
    type: chat
#  - class: org.dynmap.ClientComponent
#    type: chatballoon
#    focuschatballoons: false
  - class: org.dynmap.ClientComponent
    type: chatbox
    showplayerfaces: true
    messagettl: 5
  - class: org.dynmap.ClientComponent
    type: playermarkers
    showplayerfaces: true
    showplayerhealth: true
    # Option to make player faces small - don't use with showplayerhealth
    smallplayerfaces: false
  #- class: org.dynmap.ClientComponent
  #  type: digitalclock
  - class: org.dynmap.ClientComponent
    type: timeofdayclock
    showdigitalclock: true
    showweather: true
  #- class: org.dynmap.ClientComponent
  #  type: logo
  #  text: "Dynmap"
  #  linkurl: "http://forums.bukkit.org/threads/dynmap.489/"
  #- class: org.dynmap.regions.RegionsComponent
  #  type: regions
  #  name: WorldGuard
  #  useworldpath: true
  #  filename: regions.yml
  #  basenode: regions
  #  use3dregions: true
  #  regionstyle:
  #    stroke: true
  #    color: "#FF0000"
  #    opacity: 0.8
  #    weight: 3
  #    fill: true
  #    fillColor: "#FF0000"
  #    fillOpacity: 0.35
  #  # Optional setting to limit which regions to show, by name - if commented out, all regions are shown
  #  visibleregions:
  #    - homebase
  #    - miningsite
  #- class: org.dynmap.regions.RegionsComponent
  #  type: regions
  #  name: Residence
  #  useworldpath: false
  #  filename: res.yml
  #  basenode: Residences
  #  use3dregions: false
  #  infowindow: '<div class="infowindow"><span style="font-size:120%;">%regionname%</span><br /> Owner <span style="font-weight:bold;">%playerowners%</span><br />Flags<br /><span style="font-weight:bold;">%flags%</span></div>'
  #  regionstyle:
  #    strokeColor: "#FF0000"
  #    strokeOpacity: 0.8
  #    strokeWeight: 3
  #    fillColor: "#FF0000"
  #    fillOpacity: 0.35
  #  # Optional setting to limit which regions to show, by name - if commented out, all regions are shown
  #  visibleregions:
  #    - homebase
  #    - miningsite
  #- class: org.dynmap.TestComponent
  #  stuff: "This is some configuration-value"

# Treat hiddenplayers.txt as a whitelist for players to be shown on the map? (Default false)
display-whitelist: false

# How often a tile gets rendered (in seconds).
renderinterval: 1

# Zoom-out tile update period - how often to scan for and process tile updates into zoom-out tiles (in seconds)
zoomoutperiod: 60

# Tile hashing is used to minimize tile file updates when no changes have occurred - set to false to disable
enabletilehash: true

render-triggers:
  #- chunkloaded
  #- playermove
  #- playerjoin
  - blockplaced
  - blockbreak
  - leavesdecay
  - blockburn
  - chunkgenerated
  - blockformed
  - blockfaded
  - blockspread

# The path where the tile-files are placed.
tilespath: /home/fabian/servers/tiles/

# The path where the web-files are located.
webpath: web

# The network-interface the webserver will bind to (0.0.0.0 for all interfaces, 127.0.0.1 for only local access).
webserver-bindaddress: 0.0.0.0

# The TCP-port the webserver will listen on.
webserver-port: 8028

# Maximum concurrent session on internal web server - limits resources used in Bukkit server
max-sessions: 30

# Disables Webserver portion of Dynmap (Advanced users only)
disable-webserver: false

# Enable/disable having the web server allow symbolic links (true=compatible with existing code, false=more secure (default))
allow-symlinks: true

# Period between tile renders for fullrender, in seconds (non-zero to pace fullrenders, lessen CPU load)
timesliceinterval: 0.2

# Maximum chunk loads per server tick (1/20th of a second) - reducing this below 90 will impact render performance, but also will reduce server thread load
maxchunkspertick: 200

# Interval the browser should poll for updates.
updaterate: 2000

showplayerfacesinmenu: true

# Set sidebaropened: true to pin menu sidebar opened
#sidebaropened: true

joinmessage: "%playername% joined"
quitmessage: "%playername% quit"
spammessage: "You may only chat once every %interval% seconds."
# webprefix and websuffix support using '&color;' as escape code for color code
webprefix: "&color;2[WEB] "
websuffix: "&color;f"
# Enable checking for banned IPs via banned-ips.txt (internal web server only)
check-banned-ips: true

# Default selection when map page is loaded
defaultzoom: 0
defaultworld: world
defaultmap: flat

# NOTE: the 'templates' section is now found in the 'templates' directory
#  Templates CAN still be defined in configuration.txt, as before 0.20
templates:

# NOTE: the 'worlds' section is now found in the worlds.txt (example custom settings can be found in worlds.txt.sample)
#  Worlds CAN still be defined in configuration.txt, as before 0.20
worlds:

# Set to true to enable verbose startup messages - can help with debugging map configuration problems
# Set to false for a much quieter startup log
verbose: false

# Enables debugging.
#debuggers:
#  - class: org.dynmap.debug.LogDebugger

custom-normal-hires.txt

version: 0.21
#
# Default template for "Normal" environment worlds (deftemplatesuffix="lowres")
#  Uses the HDMap renderer with view from the SE with the "lowres" resolution (4 pixels per block edge)
#
#   This file MAY need to be replaced during an upgrade - rename file to 'custom-normal-lowres.txt' if you wish to customize it
#
templates:
  # Template for normal world (HDMap lowres)
  custom-normal-hires:
    enabled: true
    # Number of extra zoom-out levels for world (each level is twice as big as the previous one)
    extrazoomout: 2
    center:
      x: 0
      y: 64
      z: 0
    maps:
      - class: org.dynmap.hdmap.HDMap
        name: flat
        title: "Flat"
        prefix: flat
        perspective: iso_S_90_hires
        shader: stdtexture
        lighting: nightandday
        # Adjust extra zoom in levels - default is 2
        #mapzoomin: 2
      - class: org.dynmap.hdmap.HDMap
        name: surface
        title: "Surface"
        prefix: t
        perspective: iso_SE_60_hires
        shader: stdtexture
        lighting: nightandday
        # Adjust extra zoom in levels - default is 2
        #mapzoomin: 2
      - class: org.dynmap.hdmap.HDMap
        name: cave
        title: "Cave"
        prefix: ct
        perspective: iso_SE_60_lowres
        shader: cave
        lighting: default
        # Adjust extra zoom in levels - default is 2
        #mapzoomin: 2
      - class: org.dynmap.hdmap.HDMap
        name: biome
        title: "Biome"
        prefix: b
        perspective: iso_SE_60_lowres
        shader: biome
        lighting: default
        # Adjust extra zoom in levels - default is 2
        #mapzoomin: 2

worlds.txt

# These are examples of world-specific settings - customize your content as you see fit
#
# NOTES:
#   All lines here are commented with the # symbol - delete the # symbol on copied lines you wish to enable
#   Definitions of a world made here will superecede any world definition with the same name in configuration.txt
#   Deleting this file will result in a fresh copy being produced by dynmap.jar on the next startup.
#
worlds:
  - name: world
    title: "Welt"
    template: "custom-normal-hires"
  - name: exp
    title: "Experimental"
    template: "custom-normal-hires"
  - name: nether
    title: "Nëther"
    template: "nether-lowres"
  - name: m4d
    enabled: false
  # Worlds can be handled by templates, based on world type
  # You can override the properties of the template by specifying them in this section
  #    for example 'Title: "My Awesome World"'
  #- name: world
  #  title: "World"
  #   Use 'enabled: false' to disable a certain world.
  #  enabled: false
  #   Use sendposition: false to prevent player positions from showing when on this world (if sendposition is globally enabled)
  #  sendposition: false
  #   Use sendhealth: false ot prevent player health from showing when on this world (if sendhealth is globally enabled)
  #  sendhealth: false
  #  # If world isn't contiguous chunks (due to teleporting, for example), fullrender needs to be given other locations to scan for tiles on each patch of chunks
  #  fullrenderlocations:
  #    - x: 10000
  #      y: 64
  #      z: 20000
  #    - x: -15000
  #      y: 64
  #      z: -5000
  #  # Use visibilitylimits to restrict which areas of maps on your world to render (zero or more rectangles can be defined)
  #  visibilitylimits:
  #    - x0: -1000
  #      z0: -1000
  #      x1: 1000
  #      z1: 1000
  #    - x0: -2000
  #      z0: -1000
  #      x1: -1000
  #      z1: -500
  #  # Use hidestyle to control how hidden-but-existing chunks are to be rendered (air=empty air (same as ungenerated), stone=a flat stone plain, ocean=a flat ocean)
  #  hidestyle: stone
  #  # Use 'autogenerate-to-visibilitylimits: true' to choose to force the generation of ungenerated chunks while rendering maps on this world, for any chunks within the defined
  #  # visibilitylimits (limits must be set).  The three options here are: none (default - no autogenerate), map-only (temporarily generate chunks for map, but don't save them (no world change),
  #  # permanent (generate and save chunks - this permanently adds the chunks to the world, as if a player had visited them - BE SURE THIS IS WHAT YOU WANT)
  #  autogenerate-to-visibilitylimits: map-only
  #   Use 'template: mycustomtemplate' to use the properties specified in the template 'mycustomtemplate' to this world. Default it is set to the environment-name (normal or nether).
  #  template: mycustomtemplate
  #   Rest of comes from template - uncomment to tailor for world specifically
  #  center:
  #    x: 0
  #    y: 64
  #    z: 0
  #  # If bigworld set to true, use alternate directory layout better suited to large worlds
  #  bigworld: true
  #  # Number of extra zoom-out levels for world (each level is twice as big as the previous one)
  #  extrazoomout: 3
  #  maps:
  #    - class: org.dynmap.flat.FlatMap
  #      name: flat
  #      title: "Flat"
  #      prefix: flat
  #      colorscheme: default
  #      # The textured setting makes the flat render toning much more consistent with the other maps: set to 'none' for the original flat texture, 'smooth' for blended tile top colors, 'dither' for dither pattern
  #      textured: smooth
  #      # To render a world as a "night view", set shadowstrength and ambientlight
  #      shadowstrength: 1.0
  #      ambientlight: 4
  #      # To render both night and day versions of tiles (when ambientlight is set), set true
  #      night-and-day: true
  #      # Option to turn on transparency support (off by default) - slows render
  #      transparency: true
  #      # Background color for map during the day
  #      backgroundday: "#153E7E"
  #      # Background color for map during the night
  #      backgroundnight: "#000000"        
  #      # Backgrounc color for map (independent of night/day)
  #      background: "#000000"
  #    - class: org.dynmap.kzedmap.KzedMap
  #      renderers:
  #        - class: org.dynmap.kzedmap.DefaultTileRenderer
  #          name: surface
  #          title: "Surface"
  #          prefix: t
  #          maximumheight: 127
  #          colorscheme: default
  #          # Add shadows to world (based on top-down shadows from chunk data)
  #          shadowstrength: 1.0
  #          # To render a world as a "night view", set shadowstrength and ambientlight
  #          ambientlight: 4
  #          # To render both night and day versions of tiles (when ambientlight is set), set true
  #          night-and-day: true
  #          # Option to turn off transparency support (on by default) - speeds render
  #          transparency: false
  #          # Background color for map during the day
  #          backgroundday: "#153E7E"
  #          # Background color for map during the night
  #          backgroundnight: "#000000"        
  #          # Backgrounc color for map (independent of night/day)
  #          background: "#000000"
  #          # Sets the icon to 'images/block_custom.png'
  #          icon: custom
  #        - class: org.dynmap.kzedmap.HighlightTileRenderer
  #          prefix: ht
  #          maximumheight: 127
  #          colorscheme: default
  #          highlight: # For highlighting multiple block-types.
  #            - 56 # Highlight diamond-ore
  #            - 66 # Highlight minecart track
  #          highlight: 56 # For highlighting a single block-type.
  #        - class: org.dynmap.kzedmap.CaveTileRenderer
  #          name: cave
  #          title: "Cave"
  #          prefix: ct
  #          maximumheight: 127
  #
  # To just label world, and inherit rest from template, just provide name and title
  #- name: world2
  #  title: "Second World"
  #
  #- name: nether
  #  title: "Nether"
  #  center:
  #    x: 0
  #    y: 64
  #    z: 0
  #  # Number of extra zoom-out levels for world (each level is twice as big as the previous one)
  #  extrazoomout: 3
  #  maps:
  #    - class: org.dynmap.flat.FlatMap
  #      name: flat
  #      title: "Flat"
  #      prefix: flat
  #      colorscheme: default
  #      # The textured setting makes the flat render toning much more consistent with the other maps: set to 'none' for the original flat texture, 'smooth' for blended tile top colors, 'dither' for dither pattern
  #      textured: smooth
  #    - class: org.dynmap.kzedmap.KzedMap
  #      renderers:
  #        - class: org.dynmap.kzedmap.DefaultTileRenderer
  #          name: nether
  #          title: "Surface"
  #          prefix: nt
  #          maximumheight: 127
  #          colorscheme: default