Manhunt

Important: The plugin is complete as manhunt-plugin.zip, but it has not been compiled or tested on a server. The development environment had no internet access, so the Paper API dependencies could not be downloaded. As a result, the project may contain compilation errors, particularly regarding Paper 26.3 API compatibility.

Gameplay

• /manhunt runner and /manhunt hunter assign yourself to the respective team.
• /manhunt runner <Player> allows administrators with manhunt.admin to assign another player.
• /manhunt start [Seed] generates three new worlds (Overworld, Nether, and End), teleports all participants, and freezes the Hunters for 30 seconds.
• Hunters receive a tracking compass. Right-clicking it updates the compass to the Runner's last known location in the current dimension.
• Runners win when the Ender Dragon is killed in the Manhunt world.
• Hunters win when all Runners have been eliminated.
• Eliminated Runners are switched to spectator mode, while eliminated Hunters respawn.
• After the game ends, all players are teleported back to their original locations and the generated worlds are deleted.

Commands

Additional commands include:

• /manhunt leave – Leave the current game.
• /manhunt stop – Stop the current game.
• /manhunt status – Display the current game status.
• /manhunt track <Runner> – Track a specific Runner.
• /manhunt compass – Obtain a tracking compass.

Configuration

The following settings can be customized in config.yml:

• Hunter head start
• Difficulty
• World border
• World deletion behavior
• All plugin messages

Player Data Protection

Before teleporting players into the Manhunt worlds, the plugin saves their inventories, locations, experience levels, and health to disk.

This data is restored when the game ends. It is also preserved across server crashes and restored the next time the affected player joins the server.

Testing Notes

The plugin has not been compiled or tested yet. The following areas require particular attention during the first test:

• Custom dimension portals: Nether and End portals are handled manually using PlayerPortalEvent, since custom worlds are not automatically linked. Whether Paper accepts the specified destination correctly has not been verified.
• Ender Dragon spawning: The plugin assumes that the custom End world automatically generates its own Ender Dragon. This behavior has not been verified.
• World deletion: Only directories whose names start with manhunt_ are deleted. If Paper 26.3 uses a different world directory structure, the plugin will leave the worlds untouched and log a warning to the console.
• World generation: All three worlds are created synchronously when a game starts. This may cause temporary server lag, depending on the hardware.

Limitations

• Only one Manhunt game can run at a time.
• Teams and game state are stored in memory. Restarting the server during an active game will terminate the round.
• Advancements and statistics are not separated from those of the regular worlds.