Tracking Compass - Speedgot

Tracking Compass -----

Track Players and Waypoints with a Compass!

Tracking Compass
Track Players and Waypoints with a Compass!
by ZDavePlays

What is it?
Tracking Compass is a plugin that will allow you to track every player on your server. Simply use the command "/compass" to receive a tracking compass that will open a GUI when right-clicked. From there, you can select either to track players or waypoints. Simply clicking the items shown will change the orientation of your compass towards the tracked target which can be a player, the world spawn, your respawn point, your latest death, or even your own custom waypoints.
Left-clicking with the compass will tell you the distance in blocks to the tracked target and its coordinates (if enabled in the config file).
This plugin is also the perfect plugin for manhunt!

Features:
- Right-click with the Tracking Compass in hand to open the GUI.
- Left-click with the Tracking Compass in hand to get the distance in blocks and coordinates to target.
- It can track other players in real-time, the world spawn, your respawn point, your latest death, and custom personal waypoints and global waypoints.
- Admins can add global waypoints that are accessible to everyone on the server. These can be used for putting a tracker on the spawn, a server shop, etc...
- If the tracked player is in a different dimension, the compass will point to his last known location before switching dimensions.
- If the tracked player leaves and was tracked before leaving, the compass will point to his last known location. The same applies to beds when broken.
- Config options for enabling/disabling certain features
- Config option for enabling experience points cost for tracking.
- You can place your own personal waypoints and track them.
- Right-click on a waypoint to configure it or delete it.
- Choose from a variety of items to represent and identify your custom waypoint or use an item of your own.

Commands:
- /trackingcompass
↑ Gives the player a tracking compass.
- /trackingcompassreload
↑ Reloads the plugin's config.yml file.

Permissions:
- trackingcompass.deny
↑ Will deny access to /compass
- trackingcompass.bypassplayercost
↑ Will bypass the experience cost for tracking players regardless if XP costs are enabled.
- trackingcompass.bypasswaypointcost
↑ Will bypass the experience cost for tracking waypoints regardless if XP costs are enabled.
- trackingcompass.denycreatewaypoints
↑ Will deny the ability to create personal waypoints.
- trackingcompass.createglobalwaypoints
↑ Will allow the ability to create global waypoints available to be tracked by anyone.

Config:
- ShowDistance
↑ Default true. Will show distance to tracked point when left-clicking.
- ShowCoords
↑ Default true. Will show coordinates of the tracked target when left-clicking.
- EnableTrackingPlayers
↑ Default true. Will allow the tracking of players.
- EnableWaypoints
↑ Default true. Will allow the tracking of waypoints.
- EnablePlayerXPCost
↑ Default false. Will enable the cost of experience points for tracking players.
- EnableWaypointXPCost
↑ Default false. Will enable the cost of experience points for tracking waypoints.
- PlayerXPCost
↑ Default 10. Amount of experience points (not levels) taken from players when tracking other players if EnablePlayerXPCost is true.
- WaypointXPCost
↑ Default 10. Amount of experience points (not levels) taken from players when tracking waypoints if EnableWaypointXPCost is true.
- EnchantmentGlow
↑ Default true. Will enable an enchantment glow in the compass for better distinction between a tracking compass, and a regular compass.
- MaxWaypoints
↑ Default 50. Determines the max amount of waypoints a player can have.
↑ Max 50 & Min 0.
- ShowTargetDimension
↑ Default true. Will show in which dimension the tracked target is if the player with the compass is in a different dimension than the tracked target.
- TrackLastKnownLocation
↑ Default true. Will track the targetted player's last known location if the target is in a different dimension as the player with the compass.
- DisableCreateWaypoints
↑ Default false. Will disable the ability to create personal waypoints for every player.
- EnableGlobalWaypoints
↑ Default false. Will enable the list of Global Waypoints which can be accessed and tracked by every player in the server unless denied by permissions.

IMPORTANT
The plugin ONLY WORKS in version 1.14.x, 1.15.x, 1.16.x, 1.17.x, 1.18.x, and possibly any other future version.
The plugin DOES NOT WORK in version 1.13 and below...
The plugin is EXCLUSIVE TO SPIGOT and other spigot forks, do not try to use it on bukkit.
You must turn the value of the permission "compass.deny" to false with any player that has all permissions enabled for them to use a tracking compass(by having all permissions enabled, they also have compass.deny enabled). This does not apply if the player has /op.

Frequently Asked Questions:
Q: Why does the compass teleport me when using it?
A: You probably have World Edit installed. To avoid this conflict, go to world edit's config.yml and search for "navigation-wand", from there, you can either change the item to another that isn't a compass, or change the max-distance to -1 to completely disable it.

Q: How can I delete waypoints or edit them?
A: Go inside your waypoints menu and right-click any player-made waypoints. A new menu will appear with options for changing the name/item/location of your waypoint or even deleting it.

Q: How can I deny access to the command to certain players?
A: You must use the permission trackingcompass.deny. Any permission plugin works. I recommend LuckPerms. IMPORTANT: you must turn the value of that permission to false with any player that has all permissions enabled (by having all permissions enabled, they also have compass.deny enabled)
You can also deny the ability to create personal waypoints using the permission trackingcompass.denycreatewaypoints.

Q: How can I make global waypoints for my server spawn, shop, minigame area, etc...?
A: You must first enable global waypoints in the config.yml file by setting EnableGlobalWaypoints to true. After that, you must either be op or have the permission trackingcompass.createglobalwaypoints to create global waypoints.
Then, you simply use the in-game compass and navigate to the global waypoints menu and an option will appear for you to create a global waypoint where you are standing.

Q: My compass started going crazy out of a sudden.
A: This is due to the tracked target being in another dimension than yours. You can left-click to see in what dimension the target is if "ShowTargetDimension" is set to true in the config file. To fix this, simply go to the same dimension as your tracked target and the compass will point towards it.

Q: Why won't the plugin work/server won't start?
A: This plugin ONLY works in 1.14 and above. It does not work in 1.13 and below due to changes in code between the two versions. Please do not try to add this plugin if you have a server below 1.13, as this will result in the server not starting.

Picture:
2020-06-25_15.30.56.png