Waypoints - 路径标记

此项目已迁移至 Modrinth，此处将不再更新。

你是否曾因长途跋涉而找不到自己的基地？传统插件可以设置一个传送点让你直接回家，但如果你想保持生存模式的原汁原味，不希望随意传送，那么这个插件或许正是你的服务器所需要的！

💡核心功能

本插件不会直接将玩家传送回起点，而是通过多种方向指示器引导玩家步行前往目的地，让玩家在探索世界的过程中更有沉浸感。

方向指示器

玩家可通过多种可配置的指示器来获取目标方向

• 指南针：若玩家持有指南针，它将直接指向路径点方向。
• 动作栏指示器：无需指南针，在玩家动作栏中显示粗略方向。若玩家偏左，右侧的指示段会亮起，反之亦然。
• 信标光束：当路径点进入渲染距离时，其位置会出现信标光束，便于定位。
• 闪烁方块：当玩家接近路径点时，信标光束会被一组循环闪烁的方块替代，帮助精确找到位置。
• 全息图（可选）：作为闪烁方块的替代方案，可显示路径点的精确位置。此功能需要 ProtocolLib。
• 粒子效果：在玩家脚部生成指向路径点方向的粒子。

玩家追踪

默认关闭，启用后可实现以下功能

• 在 GUI 菜单中，玩家可选择追踪另一名玩家。
• 指南针、动作栏指示器和粒子效果将引导玩家找到被追踪者。
• 玩家可选择在菜单中对他人隐藏自己（若启用）。
• 只有选择公开位置的玩家才能被追踪（若启用）。
• 被追踪的玩家会收到通知（若启用）。

✨其他特色功能

• 潜行时右键点击指南针即可打开 GUI（默认方式）。
• 点击路径点或文件夹的图标可自定义图标，将使用主手持有的物品。
• 可限制每位玩家可创建的路径点和文件夹数量。
• 可自定义传送价格，并支持随传送次数增加而涨价（需 Vault）。
• 方向指示器可完全自定义。
• GUI 内的物品可完全自定义。
• 支持多语言翻译。
• 使用 SQLite 存储数据。

🎮集成支持

• 公共路径点可显示在 Dynmap 或 SquareMap 地图上。

🔧视频演示

DonKolia 制作了一系列演示插件功能的小视频，展示了基本操作和所有可用的指示器。视频为西班牙语，但提供英文字幕：

[播放列表链接](Link to playlist)

🎮命令列表

• /waypoints - 打开 GUI。
• /waypoints set <名称> - 创建一个仅自己可见的私有路径点。
• /waypoints setPublic <名称> - 创建一个所有人可见的公共路径点。
• /waypoints setPermission <权限> <名称> - 创建一个仅对拥有指定权限的玩家可见的路径点。
• /waypoints setTemporary <X> <Y> <Z> - 创建一个仅在玩家在线时可见的临时路径点。
• /waypoints other <名称|UUID> - 查看其他玩家的路径点。
• /waypoints statistics - 查看数据库的基本统计信息。
• /waypoints reload - 重载配置文件。

脚本命令

• /waypointsscript deselectWaypoint <玩家名称> - 通过命令取消玩家当前选中的路径点。
• /waypointsscript selectWaypoint <玩家名称> <路径点-UUID> - 通过命令为玩家设置选中的路径点。

⭐权限列表

• waypoints.command.use - 允许玩家使用 /waypoints 命令并打开 GUI。
• waypoints.command.other - 允许玩家使用 /waypoints other 命令。
• waypoints.command.statistics - 允许玩家使用 /waypoints statistics 命令。
• waypoints.command.reload - 允许玩家使用 /waypoints reload 命令。
• waypoints.command.scripting - 允许玩家使用 /waypointsscript 命令并获取路径点 UUID。
• waypoints.modify.private - 允许玩家创建、修改和删除私有路径点。
• waypoints.modify.public - 允许玩家创建、修改和删除公共路径点。
• waypoints.modify.permission - 允许玩家创建、修改、删除并始终查看权限路径点。
• waypoints.unlimited - 允许玩家创建超出配置限制数量的路径点和文件夹。
• waypoints.temporaryWaypoint - 允许玩家创建仅在在线时可见的临时路径点。
• waypoints.teleport.private - 允许玩家传送到私有路径点。
• waypoints.teleport.public - 允许玩家传送到公共路径点。
• waypoints.teleport.permission - 允许玩家传送到权限路径点。
• waypoints.tracking.enabled - 允许玩家使用玩家追踪功能。
• waypoints.tracking.trackAll - 允许玩家追踪已隐藏的玩家。

❓配置与翻译

几乎所有内容都可自定义。你可以查看当前的[配置文件示例](here)。此外，所有文本都可以翻译成其他语言或更改颜色。[英文翻译文件示例](English Translation File)

🔧从 v2.X.X 迁移

• 仅支持迁移至最高 3.5.2 版本的插件。3.5.3 及以上版本不再支持迁移。
• 操作步骤：
• 关闭服务器。
• 备份 plugins/Waypoints/ 和 plugins/Md5Lukas-Commons/。
• 删除旧的插件 jar（如 waypoints-2.9.2.jar）、plugins/Waypoints/config.yml、plugins/Waypoints/config.base.yml、plugins/Waypoints/lang/ 以及 md5-commons（如 md5-commons-1.2-SNAPSHOT.jar）。
• 放入新的插件 jar。
• 启动服务器。
• 仅执行一次 /waypoints import 命令。
• 确认所有旧路径点都已迁移。
• 删除 plugins/Waypoints/globalstore.nbt 和 plugins/Md5Lukas-Commons/。

⭐统计与许可

• 本插件使用 [bStats](bStats) 收集基本使用数据。你可以选择退出。有关“收集哪些数据”和“如何禁用 bStats”的详细信息，请参阅[此页面](here)。查看本插件的统计信息可访问[此链接](here)。
• 本插件基于 MIT 许可证授权。更多信息请阅读[此说明](this)。

✨支持版本

由于时间和精力有限，且通常建议更新至最新的 Minecraft/Spigot 版本，本插件仅支持最新的 3 个主要版本及其最新构建。

例如，在撰写本文时，支持 1.19.3、1.18.2 和 1.17.1，但不支持 1.18、1.16.4 或 1.15.2。

运行环境要求

• 最低 Java 版本：Java 17。