• 欢迎来到Minecraft插件百科!
  • 对百科编辑一脸懵逼?帮助:快速入门带您快速熟悉百科编辑!
  • 因近日遭受攻击,百科现已限制编辑,有意编辑请加入插件百科企鹅群:223812289

Dynmap/地图标记

From Minecraft插件百科
Revision as of 21:22, 16 August 2021 by Ff98sha (talk | contribs) (创建页面,内容为“Dynmap 支持添加数据到地图的机制,这些数据统称为Markers标记,由记号(标记图标),区域标记和折线标记构成。 ==标记集==…”)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Dynmap 支持添加数据到地图的机制,这些数据统称为Markers标记,由记号(标记图标),区域标记和折线标记构成。

标记集

标记的收集和组织被称为标记集(Marker Sets),每个标记集是一个图层,可以使用网页的层选择器选择,每个标记都包含在特定的标记集中。默认情况下,总有一个标签为 Markers 的标记集,用于包括没有被手动分配的标记。删除标记集将会删除集合中的所有标记。

新的标记集可以通过使用 /dmarker addset <markerset-label> 或 /dmarker addset id:<markerset-id> 命令来创建,这个命令可以添加其他的参数: prio:<N> 用于控制图层的相对于其他的标记集的优先度顺序;hide:<true|false> 用于控制默认情况下是否可见(选中)或不可见(未选中);minzoom:<N> 用于控制标记集可见的最小的缩放程度,如果为达到此缩放将不会可见。

对已有标记集的设置可以通过使用 /dmarker updateset <markerset-label> 或 /dmarker updateset id:<markerset-id> 命令,可以使用 prio:<N>,hide:<true|false> 或 newlabel:<new-label> 参数。

在 0.32 版本,选项 showlabels:<true|false|null> 被加入支持。此选项为 true 或 false 时,将会启用或禁用标记集的标签的可见性(禁用时,如果鼠标悬浮在某标记上,标签仍然会显示)。值 null 将会使用全局设置(由 configuration.txt 中的 markers 部件的 showlabels 设置指定)。

标记集(除了默认的 Markers 集合)可以使用 /dmarker deleteset <markerset-label> 或 /dmarker deleteset id:<markerset-id> 命令删除。

记号

记号是最常见的地图标记 - 简单的图标和一些描述性的标签和弹出窗口。每个记号都有一个在世界中的坐标(X Y Z 和世界 ID),一个记号图标 ID,一个标签,和一个可选的描述。记号图标 ID 可以是标准记号 ID(本页底部) 中的一个,也可以对应安装的图标(查看下方的 记号图标 部分)。

记号可以通过以下方法添加:

  • /dmarker add <marker-label> icon:<icon-id> set:<markerset-id> - 此命令必须由一个在线的玩家使用,这将在玩家的位置添加一个记号,如果 set 没有被提供,那么记号将会创建于默认的标记集。如果 icon 没有被提供,那么将会使用默认的记号图标(default,一个房子)。
  • /dmarker add id:<marker-id> <marker-label> icon:<icon-id< set:<markerset-id> - 与上方相同,但需要提供 独立 ID。
  • 使用牌子 - 如果 markers 部件的 enablesigns 设定被弃用,那么拥有对应权限的用户可以使用特殊标签的牌子来创建记号。牌子的第一行必须是 [dynmap],之后,除了格式为 set: <标记集ID> 或 icon:<图标ID>(允许设置为特殊的图标,如果没有设置,那么将使用默认的 sign 图标)的行数都将被包含在此记号的标签中。如果记号被成功创建,牌子的 [dynmap],set:,icon: 行都会被删除。如果这个牌子之后被破坏,那么地图上对应的记号将被删除。

创建后,记号可以使用以下的命令编辑:

  • /dmarker movehere <marker-label> set:<markerset-id> 或 /dmarker movehere id:<marker-id> set:<markerset-id> - 此命令将会移动指定的记号到玩家的位置,注意:如果要选择不在默认集中的记号,那么 markerset-id 是必要的。
  • /dmarker update <marker-label> set:<markerset-id> icon:<icon-id> newlabel:<new-label> 或 /dmarker update id:<marker-id> set:<markerset-id> icon:<icon-id> newlabel:<new-label> - 注意:如果要选择不在默认集中的记号,那么 markerset-id 是必要的。

记号可以使用 /dmarker delete <marker-label> set:<markerset-id> 或 /dmarker delete id:<marker-id> set:<markerset-id> 命令来删除。

可以使用 /dmarker list set:<markerset-id> 命令来列出所有已有的记号和属性。

记号图标

记号图标是用于给记号提供图标的图像,Dynmap 提供了一些默认的标准图标,全部都在下方的图片中,它们是预设的,并且不可以被删除。可以使用 /dmarker icons 命令来列出所有可用的图标。

新的图标可以通过以下几步来安装:

  • 将 PNG 格式的图像文件复制进 Bukkit 的服务器文件夹,图片应该为 8x8,16x16 或 32x32 的大小。
  • 运行命令 /dmarker addicon id:<icon-id> <icon-label> file:<path-to-image-file> - 如果成功,图片文件将被导入(所以不用放在第一次复制的地方)。

更新已有的图标的图片可以使用 /dmarker updateicon id:<icon-id> newlabel:<new-label> file:<path-to-image-file> 命令。

删除已有的图片可以使用 /dmarker deleteicon id:<icon-id> 命令。

-Dynmap-09.png

区域记号

区域标记用于在地图上方式 3D 或者 2D 的轮廓,区域标记由 2 个或者更多个的 X Z 坐标点序列组成的长方形(如果是两个点则是矩形的对角)或者多边形(如果是三个或者更多的点,则是多边形的有序的角序列,从第一个连接到最后一个再连回第一个点)。可选的,你可以设置设置最小和最大的 Y 值,将二维模型拓展为三维模型(顶部和底部是平坦的)。

