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).