ManhuntButItWorks

A Paper plugin for Minecraft Manhunt games. Hunters get a compass that cycles through online players, follows targets in the same dimension, and points toward the relevant Nether portal when direct tracking is not possible.

Features

• Right-click target cycling with main-hand and off-hand support
• Tracking state that survives reconnects, restarts, deaths, and offline targets
• Persistent Nether portal fallback for cross-dimension tracking
• Protected compasses that cannot be dropped, stored, cloned, or bundled accidentally
• A server-wide countdown timer with cancel support

Requirements

• Paper 1.21 or newer
• Java 21 for Paper 1.21 through 1.21.11
• Java 25 for Paper 26.1 and newer

The build is checked against Paper 1.21, 1.21.11, 26.1.2 stable, and 26.2 beta.

Install

1. Put ManhuntButItWorks.jar in the server's plugins folder.
2. Restart the server.
3. Run /manhuntcompass as an operator.

Commands

Command	Permission	Default	Purpose
/manhuntcompass [player]	manhunt.compass	Operator	Give a tracking compass
/removecompass	manhunt.remove	Everyone	Remove your Manhunt compasses
/timer <seconds|cancel>	manhunt.timer	Operator	Start or stop the global countdown
/manhunthelp	manhunt.help	Everyone	Show command help

Build

.\mvnw.cmd clean verify

Compatibility profiles are available for newer Paper APIs:

.\mvnw.cmd "-Pcompat-1.21.11" clean verify
.\mvnw.cmd "-Pcompat-26.1.2" clean verify
.\mvnw.cmd "-Pcompat-26.2" clean verify

The release jar is written to target/ManhuntButItWorks.jar.