A professional manhunt plugin for Paper servers featuring automated queues, GUI interface, lobby management, and intelligent rejoin functionality.
- Clean GUI with three game modes: 1v1, 1v2, 2v4
- Real-time status display (Available/Occupied/Running/Unavailable)
- Live player count and queue size indicators
- Smart queue system with configurable team sizes
- 30-second countdown when minimum players reached
- Automatic cancellation if players leave before start
- Instant teleport to assigned lobbies
- Dynamic lobby assignment and creation
- Automatic assignment to slots missing lobbies
- Works with existing Multiverse worlds
- Configurable world names per slot
- Rejoin System: Leave and return to exact position
- Persistent player state tracking
- Temporary leave with
/manhuntleave - Return to match with
/manhuntrejoin
- Complete command suite for server management
- Configurable via YAML configuration
- Permission system for different access levels
- Graceful match stopping and cleanup
- Download the latest jar from Modrinth or GitHub Releases
- Place
SpyHunts.jarin your server'splugins/folder - Restart your server
- Configure as needed (see Configuration below)
# Set main lobby location
/manhuntlobby set
# Create game lobbies
/manhunt lobby create
# Open GUI for players
/manhunt| Command | Description | Permission |
|---|---|---|
/manhunt |
Open the Manhunt GUI | spyhunts.use |
/manhuntlobby |
Teleport to main manhunt lobby | spyhunts.use |
/manhuntleave |
Leave active match temporarily | spyhunts.use |
/manhuntrejoin |
Rejoin your active match | spyhunts.use |
| Command | Description | Permission |
|---|---|---|
/manhunt lobby create |
Create and assign a new lobby | spyhunts.lobby |
/manhunt lobby list |
List all available lobbies | spyhunts.lobby |
/manhunt lobby remove <name> |
Remove a lobby | spyhunts.lobby |
/manhunt stop |
Stop an active match | spyhunts.admin |
/manhuntlobby set |
Set the main lobby location | spyhunts.admin |
Default config.yml:
# Slot configurations
1v1:
min_players: 2
max_players: 2
world_name: "1v1_manhunt"
1v2:
min_players: 3
max_players: 3
world_name: "1v2_manhunt"
2v4:
min_players: 6
max_players: 6
world_name: "2v4_manhunt"
# General settings
countdown_seconds: 30
main_lobby:
world: "world"
x: 0
y: 64
z: 0- Team sizes and player limits: Adjust min/max players for each slot
- World names for each game mode: Customize world names for 1v1, 1v2, and 2v4 modes
- Countdown duration: Change the 30-second default countdown timer
- Main lobby location: Configure the main spawn point for players
- Slot-specific settings: Each game mode can have unique configurations
- Paper API 1.21.11 (Required)
- Java 21+ (Required)
- Multiverse-Core (Required, for world management)
Found a bug? Please open an issue with:
- Description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Server logs (if applicable)
This project is licensed under the MPL-2.0 License.
- GitHub Issues: Report bugs or request features
- Modrinth: Download and rate
- Discord: Join our community (Optional)
- PaperMC for the excellent server software
- Spigot/Paper API developers
- All contributors and testers
- The Minecraft plugin development community
- 🟢 Available: Open for queueing
- 🟡 Occupied: Queue is full
- 🔴 Running: Game in progress
- ⚫ Unavailable: Admin-stopped
Made with ❤️ for the Minecraft community