BetterMap

Hytale BetterMap 插件

通过保存的地图数据、洞穴地图渲染、可自定义缩放、路径点、共享地图以及性能优化的渲染，增强您的世界探索体验。

---

Hstats 追踪

我们使用 hstats（链接）来了解有多少服务器/玩家使用我们的模组。您可以在管理 UI 菜单中选择退出，或编辑模组文件夹中的 hstats-server-uuid.txt 文件并将 enable 设置为 false。

---

这是什么？

默认情况下，Hytale 的游戏内地图是短暂的。它只显示玩家周围的一个小圆形区域。一旦你走开，地图就会“忘记”你去过哪里。

Hytale BetterMap 改变了这一点。这个服务端插件引入了已保存的探索功能。当你穿越世界时，插件会记录你访问过的区域，永久性地移除“战争迷雾”。你探索得越多，地图就变得越大，让你可以轻松回溯你的脚步并导航。

主要特性

1. 持久探索： 地图会跨游戏会话保留所有先前访问过的区域。数据会自动保存，以防止服务器崩溃时丢失。
2. 洞穴模式： 进入地下区域时可无缝切换到洞穴区块。包括在地下挖掘时查看地表数据或使用特定的洞穴“战争迷雾”选项。
3. 增强的路径点系统： 使用 Hytale 本地标记管理位置。包括用户友好的菜单、“这里”按钮用于快速更新，以及上下文菜单编辑选项。
4. 交互式传送： 拥有权限的玩家可以通过 UI 或简单地右键点击地图上的某个位置来传送到路径点。
5. 世界边界可视化： 在地图上直接查看服务器的世界边界范围。
6. 链接探索（共享地图）： 可选地启用共享地图模式，所有玩家共同构建一个单一的世界地图，让您可以实时看到朋友发现的区域。
7. 指南针/地图玩家雷达： 直接在指南针上轻松定位附近的玩家。范围可由管理员自定义或关闭。
8. 可自定义的 HUD 和 UI： 一个新的游戏内配置菜单（/bm）允许您调整设置、管理路径点以及获取帮助，无需使用其他命令。
9. 位置 HUD： 一个位置 HUD（与 MultipleHUD 兼容），可在屏幕上显示您的坐标。
10. 地图锚点： 地图 UI 上的快速访问快捷方式，用于打开路径点和配置菜单。
11. 多世界支持： 将特定世界列入白名单以供模组追踪，解决更改默认世界名称的服务器主机的兼容性问题。首次加入时自动追踪世界。

性能与优化

得益于重大优化，地图现在可以在没有性能损失的情况下处理显著更高的区块数量。

• 动态区块加载： 插件通过仅加载玩家附近已探索的区块并卸载远处的区块来智能管理内存。
• 地图质量设置： 管理员可以通过选择 LOW、MEDIUM 或 HIGH 质量来平衡视觉保真度和性能。
  • LOW：最多加载 80,000 个区块（8x8 分辨率）。
  • MEDIUM：最多加载 25,000 个区块（16x16 分辨率）。
  • HIGH：最多加载 8,000 个区块（32x32 分辨率）。

注意：高质量严格限制加载的区块数量以防止内存错误。

您还可以通过 /bm config maxchunk 在推荐限制内手动设置加载区块的最大数量，或者使用我们的 UI 配置菜单（/bm 并在管理员选项卡中，需管理员权限）。

命令与权限

命令系统已通过新的基于 UI 的配置进行了彻底改革。基本功能对所有玩家可用，而管理员功能需要特定权限。

您可以执行 /op add <player> 来授予完全访问权限，或者根据需要，使用 /perm group add Adventure <permission> 分配特定权限。

公共命令（无需权限）

1. /bettermap（或 /bm）
   • 打开主要的 BetterMap 配置 UI 以管理用户设置并查看帮助。
2. /bm waypoint menu 或 /waypoint 或 /wp
   • 打开路径点 UI 以管理、共享或删除路径点。
3. /bm min <value>
   • 设置您个人的最小缩放级别（默认基数为 32）。
4. /bm max <value>
   • 设置您个人的最大缩放级别（默认基数为 256）。

管理员

权限： bettermap.admin

• 授予 BetterMap 的完全管理权限。允许在 /bettermap 下查看所有设置和覆盖项。

传送

权限： bettermap.command.teleport

• 地图传送： 允许用户通过路径点 UI 按钮或右键点击地图上的任意位置传送到该地点。

全局共享路径点编辑/删除

权限： bettermap.command.waypoint.editglobal

• 允许编辑/删除其他玩家创建的共享路径点。
• 标记所有者始终可以编辑/删除他们自己的共享路径点。
• 如果全局开关被禁用，此权限将覆盖它。

地图隐私覆盖

权限：

