Dynmapの使い方と設定

storage:
  type: sqlite
  dbfile: "../../../hdd/dynmap.db"

mv -v /minecraft/plugins/dynmap/web/tiles /hdd/tiles
ln -sv /hdd/tiles /minecraft/plugins/dynmap/web/tiles

storage:
  type: filetree

server {
	listen 80;
	listen [::]:80;

	server_name example.com;

	location ^~ /dynmap/ {
		proxy_pass http://Minecraftサーバーのアドレス:8123/;
	}
}

<VirtualHost *:80>
        ServerName example.com;
        ProxyPass /dynmap/ http://Minecraftサーバーのアドレス:8123/
        ProxyPassReverse /dynmap/ http://Minecraftサーバーのアドレス:8123/
</VirtualHost>

# 画質の設定、テンプレート設定はtemplatesディレクトリにある
# 設定できる値は以下の通り
# vlowres: 超低解像度(2 ppb)
# lowres: 低解像度(4 ppb)
# hires: 高解像度(16 ppb)
# low_boost_hi: 低解像度(4 ppb)と高解像度(16 ppb)を組み合わせて使う
# hi_boost_vhi: 高解像度(16 ppb)と超高解像度(32 ppb)を組み合わせて使う
# hi_boost_xhi: 高解像度(16 ppb)と超々高解像度(64 ppb)を組み合わせて使う
# ppb=おそらくpixel per blockの意味だと思われる。
deftemplatesuffix: hires

# 保存方法の指定
# filetree: ファイルに保存
# sqlite: 単一の(巨大な)sqliteファイルとして保存
# mysql: mysqlに保存
storage:
  # 種類の指定
  type: filetree
  # SQLiteの場合はdbfileで保存先指定
  #type: sqlite
  #dbfile: dynmap.db
  # MySQLの場合は接続情報などが必要
  #type: mysql
  #hostname: localhost
  #port: 3306
  #database: dynmap
  #userid: dynmap
  #password: dynmap
  #prefix: ""
  #flags: "?allowReconnect=true"

