SpyHunt-Compass 🧭

SpyHunt-Compass is a standalone, lightweight, and high-performance tracking compass plugin for Minecraft servers. Originally developed as a core mechanic for the SpyHunts manhunt gamemode, this plugin brings smart player tracking logic to any survival or minigame server.

✨ Features

🎯 Smart Tracking Logic

• Real-Time Tracking: The compass updates every second to point directly to the target player.
• Cross-Dimension Support:
  • Overworld Tracking: Points directly to the player.
  • Nether/End Tracking: If the target is in a different dimension, the compass tracks the last known portal location (or where they entered the dimension).
  • Smart Recovery: If a target disconnects or is in a different world without portal data, the compass points to their last seen location.

🛠️ Advanced Management

• Multi-Target System: Add multiple players to a single tracker.
  • Cycle Targets: Right-click your compass to switch between tracked players.
• Auto-Inventory Management:
  • Automatically gives a compass if the player doesn't have one.
  • Updates existing compasses in the inventory.

📜 Commands

| Command | Description | Permission |
|---------|-------------|------------|
| /track <player> | Instantly get a compass tracking a specific player (clears other targets). | spyhuntcompass.use (default: true) |
| /tracker | Get an empty tracker compass. | spyhuntcompass.use |
| /tracker add <player> | Add a player to your tracking list. | spyhuntcompass.use |
| /tracker remove <player> | Remove a player from your tracking list. | spyhuntcompass.use |
| /tracker help | View all available commands. | spyhuntcompass.use |

🚀 Installation

1. Download the latest SpyHunt-Compass.jar.
2. Place it in your server's plugins/ folder.
3. Restart your server.
4. Enjoy smart tracking!

🔧 Configuration

Currently, SpyHunt-Compass is designed to be plug-and-play with zero configuration required. All data is stored persistently on the compass items themselves.

---

Developed by SpyGamingOG