海螺螺
本帖最后由 754503921 于 2017-10-2 23:51 编辑

Dynmap Wiki 翻译
Dynmap 是一个类似谷歌地图的、为 Minecraft 服务器设计的地图插件，可以让你在浏览器查看服务器的地图。希望这篇 Wiki 能起到介绍、引导使用这个插件的作用。

参与者
@754503921 29204 汉字
@梦彗業 5101 汉字
@1345979462 2530 汉字
共 3.7W 汉字

GitHub 原文地址 https://github.com/webbukkit/dynmap/wiki
>> 完整版这里观看 https://pluginscdtribe.github.io/wiki/dynmap/
一些常用的Wiki章节已经添加进帖子，点击帖子顶部的目录即可跳转
由于帖子篇幅限制，一些不常用的章节未添加

离线版（也是完整版）下载
https://pan.baidu.com/s/1dFGlEff
DynmapWiki.rar (817.45 KB, 下载次数: 247)
草稿贴 http://www.mcbbs.net/thread-717808-1-1.html


2021.12 数据，可能有更多内容

Dynmap Wiki 翻译
Dynmap 是一个类似谷歌地图的、为 Minecraft 服务器设计的地图插件，可以让你在浏览器查看服务器的地图。希望这篇 Wiki 能起到介绍、引导使用这个插件的作用。


参与者
@754503921 29204 汉字
@梦彗業 5101 汉字
@1345979462 2530 汉字
共 3.7W 汉字


GitHub 原文地址 https://github.com/webbukkit/dynmap/wiki
>> 完整版这里观看 https://pluginscdtribe.github.io/wiki/dynmap/
一些常用的Wiki章节已经添加进帖子，点击帖子顶部的目录即可跳转
由于帖子篇幅限制，一些不常用的章节未添加


离线版（也是完整版）下载
https://pan.baidu.com/s/1dFGlEff

草稿贴 http://www.mcbbs.net/thread-717808-1-1.html


配置
这里我们将会介绍配置的结构和如何编辑配置。


文件 plugins/dynmap/configuration.txt 的配置为 YAML 格式，这种格式使用锁紧结构，很重要的一点就是不能含有任何TAB，只能有空格，所以你必须将正确数量的空格放置在配置之前。


仅作为参考，你可以查看这里的默认配置：
https://github.com/webbukkit/dynmap/blob/recommended/src/main/resources/configuration.txt.


配置文件包含 4 部分，以部件、全局设定、世界模板、世界的顺序排列。全局设定更改渲染和Dynmap的（内部）Web服务器的表现，这是很显然的。一个示例全局设定：

代码:

  1. # How often a tile gets rendered (in seconds).
  2. renderinterval: 1
注意: 在版本 v0.20，默认的 configuration.txt file 被分离了， templates: 章节被移动到了 templates/ 目录， worlds: 章节被移动到了 worlds.txt 文件。用户不是必须更改他们现有的 configuration.txt - configuration.txt 定义的模板或世界仍然生效，并且会覆盖 templates/ 下的相同名称的模板。推荐已经使用的用户，尽快将 worlds: 章节（如果已经设置），从 configuration.txt 移动到 worlds.txt，放置以后的更新可能出现的冲突和影响。当然，现有的用户最好也把 templates: 章节从 configuration.txt 移动到新的文件 templates/custom-templates.txt。
部件（Component）


部件部分看起来像这样：

代码:

  1. components:
  2. - class: org.dynmap.ClientConfigurationComponent

  4. - class: org.dynmap.InternalClientUpdateComponent
  5.     sendhealth: true
  6.     allowwebchat: true
  7.     webchat-interval: 5
  8. ...
每个不换都可以认为是Dynmap的一个单独的特性，可以被单独开启或者关闭。有些不见基于其他的部件，但是我们不会深入。配置文件中的部件都以 - class: ... 开头，接着是部件的设置。


作为示例，我们会关闭处理聊天气泡的部件。这个部件看起来像这样：

代码:


  2. ...
  3. - class: org.dynmap.ClientComponent
  4.     type: chatballoon
  5.     focuschatballoons: false
  6. ...
我们可以通过删除这几行来关闭这个部件，但是更安全的方法是将他们变为注释。这个示例中：

代码:


  2. ...
  3. - class: org.dynmap.ClientComponent
  4.     type: chat
  5. #- class: org.dynmap.ClientComponent
  6. #type: chatballoon
  7. #focuschatballoons: false
  8. - class: org.dynmap.ClientComponent
  9.     type: chatbox
  10.     showplayerfaces: true
  11.     messagettl: 5
  12. ...
确保 # 之前仍然有正确的空格数。
保存配置后，重载Dynmap，刷新浏览器，聊天气泡不会再出现了。
同样的方法可以用来启用已经禁用的部件。


查看更多的部件和他们的配置可以查看部件配置。
世界与模板


在这个配置你会看到一个 world 章节（从 0.20 开始），可以在 worlds.txt 找到（之前是在 configuration.txt 的底部）。这个章节可以留空 - Dynmap将会找到服务器加载的所有世界，并提供一个默认的地图设定，基于使用 模板，定义于 templates: 章节。从 0.20 开始，模板定义从 configuration.txt 移动到了单独的文件，在 templates/ 目录中。但是之前的方式仍然生效。


关于世界设置的全面的介绍，查看世界与模板设定。
模板


默认有 3 种模板：普通，地狱和空岛。模板基于世界的环境自动选择 - normal 为普通的世界，nether 为地狱世界，skylands 为空岛世界。在 0.20 版本中，这些定义可以在 templates/ 目录找到，使用相应的名称“ templates/normal.txt，templates/nether.txt 和 templates/skylands.txt。


