DapperMap

DapperMap

一个轻量、精致且完全可配置的Hytale小地图。

实用

DapperMap

一个轻量、精致且完全可配置的 Hytale 小地图。

DapperMap 在 Hytale HUD 上添加实时小地图。它将附近地形、方向性玩家定位器、可配置标记和有用的世界信息整合在一个紧凑的显示界面中。玩家可以通过游戏内设置界面或命令来自定义小地图显示,而服务器管理员可以控制默认值并决定玩家可以更改哪些选项。

DapperMap HUD

亮点

  • 基于 Hytale 世界地图数据生成的实时地形小地图
  • 圆形和方形地图样式
  • 北向朝上或面向玩家旋转
  • 可调节缩放、地图大小、界面缩放和纹理分辨率
  • 可自由定位的 HUD,带有可移动的信息面板
  • 玩家、生物、死亡和世界地图标记
  • 可选的 BetterMap 路径点集成
  • 坐标、方位、世界时间和生物群系读数
  • 边框、文本和标记类别的完全可配置颜色
  • 每位玩家的设置及持久化存储
  • 服务器为新玩家和未自定义玩家定义的默认值
  • 权限感知设置:被阻止的控件将被禁用并置灰
  • 独立的玩家和管理员命令分支

集成

Dappermap 支持与以下模组集成:

  • BetterMap - DapperMap 将显示由 BetterMap 生成的标记。
  • LuckPerms - DapperMap 的权限结构支持通过 LuckPerms 进行配置。

使用 DapperMap

小地图可以通过两种方式控制:

  1. 运行 /dappermap settings 以使用游戏内设置界面。
  2. 使用单独的 /dappermap 命令进行直接更改。

命令也可以写为 /minimap、/mm 或 /dm。

运行任何基础 DaperMap 命令(例如 /dappermap)而不带任何子命令,将切换小地图的开启和关闭。

DapperMap Settings

功能

实时地形地图

DapperMap 使用 Hytale 的原生世界地图信息渲染玩家周围的地形。地图随玩家移动而平移,并在周围地图数据变化时刷新地形。

玩家可以配置:

  • 缩放半径: 控制玩家周围可见的方块数量,从 16 到 256 个方块。
  • 地图大小: 将屏幕上的地图大小从 120 更改为 360 像素。
  • 纹理分辨率: 将内部渲染纹理分辨率从 256 更改为 1024 像素。更高的值产生更多细节,但需要更多的处理和网络传输。
  • 界面缩放: 将完整的地图和信息显示从 75% 缩放到 160%,而不改变所显示的世界区域。
  • 地图形状: 选择圆形或方形小地图。

旋转与指南针

DapperMap 支持两种方向模式:

  • 北向朝上: 北方保持在顶部,同时玩家定位器旋转。
  • 面向玩家: 地图随玩家视角旋转,使前方方向保持在顶部。

可选的指南针读数显示玩家当前的方位和朝向。

更新速度

提供四种更新速度配置文件:

配置文件 地图平移 标记 地形检查 地形刷新
非常快 40 ms 50 ms 150 ms 300 ms
快 75 ms 100 ms 300 ms 600 ms
正常 150 ms 250 ms 750 ms 1,200 ms
慢 300 ms 500 ms 1,500 ms 2,500 ms

更快的配置文件使移动和标记感觉更灵敏,但如果被许多玩家使用,可能会对服务器性能造成影响。更慢的配置文件减少服务器检查和重绘小地图内容的频率。

HUD 定位和信息面板

完整的小地图可以在可用屏幕区域的 0% 到 100% 范围内水平和垂直定位。设置页面提供快速放置控件以及精细调整滑块。

信息面板可以出现在地图的上方、下方、左侧或右侧。其文本可以左对齐、居中对齐或右对齐。

可以启用或禁用单独的信息行:

  • 坐标: 当前世界坐标
  • 方位: 指南针方位和朝向
  • 世界时间: 当前 Hytale 世界时间,12 小时或 24 小时格式
  • 区域: 当前生物群系或区域名称

玩家和生物标记

DapperMap 可以将附近的玩家和生物显示为颜色编码的标记。生物标记区分:

  • 正在主动攻击玩家的生物
  • 其他敌对生物
  • 中立或撤退的生物
  • 友好生物

可见生物标记的数量可选择为 16(默认)、32 或 64。玩家和集成标记不使用此生物限制。

生物高度检测可以隐藏位于玩家上方或下方过远的实体。垂直范围可配置为 4 到 256 个方块。

死亡标记

启用后,DapperMap 记录并显示玩家最近的死亡位置。这使得导航返回更加容易,而无需反复打开完整的世界地图。

Hytale 世界地图标记

DapperMap 可以显示 Hytale 原生世界地图支持的标记,包括个人标记、共享标记、兴趣点、出生和重生位置。设计用于边缘跟踪的标记在其位置超出当前视图时,会保持在小地图边缘可见。

BetterMap 集成