components:
  - class: org.dynmap.ClientConfigurationComponent

  - class: org.dynmap.InternalClientUpdateComponent
    sendhealth: true
    sendposition: true
    allowwebchat: true
    webchat-interval: 5
    hidewebchatip: false
    trustclientname: false
    includehiddenplayers: false
    # オプション: trueの場合、プレイヤーの表示名のカラーコードが使用される
    use-name-colors: false
    # オプション: trueの場合、IPが一致するとプレーヤーのログインIDがWebチャットに使用される
    use-player-login-ip: true
    # オプション: use-player-login-ipがtrueの場合にこれをtrueに設定すると、既知のプレーヤーのIPと一致しないチャットメッセージが無視される。
    require-player-login-ip: false
    # オプション: チャットを禁止されているユーザーのログインIDをブロック
    block-banned-player-chat: true
    # Webからサーバーへのチャットにログインが必要か
    webchat-requires-login: false
    # trueの場合Webチャットにdynmap.webchatパーミッションが必要になる
    webchat-permissions: false
    # 単一のチャットメッセージの長さを制限
    chatlengthlimit: 256
  #  # オプション: 暗所や地下に居るときにプレイヤーを隠す
  #  hideifshadow: 4
  #  # オプション: プレイヤーが隠れている場合に非表示になる(明るさレベルで判定)
  #  hideifundercover: 14
    # オプション: trueの場合スニーク中のユーザーが非表示になる
    hideifsneaking: false
    # trueの場合、プレイヤーの位置や状態が保護される(dynmap.playermarkers.seeallを持つIDでログインしないと非表示になる)
    protected-player-info: false
    # trueの場合、不可視ポーションを使っているユーザーを非表示にする
    hide-if-invisiblity-potion: true
    # trueの場合、プレイヤー名がマップ、チャット、リストに表示されなくなる
    hidenames: false
  #- class: org.dynmap.JsonFileClientUpdateComponent
  #  writeinterval: 1
  #  sendhealth: true
  #  sendposition: true
  #  allowwebchat: true
  #  webchat-interval: 5
  #  hidewebchatip: false
  #  includehiddenplayers: false
  #  use-name-colors: false
  #  use-player-login-ip: false
  #  require-player-login-ip: false
  #  block-banned-player-chat: true
  #  hideifshadow: 0
  #  hideifundercover: 0
  #  hideifsneaking: false
  #  # Webからサーバーへのチャットにログインが必要か
  #  webchat-requires-login: false
  #  # trueの場合Webチャットにdynmap.webchatパーミッションが必要になる
  #  webchat-permissions: false
  #  # 単一のチャットメッセージの長さを制限
  #  chatlengthlimit: 256
  #  hide-if-invisiblity-potion: true
  #  hidenames: false

  - class: org.dynmap.SimpleWebChatComponent
    allowchat: true
    # trueの場合、Web UIユーザーは "playername"パラメーターを使用してチャットの名前を指定できるようになる。
    # "trustclientname"もtrueに設定する必要がある。
    allowurlname: false

  # この設定はdmarkerやAPIなどに必要
  - class: org.dynmap.MarkersComponent
    type: markers
    showlabel: false
    enablesigns: false
    # 看板で追加したマーカーのデフォルトセット
    default-sign-set: markers
    # オプション: スポーンポイントマーカーを表示する設定
    showspawn: true
    spawnicon: world
    spawnlabel: "Spawn"
    # オプション: ログアウト後のプレイヤーを一定時間表示する設定
    showofflineplayers: false
    offlinelabel: "Offline"
    offlineicon: offlineuser
    offlinehidebydefault: true
    offlineminzoom: 0
    maxofflinetime: 30
    # オプション: プレイヤーのベッドを表示する設定
    showspawnbeds: false
    spawnbedlabel: "Spawn Beds"
    spawnbedicon: bed
    spawnbedhidebydefault: true
    spawnbedminzoom: 0
    spawnbedformat: "%name%'s bed"
    # オプション: バニラのボーダーを表示するか
    showworldborder: true

  チャット関係の設定
  - class: org.dynmap.ClientComponent
    type: chat
    allowurlname: false
  # チャットバルーンの設定
  - class: org.dynmap.ClientComponent
    type: chatballoon
    focuschatballoons: false
  # チャットボックスの設定
  - class: org.dynmap.ClientComponent
    type: chatbox
    showplayerfaces: true
    messagettl: 5
    # オプション: スクロール可能なメッセージ履歴の行数を設定。
    #scrollback: 100
    # オプション: チャットボックスに表示される最大行数
    #visiblelines: 10
    # オプション: プッシュボタンを送信
    sendbutton: false
  # プレイヤーマーカーの設定
  - class: org.dynmap.ClientComponent
    type: playermarkers
    showplayerfaces: true
    showplayerhealth: true
    # trueの場合プレイヤーの体も表示、showplayerfacesがtrueの時だけ有効
    showplayerbody: false
    # プレイヤーの顔を小さくする設定、showplayerhealthとの併用不可
    smallplayerfaces: false
    # オプション: デフォルトでプレイヤーのレイヤーを非表示にする
    hidebydefault: false
    # オプション: レイヤーメニューでの優先順位
    layerprio: 0
    # プレイヤーレイヤーのラベル名
    label: "Players"

  #- class: org.dynmap.ClientComponent
  #  type: digitalclock
  - class: org.dynmap.ClientComponent
    type: link

  # 時刻表示
  - class: org.dynmap.ClientComponent
    type: timeofdayclock
    showdigitalclock: true
    showweather: true
  # マウスの位置に座標を表示する設定
  - class: org.dynmap.ClientComponent
    type: coord
    label: "Location"
    hidey: false
    show-mcr: false

  # 画像を表示する設定、複数定義できる
  #- class: org.dynmap.ClientComponent
  #  type: logo
  #  text: "Dynmap"
  #  #logourl: "images/block_surface.png"
  #  linkurl: "http://forums.bukkit.org/threads/dynmap.489/"
  #  # top-left(左上), top-right(右上), bottom-left(左下), bottom-right(右下)が使える
  #  position: bottom-right

  # ページを開いたまま放置されている時に別の画面にリダイレクトしたりする設定
  #- class: org.dynmap.ClientComponent
  #  type: inactive
  #  timeout: 1800 # 秒単位
  #  redirecturl: inactive.html
  #  #showmessage: 'You were inactive for too long.'

  #- class: org.dynmap.TestComponent
  #  stuff: "This is some configuration-value"

# hiddenplayers.txtをプレイヤーがマップに表示されるようにするためのホワイトリストとして扱うか
display-whitelist: false

# タイルがレンダリングされる頻度(秒単位)
renderinterval: 1

# 更新キューにあるタイルが指定値を上回るとレンダリング間隔を早める
renderacceleratethreshold: 60

# 更新キューがrenderacceleratethresholdを超えた際のレンダリング速度
renderaccelerateinterval: 0.2

