Waypointly

Waypointly

Waypointly 是 Waypoint Manager 的一个分支，已更新至最新版本的 Hytale。

一个为 Hytale 设计的路径点管理系统，带有游戏内 UI。

功能

• 基于 UI 的路径点管理器 - 通过图形界面创建、编辑和删除路径点
• 传送 - 从路径点列表或直接从地图界面传送，可配置冷却时间和引导时间
• 共享路径点 - 将路径点发布到整个世界，让所有玩家都能看到
• 每个路径点色调 - 使用十六进制色调重新着色任何图标
• 可配置的图标集 - 每个图标都来自配置，因此资源包可以添加自己的图标
• 距离显示 - 显示与每个路径点的水平距离（以方块为单位）
• 排序和搜索 - 按距离或名称排序，按名称筛选
• 地图标记 - 路径点会显示在游戏地图上

使用方法

使用 /waypoint 或 /wp 打开路径点管理器。

每个路径点行显示三个按钮：

• 传送（绿色）- 传送到该路径点
• 编辑（蓝色）- 更改其名称、位置、图标或色调
• 删除（红色）- 删除该路径点

创建和编辑

添加和编辑表单需要名称、X 和 Z 坐标、图标以及可选的色调。如果你有权限发布共享路径点，色调字段旁边会出现一个 个人 / 共享 切换开关。路径点创建后可见性即固定，因此在创建时就要选择好。

从地图界面传送

在地图上右键单击你的某个路径点，然后从上下文菜单中选择 传送。此选项仅对有权传送的玩家显示。

地图界面也有内置的“传送到标记”按钮。那个按钮由引擎控制，并且无论你在这里如何配置，都仅限创造模式使用。Waypointly 的 传送 选项在冒险模式中也可用。

垂直位置

Hytale 仅存储地图标记的 X 和 Z 坐标，因此路径点没有保存的 Y 坐标。传送时，会根据目标列的地形解析落点高度，这与原版地图自身的标记传送方式相同。位于洞穴或上层楼板上的路径点会落在其上方的地表。

命令

命令	描述
/waypoint、/wp	打开路径点 UI
/waypoint add <name>	在你当前位置添加一个路径点
/waypoint remove <name>	按名称删除一个路径点
/warp <name>	按名称或标记 ID 传送到一个路径点
/waypoint perms grant <player> <ui|teleport|shared>	授予在线玩家一项权限
/waypoint perms revoke <player> <ui|teleport|shared>	撤销在线玩家的一项权限
/waypoint perms list <player>	显示玩家拥有哪些 Waypointly 权限
/listmarkers	在聊天中列出你的路径点
/resetmarkers	删除此世界中你所有的个人路径点

/waypoint perms 命令中的玩家和权限参数均支持 Tab 补全。

权限

节点	默认值	授予内容
riprod.waypoints.command.waypoint	所有人	访问 /waypoint UI
riprod.waypoints.command.teleport	世界编辑者及以上	传送按钮、地图传送选项和 /warp 命令
riprod.waypoints.command.shared	建造者及以上	发布共享路径点
riprod.waypoints.command.admin	服务器编辑者及以上	管理权限、编辑任何人的共享路径点

用户组彼此继承（冒险者 → 建造者 → 世界编辑者 → 服务器编辑者 → 管理员），因此授予建造者的节点，其上级用户组也拥有。

授予权限

引擎自带的 /perm user add 命令需要原始 UUID。Waypointly 的 perms 子命令则接受带有 Tab 补全的玩家名称，因此你无需再去查找 UUID：

/waypoint perms grant Riprod teleport
/waypoint perms revoke Riprod ui
/waypoint perms list Riprod

玩家必须在线才能解析其名称。对于离线玩家，或需要更改整个用户组，请使用引擎的 /perm 命令。

在单人游戏中，/op self 会授予所有权限。

若要不考虑权限而将传送权限交给所有人，请在配置中将 AllowTeleportForEveryone 设置为 true，而不是向每个玩家授予该节点。

配置

Waypointly 使用 Configly，它已捆绑在 jar 包内——无需额外安装任何东西。配置文件位于 Server/Configs/Waypointly.json。

编辑配置

配置更改应在资源编辑器中进行，而不是手动编辑保存文件夹中的文件：

1. 打开资源编辑器并找到 Server/Configs/Waypointly.json。
2. 根据需要更改任何内容。每个字段都是带有内联文档的类型化控件，因为 Configly 会将配置的编解码器注册到编辑器中，而不是提供原始 JSON 数据。
3. 点击覆盖资源并将其保存到你的自定义资源包中。

覆盖会将你编辑的副本写入你自己的资源包，因此你的设置能够在模组更新后保留，而不会被随附的默认值替换。

选项

键	默认值	含义
MaxWaypoints	-1	每个玩家在每个世界中的个人路径点数量上限。-1 表示无限制。
MaxSharedWaypoints	-1	每位玩家在每个世界中可贡献的共享路径点数量上限。-1 表示无限制。
MaxNameLength	24	可接受的路径点名称最大长度。
AllowTeleportForEveryone	false	无论权限如何，赋予所有玩家传送能力。
AllowSharedWaypoints	true	是否允许创建共享路径点。
TeleportCooldownSeconds	0	两次传送之间的间隔秒数。0 表示禁用冷却。
TeleportWarmupSeconds	0	请求传送与实际移动之间的延迟秒数。0 表示立即传送。
Icons	11 个内置	选择器中提供的所有图标。第一个条目是新路径点的默认图标。

自定义图标

Icons 是 Name（选择器标签）和 Image（标记纹理）的列表。Image 是资源编辑器中经过验证的图像字段，限制在 Common/UI/WorldMap/MapMarkers —— 客户端解析地图标记图像的同一文件夹，因此单个条目即可同时涵盖选择器色板和地图上的标记。

"Icons": [
  { "Name": "坐标", "Image": "UI/WorldMap/MapMarkers/Coordinate.png" },
  { "Name": "我的公会", "Image": "UI/WorldMap/MapMarkers/GuildBanner.png" }
]

要添加你自己的图标，请将 .png 文件放入你的资源包中的 Common/UI/WorldMap/MapMarkers 文件夹，然后在编辑器中选中它——无需重新构建。编辑器会拒绝该文件夹之外的路径、非 .png 文件或不存在文件，因此拼写错误会在保存时被发现，而不是在游戏中显示为空白图标。

Waypointly 本身不附带任何标记图像；那 11 个默认图标来自 Hytale 自带的地图标记集。

待办事项

• 翻译

有问题或建议？欢迎在下方留言！