~/projects/manhunt

GAMES2026

Manhunt

A Minecraft plugin that runs a Manhunt game (hunters chasing a runner with a tracking compass) with an autonomous lobby and world lifecycle.

TIMELINE
May 2026
TEAM
Solo
CONTEXT
Personal project
Top-down diagram of three hunters whose compass needles all point at the runner and their trail.

Overview

Manhunt is a Minecraft plugin implementing the Manhunt game format: one or more hunters are given tracking compasses that point to a runner, and must catch them before the runner completes their objective. The plugin manages game state, an automated pre-game lobby, and per-game world creation/teardown through the /manhunt command.

Features

  • /manhunt admin command for starting, stopping, checking status, and adding/removing players
  • Tracking compass item that continuously points to the current runner target
  • Autonomous lobby system that stages players before a game begins
  • Permission-gated commands (manhunt.admin, manhunt.use) with status viewing open to all players by default
  • Per-game world creation and cleanup via Multiverse-Core and Multiverse-Inventories (soft dependencies)

How it works

GameManager and GameState track the active game’s players and phase, while WorldManager wraps the Multiverse APIs to create and tear down the Manhunt world for each run. TrackingCompass uses the item’s persistent data container to store which runner UUID it’s currently tracking, and ManhuntListener / LobbyListener hook into player events to enforce the lobby and in-game rules.