# いちどに動作するタイルアップデートの数(設定していない場合、デフォルトはコア数の半分)
tiles-rendered-at-once: 2

# trueの場合、スレッドのレンダリングを普通の優先度で行う
# これは負荷の高いWindowsでレンダリングが追い付かなくなるのを防ぐ機能
# (LinuxのJVMはスレッドの優先度をほとんど無視する)
usenormalthreadpriority: true

# 保留中のレンダリングを保存して復元するか
# シャットダウン時やリロード時に保留中の作業が失われるのを防ぐ
saverestorepending: true

# ジョブ実行中のクラッシュから回復するのための定期的な保存を行う間隔(秒単位)
save-pending-period: 900

# タイル更新をスキャンしてズームアウトタイルに処理する頻度(秒単位)
zoomoutperiod: 30

# ズームアウトタイルを起動時に検証するかの設定
# ズームアウト処理が中断された場合に必要となることがあるが、マップが大きいと負荷が上がる
initial-zoomout-validate: true

# 更新されたタイルを処理する際の遅延(秒単位)
# これにより、ピストンや採掘場、自動化などにより頻繁に更新されるタイルの再レンダリングを減らすことができる
tileupdatedelay: 30

# タイルハッシュを利用するか
# タイルハッシュは変更が行われていない場合に更新を最小限に抑えるために使われる。
enabletilehash: true

# オプション: 鉱石を隠す
#hideores: true

# オプション: 草と雪のブロックの側面のBetterGrassスタイルのレンダリングを有効にするか
#better-grass: true

# オプション: スムースライティングを使用するか
smooth-lighting: true

# オプション: ワールドプロバイダのライティングテーブルを使用するか(カスタムの照明があるマップなどに適している)
use-brightness-table: true

# オプション: ブロックのレンダリングに他のブロックを使用
# 特定のブロックを隠したり、サポートされていないブロックをとりあえずレンダリングしたりするために使用
block-id-alias:
#    "14": 1
#    "15": 1
#    "16": 1

# デフォルトの画像フォーマット(png, jpg, jpg-q75, jpg-q80, jpg-q85, jpg-q90, jpg-q95, jpg-q100)
image-format: png

# trueの場合生産されたテスクチャを使用、falseの場合水や溶岩が静的になる
use-generated-textures: true
# trueの場合正しい水の照明を利用、falseは古い水の照明
correct-water-lighting: true
# trueの場合葉っぱが透過する
transparent-leaves: true

# trueの場合、テクスチャパックのConnected Texture Mod(CTM)が有効になります
ctm-support: true
# trueの場合、テクスチャパックのカスタムカラーが有効になります
custom-colors-support: true

# プレイヤーの顔画像の取得を設定、falseならスキンが取得されない
#fetchskins: false

# ロードされた画像の更新を制御
# 顔画像が他のソフトウェアや手動で管理されている時用
#refreshskins: false

# スキン画像を取得するためのURL
skin-url: "http://skins.minecraft.net/MinecraftSkins/%player%.png"

# どの動作でレンダリングを行うか
render-triggers:
  #- playermove
  #- playerjoin
  - blockplaced
  - blockbreak
  - leavesdecay
  - blockburn
  - chunkgenerated
  - blockformed
  - blockfaded
  - blockspread
  - pistonmoved
  - explosion
  #- blockfromto
  #- blockphysics
  - structuregrow
  - blockgrow
  #- blockredstone

# Webページのタイトル
#webpage-title: "My Awesome Server Map"

# 画像ファイルのディレクトリ
tilespath: web/tiles

# Webファイルのディレクトリ
webpath: web

# /dynmapexpコマンドでエクスポートするディレクトリ
exportpath: export

# 内部Webサーバーのバインドアドレス
#webserver-bindaddress: 0.0.0.0

# 内部WebサーバーのTCPポート
webserver-port: 8123

# 内部Webサーバーの最大同時接続数
max-sessions: 30

# 内部Webサーバーを無効にする、上級者向け
disable-webserver: false

# シンボリックリンクを許可するか
allow-symlinks: true

# ログイン機能を使用可能にするか
login-enabled: false
# マップを閲覧するためにログインを必要にする
login-required: false

# fullrenderのレンダリング間隔(秒単位)
timesliceinterval: 0.0

# 1tickあたりのチャンクロード数
# これを90未満にするとレンダリングのパフォーマンスに影響があるが、サーバーの負荷も軽減される
maxchunkspertick: 200

