Manhunt Compass

Manhunt Compass

A high-performance, server-driven Fabric mod designed for Minecraft 1.21.8 that introduces a dynamic player-tracking compass mechanism for Manhunt minigames. Built with efficiency and vanilla-parity synchronization in mind, it operates fully on the server side using the modern component system.

⚡ Features

• Dynamic Targeting System: Right-clicking the compass cycles through all active, online players in alphabetical order (excluding yourself).
• Smart Action Bar Sync: Displays real-time updates regarding your target’s name, active world status, and exact block distance dynamically on your action bar.
• Automatic Hand Handling: The tracking algorithms automatically recognize and update the compass whether it is held in your main hand or off-hand.
• Inventory Lifecycle Control: * Players automatically receive a fresh tracking compass upon respawning.
• Compasses are immediately stripped from the inventory on death preventing unintended drops or duplication.

• Granular Performance Configuration: Built-in JSON config manager allowing you to customize the compass display name, choose between ACTION_BAR or CHAT logs, toggle block-reach calculations, and tune the tick interval rate to minimize server overhead.

🛠️ Commands & Permissions

The mod exposes clean, localized commands under the /pusula literal with internal aliases for international setups.

| Command | Permission Level | Description |
| — | — | — |
| /pusula | Anyone | Gives a new tracking compass to the executing player. |
| /compass | Anyone | Alias for /pusula. |
| /target | Anyone | Alias for /pusula. |
| /pusula reload | OP (Level 2) | Reloads the JSON config files directly from the disk and resets internal tick timers instantly. |

⚙️ Configuration File

The configuration file is automatically generated at .minecraft/config/manhunt-compass.json.

{
  "compassName": "§6Manhunt Pusula",
  "messageType": "ACTION_BAR",
  "blockReach": true,
  "updateInterval": 20
}

• compassName: Custom string supporting vanilla formatting color codes.
• messageType: Choose between ACTION_BAR or CHAT outputs.
• blockReach: Toggle whether the exact block distance calculation is broadcasted to trackers.
• updateInterval: The frequency of updates in server ticks (e.g., 20 ticks = 1 second).