A comprehensive multiplayer Manhunt plugin for Minecraft servers featuring advanced tracking systems, economy integration, and full internationalization support.
- Dynamic Role System: Players can be Hunters, Runners, or Spectators
- Advanced Compass Tracking: Virtual compass-based tracking with target switching
- Proximity Warning System: Tiered warning system for Runners when Hunters approach
- Automatic Game Management: Smart game state handling with reconnection support
- Time Limit Mode (default 40 minutes)
- Game ends when time expires
- Winner determined by proximity/escape time ratio
- Kill bonus adds 5 minutes to killer's team time
- Real-time dominance percentage display
- Instant runner respawn in this mode
- Endless Mode (time-limit: 0)
- Traditional Manhunt gameplay
- Game continues until victory conditions are met
- Runner respawn with 300-second wait time
- No time pressure, strategic gameplay focus
- In-Game Currency: Earn coins through gameplay actions
- Comprehensive Shop: 40+ items across 6 categories (Weapons, Armor, Tools, Consumables, Food, Special)
- Role-Based Rewards: Different earning methods for Hunters and Runners
- Purchase Restrictions: Item limits, cooldowns, and role-specific restrictions
- Movement Bonus: Sprint movement rewards when enemies are within 3 chunks
- Multi-Language Support: Complete English and Japanese localization
- Player-Specific Languages: Individual language preferences
- Localized Shop Items: All items and descriptions fully translated
- Dynamic UI: All interfaces adapt to player language settings
- Detailed Player Statistics: Track performance, earnings, and achievements
- MVP System: Automatic recognition of top performers
- Comprehensive Game Results: Multi-stage result presentation with visual effects
- Team Rankings: Performance-based team and individual rankings
- Role Selection GUI: Intuitive graphical role selection menu
- Spectator Menu: Easy teleportation system for spectators
- Team Communication: Private team chat and coordinate sharing
- Buddy System: Partner up with a teammate for enhanced coordination
- Real-time UI: Dynamic scoreboard, action bar, and boss bar displays
- Warp System: Teleport to teammates with cost and delay
- Automatic Night Skip: Skip to dawn when night falls
- Achievement Reset: Fresh start for each game
- 🏃 Runners: Defeat the Ender Dragon to achieve victory
- 🗡 Hunters: Eliminate all Runners before they complete their objective
- 👁 Spectators: Observe the game with full mobility and teleportation options
- Minecraft Version: 1.21.4
- Server Software: Spigot or Paper
- Java Version: 21 or higher
- Minimum Players: 2 (configurable)
- Join the server and run
/manhunt roles - Select your role using menu (GUI menu)
- Wait for minimum players and automatic game start
- Use
/manhunt helpfor all available commands
The plugin is highly configurable through config.yml:
# Language Settings
language:
default: "en" # Default language (ja/en)
per-player: true # Per-player language settings
# Game Settings
game:
min-players: 2 # Minimum players to start
start-countdown: 10 # Countdown before game start
reset-advancements: true # Reset achievements on game start
time-limit: 40 # Game time limit in minutes (0 for endless)
# Time Mode Settings (only active when time-limit > 0)
time-mode:
kill-bonus: 5 # Minutes added for each kill
proximity-distance: 3 # Chunks for proximity calculation
runner-instant-respawn: true # Instant respawn for runners
runner-respawn-time: 30 # Respawn wait time in seconds
# Economy Settings
economy:
starting-balance: 0 # Starting money (0G)
currency-unit: "G" # Currency symbol
earn-multiplier: 2.0 # Earning rate multiplier
hunter:
damage-reward: 5 # Reward per damage point
kill-reward: 150 # Reward per kill
tracking-reward: 30 # Continuous tracking bonus
runner:
survival-bonus: 0.05 # Survival bonus per second
nether-reward: 200 # Nether entry reward
end-reward: 500 # End entry reward/manhunt role <runner|hunter|spectator>- Change role (waiting only)/manhunt roles- Open role selection GUI/manhunt status- Check game status/manhunt compass- Get tracking compass (Hunters only)/manhunt spectate- Open spectator menu (Spectators only)/r <message>- Team chat/pos- Share coordinates with team/shop- Open shop menu/shop balance- Check balance/buddy <subcommand>- Buddy system commands (during game only)/warp <player>- Teleport to teammate (costs 100G, 5s delay)
/manhunt start- Force start game/manhunt stopor/manhunt end- Force stop game/manhunt sethunter <player>- Assign hunter role/manhunt setrunner <player>- Assign runner role/manhunt setspectator <player>- Assign spectator role/manhunt minplayers <number>- Set minimum players/manhunt reload [config|shop|all]- Reload configurations/manhunt ui <toggle|status>- Control UI displays/manhunt respawntime <player> <seconds>- Set custom respawn time/manhunt reset- Force reset game (after game ended only)/manhunt give <player> <amount>- Give money to player/manhunt validate-messages- Check message file integrity/manhunt diagnose- Output diagnostic information
🗡 Hunters:
- 5G per damage point dealt to Runners
- 150G per Runner elimination
- 30G for tracking a Runner continuously for 30 seconds (within 100m)
- 1.5G every 30 seconds (time bonus)
🏃 Runners:
- 1.5G every 30 seconds (survival bonus)
- 200G for reaching the Nether
- 300G for finding a fortress
- 500G for reaching the End
- 25G per diamond collected
- 20G for successful escapes (100m+ distance)
- Movement bonus when sprinting with enemies nearby
- ⚔️ Weapons: Swords, axes, tridents
- 🛡️ Armor: Full armor sets in various materials
- 🔧 Tools: Pickaxes, shovels, buckets
- 🧪 Consumables: Potions, golden apples
- 🍖 Food: Various food items
- ✨ Special: Elytra, ender pearls, emeralds
- Dynamic Placement Range: Automatically adjusts based on total players
- 2 players: Max 500m
- 20 players: Max 2000m
- 20+ players: Additional 500m per 20 players
- Enemy Distance: Minimum distance between enemy teams (default: 500m)
- Team Ratio Adjustments:
- Minority team: Placed close together
- Majority team: Spread apart based on team ratio
- Safe Placement: Avoids dangerous locations, places on ground
- Red Alert: Hunter within 1 chunk
- Orange Alert: Hunter within 2 chunks
- Yellow Alert: Hunter within 3 chunks
- Frequency Control: Warnings limited to prevent spam
- Physical compass item or empty hand right-click
- Target switching with right-click (cycles through runners)
- Distance and direction indicators with particles
- Same-world tracking only
- Death state awareness (dead runners not tracked)
- 1-second cooldown between uses
- Private team chat with
/r <message> - Coordinate sharing with
/pos - Real-time teammate positions in Tab list
- Buddy system for enhanced teamwork
- Partner with one teammate for closer coordination
- Real-time buddy location display in scoreboard
- Orange color highlighting in player list
- Commands:
/buddy invite,accept,decline,remove,status - Mutual consent required for buddy relationships
- Automatic cleanup on game end or player disconnect
- Hunters: Instant respawn (1 tick delay)
- Runners:
- Endless mode: 300-second wait in spectator mode
- Time mode: Instant respawn
- Real-time countdown display
- Full spectator capabilities during wait
- Automatic notification when hunter finds runner
- Configurable cooldown between notifications
- Sound and title effects
- Prevents duplicate notifications for continuous proximity
- Language: Kotlin 1.9.24
- Build Tool: Gradle 8.8
- Target JVM: Java 21
- API: Spigot/Paper 1.21.4
- Architecture: Event-driven with comprehensive manager classes
Main.kt- Plugin main classGameManager.kt- Game state and player managementVirtualCompass.kt- Virtual compass tracking systemEventListener.kt- Event handlingUIManager.kt- User interface managementEconomyManager.kt- Currency systemMessageManager.kt- InternationalizationProximityTimeTracker.kt- Time mode tracking
- Clone the repository
- Run
./gradlew build - The plugin JAR will be in
build/libs/
The build process automatically checks that all message keys used in the code are defined in both ja.yml and en.yml files.
To manually check message keys:
./gradlew checkMessageKeysIf any keys are missing, the build will fail and provide suggestions for the missing keys.
- Achievement Reset: Automatically resets all player achievements when game starts
- Night Skip: Automatically advances to dawn when night falls (configurable)
- Warp Command: Teleport to teammates with 100G cost and 5-second delay
- Tracking Persistence Bonus: Hunters earn 30G for continuously tracking runners
- Fixed runner respawn visibility bug where dead runners appeared in survival mode instead of spectator mode
- Fixed compass tracking continuing for dead runners during respawn wait time
- Fixed distance display showing actual distance for dead runners (now shows 0m)
- Fixed economy bonus payouts for dead runners
- Prevented duplicate encounter notifications
- Fixed role selector GUI not working after game reset
- Fixed various hardcoded language strings throughout the codebase
- Removed unnecessary game reset countdown for instant reset after results display
We welcome contributions! Please feel free to:
- Report bugs through GitHub Issues
- Suggest new features
- Submit pull requests
- Help with translations
This project is licensed under the MIT License - see the LICENSE file for details.
🎮 Ready to start your Manhunt adventure? Download now and experience the ultimate chase!