如果安装了 BetterMap 并被检测到,DapperMap 可以显示该玩家的 BetterMap 路径点和路径点图标。集成可以按玩家单独启用或禁用,也可以在管理员默认值中配置。

主集成、路径点标记和洞穴地形开关是分开的。洞穴地形还要求玩家已激活 BetterMap 洞穴模式。

BetterMap 是可选的。没有它,DapperMap 仍然完全可用。

颜色编辑器

游戏内颜色编辑器提供实时预览,并允许玩家自定义:

  • 地图边缘和指南针刻度
  • 面板边框、标题和标签颜色
  • DapperMap 标题和信息文本
  • 玩家定位器和其他玩家标记
  • 死亡标记
  • 攻击、敌对、中立和友好生物标记

颜色也可以通过命令使用十六进制 #RRGGBB 值或十进制 RGB 通道进行更改。

游戏内设置界面

设置界面分为显示、标记、界面、位置和颜色部分。更改可以在应用之前进行预览。

如果玩家缺少某项设置的权限,该控件将被禁用并显示 Permission denied。在应用更改时,服务器上也会重复进行权限检查,因此隐藏或伪造的 UI 事件无法更改被阻止的设置。

玩家设置和管理员默认值

新玩家继承当前的管理员设置的默认值。仅仅加入并不会创建个人设置文件,因此从未自定义过 DapperMap 的玩家会继续接收未来的管理员默认更改。

一旦玩家更改并应用了某项设置,DapperMap 就会为该玩家保存个人覆盖。在设置页面中使用 Reset to Defaults 会移除该覆盖,并恢复继承当前管理员默认值。

管理员默认值与玩家偏好分开存储,可以通过管理员设置页面或 /dappermap admin 命令分支进行管理。

命令

主命令是 /dappermap。

别名:/minimap、/mm、/dm

所有 DapperMap 命令都需要有效的玩家上下文,因为它们操作玩家的 HUD 或打开游戏内页面。因此,管理员命令由授权的玩家在游戏内运行,而不是从专用服务器控制台运行。

通用命令

命令 描述
/dappermap 切换小地图
/dappermap settings 打开玩家设置页面
/dappermap colours 打开颜色编辑器
/dappermap on 显示小地图
/dappermap off 隐藏小地图
/dappermap help 列出命令语法和可接受的值
/dappermap status 显示当前设置
/dappermap reset 将玩家的值重置为引导模组默认值

显示和放置命令

命令 描述
/dappermap zoom close|medium|far|<16..256> 设置可见地图半径;预设为 48、96 和 160 个方块
/dappermap size <120..360> 设置逻辑屏幕地图大小
/dappermap scale <75..160> 缩放完整的小地图界面
/dappermap resolution <256..1024> 设置渲染的地图纹理分辨率
/dappermap speed very-fast|fast|normal|slow 选择更新速度配置文件
/dappermap shape circle|square 选择地图形状
/dappermap rotation north|player 选择北向朝上或面向玩家旋转
/dappermap position <x 0..100> <y 0..100> 定位完整的 HUD
/dappermap info on|off 显示或隐藏完整的信息面板
/dappermap panel below|above|left|right 相对于地图定位信息面板
/dappermap panel-alignment left|centre|right 对齐信息面板文本(也接受 center)

标记和信息命令

命令 描述
/dappermap markers players|entities|death|worldmap on|off 启用或禁用标记类别
/dappermap creature-limit 16|32|64 设置最大可见生物标记数
/dappermap height on|off 启用或禁用生物高度过滤
/dappermap height-range <4..256> 设置玩家上方和下方允许的生物距离
/dappermap coordinates on|off 显示或隐藏坐标
/dappermap compass on|off 显示或隐藏方位(bearing 别名)
/dappermap clock on|off|12|24 控制世界时间和时钟格式(world-time 别名)
/dappermap biome on|off 显示或隐藏区域(region 别名)
/dappermap integration native on|off 控制 Hytale 世界地图标记
/dappermap integration bettermap enable|disable 控制 BetterMap 主集成
/dappermap integration bettermap markers on|off 控制 BetterMap 路径点标记
/dappermap integration bettermap caves on|off 控制洞穴地形;BetterMap 洞穴模式必须已激活

颜色命令

命令 描述
/dappermap colours list 列出可用的颜色目标及其当前值
/dappermap colour <target> <#RRGGBB> 使用十六进制 RGB 设置颜色
/dappermap colour <target> <R G B> 使用 0 到 255 的十进制 RGB 通道设置颜色
/dappermap colour reset <target> 重置一个颜色目标
/dappermap colour reset all 重置完整调色板

管理员命令

管理员分支使用与玩家分支相同的设置和值,但更改新玩家和未自定义玩家继承的默认值。

/dappermap admin settings
/dappermap admin status
/dappermap admin help
/dappermap admin reset
/dappermap admin <setting> <value>

示例:

