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_BARorCHATlogs, 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 betweenACTION_BARorCHAToutputs.blockReach: Toggle whether the exact block distance calculation is broadcasted to trackers.updateInterval: The frequency of updates in server ticks (e.g.,20ticks = 1 second).