# fullrenderやradiusrenderの進捗報告、100以上でなければならない
progressloginterval: 100

# 設定するとfullrenderやradiusrenderを並列で実行する
# 注意: 設定するとCPUやメモリの使用量が増える。システムの物理コア数以上に設定する場合は注意が必要
#parallelrendercnt: 4

# ブラウザが更新をポーリングする間隔
updaterate: 2000

# 0以外の値にすると指定したプレイヤー数を上回った時にfullrenderやradiusrenderを一時停止する
fullrenderplayerlimit: 0
# 0以外の値にすると指定したプレイヤー数を上回った時に更新処理を一時停止する
updateplayerlimit: 0
# 1チック当たりのサーバースレッドの使用制限(ミリ秒単位)
per-tick-time-limit: 50
# TPSが指定した値を下回ると更新処理を一時停止
update-min-tps: 18.0
# TPSが指定した値を下回るとfullrenderやradiusrenderを一時停止
fullrender-min-tps: 18.0
# TPSが指定した値を下回るとズームアウト処理を一時停止
zoomout-min-tps: 18.0

# メニューにプレイヤーの顔画像を表示するか
showplayerfacesinmenu: true

# 現在のマップで隠れているプレイヤーをグレーアウトするか
grayplayerswhenhidden: true

# プレイヤーを権限でソートする
player-sort-permission-nodes:
  - bukkit.command.op

# サイドバーの設定
# サイドバーを永続的に開いたままにするには"true"を、デフォルトで固定するが解除を許可するには"pinned"を指定
#sidebaropened: true

# レスポンスヘッダの追加(内部Webサーバーのみ)
#http-response-headers:
#    Access-Control-Allow-Origin: "my-domain.com"
#    X-Custom-Header-Of-Mine: "MyHeaderValue"

# X-Forwarded-Forを提供するために信頼されているプロキシのIPアドレス
trusted-proxies:
  - "127.0.0.1"
  - "0:0:0:0:0:0:0:1"

# プレイヤーログイン/ログアウト時のWebメッセージフォーマット
# 空文字にすると無効になる
joinmessage: "%playername% joined"
quitmessage: "%playername% quit"

spammessage: "You may only chat once every %interval% seconds."
# Webからのメッセージのフォーマット
webmsgformat: "&color;2[WEB] %playername%: &color;f%message%"

# レイヤコントロールをUIに表示するかどうか
showlayercontrol: true

# banned-ips.txtを使用して禁止IPのチェックを有効にする(内部Webサーバーのみ)
check-banned-ips: true

# ページが表示された時のデフォルトを設定
defaultzoom: 0
defaultworld: world
defaultmap: flat
# (オプション) 可能であれば、プレイヤーをフォローしているときにズームレベルとマップを切り替える
#followzoom: 3
#followmap: surface

# trueにするとプレイヤーのログイン時に使用されたIPアドレスの記録を永続的に作成し、Webでのプレイヤーとのマッチングを行う
persist-ids-by-ip: true

# trueにするとテキストがキリル文字にマップされる。
cyrillic-support: false

# trueにすると座標が丸められる
round-coordinates: true

# メッセージのカスタマイズ
msg:
    maptypes: "Map Types"
    players: "Players"
    chatrequireslogin: "Chat Requires Login"
    chatnotallowed: "You are not permitted to send chat messages"
    hiddennamejoin: "Player joined"
    hiddennamequit: "Player quit"

# URLの設定
# プロキシ下など特殊な環境で必要がある時のみ調整
url:
    #configuration: "up/configuration"
    #update: "up/world/{world}/{timestamp}"
    #sendmessage: "up/sendmessage"
    #login: "up/login"
    #register: "up/register"
    #tiles: "tiles/"
    #markers: "tiles/"

# カスタマイズコマンド、特定のイベントの前後にスクリプトを実行できるようにする
custom-commands:
    image-updates:
        # 画像が書き込まれる前に実行されるコマンド
        preupdatecommand: ""
        # 画像が書き込まれた後に実行されるコマンド
        postupdatecommand: ""
        # どちらも引数としてファイル名が渡される

# チャンクスナップショットのキャッシュサイズ
snapshotcachesize: 500
# キャッシュをSoftReference(true)で保持するか、WeakReference(false)で保持するか
soft-ref-cache: true

# 詳細な起動メッセージ。有効にするにはtrueを指定
verbose: false

# デバッグの設定
#debuggers:
#  - class: org.dynmap.debug.LogDebugger
# Debug: dump blocks missing render data
dump-missing-blocks: false