• bettermap.command.override.players - 绕过全局隐藏玩家
• bettermap.command.override.warps - 绕过全局隐藏所有/其他传送点
• bettermap.command.override.unexploredwarps - 绕过全局隐藏未探索传送点
• bettermap.command.override.poi - 绕过全局隐藏所有兴趣点及隐藏兴趣点名称
• bettermap.command.override.unexploredpoi - 绕过全局隐藏未探索兴趣点
• bettermap.command.override.spawn - 绕过全局隐藏出生点
• bettermap.command.override.death - 绕过全局隐藏死亡标记
• bettermap.command.override.waypoints - 绕过全局隐藏路径点

配置命令

权限： bettermap.command.config

• 使用 /bm config 子命令以及在 UI 中访问管理员设置需要此权限。

1. /bm config radar <range>
   • 设置雷达范围（使用 -1 表示无限范围）。
2. /bm config location
   • 切换服务器范围内位置 HUD 的默认状态。
3. /bm config hideplayers
   • 在地图上隐藏玩家光标。
4. /bm config hidewarps
   • 在地图上隐藏其他玩家的传送点。
5. /bm config hideunexploredwarps
   • 在未探索区域中隐藏传送点。
6. /bm config hidepois
   • 在地图上隐藏所有兴趣点标记。
7. /bm config hideunexploredpoi
   • 在未探索区域中隐藏兴趣点。
8. /bm config hideglobalwaypoints
   • 对地图上的所有玩家隐藏全局路径点。
9. /bm config waypointteleport
   • 切换传送到路径点的能力。
10. /bm config markerteleport
    • 切换传送到地图标记点的能力。
11. /bm config shareallexploration
    • 切换“链接地图”模式（共享探索数据）。
12. /bm config track / untrack
    • 将当前世界添加至活动白名单或从中移除。
13. /bm config maxchunk <number>
    • 手动覆盖加载区块的最大数量。
14. /bm config autosave <minutes>
    • 设置自动保存地图数据的时间间隔。
15. /bm config worldborder
    • 切换地图上的世界边界可视化。
16. /bm config worldborderradius <radius>
    • 设置世界边界半径（以方块为单位）。
17. /bm config worldborderoffset <x> <z>
    • 设置世界边界中心偏移量（X 和 Z 坐标）。

重载命令

权限： bettermap.command.reload

• /bm reload
• 立即重载配置文件。

配置与数据存储

所有插件文件位于服务器的 mods 目录中。

配置文件

您可以在 mods/bettermap/config.json 中修改插件设置。

注意：更改 mapQuality 或 maxChunksToLoad 需要重启服务器才能生效。

默认配置：

{
  "explorationRadius": 16,
  "updateRateMs": 500,
  "mapQuality": "MEDIUM",
  "minScale": 10.0,
  "maxScale": 256.0,
  "debug": false,
  "locationEnabled": true,
  "locationHudPosition": "top_right",
  "shareAllExploration": false,
  "maxChunksToLoad": 25000,
  "radarEnabled": true,
  "radarRange": -1,
  "hidePlayersOnMap": false,
  "hideAllWarpsOnMap": false,
  "hideOtherWarpsOnMap": false,
  "hideUnexploredWarpsOnMap": true,
  "allowWaypointTeleports": true,
  "allowMapMarkerTeleports": true,
  "hideAllPoiOnMap": false,
  "hideUnexploredPoiOnMap": true,
  "hideSpawnOnMap": false,
  "hideDeathMarkerOnMap": false,
  "hideGlobalWaypointsOnMap": false,
  "hiddenPoiNames": [],
  "autoSaveInterval": 5,
  "maxPersonalMarkersPerPlayer": 12,
  "maxSharedMarkersPerPlayer": 12,
  "allowedWorlds": [
    "default",
    "world"
  ],
  "caveModeEnabled": true,
  "caveModeLayerSize": 10,
  "caveModeUndergroundThreshold": 100,
  "caveModeRadius": 4,
  "discoverSurfaceUnderground": false,
  "caveFogOfWar": false,
  "worldBorderEnabled": false,
  "worldBorderRadius": 5000,
  "worldBorderOffsetX": 0,
  "worldBorderOffsetZ": 0
}

已保存的探索数据

地图数据按世界保存。您可以在这里找到已保存的探索文件：mods/bettermap/data/

示例：

• BetterMap 配置菜单（使用 /bm）：

• BetterMap 帮助菜单（使用 /bm help）：

• 使用命令 /bettermap waypoint menu 的路径点列表：

• 地图上的路径点：

• 路径点编辑菜单：

• 洞穴模式：

• 高质量地图：

• 中等质量地图：

• 低质量地图：

致谢

该项目旨在改善 Hytale 中的探索体验。

• 创建者： Paralaxe 和 Theobosse
• 贡献者： Xytronix 和 DARKACE
• 团队： Ninesliced

---

发现 Bug？有建议？请在评论中或我们的 Discord 服务器上报告！ 加入我们的 Discord

---

我们的其他模组：

---

您可以通过我们的链接和 50% 折扣优惠码在 zap-hosting.com 支持我们：

如果您想通过捐赠来支持我们，我们也提供 ko-fi 页面：ko-fi 链接

---