Manhunt Compass

Quick rating

Community listing page, reviews here may not be monitored by the author.

Report a bug to the author How listings work Are you the author?

Manhunt Compass

By iamnullmanOwner

No reviews yet

Player Tracking Compass Mode for Manhunts

Mod Loaders
Minecraft
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

About

Description

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