/dappermap admin zoom far
/dappermap admin shape circle
/dappermap admin markers entities off
/dappermap admin clock 24
/dappermap admin panel-alignment centre
/dappermap admin creature-limit 32
/dappermap admin integration bettermap enable

/dappermap admin settings 打开设置界面的管理员版本。管理员模式仅受管理员权限控制,不需要每项玩家设置权限。

权限

DapperMap 将玩家权限和管理员访问权限保留在独立的分支中:

scyphoz.dappermap.command.<setting>
scyphoz.dappermap.admin

这种分离意味着使用 scyphoz.dappermap.command.* 授予所有玩家命令永远不会授予管理员设置的访问权限。

默认权限行为

dappermap_minimap.json 中的 GrantPlayerSettingsByDefault 值控制玩家权限的注册方式。

默认启用玩家设置

"GrantPlayerSettingsByDefault": true

这是默认模式。每个玩家命令和设置权限都通过 Hytale 的默认玩家组授予。服务器管理员可以通过 Hytale 的权限系统或兼容的提供者(如 LuckPerms)显式拒绝其权限节点,从而选择性地阻止功能。

显式拒绝还会禁用并置灰游戏内界面中的相应设置。

需要显式授予

"GrantPlayerSettingsByDefault": false

在此模式下,DapperMap 注册权限节点,但不将它们授予默认玩家组。玩家只获得管理员显式授予的命令和设置。

更改 GrantPlayerSettingsByDefault 后,重启服务器,以便 DapperMap 使用新策略注册其权限。

若要访问图形设置页面,请授予:

scyphoz.dappermap.command.settings

然后授予玩家可以使用的控件的权限。若要一次性允许所有面向玩家的命令和设置,请授予:

scyphoz.dappermap.command.*

若只允许裸 /dappermap 切换,请授予:

scyphoz.dappermap.command.toggle

玩家权限参考

权限 控制
scyphoz.dappermap.command.toggle 裸 /dappermap 切换和设置页面中的启用控件
scyphoz.dappermap.command.settings 打开设置页面
scyphoz.dappermap.command.colours 颜色编辑器和颜色命令
scyphoz.dappermap.command.on /dappermap on
scyphoz.dappermap.command.off /dappermap off
scyphoz.dappermap.command.status /dappermap status
scyphoz.dappermap.command.reset 重置玩家设置
scyphoz.dappermap.command.zoom 缩放半径
scyphoz.dappermap.command.size 地图大小
scyphoz.dappermap.command.scale 界面缩放
scyphoz.dappermap.command.resolution 纹理分辨率
scyphoz.dappermap.command.speed 更新速度
scyphoz.dappermap.command.shape 圆形或方形地图形状
scyphoz.dappermap.command.rotation 北向朝上或面向玩家旋转
scyphoz.dappermap.command.position HUD 位置控件
scyphoz.dappermap.command.panel 信息面板可见性、位置和 panel-alignment
scyphoz.dappermap.command.markers 玩家、生物、死亡和 Hytale 世界地图标记控件以及 creature-limit
scyphoz.dappermap.command.height 生物高度检测
scyphoz.dappermap.command.height-range 生物垂直范围
scyphoz.dappermap.command.coordinates 坐标读数
scyphoz.dappermap.command.clock 世界时钟和 12/24 小时格式
scyphoz.dappermap.command.compass 指南针读数
scyphoz.dappermap.command.biome 生物群系读数
scyphoz.dappermap.command.integration 原生和 BetterMap 主/标记/洞穴集成控件
scyphoz.dappermap.command.* 所有面向玩家的 DapperMap 命令和设置

help 使用 scyphoz.dappermap.command.help。新的直接命令有意重用其匹配 UI 控件的权限:panel-alignment 使用 panel,creature-limit 使用 markers。信息面板可见性使用 scyphoz.dappermap.command.info。

命令别名使用分配给其规范命令的权限。例如,coords 使用 coordinates 权限,update 使用 speed 权限。

管理员权限

管理员访问由单独的权限控制:

scyphoz.dappermap.admin

此权限允许游戏内玩家:

  • 打开 /dappermap admin settings
  • 查看和更改所有服务器默认设置
  • 使用每个 /dappermap admin <setting> 子命令
  • 将管理员默认值重置为模组默认值

管理员权限默认授予 Hytale 的操作员组。如果安装了其他权限提供者,可以通过该提供者授予或拒绝相同的节点。

授予 scyphoz.dappermap.command.* 不会授予 scyphoz.dappermap.admin。

引导配置

主文件 dappermap_minimap.json 包含初始的模组级默认值:

设置 默认值 描述
EnabledByDefault true 在应用管理员或玩家覆盖之前,小地图是否默认启用
DefaultRadiusBlocks 96 初始缩放半径
ShowCoordinates true 初始坐标读数状态
GrantPlayerSettingsByDefault true 是否通过 Hytale 的默认玩家组授予玩家权限

管理员设置页面提供完整的操作默认值集。这些默认值与引导配置分开存储。