在 0.20，模板的名称可以使用 configuration.txt 中的 deftemplatesuffix 设定来变更。如果设置了，那么世界使用的模板的名称将会添加 - 和 deftemplatesuffix 设定的结果：所以设定 deftemplatesuffix 为 hires 将会造成 normal-hires 模板启用于所有的普通世界，nether-hires 启用于所有的地狱世界，skylands-hires 启用于所有的空岛世界。这会允许Dynmap（和其他的用户）使用预置的前缀设定，可以在 deftemplatesuffix 轻松设定。在 0.20版本，提供了 3 中默认的模板。


  • 默认 (normal,nether,skylands)
  • lowres 模板集 (normal-lowres, nether-lowres, skylands-lowres - 提供更低解析度的地图（默认的2倍）。
  • hires 模板集 (normal-hires, nether-hires, skylands-hires - 提供更高解析度的地图 - 大概是默认地图的8倍 - 'lowres' 版本用于平原和洞穴地图。

在所有的情况下，模板的定义可以在 templates/ 目录找到，使用对应的名称，加上 .txt (比如 normal-hires 可以在 templates/normal-hires.txt 找到)。
世界


配置文件中，在模板章节附近还有一个世界设置。在 0.20 版本，推荐的配置文件的位置是 worlds.txt 文件。这里我们可以指定每个世界的单独的设置。我们会使用一些例子让你理解。


基本上每个世界都有一些默认的值。 title 设置为世界的名称， template 设置为世界的环境（如果 deftemplatesuffix 在 configuration.txt 中被定义，那么有一个短横线和 deftemplatesuffix 跟随）。这个世界的模板可以覆盖这些值，但是这些世界设定里的值可以覆盖模板的设定。


如果你有 3 个世界，名称为 world, nether 和 alternative，然后你像让他们以明确的顺序显示，你可以将其放入你的配置里：

代码:


  2. worlds:
  3. - name: world
  4. - name: alternative
  5. - name: nether
这样他们就以 world, alternative, nether的顺序出现。


更改某个世界的标题，你可以在配置添加title的配置：

代码:


  2. worlds:
  3. - name: world
  4.     title: "My Super Awesome World"
  5. - name: alternative
  6. - name: nether
你可以对所有的世界都这样做。


如果你想要关闭某个世界，比如世界alternative，你可以在配置添加 enable: false：

代码:


  2. worlds:
  3. - name: world
  4.     title: "My Super Awesome World"
  5. - name: alternative
  6.     enabled: false
  7. - name: nether
你可以使用这个设置在你的模板里停用所有某一环境的世界。


如果你想要更改某个世界的特定的设置，你可以使用这个设置。这个设置还包含了 maps: 属性，这样你就可以指定世界使用的地图了：

代码:


  2. - name: world
  3.     title: "My Super Awesome World"
  4.     center:
  5.    x: 100
  6.    y: 64
  7.    z: 0
  8.     maps:
  9.    - class: org.dynmap.flat.FlatMap
  10.   name: flat
  11.   title: "Flat"
  12.   prefix: flat
  13.   colorscheme: default
这将让这个世界，设置中心为 (100,64,0)，并且只在侧边栏显示平坦地图。


最终如果你有多个世界使用相同的设置，你可以添加一个模板到 templates: 部分（或者最好添加一个自定义分模板文件到 templates/ 目录），然后指定这些世界的模板。

代码:


  2. templates:
  3. mycustomtemplate:
  4.     enabled: true
  5.     maps:
  6.    - class: org.dynmap.flat.FlatMap
  7.   name: flat
  8.   title: "Flat"
  9.   prefix: flat
  10.   colorscheme: ovocean
  11. ...
  12. worlds:
  13. - name: world
  14.     template: mycustomtemplate
  15. - name: nether
  16.     template: mycustomtemplate
  17. - name: alternative
这里 world 和 nether 都使用 mycustomtemplate 模板，但是 alternative 会使用 normal 模板（因为这个示例中 alternative 有普通的世界环境）。


就像上面你能看见的一样，每个 FlatMap 或者 KzedMap 地图都可以设置一个特定的颜色主题。颜色主题可以在 plugins/dynmap/colorschemes/, 也可以在这里看到。一个关于这些的简介可以在颜色主题找到。


在 0.20 版本，一个新的地图种类出现了 - HDMap。这种地图种类，支持更高解析度的地图渲染，并且支持使用材质包，并且支持所有 FlatMap 和 KzedMap 的特性，但是更加灵活（允许自定义的观察角度，自定义的观察方向和缩放大小，等等）。有关配置 HDMaps 的详细信息，请查看HD Map 配置。


基础插件设置
这些设定是 configuration.txt 文件中的第一级设定，一般来说，会覆盖插件的基础设置，但与特殊的部件、地图和世界无关。有关部件的设定，详见部件设定。


核心设置包含以下内容：


  • deftemplatesuffix : 这个设定是可选的，字符串值。用于控制世界使用的模板，如果没有指定，那么普通的世界将会使用 normal 模板，地狱世界将会使用 nether 模板，末地世界将会使用 theend 模板。当指定并且不为空后，使用的模板的名称将会是世界名加上下划线加上定义的内容。（比如 deftemplatesuffix 设置为XXX，普通的世界将会使用 normalXXX 模板而不是 normal 模板。地狱世界将会使用 netherXXX 模板，末地世界将会使用 theend_XXX 模板）。查看高分辨率地图设定获得更多的信息。默认的模板有 vlowres, lowres, hires, 和 "" (留空)。
  • display-whitelist : 如果为 false（默认），用户是可见的直到他们使用了 /dynmap hide 命令，如果设置为 true，用户默认是不可见的直到他们使用了 /dynmap show 命令。
  • renderinterval : 这个设置为小数，以秒计算，用于控制多久之后tiles（比如玩家）需要被更新和处理。将这个设置的过低可能给服务器带来由于重复更新tiles的计算而额外的负担。默认为 0.5 秒，大多数的服务器设置为高于 0.2 的值都不会有问题。
  • renderacceleratethreshold : 这个设置为一个整数，用于设定处理从 renderinterval 到 renderaccelerateinterval 的tile更新队列的大小。这用于防止大量tiles的积累（玩家大量跑图创建新的区块时），不用以很快的速度处理常规的更新。
  • renderaccelerateinterval : 这个设定为以秒为单位的小数值，用于当tiles更新队列长度超过了 renderacceleratethreshold 的值而使用的类似 renderinterval 的值。
  • tiles-rendered-at-once : 这个设定控制异步渲染的更新tiles的最大数量。如果没有设置，那么默认的值会是处理器数量的一半。将这个值设置的偏小可以减少在大量加载更新tiles（如新生成的大量区块）时CPU的峰值使用量。
  • usenormalthreadpriority : 这个设定当设置为 true，会将渲染线程的优先度设置为普通（与最低优先度相比）。这可以帮助Windows下的渲染性能，但是可能会造成与其他进程的CPU使用竞争。大多数的Linux JVM忽略优先度。
  • zoomoutperiod : 这个设定为以秒为单位的整数，指定了移出的tiles的更新频率。用于防止由于玩家的重复改变（比如挖矿）而造成不必要的tiles的重新生成。默认的值为 60 秒。
  • enabletilehash : 此选项为 true 或者 false，用于启用tile数据的hash代码，可以用于避免在重新渲染后（比如tile不可见的方块）值没有发生变化的tile的重新编码。这减少了处理的负载、移出的处理和网页客户端的连接处理。
  • render-triggers : 这个设定为字符串列表，用于启用检测或者更新地图tile的不同的机制。定义的触发器如下：
    • chunkloaded : 这个触发器当地图的区块加载时更新tiles。这个触发器不再被推荐 - 使用 chunkgenerated ，因为 chunkloaded 可能造成大量的不必要的tiles的计算。在 v0.31 被删除。
    • playermove : 这个触发器在玩家移动时更新tiles。这个触发器不被推荐，因为会造成大量不必要的重新计算。
    • playerjoin : 这个触发器会在玩家登陆后的周围的区域更新tiles。
    • blockplaced : 这个触发器在玩家放置方块后更新tiles。（推荐）
    • blockbreak : 这个触发器会在玩家破坏方块后更新tiles。（推荐）
    • leavesdecay : 这个触发器会在玩家砍树后树叶掉落更新tiles。（推荐）
    • blockburn : 这个触发器会在火破坏一个方块后更新tiles。（推荐）
    • blockfaded : 这个触发器会在一个方块消失后（比如冰或雪融化）更新tiles。（推荐）
    • blockspread : 这个触发器会在一个方块传播（岩浆或水的流动）时更新tiles。
    • chunkgenerated : 这个触发器会在新的地图生成新的区块时更新tiles。（推荐）
    • pistonmoved : 这个触发器会在活塞伸出或收回时更新tiles。（推荐）
    • explosion : 这个触发器会在方块被爆炸摧毁后更新tiles。（推荐）
    • blockfromto : 这个触发器会在方块流入新的方块（水、岩浆）更新tiles。（推荐）
    • blockphysics : 这个触发器会在方块进行物理移动（掉落的沙砾、水、岩浆、沙子）时更新tiles。（推荐）
    • structuregrow : 这个触发器会在树枝长成树或者蘑菇长成巨型蘑菇时更新tiles。
    • blockgrow : 这个触发器会在方块生长（作物和蘑菇）时更新tiles。
    • blockredstone : 这个触发器会在红石电流更新了一个方块时更新tiles。（在你有高频的红石机械运作时小心使用）
  • webpage-title : 这个设定为一个字符串，用于指定Dynmap网页的标题。如果没有设定，将会尝试使用 server.properties 中的 'server-name'，如果没有设置或者为 'Unknown Server'，那么将自动设置为 'Minecraft Dynamic Map'。
  • tilespath : 这个设定为一个字符串，用于指定地图tiles生成的路径（可以是Dynmap插件目录相对路径或者绝对路径），（并且是内部服务器使用的路径）。
  • webpath : 这个设定为一个字符串，用于指定内部服务器的根目录。所有内部服务器使用的文件（除了地图tiles）都会基于这个路径。可以是Dynmap插件目录相对路径或者绝对路径。
  • webserver-bindaddress : 这个设定为一个IP地址，控制内部服务器的网络接口绑定的地址。默认为 0.0.0.0，将会让服务器绑定在所有的接口（应该对绝大部分的配置都是正确的）。设置为 127.0.0.1 会让其只绑定在本地网络（如果一个外部的Web服务器在同一台机器使用时可以这样做）。其他的值必须与网络地址匹配（不是防火墙外的公共地址或者代理）。
  • webserver-port : 这个设定为一个整数，指定了内部的Web服务器绑定的端口。默认为 8123。注意大多数的操作系统需要使用root权限运行程序才能将端口绑定至 1024 以下的端口。
  • max-sessions : 这个设定为一个整数，设置Web服务器活跃的最大的异步会话数量（限制会话使用的资源和线程）。默认的值为 30。
  • http-response-headers : 这个设置为一串属性/值对，提供了在所有的HTTP相应中添加自定义的header值。这个属相下的值为header的值。见下示例：

  • 代码:

    1.   http-response-headers:
    2.    Access-Control-Allow-Origin: "http://mydomain.com"
    3.    X-Another-Header: "Another Header Value"

  • disable-webserver : 如果设置为 true ，内部的Web服务器将会关闭（这需要使用外部Web服务器，和`JSONFileClientUpdateComponent`部件），其他的配置选项需要将其设置为 false 。
  • allow-symlinks : 如果设置为 true ， webpath 或 tilespath 目录下的目录允许含有符号链接（symbolic link）。如果设置为 false ，内部Web服务器将不会使用符号链接（推荐实验一下，因为几乎所有的外部Web服务器都会使用）。
  • timesliceinterval : 此设置为以秒为单位的小数，指定处理 /dynmap fullrender 时tile处理的最小时间段。默认的值为 0.0 （无延迟）。非 0 的值可以在全部渲染时减少服务器的负载，但是会显著增长处理的时间。
  • maxchunkspertick : 此设置为一个整数，限制一个服务器tick中地图区块加载的数量。因为加载地图区块是Bukkit服务器主线程的主要负载源，这可以用来限制可能由于地图处理导致的卡顿。
  • progressloginterval : 此设置为一个整数，是全部渲染请求是记录进度的间隔。默认（并且最小）的值为 100。
  • parallelrendercnt : 此设置是可选的，为一个整数，用于在全部渲染时使用多于一条线程进行处理。这个设定表明了异步线程的数量，应该限制为服务器处理器的数量（或者少于）。设置此将会增加CPU的使用，可能会使用更多的内存。在设置为等于或者超过系统的处理器数量时应该保持注意。
  • updaterate : 此设置为以毫秒为单位的整数，指定Web客户端应该多长时间查询服务器的更新（无论是tiles更新
  • 聊天信息或者玩家的位置更新）。设置更高的值会减少Web服务器的流量负载。
  • fullrenderplayerlimit : 此设置是可选的，设定了当玩家登陆的数量超过多少后停止处理全部渲染/范围渲染的值。默认为 0（停用），设置为 1 会在任何玩家登陆时停止处理全部渲染/范围渲染。
  • showplayerfacesinmenu : 这个设定为 true或者false，用于控制在网页托盘中是否显示在线玩家。默认显示（true）。
  • sidebaropened : 此设置为一个字符串，用于控制侧边栏菜单开启（true），固定（pinned）或者默认关闭（false）。默认为 false。
  • joinmessage : 此设置为一个字符串，用来控制玩家加入服务器时网页显示的消息。`%playername%` 用来表示玩家的名称。
  • quitmessage : 此设置为一个字符串，用来控制玩家退出服务器时网页显示的消息。`%playername%` 用来表示玩家的名称。
  • spammessage : 此设置为一个字符串，当网页聊天用户试图发送过多的信息时显示。
  • webprefix : 此设置为一个字符串，用于给接收到的网页聊天添加前缀。'&color;' 可以用来代替Bukkit颜色代码。
  • websuffix : 此设置为一个字符串，用于给接收到的网页聊天添加后缀。'&color;' 可以用来代替Bukkit颜色代码。
  • showlayercontrol : 此设置可为 true 或 false，用于控制覆盖层是否显示（设置为 false 会造成覆盖层的不显示，即使定义了记号层）。默认为 true。
  • check-banned-ips : 此设置可为 true 或 false，用于控制内部Web服务器是否检查 banned-ips.txt 来阻塞已经被禁止的IP连接到网页。
  • persist-ids-by-ip : 如果为 true，玩家的IP地址和联系的玩家ID是持久的，将会在服务器关闭或重启后被保存（）if true, player IP addresses and the associated player IDs are persistent, and will be saved on server shutdown and reloaded on server startup (允许累加玩家的已知IP)。默认为 true。（0.29及之后的版本）
  • defaultzoom : 此设置为一个整数，指定了网页被第一次加载时默认的缩放的大小。
  • defaultworld : 此设置为一个字符串，指定了网页被第一次加载时默认显示的世界。
  • defaultmap : 此设置为一个字符串，指定了网页被第一次加载时默认显示的地图。
  • followzoom : 此设置为可选的设置，为一个整数，指定了当网页选择了要跟随的玩家时，默认的缩放等级。
  • followmap : 此设置为可选的设置，为一个字符串，指定了当网页选择了要跟随的玩家时，默认显示的地图。
  • verbose : 此设置可为 true 或 false，控制Dynmap插件启动时的信息的详细程度。设置为 false 将会明显减少显示的信息和细节。
  • hideores : 此设置可为 true 或 false，控制是否隐藏所有的矿物方块，让他们变得和普通的石块（防止利用地图寻找裸露的矿物）。默认为 false。
  • better-grass : 此设置可为 true 或 false，控制是否渲染草地和雪地的侧面，就像 BetterGrass Mod 一样。默认为 false。
  • smooth-lighting : 此设置可为 true 或 false，提供所有地图都支持的平滑光照的设定。设置为 true 可以在使用的所有地图上开启平滑光照，此选项也是每个着色器的基础设定，可以在单独的地图上开启这个特性。开启此特性将会增加 10% 的渲染成本。
  • use-generated-textures: 此设置如果设置为 true，那么将导致基于材质包的高解析度地图使用Minecraft客户端相同的纹理来渲染水、岩浆和火焰。如果设置为 false，老的材质 texture.png 和 misc/water.png 将会使用。（0.29之前的结果）设置之后需要进行一次全地图的渲染才能得到正确的结果。
  • correct-water-lighting: 此设置如果设置为 true，将会导致基于材质包的高解析度地图渲染器像Minecraft客户端一样处理水的光照。如果设置为 false，那么将会使用老的水 - 也就会更暗。（0.29之前的结果）设置之后需要进行一次全地图的渲染才能得到正确的结果。
  • fetchskins : 此设置可为 true 或 false，控制服务器在玩家登陆时是否尝试获取玩家的皮肤。如果设置为 false，默认的皮肤将会显示在所有玩家身上。默认为 true。
  • refreshskins : 此设置可为 true 或 false，控制每次玩家登陆时刷新皮肤数据。如果设置为 false，已有的文件将永远不会刷新（如果是管理员手动上传皮肤数据那么很有用）。默认为 true。
网页接口的用户登陆安全设定


网页支持的基于用户登陆的安全系统可以在这里设置：


  • login-enabled : 此设置可为 true 或 false，启用登陆安全支持（如果设置为 true）。
  • login-required : 此设置可为 true 或 false，强迫所有的用户登陆才能进入网页。（如果设置为 true）


部件设置
Dynmap的接口通过一些部件构成。不是所有的部件都可以被开启，并且有些必须开启。冠以这些部件和他们的属性可以下接下来的章节找到。
核心客户端部件


接下来的部件指定了网页的核心接口。客户端配置部件，和至少一个的客户端更新部件都是必须添加的。
客户端配置部件


这个部件在 components 章节如下定义：

代码:

  1.    - class: org.dynmap.ClientConfigurationComponent
此部件是必须的，并且没有任何设置。
内部客户端更新部件


这个部件定义了Dynmap内部服务器的Web网页的主接口（这是部件运行必须开启的）。这个部件设置了用户使用的在 http://地址:端口/up/ 路径下的URL，包括了获取配置数据和地图更新，玩家信息和聊天信息。这个部件在 components 章节这样配置：

代码:

  1.    - class: org.dynmap.InternalClientUpdateComponent
  2.   sendhealth: true
  3.   sendposition: true
  4.   allowwebchat: true
  5.   webchat-interval: 5
  6.   hidewebchatip: false
  7.   trustclientname: false
  8.   use-player-login-ip: true
  9.   require-player-login-ip: false
  10.   block-banned-player-chat: true
  11.   webchat-requires-login: false
  12.   webchat-permissions: false
  13.   includehiddenplayers: false
  14.   hideifshadow: 15
  15.   hideifundercover: 15
  16.   hideifsneaking: false
  17.   protected-player-info: false
设置如下：


  • sendhealth : 此选项控制了网页是否发送玩家的生命信息。如果关闭，其他反馈玩家生命信息的部件将不会使用此数据，玩家的生命信息也不会受到检查，如果启用，生命信息仍然可以通过在世界设定的 sendhealth: false 选项来关闭。
  • sendpostiion : 此选项控制了是否向网页发送玩家的位置信息。如果关闭，其他反馈玩家位置信息的部件将不会使用此数据，玩家的位置信息也不会受到检查，如果启用，位置信息仍然可以通过在世界设定的 sendhealth: false 选项来关闭。
  • allowwebchat : 此选项控制了网页是否被允许向服务器发送网页聊天消息。如果停用，用户将不会发送任何网页聊天消息。
  • webchat-interval : 此选项控制来自同一个网页的聊天信息的最小间隔，以秒为单位。
  • hidewebchatip : 如果设置为 true，网页聊天将会显示为和游戏内IP地址相同的玩家的名称显示。
  • trustclientname : 如果设置为 true，服务器将会使用网页使用者上传的IP地址（可能被伪造）而不是服务器获取的IP地址。
  • use-player-login-ip : 如果设置为 true，网页聊天将会匹配当前或以前登陆的玩家的相同的IP地址 - 如果找到了匹配，将会以该玩家的ID作为身份标识。默认为 true（0.29或之后）。
  • require-player-login-ip : 如果 use-player-login-ip 为 true 且此选项设置为 true，网页聊天没有匹配到当前或以前登陆的玩家的消息将会被忽略。默认为 false。（0.29或之后）
  • block-banned-player-chat : 如果 use-player-login-ip h设置为 true 且此选项设置为 true，网页聊天匹配到已经被ban的玩家将被忽略。默认为 true（0.29或之后）。注意将不会对实现了自身的禁止系统的插件支持。
  • webchat-requires-login : 如果 login-enabled 设置为 true 且此选项设置为 true，网页聊天信息只能由已经登录的用户发送。
  • webchat-permissions : 如果设置为 true，绑定玩家的（通过登录或者IP）网页聊天将会检查 `dynmap.webchat` 权限，如果没有权限将被禁止发送。这需要一个支持读取离线玩家的权限的权限系统 - 比如 PermissionsEx 和 LuckPerms - 来让不用使用Minecraft客户端登录的玩家也能被检查权限。
  • includehiddenplayers : 如果设置为 true，隐藏的玩家（使用 /dynmap hide 命令）也会显示在网页UI上，但是他们的位置、生命和信息仍然会隐藏，他们只出现在玩家列表里。
  • hideifshadow : 如果设置为小于 15 的值，每个玩家的位置信息和生命信息都将在一定的光照亮度下被隐藏。（0=完全黑暗，4=晚上露天，15=完全的白天）
  • hideifundercover : 如果设置为小于 15 的值，每个玩家的位置信息和生命信息都将在他被覆盖时隐藏。由于当前的Bukkit的限制（我们已经发出了 pull request），我们将将此设置改为基于阴影等级的判定（白天的该坐标的阴影等级）。
  • hideifsneaking : 如果设置为 true，潜行的玩家将被隐藏。
  • protected-player-info : 如果设置为 true，玩家的位置信息和生命信息将受到保护，没有 dynmap.playermarkers.seeall 权限的玩家（OP默认拥有）将只会看见此玩家的标记，而拥有此权限的用户将看见完整的玩家信息。如果此设定没有被设置或者设置为 false，那么所有的生命信息和位置信息都对所有人可见。
JSON 文件客户端更新部件


使用内部Web服务器的另一种方法是将Dynmap和Web客户端的通信全部由一个外部Web服务器完成。这个文件的格式为 JSON（JavaScript Object Notation），操作的模式为"JSON 文件模式"。此模式允许内部Web服务器被关闭，转而使用内部客户端更新部件（它们之中一次只能启用一个）。此部件在 components 部分这样设置：

代码:

  1.    - class: org.dynmap.JsonFileClientUpdateComponent
  2.   writeinterval: 1
  3.   sendhealth: true
  4.   sendposition: true
  5.   allowwebchat: false
  6.   webchat-interval: 5
  7.   hidewebchatip: false
  8.   trustclientname: false
  9.   use-player-login-ip: true
  10.   require-player-login-ip: false
  11.   block-banned-player-chat: true
  12.   webchat-requires-login: false
  13.   webchat-permissions: false
  14.   includehiddenplayers: false
  15.   hideifshadow: 15
  16.   hideifundercover: 15
  17.   hideifsneaking: false
  18.   protected-player-info: false
定义的属性与内部客户端更新部件相同，附加的属性如下：


  • writeinterval : 此选项单位为秒，控制写入到 webpath/standalone 目录的间隔时间，这些文件为网页用户通过外部Web服务器加载地图配置使用的文件，也用于更新地图、玩家信息和生命值和聊天信息。
标记部件


此部件添加于 v0.22，提供了地图记号标记的内置支持，可以通过 /dmarker 命令或者API来使用。部件在 components 部分如下设置：

代码:

  1.    - class: org.dynmap.MarkersComponent
  2.   type: markers
  3.   showlabel: false
  4.   enablesigns: false
  5.   showspawn: false
  6.   spawnicon: world
  7.   spawnlabel: "Spawn"
  8.   showofflineplayers: false
  9.   offlinelabel: "Offline"
  10.   offlineicon: offlineuser
  11.   offlinehidebydefault: true
  12.   offlineminzoom: 0
  13.   maxofflinetime: 30
  14.   showspawnbeds: false
  15.   spawnbedlabel: "Spawn Beds"
  16.   spawnbedicon: "bed"
  17.   spawnbedhidebydefault: true
  18.   spawnbedminzoom: 0
  19.   spawnbedformat: "%name%'s bed"
部件包含的设置如下：


  • showlabel : 如果定义并设置为 true，这将导致地图标记的标签始终显示，而不是当用户将鼠标放在上面才显示。
  • enablesigns : 如果定义并设置为 true，这将开启对牌子的标记支持。如果启用并且玩家拥有 `dynmap.marker.sign` 权限，玩家可以通过创建一个第一行为 '[dynmap]' 的牌子，来启用一个以第二行开始的标记。图标将会是 'sign' 图标，除非牌子上有一行是 'icon:<icon-id>'。标记组将会是默认的 'markers' 集合，除非牌子上有一行是 'set:<set-id>'。一旦通过检查，'[dynmap]' 行和任何的设置行将会是空白的，留下标签行和任何剩余的行，破坏牌子将会删除对应的标记。
  • showspawn : 如果定义并设置为 true，这将让每个世界的出生点显示为一个合适的标记（默认为 'world' 标记）和标签（默认为字符串 'Spawn'）。
  • spawnicon : 如果定义，提供出生点使用的标记（如果 showspawn 设置为 true）。默认为 'world'。
  • spawnlabel : 如果定义，提供出生点使用的标签（如果 showspawn 设置为 true）。默认为 'Spawn'。
  • showofflineplayers : 如果定义并设置为 true，将会添加一个显示离线玩家的标记层。（当玩家离线时会添加标记）
  • offlinelabel : 如果定义，提供离线玩家使用的标签。默认为 'Offline'。
  • offlineicon : 如果定义，提供离线玩家使用的标记。默认为 'offlineuser'。
  • offlinehidebydefault : 如果定义并设置为 true，离线玩家标记层将默认隐藏。默认为 true。
  • offlineminzoom : 如果设置不会 0，浙江制定显示离线玩家标记前的最小缩放等级。
  • maxofflinetime : 如果设置为大于0，这将指定玩家离线后的几分钟内标记应该被移除（小于等于0位从不）。所有的离线玩家的标记都将在服务器重启后被重置，独立于此设定。
  • showspawnbeds : 如果定义并设置为 true，将会显示在线玩家的出生点床的位置的标记层。（标记将在玩家离线后被移除）
  • spawnbedlabel : 在线玩家出生点床使用的标签。默认为 'Spawn Beds'。
  • spawnbedicon : 在线玩家出生点床使用的标记。默认为 'bed'。
  • spawnbedhidebydefault : 如果为 true，出生点床标记层将会被隐藏，默认隐藏。
  • spawnbedminzoom : 如果设置不为0，这将指定出生点床标记显示前最小的缩放等级。
服务器聊天部件


这些部件控制了服务器端实现的聊天功能，包括了从服务器发送至客户端聊天消息，和客户端到服务器的玩家聊天的显示。这些部件一次只能设置一个。
基础聊天部件


此部件实现了标准Bukkit/Minecraft服务端聊天通道，当激活时，所有的聊天消息都会被共享给网页用户，所有从网页接收到的聊天消息也将发送给服务器上的玩家（当然也有其他的网页用户）。此部件在 components 中如下配置：

代码:

  1.    - class: org.dynmap.SimpleWebChatComponent
  2.   allowchat: true
部件包含以下设置：


  • allowchat : 如果启用，将会决定服务器上的聊天是否发送给网页，如果设置为 false，将不会给网页发送聊天消息。
HeroChat 聊天部件 （弃用 - 不兼容 HeroChat 5）


HeroChat 插件实现了特殊的聊天通道。此部件允许选择HeroChat的特定聊天通道发送给网页客户端，网页聊天显示于哪一条通道。此部件在 components 中如下配置：

代码:

  1.    - class: org.dynmap.herochat.HeroWebChatComponent
  2.   herochatwebchannel: Global
  3.   herochatchannels:
  4.     - Global
此部件包含如下选项：


  • herochatwebchannel : 从网页接收到的聊天信息显示于 HeroChat 的聊天通道的名称。默认为 'Global'。
  • herochatchannels : 此为HeroChat聊天通道需要监视的名称，将会共享给网页用户。0或者多个通道可能被列出，默认只有 Global。
客户端聊天部件


这些部件控制了网页是否启用并支持发送和接受聊天消息。这些部件基于对应的服务端部件才能接受请求的功能。部件可以被单独定义也可以结合。
聊天客户端部件


此部件启用了聊天信息的输入部分，允许用户进入并从网页向服务器发送聊天信息。此部件如下配置：

代码:

  1.    - class: org.dynmap.ClientComponent
  2.   type: chat
  3.   allowurlname: false
此部件包含如下选项：


  • allowurlname : 如果设置为 true （并且 trustclientname 在对应的客户端更新部件），用户可以通过 chatname URL 参数应用自己的聊天名称。
聊天气泡客户端插件


此部件实现了可弹出的气泡信息，气泡可以在地图上玩家的位置出现。此部件在 components 中如下配置：

代码:

  1.    - class: org.dynmap.ClientComponent
  2.   type: chatballoon
  3.   focuschatballoons: false
此部件包含如下选项：


  • focuschatballoons : 如果启用，这将导致气泡如果不在地图上显示，地图将会平移至气泡的位置。

注意放置气泡需要先知道说话的玩家的位置信息，如果 sendposition: false 设置于玩家的当前的世界，或者通过激活的客户端更新部件来全局设置会失效。
聊天栏客户端部件


此部件实现了从服务器和其他网页接受消息并显示在聊天栏的功能。此部件在 components 中如下配置：

代码:

  1.    - class: org.dynmap.ClientComponent
  2.   type: chatbox
  3.   showplayerfaces: true
  4.   messagettl: 5
  5.   scrollback: 100
  6.   sendbutton: false
此部件包含如下选项：


  • showplayerfaces : 如果启用，玩家的头像将会在消息前显示。
  • messagettl : 这控制了显示的消息几秒钟后消失。如果 scrollback 设置，此设置将被忽略。
  • scrollback : 如果定义，这指定了最多在可滚动的信息列表里保存多少条消息。如果指定，消息将不会淡出（messagettl被忽略）并只会将超过 scrollback 的数量的聊天信息移除。
  • sendbutton : 如果定义并设置为 true，这将在WebUI上显示一个发送按钮，允许按按钮而不是使用回车键发送消息。
地图控制部件


这些部件定义了附加的地图数据，例如玩家记号、时间、日志等。任何部件都可以被定义。
玩家图标部件


此部件用于在地图上以图标显示玩家的位置和名称。玩家的位置信息只能在可用时（查看 sendposition 上方的设置）才会显示。此部件在 components 中如下配置：

代码:

  1.    - class: org.dynmap.ClientComponent
  2.   type: playermarkers
  3.   showplayerfaces: true
  4.   showplayerhealth: true
  5.   showplayerbody: false
  6.   smallplayerfaces: false
  7.   hidebydefault: false
  8.   layerprio: 0
  9.   label: "Players"
此部件包含如下选项：


  • showplayerfaces : 如果启用，这将让网页试图加载玩家的自定义的皮肤作为头像的图标。否则将会加载一个通用的小图标作为标记。
  • showplayerhealth : 如果启用，客户端将会尝试显示在图标下方以两行显示玩家的生命和护甲值。这要求玩家的生命信息必须可用（查看上方的 sendhealth）。
  • smallplayerfaces : 如果启用，玩家的头像将会以 1/2 显示（与 showplayerfaces 开启有关）（如果 showplayerfaces 关闭将会显示默认图标的 1/2 大小）。
  • showplayerbody : 如果启用，将会显示整个身体的图标而不仅是头像，只有在 showplayerfaces 设置为 true 并且 smallplayerfaces 设置为 false 才可用。
  • hidebydefault : 此选项是可选的，如果定义并设置为 true，将会更改地图上玩家的图标的默认可见性设定。该图标层仍然可被WebUI控制设置为可见。
  • layerprio : 此选项是可选的，提供了图层选择的权重排序，从最低排到最高的 layerprio，（相同权重以字母顺序排序）。默认为 0。
  • label : 此选项是可选的，提供了用于选择控制图层的标签。默认为 'Players'。
数字钟部件


此部件用于显示一个简单的数字钟，显示显示的世界对应的时间。此部件在 components 中如下配置：

代码:

  1.    - class: org.dynmap.ClientComponent
  2.   type: digitalclock
一次只能开启一个数字钟部件。
日月时钟部件


这是一个更加复杂的时钟部件，通过太阳和月亮图标的升起降下来对应当前世界的时间。此部件在 components 中如下配置：

代码:

  1.    - class: org.dynmap.ClientComponent
  2.   type: timeofdayclock
  3.   showdigitalclock: true
  4.   showweather: true
此部件包含如下选项：


  • showdigitalclock : 如果启用，数字时钟将会显示（附加于日月的显示）。
  • showweather : 显示天气
坐标部件


此部件用于显示鼠标所指的地方对应的世界的坐标。此部件在 components 中如下配置：

代码:

  1.     - class: org.dynmap.ClientComponent
  2.    type: coord
  3.    label: "Location"
  4.    hidey: false
  5.    show-mcr: false
此部件包含如下选项：


  • label : 允许控制用于显示坐标的标签，默认为 'x,y,z'。
  • hidey : 此选项如果定义并设置为 true，会只显示 X,Z 坐标。
  • show-mcr : 此选项如果定义并设置为 true，会显示当前位置的Minecraft区域文件ID。
Logo 部件


此部件允许在地图上显示一个可选的图标和链接。此部件在 components 中如下配置：

代码:

  1.     - class: org.dynmap.ClientComponent
  2.    type: logo
  3.    text: "Dynmap"
  4.    linkurl: "http://forums.bukkit.org/threads/dynmap.489/"
此部件包含如下选项：


  • text : logo的标签
  • linkurl : 显示的标签链接到的 URL。
链接部件


此部件可以在WebUI显示一个 '链接到' 按钮。这个按钮点击后会链接到另一个页面，但是会保留世界的地图、缩放和当前的视图的位置信息 - 允许将视图分享，作为标签或者其他的链接。此部件在 components 中如下配置：

代码:

  1.     - class: org.dynmap.ClientComponent
  2.    type: link
现在没有任何设置。


世界 & 模板设置
有很多用于控制地图和界面的可配置的设置，大多数都可以使用模板设置 - 这是很正常的，因为模板本质上是用来设置世界没有指定的某些设置的集合。


按道理来说，任何定义的世界都应该有一些默认的设置，按照他们的环境（普通、地狱、空岛）分为不同的模板 - 设置继承于默认的与环境名称相同的模板。如果 deftemplatesuffix 设置，模板的名称将变成环境加 '-' 加上设置的后缀。所以设置 deftemplatesuffix 为 hires 让普通的世界使用 normal-hires 模板，而地狱使用 nether-hires 模板。


除了这些由模板继承的设置，给定的设置可以通过在 worlds:（在 worlds.txt，或者 configuration.txt） 部分指定选项来给出自定义的设置。当给定世界的选项在配置文件出现，任何在配置中提供的设置将会覆盖对应的继承自模板的设定。


除了世界的名称和地图以外，所有的世界设定都是可选的，并且拥有默认的值，地图通常由模板提供。因此，在worlds:部分下的设定只能包含世界名称：

代码:

  1.     worlds:
  2.    - name: world1
  3.    - name: world2
这可以用来控制世界的顺序，因为定义的世界总是根据这里的顺序排列。


一份更加复杂的示例世界设置如下：

代码:

  1.     worlds:
  2.    - name: world
  3.   title: "My Great World"
  4.   enabled: true
  5.   template: mycustomtemplate
  6.   sendposition: true
  7.   sendhealth: true
  8.   fullrenderlocations:
  9.     - x: 100
  10.    y: 64
  11.    z: 2000
  12.   visibilitylimits:
  13.     - x0: -1000
  14.    z0: -1000
  15.    x1: 1000
  16.    z1: 1000
  17.   hiddenlimits:
  18.     - x0: 100
  19.    z0: 0
  20.    x1: 200
  21.    z1: 0
  22.   hidestyle: stone
  23.   center:
  24.     x: 0
  25.     y: 64
  26.     z: 0
  27.   bigworld: false
  28.   extrazoomout: 0
  29.   maps:
  30.     - class: org.dynmap.flat.FlatMap
  31.     ....
可用的设定如下


  • name : 设置世界的名称，必须独一无二，不能从模板继承。
  • title : 如果设置，此字符串为世界的标签，默认留空。
  • enabled : 如果启用（设置为 true），将会启用该世界的地图，或者禁用（设置为 false）。所有的世界都是默认启用的，所以将其设置为 false 只能防止生成地图和显示在网页上。
  • template : 如果设置，此选项覆写模板的默认世界设置。如果没有设置，那么将会使用基于世界环境的模板的设置（普通、地狱或空岛），如果设置了 deftemplatesuffix，还会在后面跟上 -deftemplatesuffix。这个设定不能由模板继承而来。
  • sendposition : 如果设置为 false，这将导致该世界的所有玩家的位置信息全部隐藏，设置此属性为 true 时，如果全局 sendposition 设置为 false，那么仍然不显示位置信息。如果没有设置此选项，默认为 true。
  • sendhealth : 如果设置为 false，这将导致该世界的所有玩家的生命信息全部隐藏，设置此属性为 true 时，如果全局 sendhealth 设置为 false，那么仍然不显示生命信息。如果没有设置此选项，默认为 true。
  • fullrenderlocations : 如果设置，这组世界坐标列表（每个坐标由x，y和z坐标组成）定义了一组附加位置（如果一个/dynmap fullrender命令由游戏玩家发出，那么为除了x=0，y=64，z=0，或玩家的当前位置的坐标）来开始一次完全渲染。讲道理，fullrender 就像画图软件中的油漆桶一样 - 如果地图在区块之间有间隙，比如地图使用传送门或者传送来探索，那么从一个点开始的完全渲染可能无法到达地图生成的全部区块： 添加到 fullrenderlocations 中的坐标点也会使这些区块被渲染。
  • visibilitylimits : 如果设置，那么这个列表代表的矩形能够用来限制渲染的区域：矩形外的区域将不会被精确呈现，而是使用某种形式填充（见下 hidestyle）。如果列表为空，那么将没有限制，地图将会渲染到生成的所有区块的边缘位置。每个矩形由两个坐标对 - x0, z0, 和 x1, z1 组成。从 1.5-alpha-3 开始，可以使用 x, z 作为圆心， r 作为半径的原型区域。
  • hiddenlimits : 如果设置，那么这个列表代表的矩形与 visibilitylimits 相反 - 定义了隐藏的世界特定区域（使用 hidestyle 的设置来填充）。如果定义了 'visibilitylimits' 和 'hiddenlimits'，那么首先使用 'visibilitylimits'（确定可见区域），然后使用 'hiddenlimits' 来进一步限制渲染的区域。每个矩形由两个坐标对 - x0, z0, 和 x1, z1 组成。从 1.5-alpha-3 开始，可以使用 x, z 作为圆心， r 作为半径的原型区域。
  • hidestyle : 如果 visibilitylimits 和/或 hiddenlimits 设置限制了世界的可见区域，则 hidestyle 设置用于控制如何显示这些无法显示的区块。有以下 3 种设置：stone，用石块填满隐藏区域，ocean，用海填满隐藏的地区，或 air，使隐藏区域为空（如世界地图的生成部分的边缘）。默认值为stone。
  • center : 如果设置，此选项提供该世界的地图的视点中心。该坐标包括了 x, y 和 z 的坐标。如果没有设置，则使用世界的出生点坐标。
  • bigworld : 如果设置，则将使用 FlatMap 或 KzedMap 地图种类的替代的文件结构，这个结构更加适合拥有数万数十万的 tiles 的大型世界。HDMap 始终使用这种结构，不会被此设置影响。默认为 false，当使用 true 则启用这种文件结构。如果更改了此设置，则需要使用 /dynmap fullrender 开初始化全新的地图。
  • extrazoomout : 如果设置，那么这将指定地图默认的缩小等级。这能让地图查看器提供更多的缩放等级，也能生成其他的缩放等级的 tiles（基于原始的tiles）：每一级将会缩小两倍的大小，每一级 4 个tiles将会缩小为 1 个tiles。启用此设置将会增加tiles文件数量和磁盘使用量的 25% - 33%，但是可以在大型世界更高的找到方位。默认为 0（无附加的缩小）。
  • maps : 如果设置，那么 maps 部分提供了按地图查看器显示的顺序用于渲染世界的所有的设置，如果在 worlds: 部分设置，则替换世界模板提供的地图设置。有关地图定义的详细信息，参见地图配置和高解析度地图配置。


命令
隐藏/显示玩家


  • /dynmap hide: 将此玩家从地图隐藏。
  • /dynmap hide thedude: 将玩家 thedude 从地图隐藏。
  • /dynmap show: 将此玩家重新从地图显示。
  • /dynmap show thedude: 将玩家 thedude 重新从地图显示。
渲染


  • /dynmap render: 渲染你的位置的一个tile。
  • /dynmap fullrender: 尝试从你的位置开始渲染整个世界的全部地图（如果从控制台使用则从世界中心开始）。
  • /dynmap fullrender world: 尝试从你的位置开始渲染 world 世界的全部地图（如果从控制台使用则从世界中心开始）。
  • /dynmap fullrender world:surface: 尝试从你的位置开始渲染 world 世界的 surface 地图（如果从控制台使用则从世界中心开始）。
  • /dynmap radiusrender radius: 尝试从你的位置开始渲染半径为 radius 的所有方块的区域。
  • /dynmap radiusrender radius mapname: 尝试从你的位置开始渲染半径为 radius 的所有方块的区域的 mapname 地图。
  • /dynmap radiusrender world x z radius: 尝试从 (x,64,z) 开始渲染 world 世界半径为 radius 的所有方块的区域。
  • /dynmap updaterender: 尝试从你的位置开始渲染 所有需要更新的tiles，到地图的边缘或是没有需要更新的tiles停止。
  • /dynmap updaterender mapname: 尝试从你的位置开始渲染 mapname 地图所有需要更新的tiles，到地图的边缘或是没有需要更新的tiles停止。
  • /dynmap updaterender world x z: 尝试从 (x,64,z) 开始渲染 world 世界所有需要更新的tiles，到地图的边缘或是没有需要更新的tiles停止。
  • /dynmap updaterender world x z mapname: 尝试从 (x,64,z) 开始渲染 world 世界 mapname 地图所有需要更新的tiles，到地图的边缘或是没有需要更新的tiles停止。
  • /dynmap cancelrender world: 取消指定世界所有激活的渲染任务。
  • /dynmap purgequeue: 清除tile更新队列
  • /dynmap purgeworld world: 清除 'world' 世界的所有地图文件
  • /dynmap purgemap world map: 清除 'world' 世界的 'map' 地图文件
  • /dynmap pause all: 暂停所有的渲染（更新和全部/范围渲染）
  • /dynmap pause none: 恢复所有渲染
统计


  • /dynmap stats: 显示所有世界的所有地图的渲染统计
  • /dynmap stats world : 显示 world 世界的所有地图的渲染统计
  • /dynmap triggerstats : 显示所有世界的触发器的渲染统计
  • /dynmap resetstats : 重置所有世界的所有地图的渲染统计
  • /dynmap resetstats world : 重置 world 世界的所有地图的渲染统计
记号
这些命令只能在标记部件启用后使用（v0.22或之后的版本）。


  • /dmarker add <label> icon:<icon> set:<set-id> : 在玩家的当前位置添加一个指定标签，可选的图标和可选的记号集的记号
  • /dmarker add id:<id> <label> icon:<icon> set:<set-id> : 在玩家的当前位置添加一个指定标签和 ID，可选的图标和可选的记号集的记号
  • /dmarker add id:<id> <label> icon:<icon> set:<set-id> x:<x-coord> y:<y-coord> z:<z-coord> world:<Worldname> : 在指定位置添加一个指定标签和 ID，可选的图标和可选的记号集的记号
  • /dmarker movehere <label> : 将第一个匹配指定标签的记号移动至玩家的当前位置
  • /dmarker movehere id:<id> : 将第一个匹配指定 ID 的记号移动至玩家的当前位置
  • /dmarker update <label> icon:<newicon> newlabel:<newlabel> : 更新第一个匹配指定标签的记号的图标和/或标签
  • /dmarker update id:<id> icon:<newicon> newlabel:<newlabel> : 更新第一个匹配指定 ID 的记号的图标和/或标签
  • /dmarker delete <label> : 删除第一个匹配指定标签的记号
  • /dmarker delete id:<id> : 删除第一个匹配指定 ID 的记号
  • /dmarker list : 列出默认记号集中定义的所有记号的属性
  • /dmarker list set:<set-id> : 列出指定记号集中定义的所有记号的属性
  • /dmarker icons : lists the attributes of all the icons defined for use by markers
  • /dmarker addset <label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : 添加指定标签的新记号集 (ID = 标签)
  • /dmarker addset id:<id> <label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : 添加指定标签和 ID 的新记号集
  • /dmarker updateset <label> newlabel:<new-label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : 更新指定标签的记号集 (ID = 标签)
  • /dmarker updateset id:<id> newlabel:<new-label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : 更新指定 ID 的记号集
  • /dmarker deleteset <label> : 删除指定标签的记号集
  • /dmarker deleteset id:<id> : 删除指定 ID 的记号集
  • /dmarker listsets : 列出所有的记号
  • /dmarker addicon id:<id> <label> file:"filename" : 使用指定的文件添加指定 ID 和标签的新图标（路径相对于 MC 服务器文件夹）。
  • /dmarker updateicon id:<id> newlabel:<label> file:"filename" : 使用指定的文件更新指定 ID 和标签的图标（路径相对于 MC 服务器文件夹）。
  • /dmarker deleteicon id:<id> : 删除指定 ID 的图标
  • /dmarker addcorner : 将目前的坐标作为一个角添加到列表
  • /dmarker addcorner <x> <z> <world> : 将给定的坐标作为一个角添加到列表
  • /dmarker clearcorners : 清除角列表
  • /dmarker addarea <label> : 使用给定的标签和当前的角列表创建并添加新的区域
  • /dmarker addarea id:<id> <label> : 使用给定的标签、ID 和当前的角列表创建并添加新的区域
  • /dmarker deletearea <label> : 删除给定标签的区域
  • /dmarker deletearea id:<id> <label> : 删除给定 ID 的区域
  • /dmarker listareas : 列出所有区域的详细信息
  • /dmarker updatearea <label> <arg>:<value> ... : 更新给定标签的区域的属性
  • /dmarker updatearea id:<id> <arg>:<value> ... : 更新给定 ID 的区域的属性
  • /dmarker addline <label> : 使用当前的角列表和给定的标签创建并添加新的线
  • /dmarker addline id:<id> <label> : 使用当前的角列表和给定的 ID 创建并添加新的线
  • /dmarker deleteline <label> : 删除给定标签的线
  • /dmarker deleteline id:<id> <label> : 删除给定 ID 的线
  • /dmarker listlines : 列出所有线的详细信息
  • /dmarker updateline <label> <arg>:<value> ... : 更新给定标签的线的属性
  • /dmarker updateline id:<id> <arg>:<value> ... : 更新给定 ID 的线的属性
地图/世界配置命令


  • /dmap worldlist : 显示所有配置了的世界（启用或禁用）
  • /dmap worldset worldname enabled:<true|false> : 设置 'worldname' 世界启用或禁用
  • /dmap worldset worldname center:<x/y/z|here|default> : 设置 'worldname' 世界的地图中心
  • /dmap worldset worldname extrazoomout:<N> : 设置 'worldname' 世界的额外缩小等级
  • /dmap worldset worldname title:<label> : 设置 'worldname' 世界的标题名称
  • /dmap worldset worldname sendposition:<true|false> sendhealth:<true|false> : 设置 'world' 世界的 sendposition 和 sendhealth 标签
  • /dmap worldset worldname order:<N> : 设置 'worldname' 世界的顺序
  • /dmap worldreset worldname : 重置 'worldname' 世界为模板设定
  • /dmap worldreset worldname templatename : 设置 'worldname' 世界为 'templatename' 模板设定
  • /dmap maplist worldname : 列出 'worldname' 世界的详细信息
  • /dmap mapdelete worldname:mapname : 删除 'worldname' 世界的 'mapname' 地图
  • /dmap mapadd worldname:mapname attrib:val attrib:val : 在世界 'worldname' 创建新的地图 'mapname'，使用所有给出的属性（所有的 'mapset' 属性都可用）
  • /dmap mapset worldname:mapname order:<N> : 设置地图 'mapname' 在世界 'worldname' 中的顺序
  • /dmap mapset worldname:mapname prefix:<prefix> : 设置世界 'worldname' 的地图 'mapname' 的文件前缀
  • /dmap mapset worldname:mapname title:<label> : 设置世界 'worldname' 的地图 'mapname' 的标题
  • /dmap mapset worldname:mapname icon:<icon-file> : 设置世界 'worldname' 的地图 'mapname' 的图标文件（相对于 'webpath' 目录）
  • /dmap mapset worldname:mapname mapzoomin:<N> : 设置世界 'worldname' 的地图 'mapname' 的缩放等级
  • /dmap mapset worldname:mapname perspective:<perspective> shader:<shader> lighting:<lighting> : 设置世界 'worldname' 的地图 'mapname' 的预设、光照和着色
  • /dmap mapset worldname:mapname img-format:<format> : 设置世界 'worldname' 的地图 'mapname' 的图片格式
  • /dmap perspectivelist : 列出所有的预设
  • /dmap shaderlist : 列出所有的着色器
  • /dmap lightinglist : 列出所有的光照
杂项
其他的命令。


  • /dynmap sendtoweb message ... : 向网页发送一条消息
  • /dynmap ids-for-ip ip-address : 列出指定 IP 最近登录的所有玩家
  • /dynmap ips-for-id player-id : 列出玩家的所有连接到服务器过的 IP 地址
  • /dynmap add-id-for-ip player-id ip-address : 将指定玩家添加到指定 IP 的已知玩家列表中
  • /dynmap del-id-for-ip player-id ip-address : 将指定玩家移除于指定 IP 的已知玩家列表中
  • /dynmap webregister : 开始注册自己的网页登录账户
  • /dynmap webregister player-id : 开始注册指定玩家的网页登录账户


权限
基于 SuperPerms 权限控制，包括了对 PermissionsEx, BukkitPermissions, bPermissions, 和经典的 Permissions 的支持、有以下的权限节点：


  • dynmap.render - 允许使用 /dynmap render 命令
  • dynmap.show.self - 允许使用 /dynmap show （自己）
  • dynmap.show.others - 允许使用 /dynmap show <player>
  • dynmap.hide.self - 允许使用 /dynmap hide 自己
  • dynmap.hide.others - 允许使用 /dynmap hide <player>
  • dynmap.fullrender - 允许使用 /dynmap fullrender 或 /dynmap fullrender <world>
  • dynmap.radiusrender - 允许使用 /dynmap radiusrender
  • dynmap.updaterender - 允许使用 /dynmap updaterender
  • dynmap.cancelrender - 允许使用 /dynmap cancelrender <world>
  • dynmap.pause - 允许使用 /dynmap pause
  • dynmap.reload - 允许使用 /dynmap reload
  • dynmap.stats - 允许使用 /dynmap stats 或 /dynmap stats <world> 或 /dynmap triggerstats
  • dynmap.resetstats - 允许使用 /dynmap resetstats 或 /dynmap resetstats <world>
  • dynmap.sendtoweb - 允许使用 /dynmap sendtoweb
  • dynmap.purgequeue - 允许使用 /dynmap purgequeue
  • dynmap.ids-for-ip - 允许使用 /dynmap ids-for-ip
  • dynmap.ips-for-id - 允许使用 /dynmap ips-for-id
  • dynmap.add-id-for-ip - 允许使用 /dynmap add-id-for-ip
  • dynmap.del-id-for-ip - 允许使用 /dynmap del-id-for-ip
  • dynmap.marker.add - 允许使用 /dmarker add
  • dynmap.marker.movehere - 允许使用 /dmarker movehere
  • dynmap.marker.update - 允许使用 /dmarker update
  • dynmap.marker.delete - 允许使用 /dmarker delete
  • dynmap.marker.list - 允许使用 /dmarker list
  • dynmap.marker.icons - 允许使用 /dmarker icons
  • dynmap.marker.addset - 允许使用 /dmarker addset
  • dynmap.marker.updateset - 允许使用 /dmarker updateset
  • dynmap.marker.deleteset - 允许使用 /dmarker deleteset
  • dynmap.marker.listsets - 允许使用 /dmarker listsets
  • dynmap.marker.addicon - 允许使用 /dmarker addicon
  • dynmap.marker.updateicon - 允许使用 /dmarker updateicon
  • dynmap.marker.deleteicon - 允许使用 /dmarker deleteicon
  • dynmap.marker.addarea - 允许使用 /dmarker addarea
  • dynmap.marker.updatearea - 允许使用 /dmarker updatearea
  • dynmap.marker.deletearea - 允许使用 /dmarker deletearea
  • dynmap.marker.listareas - 允许使用 /dmarker listareas
  • dynmap.marker.addline - 允许使用 /dmarker addline
  • dynmap.marker.updateline - 允许使用 /dmarker updateline
  • dynmap.marker.deleteline - 允许使用 /dmarker deleteline
  • dynmap.marker.listlines - 允许使用 /dmarker listlines
  • dynmap.dmap.worldlist - 允许使用 /dmap worldlist
  • dynmap.dmap.worldset - 允许使用 /dmap worldset
  • dynmap.dmap.worldreset - 允许使用 /dmap worldreset
  • dynmap.dmap.mapdelete - 允许使用 /dmap mapdelete
  • dynmap.dmap.mapset - 允许使用 /dmap mapset
  • dynmap.dmap.mapadd - 允许使用 /dmap mapadd
  • dynmap.dmap.perspectivelist - 允许使用 /dmap perspectivelist
  • dynmap.dmap.shaderlist - 允许使用 /dmap shaderlist
  • dynmap.dmap.lightinglist - 允许使用 /dmap lightinglist
  • dynmap.webregister - 允许使用 /dynmap webregister
  • dynmap.webregister.other - 允许使用 /dynmap webregister player-id
  • dynmap.webchat - 允许通过网页发送聊天消息（需要登录或 ID-IP 映射）
  • dynmap.playermarkers.showall - 允许用户查看隐藏的玩家的记号
  • dynmap.world.<世界名> - 如果世界被设置为保护，允许用户查看指定世界的地图
  • dynmap.map.<世界名>.<地图名> - 如果地图被设置为保护，允许用户查看指定世界的指定地图

梦
本帖最后由 梦彗業 于 2017-10-9 22:42 编辑

感谢大家对本项目的期待和支持，本人也是第一次参与此类插件Wiki的翻译，如有错漏之处请在本帖回复，谢谢。
cc7w
你看我是最垃圾的一个
volta薯片~
辛苦XD
想当年wiki的词条里我还做了点小贡献XD
a526026058
为何这帖子这么少回复？
adfg36360533
MCBBS有你更精彩~
xunli85094
好高级
yr69658011
这是插件还是模组，加进plugins文件，没反应呢呢？
大哞菇
让网页地图缩放更大倍数，达到能看到更大视野的效果如何实现？？？
大哞菇
禁用洞穴视角渲染如何实现？
diting
MCBBS有你更精彩~
粉红鹊
好帖子啊！兄弟们！支持了
炼药锅
每个不换都可以认为是Dynmap的一个单独的特性，可以被单独开启或者关闭。有些不见基于其他的部件，但是我们不会深入。

“不换”  “不见”
怎么文章开头就遇到错别字？
小胡大大1
很不错，内容详细，帮助很大
小野喔
非常感谢 帮助很大
小野喔
本帖最后由 小野喔 于 2023-3-23 09:32 编辑

followzoom : 此设置为可选的设置，为一个整数，指定了当网页选择了要跟随的玩家时，默认的缩放等级。
followmap : 此设置为可选的设置，为一个字符串，指定了当网页选择了要跟随的玩家时，默认显示的地图。
如何设置地图跟随玩家？
dfg21542

为何这帖子这么少回复？
LHXC
MCBBS有你更精彩~
1459226117
我安装地皮插件好像告诉我需要dynmap这个东西，这个是啥，在哪里下载