Tracking Compass - 追踪指南针

💡追踪指南针：用指南针追踪玩家与路径点！

Tracking Compass 是一款允许你在服务器上追踪所有玩家的插件。使用指令 /compass 即可获得一个追踪指南针，右键点击可打开交互界面。你可以选择追踪其他玩家或自定义路径点。点击界面中的选项，指南针便会指向追踪目标——可以是玩家、世界出生点、你的重生点、上次死亡位置，或是你设置的自定义路径点。左键点击指南针会显示你与目标之间的距离（以方块计）及其坐标（若在配置文件中启用）。这款插件也是进行“猎人游戏”玩法的绝佳工具！

🎮主要功能

• 右键手持追踪指南针可打开交互界面。
• 左键手持追踪指南针可获取与目标的距离（方块数）及坐标。
• 可实时追踪其他玩家、世界出生点、个人重生点、上次死亡位置，以及个人与全局的自定义路径点。
• 管理员可以添加全局路径点，供服务器上所有玩家使用。例如，可用于标记出生点、服务器商店等位置。
• 若追踪的玩家处于不同维度，指南针将指向其切换维度前的最后已知位置。
• 若被追踪的玩家离线，指南针将指向其离线前的最后已知位置。床被破坏时同理。
• 配置文件提供多项功能开关选项。
• 可配置是否启用追踪所需的经验值消耗。
• 你可以放置并追踪自己的个人路径点。
• 右键点击路径点可进行配置或删除。
• 可从多种物品中选择作为自定义路径点的图标，或使用你自己的物品。

🔧指令与权限

指令

• /trackingcompass – 给予玩家一个追踪指南针。
• /trackingcompassreload – 重载插件的 config.yml 配置文件。

权限

• trackingcompass.deny – 禁止使用 /compass 指令。
• trackingcompass.bypassplayercost – 绕过追踪玩家的经验值消耗（无论是否启用经验消耗）。
• trackingcompass.bypasswaypointcost – 绕过追踪路径点的经验值消耗（无论是否启用经验消耗）。
• trackingcompass.denycreatewaypoints – 禁止创建个人路径点。
• trackingcompass.createglobalwaypoints – 允许创建可供所有人追踪的全局路径点。

⭐配置选项

以下为配置文件 config.yml 中的主要选项：

• ShowDistance – 默认 true。左键点击时显示与目标的距离。
• ShowCoords – 默认 true。左键点击时显示目标的坐标。
• EnableTrackingPlayers – 默认 true。允许追踪玩家。
• EnableWaypoints – 默认 true。允许追踪路径点。
• EnablePlayerXPCost – 默认 false。启用追踪玩家的经验值消耗。
• EnableWaypointXPCost – 默认 false。启用追踪路径点的经验值消耗。
• PlayerXPCost – 默认 10。若启用玩家追踪消耗，每次追踪扣除的经验值（点数，非等级）。
• WaypointXPCost – 默认 10。若启用路径点追踪消耗，每次追踪扣除的经验值（点数，非等级）。
• EnchantmentGlow – 默认 true。为指南针添加附魔光效，以便与普通指南针区分。
• MaxWaypoints – 默认 50。设定单个玩家可拥有的最大路径点数量（范围：0-50）。
• ShowTargetDimension – 默认 true。当追踪目标与持指南针玩家处于不同维度时，显示目标所在维度。
• TrackLastKnownLocation – 默认 true。当目标玩家处于不同维度时，追踪其最后已知位置。
• DisableCreateWaypoints – 默认 false。为所有玩家禁用创建个人路径点的功能。
• EnableGlobalWaypoints – 默认 false。启用全局路径点列表，所有玩家均可访问和追踪（除非被权限禁止）。

✨重要须知

• 版本兼容性：本插件仅适用于 1.14.x、1.15.x、1.16.x、1.17.x、1.18.x 及可能的未来版本。不兼容 1.13 及以下版本。
• 服务端类型：插件专为 Spigot 及其分支（如 Paper）设计，请勿在 Bukkit 上使用。
• 权限说明：若玩家拥有所有权限（即 * 通配符），则默认包含 trackingcompass.deny 权限，这将导致其无法使用追踪指南针。你必须手动将该权限值设为 false，或使用权限插件进行精细控制。此问题不适用于拥有 OP 权限的玩家。

❓常见问题

问：为什么使用指南针时会被传送？

• 你可能安装了 WorldEdit。为避免冲突，请打开 WorldEdit 的 config.yml，找到 navigation-wand 选项。你可以将其物品更改为非指南针的物品，或将 max-distance 设为 -1 来完全禁用此功能。

问：如何删除或编辑路径点？

• 进入路径点菜单，右键点击任何玩家创建的路径点。将出现一个新菜单，提供更改路径点名称、图标、位置或删除它的选项。

