Dynmap 雷达

Dynmap Radar

直接在 Xaero 世界地图 和 Xaero 小地图 上显示 Dynmap 的玩家与标记。

功能

玩家追踪

• 在 Xaero 世界地图与小地图上显示 Dynmap 服务器中的所有在线玩家
• 使用真实的 Minecraft 皮肤（原版 PlayerFaceRenderer）渲染玩家头像
• 在头像下方显示玩家名称（支持 NAME / ACCOUNT 显示模式）
• 可配置头像大小、缩放比例和更新间隔
• 自动排除本地加载（附近）的玩家
• 小地图距离剔除——隐藏超出可配置半径（默认 200 格）的玩家

标记渲染

• 全面支持四种 Dynmap 标记类型：
  • 区域 — 带轮廓的填充多边形
  • 圆形 — 带轮廓的填充圆
  • 折线 — 多段线（通过顶点四边形实现粗线）
  • 点 — 从 Dynmap 下载的自定义图标并带标签
• 图标自动异步下载并缓存至磁盘
• 可配置标记缩放、点图标缩放及跟随缩放行为
• 世界地图与小地图分别控制图层可见性——可独立显示或隐藏各标记集
• 小地图距离剔除——隐藏超出可配置半径（默认 200 格）的远处标记

右键菜单（世界地图）

• 复制名称 — 复制标记/玩家名称到剪贴板
• 复制坐标 — 复制 x y z 到剪贴板
• 复制完整信息 — 复制名称 + 坐标 + 描述（仅标记）
• 传送 — 使用 Xaero 内置传送器传送至标记/玩家位置（遵循 Xaero 传送命令设置）
• 创建路径点 — 在标记/玩家位置即时创建 Xaero 小地图路径点（可配置颜色）

小地图支持

• 可选在小地图上渲染标记和玩家头像
• 小地图上的形状渲染（区域/圆形/折线）可单独开关
• 可配置的距离剔除半径，保持小地图整洁

依赖项

• Xaero 世界地图
• Xaero 小地图
• 运行 Dynmap 的服务器

快速入门

1. 安装模组和依赖项
2. 加入一个运行 Dynmap 的服务器
3. 设置 Dynmap 网址：/dradar settings url set http://yourserver.com:8123
4. 打开 Xaero 世界地图——玩家和标记将显示
5. 右键点击任意标记或玩家以获取选项（复制、传送、创建路径点）

重要提示

• 在小地图上渲染非点状标记可能存在缺陷，请谨慎使用（切换 minimapShapes 设置）
• 目前仅支持无需认证即可查看在线地图的服务器。未来可能增加对需要认证的服务器的支持。

---

命令

所有命令均使用 /dradar

设置

命令	描述
/dradar status	显示当前配置
/dradar settings <key> get	读取设置值
/dradar settings <key> set <value>	写入设置值
/dradar reload	重新加载配置文件
/dradar clearCache	清除所有缓存数据并重新获取

可用的设置键：

键	类型	默认值	范围	描述
url	字符串	""	—	Dynmap 服务器基础网址（例如 http://example.com:8123）
mode	字符串	NAME	NAME / ACCOUNT	玩家显示模式
headSize	整数	24	8–64	玩家头像图标大小
markerScale	双精度浮点数	2.0	0.1–10	整体标记渲染缩放
pointScale	双精度浮点数	1.0	0.25–10	点状图标缩放倍数
pointFollowZoom	布尔值	true	—	点状图标大小跟随地图缩放
headFollowZoom	布尔值	false	—	头像图标大小跟随地图缩放
showInMinimap	布尔值	false	—	在小地图上显示标记/玩家
minimapShapes	布尔值	false	—	在小地图上渲染区域/圆形/折线形状
minimapCullRadius	双精度浮点数	200	10–10000	隐藏超出此半径的小地图元素（格）
waypointColor	整数	0xFFFFFF	0–0xFFFFFF	创建的路径点颜色（RGB 十六进制，例如 0xFF5555）
interval	整数	1000	100–60000	数据获取间隔（毫秒）

图层管理

图层可见性在世界地图和小地图上分别管理。

命令	描述
/dradar layer world list	列出所有标记集及其世界地图可见性
/dradar layer world show <setId>	在世界地图上显示一个标记集
/dradar layer world hide <setId>	在世界地图上隐藏一个标记集
/dradar layer world showAll	在世界地图上显示所有标记集
/dradar layer minimap list	列出所有标记集及其小地图可见性
/dradar layer minimap show <setId>	在小地图上显示一个标记集
/dradar layer minimap hide <setId>	在小地图上隐藏一个标记集
/dradar layer minimap showAll	在小地图上显示所有标记集
/dradar layer reset <setId>	将图层重置为 Dynmap 服务器默认设置

维度映射

命令	描述
/dradar dim list	显示当前维度映射
/dradar dim map <dynmapWorld> <xaeroDim>	将 Dynmap 世界映射到一个维度
/dradar dim unmap <dynmapWorld>	移除一个维度映射
/dradar dim mapCurrent	将 Dynmap "world" 映射到当前维度