?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Manhunt Compass

Manhunt Compass

Player Tracking Compass Mode for Manhunts

14
1
14
1

Compatibility

Minecraft: Java Edition

1.21.8–1.21.11

Platforms

Supported environments

Server-side
Client and server

Links

Report issues View source Join Discord server
Buy Me a Coffee

Tags

Creators

Details

Licensed MIT
Published 4 days ago

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