问：如何禁止特定玩家使用指令？

• 使用权限 trackingcompass.deny。任何权限插件（推荐 LuckPerms）均可管理。重要：对于拥有所有权限（*）的玩家，你必须手动将该权限值设为 false。你也可以使用 trackingcompass.denycreatewaypoints 权限来禁止创建个人路径点。

问：如何为服务器出生点、商店、小游戏区域等创建全局路径点？

• 首先在 config.yml 中将 EnableGlobalWaypoints 设为 true。然后，你需要拥有 OP 权限或 trackingcompass.createglobalwaypoints 权限。之后，在游戏中使用指南针进入全局路径点菜单，会出现选项让你在当前位置创建全局路径点。

问：我的指南针突然乱转。

• 这是因为追踪目标与你处于不同维度。如果配置中 ShowTargetDimension 为 true，左键点击可查看目标所在维度。要修复此问题，只需前往与目标相同的维度，指南针便会正常指向。

问：为什么插件不工作/服务器无法启动？

• 本插件仅支持 1.14 及以上版本。由于代码变更，它与 1.13 及以下版本不兼容。请勿在低于 1.13 版本的服务器上安装此插件，否则将导致服务器无法启动。

🔧预览与反馈

**交互界面预览视频**

https://i.gyazo.com/b20dbf5ff99d3fa6696003882adf5828.mp4

发现漏洞或有疑问？请在本页面留言告知！感谢你下载 Tracking Compass。

💡追踪指南针

使用指南针追踪玩家与路径点！作者：ZDavePlays

本插件允许玩家使用特殊的追踪指南针来定位其他玩家或自定义的路径点。通过简单的点击操作，即可获取目标的方向、距离乃至坐标信息，是探索与团队协作的实用工具。

🎮命令

• /trackingcompass – 给予玩家一个追踪指南针。
• /trackingcompassreload – 重新加载插件的 config.yml 配置文件。

🎮权限

• trackingcompass.deny – 拒绝玩家使用 /compass 命令。
• trackingcompass.bypassplayercost – 绕过追踪玩家所需的经验值消耗（无论经验消耗功能是否开启）。
• trackingcompass.bypasswaypointcost – 绕过追踪路径点所需的经验值消耗（无论经验消耗功能是否开启）。
• trackingcompass.denycreatewaypoints – 禁止玩家创建个人路径点。
• trackingcompass.createglobalwaypoints – 允许玩家创建可供所有人追踪的全局路径点。

🎮配置说明

以下为 config.yml 中的主要配置项及其默认值：

显示与功能

• ShowDistance – 默认 true。左键点击指南针时显示到追踪目标的距离。
• ShowCoords – 默认 true。左键点击指南针时显示追踪目标的坐标。
• ShowTargetDimension – 默认 true。当持指南针者与追踪目标处于不同维度时，显示目标所在维度。
• TrackLastKnownLocation – 默认 true。当目标玩家与持指南针者处于不同维度时，追踪该玩家最后已知的位置。
• EnchantmentGlow – 默认 true。为追踪指南针启用附魔光效，以便与普通指南针区分。

追踪开关

• EnableTrackingPlayers – 默认 true。允许追踪其他玩家。
• EnableWaypoints – 默认 true。允许追踪路径点。

经验值消耗

• EnablePlayerXPCost – 默认 false。启用追踪玩家时的经验值消耗。
• EnableWaypointXPCost – 默认 false。启用追踪路径点时的经验值消耗。
• PlayerXPCost – 默认 10。追踪玩家时消耗的经验点数（非等级），仅在 EnablePlayerXPCost 为 true 时生效。
• WaypointXPCost – 默认 10。追踪路径点时消耗的经验点数（非等级），仅在 EnableWaypointXPCost 为 true 时生效。

路径点设置

• MaxWaypoints – 默认 50。单个玩家可拥有的最大路径点数量（范围：0-50）。
• DisableCreateWaypoints – 默认 false。禁用所有玩家创建个人路径点的能力。
• EnableGlobalWaypoints – 默认 false。启用全局路径点列表，服务器上所有玩家（除非被权限禁止）均可访问和追踪这些路径点。

💡重要须知

• 兼容版本：本插件仅适用于 1.14.x, 1.15.x, 1.16.x, 1.17.x, 1.18.x 及可能更新的未来版本。不兼容 1.13 及以下版本。
• 服务端类型：插件专为 Spigot 及其分支（如 Paper）设计，请勿在纯 Bukkit 服务端上使用。
• 权限注意事项：若某玩家被授予了所有权限（即拥有 trackingcompass.*），则其默认也会拥有 trackingcompass.deny 权限，这将阻止其使用追踪指南针。你必须手动将 trackingcompass.deny 权限设置为 false，该玩家才能正常使用。此限制对拥有 /op 权限的玩家不适用。