
DapperMap
一个轻量、精致且完全可配置的Hytale小地图。
查看大图DapperMap
一个轻量、精致且完全可配置的 Hytale 小地图。
DapperMap 在 Hytale HUD 上添加实时小地图。它将附近地形、方向性玩家定位器、可配置标记和有用的世界信息整合在一个紧凑的显示界面中。玩家可以通过游戏内设置界面或命令来自定义小地图显示,而服务器管理员可以控制默认值并决定玩家可以更改哪些选项。
![]()
亮点
- 基于 Hytale 世界地图数据生成的实时地形小地图
- 圆形和方形地图样式
- 北向朝上或面向玩家旋转
- 可调节缩放、地图大小、界面缩放和纹理分辨率
- 可自由定位的 HUD,带有可移动的信息面板
- 玩家、生物、死亡和世界地图标记
- 可选的 BetterMap 路径点集成
- 坐标、方位、世界时间和生物群系读数
- 边框、文本和标记类别的完全可配置颜色
- 每位玩家的设置及持久化存储
- 服务器为新玩家和未自定义玩家定义的默认值
- 权限感知设置:被阻止的控件将被禁用并置灰
- 独立的玩家和管理员命令分支
集成
Dappermap 支持与以下模组集成:
- BetterMap - DapperMap 将显示由 BetterMap 生成的标记。
- LuckPerms - DapperMap 的权限结构支持通过 LuckPerms 进行配置。
使用 DapperMap
小地图可以通过两种方式控制:
- 运行
/dappermap settings以使用游戏内设置界面。 - 使用单独的
/dappermap命令进行直接更改。
命令也可以写为 /minimap、/mm 或 /dm。
运行任何基础 DaperMap 命令(例如 /dappermap)而不带任何子命令,将切换小地图的开启和关闭。

功能
实时地形地图
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 的默认玩家组授予玩家权限 |
管理员设置页面提供完整的操作默认值集。这些默认值与引导配置分开存储。
正在加载版本记录…



正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。