可以设置颜色属性(#RRGGBB)和线段重量(0-N)和透明度(0.0-1.0)控制填充区域的颜色和外观。

创建一个区域之前必须提供一组角,可以通过以下步骤完成:

  • 运行 /dmarker addcorner 命令来将玩家的当前位置添加为一个角
  • 运行 /dmarker addcorner <x> <y> <z> 或 /dmarker addcorner <x> <y> <z> <world> 命令来添加指定的坐标点为一个角

添加的角可以使用 /dmarker clearcorners 命令来清除。

添加角之后,可以使用 /dmarker addarea <area-label> set:<markerset-id> 或 /dmarker addarea id:<area-id> <area-label> set:<markerset-id> 命令来创建一个区域标记。可以使用这些命令来设置附加的属性,或者使用 /dmarker updatearea id:<area-id> set:<markerset-id> 或 /dmarker updatearea <area-label> set:<markerset-id> 命令来更新已有的区域的属性。可用的选项包括:

  • color - 轮廓颜色 (#RRGGBB 格式)
  • fillcolor - 填充颜色 (#RRGGBB 格式)
  • opacity - 轮廓的不透明度 (0.0 = 透明, 1.0 = 实体)
  • fillopacity - 填充的不透明度 (0.0 = 透明, 1.0 = 实体)
  • weight - 轮廓的重量(0=最小,越大越粗)
  • ytop - 区域最大的 Y 轴高度 (默认=64)
  • ybottom - 区域最小的 Y 轴高度 (默认=64)

注意:现有的区域无法更新,必须删除后重新创建新的区域。另外,当使用 /dmarker addarea 命令创建区域后,当前的角列表将会重置。

你可以使用 /dmarker deletearea id:<area-id> set:<markerset-id> 命令删除一个区域标记。

已经存在的区域和他们的属性可以使用 /dmarker listareas set:<markerset-id> 命令显示。

圆形标记

圆形标记用于在地图上放置二维圆形(或椭圆)轮廓,此区域使用圆形的轮廓,通过一个中心点(XYZ)和一个半径(圆形)或 X 和 Z 半径(椭圆)来创建。

轮廓边缘的外观可以通过设置颜色属性(#RRGGBB),线条重量(0-N)和透明度(0.0-1.0)来设置。

圆形标记可以通过使用 /dmarker addcircle <circle-label> set:<markerset-id> 或 /dmarker addcircle id:<circle-id> <circle-label> set:<markerset-id> 命令来创建。可以使用这些命令来设置附加的属性,或者使用 /dmarker updatecircle id:<circle-id> set:<markerset-id> 或 /dmarker updatecircle <circle-label> set:<markerset-id>命令来更新已有的圆形标记的属性。可用的选项包括:

  • x - 中心的 X 坐标(默认为使用命令的玩家的坐标点 X 坐标)
  • y - 中心的 Y 坐标(默认为使用命令的玩家的坐标点 Y 坐标)
  • z - 中心的 Z 坐标(默认为使用命令的玩家的坐标点 Z 坐标)
  • radius - 圆的半径(默认为 1)
  • radiusx - 椭圆的 X 轴半径(默认为 1)
  • radiusz - 椭圆的 Z 轴半径(默认为 1)
  • world - 中心的世界(默认为使用命令的玩家的世界)
  • color - 轮廓颜色 (#RRGGBB 格式)
  • fillcolor - 填充颜色 (#RRGGBB 格式)
  • opacity - 轮廓的不透明度 (0.0 = 透明, 1.0 = 实体)
  • fillopacity - 填充的不透明度 (0.0 = 透明, 1.0 = 实体)
  • weight - 轮廓的重量(0=最小,越大越粗)

使用 /dmarker deletecircle id:<circle-id> set:<markerset-id> 删除一个圆形标记。

已经存在的圆形标记和他们的属性可以使用 /dmarker listcircles set:<markerset-id> 命令显示。

折线标记

折线标记将连接的线段放置在地图上,每个折线标记由一个或多个 XYZ 坐标构成。以及可选的描述弹出窗口,重量和透明度设置。

轮廓边缘的外观可以通过设置颜色属性(#RRGGBB),线条重量(0-N)和透明度(0.0-1.0)来设置。

创建一个折线之前必须提供一组角,可以通过以下步骤完成:

  • 运行 /dmarker addcorner 命令来将玩家的当前位置添加为一个角
  • 运行 /dmarker addcorner <x> <y> <z> 或 /dmarker addcorner <x> <y> <z> <world> 命令来添加指定的坐标点为一个角

添加的角可以使用 /dmarker clearcorners 命令来清除。

添加角之后,可以使用 /dmarker addline <line-label> set:<markerset-id> 或 /dmarker addline id:<line-id> <line-label> set:<markerset-id> 命令来创建一个折线标记。可以使用这些命令来设置附加的属性,或者使用 /dmarker updateline id:<line-id> set:<markerset-id> 或 /dmarker updateline <line-label> set:<markerset-id> 命令来更新已有的折线的属性。可用的选项包括:

  • color - 轮廓颜色 (#RRGGBB 格式)
  • opacity - 轮廓的不透明度 (0.0 = 透明, 1.0 = 实体)
  • weight - 轮廓的重量(0=最小,越大越粗)

注意:现有的折线无法更新,必须删除后重新创建新的折线。另外,当使用 /dmarker addline 命令创建折线后,当前的角列表将会重置。

你可以使用 /dmarker deleteline id:<line-id> set:<markerset-id> 命令删除一个折线标记。

已经存在的折线和他们的属性可以使用 /dmarker listlines set:<markerset-id> 命令显示。