# \ud83c\udfc3 Minecraft Manhunt Latest – Project Summary<\/p>\n
\n
\n
\n<\/p>\n
A comprehensive multiplayer Manhunt plugin for Minecraft servers featuring advanced tracking systems, economy integration, and full internationalization support.<\/p>\n
## \u2728 Features<\/p>\n
### \ud83c\udfaf Core Manhunt Gameplay
\n– **Dynamic Role System**: Players can be Hunters, Runners, or Spectators
\n– **Advanced Compass Tracking**: Virtual compass-based tracking with target switching
\n– **Proximity Warning System**: Tiered warning system for Runners when Hunters approach
\n– **Automatic Game Management**: Smart game state handling with reconnection support<\/p>\n
### \u23f1\ufe0f Game Modes
\n– **Time Limit Mode** (default 40 minutes)
\n – Game ends when time expires
\n – Winner determined by proximity\/escape time ratio
\n – Kill bonus adds 5 minutes to killer’s team time
\n – Real-time dominance percentage display
\n – Instant runner respawn in this mode
\n– **Endless Mode** (time-limit: 0)
\n – Traditional Manhunt gameplay
\n – Game continues until victory conditions are met
\n – Runner respawn with 300-second wait time
\n – No time pressure, strategic gameplay focus<\/p>\n
### \ud83d\udcb0 Economy & Shop System
\n– **In-Game Currency**: Earn coins through gameplay actions
\n– **Comprehensive Shop**: 40+ items across 6 categories (Weapons, Armor, Tools, Consumables, Food, Special)
\n– **Role-Based Rewards**: Different earning methods for Hunters and Runners
\n– **Purchase Restrictions**: Item limits, cooldowns, and role-specific restrictions
\n– **Movement Bonus**: Sprint movement rewards when enemies are within 3 chunks<\/p>\n
### \ud83c\udf0d Full Internationalization
\n– **Multi-Language Support**: Complete English and Japanese localization
\n– **Player-Specific Languages**: Individual language preferences
\n– **Localized Shop Items**: All items and descriptions fully translated
\n– **Dynamic UI**: All interfaces adapt to player language settings<\/p>\n
### \ud83d\udcca Advanced Statistics & Results
\n– **Detailed Player Statistics**: Track performance, earnings, and achievements
\n– **MVP System**: Automatic recognition of top performers
\n– **Comprehensive Game Results**: Multi-stage result presentation with visual effects
\n– **Team Rankings**: Performance-based team and individual rankings<\/p>\n
### \ud83c\udfae Enhanced User Experience
\n– **Role Selection GUI**: Intuitive graphical role selection menu
\n– **Spectator Menu**: Easy teleportation system for spectators
\n– **Team Communication**: Private team chat and coordinate sharing
\n– **Buddy System**: Partner up with a teammate for enhanced coordination
\n– **Real-time UI**: Dynamic scoreboard, action bar, and boss bar displays
\n– **Warp System**: Teleport to teammates with cost and delay
\n– **Automatic Night Skip**: Skip to dawn when night falls
\n– **Achievement Reset**: Fresh start for each game<\/p>\n
## \ud83c\udfaf Game Objectives<\/p>\n
– **\ud83c\udfc3 Runners**: Defeat the Ender Dragon to achieve victory
\n– **\ud83d\udde1 Hunters**: Eliminate all Runners before they complete their objective
\n– **\ud83d\udc41 Spectators**: Observe the game with full mobility and teleportation options<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Minecraft Version**: 1.21.4
\n– **Server Software**: Spigot or Paper
\n– **Java Version**: 21 or higher
\n– **Minimum Players**: 2 (configurable)<\/p>\n
## \ud83c\udfae Quick Start<\/p>\n
1. Join the server and run `\/manhunt roles`
\n2. Select your role using menu (GUI menu)
\n3. Wait for minimum players and automatic game start
\n4. Use `\/manhunt help` for all available commands<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
The plugin is highly configurable through `config.yml`:<\/p>\n
“`yaml
\n# Language Settings
\nlanguage:
\n default: “en” # Default language (ja\/en)
\n per-player: true # Per-player language settings<\/p>\n
# Game Settings
\ngame:
\n min-players: 2 # Minimum players to start
\n start-countdown: 10 # Countdown before game start
\n reset-advancements: true # Reset achievements on game start
\n time-limit: 40 # Game time limit in minutes (0 for endless)<\/p>\n
# Time Mode Settings (only active when time-limit > 0)
\n time-mode:
\n kill-bonus: 5 # Minutes added for each kill
\n proximity-distance: 3 # Chunks for proximity calculation
\n runner-instant-respawn: true # Instant respawn for runners
\n runner-respawn-time: 30 # Respawn wait time in seconds<\/p>\n
# Economy Settings
\neconomy:
\n starting-balance: 0 # Starting money (0G)
\n currency-unit: “G” # Currency symbol
\n earn-multiplier: 2.0 # Earning rate multiplier
\n hunter:
\n damage-reward: 5 # Reward per damage point
\n kill-reward: 150 # Reward per kill
\n tracking-reward: 30 # Continuous tracking bonus
\n runner:
\n survival-bonus: 0.05 # Survival bonus per second
\n nether-reward: 200 # Nether entry reward
\n end-reward: 500 # End entry reward
\n“`<\/p>\n
## \ud83c\udfaf Commands<\/p>\n
### Player Commands ### Admin Commands ## \ud83c\udfc6 Economy System<\/p>\n ### Earning Methods<\/p>\n **\ud83d\udde1 Hunters:** **\ud83c\udfc3 Runners:** ### Shop Categories ## \ud83c\udf1f Advanced Features<\/p>\n ### Spawn Placement System ### Proximity Warning System ### Virtual Compass Tracking System ### Team Coordination ### Buddy System ### Respawn System ### Encounter Notifications ## \ud83d\udd27 Technical Details<\/p>\n – **Language**: Kotlin 1.9.24 ### Core Components ### Building<\/p>\n 1. Clone the repository ### Message Key Validation<\/p>\n The build process automatically checks that all message keys used in the code are defined in both `ja.yml` and `en.yml` files. <\/p>\n To manually check message keys: If any keys are missing, the build will fail and provide suggestions for the missing keys.<\/p>\n ## \ud83d\udcdd Latest Updates (2025-07-22)<\/p>\n ### New Features ### Bug Fixes ## \ud83e\udd1d Contributing<\/p>\n We welcome contributions! Please feel free to: ## \ud83d\udcc4 License<\/p>\n This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.<\/p>\n ## \ud83d\udd17 Links<\/p>\n – Official Guide —<\/p>\n **\ud83c\udfae Ready to start your Manhunt adventure? Download now and experience the ultimate chase!**<\/p>\n","protected":false},"excerpt":{"rendered":" Minecraft Manhunt is a competitive game plugin in which multiple players are divided into hunters and runners.<\/p>\n","protected":false},"featured_media":97942,"template":"","meta":{"_minecraft_slug":"man-hunt-latest","_minecraft_project_id":"DxnFiYdM","_minecraft_author":"yokmama","_minecraft_license":"MIT","_minecraft_downloads":317,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"man-hunt-latest.zip","_minecraft_size_bytes":5685183,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T11:38:14.684268Z","_minecraft_date_created":"2025-07-08T18:14:39.808555Z","_minecraft_date_modified":"2025-09-05T23:22:05.439341Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/man-hunt-latest","_minecraft_icon_attachment_id":97942,"_minecraft_imported_at":"2026-06-05T14:55:43+00:00","_minecraft_import_hash":"e1017425c7631fed9632e4f6a6484560","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[866,127,129],"mod_loader":[132,134],"minecraft_version":[38],"class_list":["post-97941","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-minigame","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21-4"],"yoast_head":"\n
\n– `\/manhunt role
\n– `\/manhunt roles` – Open role selection GUI
\n– `\/manhunt status` – Check game status
\n– `\/manhunt compass` – Get tracking compass (Hunters only)
\n– `\/manhunt spectate` – Open spectator menu (Spectators only)
\n– `\/r
\n– `\/pos` – Share coordinates with team
\n– `\/shop` – Open shop menu
\n– `\/shop balance` – Check balance
\n– `\/buddy
\n– `\/warp
\n– `\/manhunt start` – Force start game
\n– `\/manhunt stop` or `\/manhunt end` – Force stop game
\n– `\/manhunt sethunter
\n– `\/manhunt setrunner
\n– `\/manhunt setspectator
\n– `\/manhunt minplayers
\n– `\/manhunt reload [config|shop|all]` – Reload configurations
\n– `\/manhunt ui
\n– `\/manhunt respawntime
\n– `\/manhunt reset` – Force reset game (after game ended only)
\n– `\/manhunt give
\n– `\/manhunt validate-messages` – Check message file integrity
\n– `\/manhunt diagnose` – Output diagnostic information<\/p>\n
\n– 5G per damage point dealt to Runners
\n– 150G per Runner elimination
\n– 30G for tracking a Runner continuously for 30 seconds (within 100m)
\n– 1.5G every 30 seconds (time bonus)<\/p>\n
\n– 1.5G every 30 seconds (survival bonus)
\n– 200G for reaching the Nether
\n– 300G for finding a fortress
\n– 500G for reaching the End
\n– 25G per diamond collected
\n– 20G for successful escapes (100m+ distance)
\n– Movement bonus when sprinting with enemies nearby<\/p>\n
\n– **\u2694\ufe0f Weapons**: Swords, axes, tridents
\n– **\ud83d\udee1\ufe0f Armor**: Full armor sets in various materials
\n– **\ud83d\udd27 Tools**: Pickaxes, shovels, buckets
\n– **\ud83e\uddea Consumables**: Potions, golden apples
\n– **\ud83c\udf56 Food**: Various food items
\n– **\u2728 Special**: Elytra, ender pearls, emeralds<\/p>\n
\n– **Dynamic Placement Range**: Automatically adjusts based on total players
\n – 2 players: Max 500m
\n – 20 players: Max 2000m
\n – 20+ players: Additional 500m per 20 players
\n– **Enemy Distance**: Minimum distance between enemy teams (default: 500m)
\n– **Team Ratio Adjustments**:
\n – Minority team: Placed close together
\n – Majority team: Spread apart based on team ratio
\n– **Safe Placement**: Avoids dangerous locations, places on ground<\/p>\n
\n– **Red Alert**: Hunter within 1 chunk
\n– **Orange Alert**: Hunter within 2 chunks
\n– **Yellow Alert**: Hunter within 3 chunks
\n– **Frequency Control**: Warnings limited to prevent spam<\/p>\n
\n– Physical compass item or empty hand right-click
\n– Target switching with right-click (cycles through runners)
\n– Distance and direction indicators with particles
\n– Same-world tracking only
\n– Death state awareness (dead runners not tracked)
\n– 1-second cooldown between uses<\/p>\n
\n– Private team chat with `\/r
\n– Coordinate sharing with `\/pos`
\n– Real-time teammate positions in Tab list
\n– Buddy system for enhanced teamwork<\/p>\n
\n– Partner with one teammate for closer coordination
\n– Real-time buddy location display in scoreboard
\n– Orange color highlighting in player list
\n– Commands: `\/buddy invite`, `accept`, `decline`, `remove`, `status`
\n– Mutual consent required for buddy relationships
\n– Automatic cleanup on game end or player disconnect<\/p>\n
\n– **Hunters**: Instant respawn (1 tick delay)
\n– **Runners**:
\n – Endless mode: 300-second wait in spectator mode
\n – Time mode: Instant respawn
\n – Real-time countdown display
\n – Full spectator capabilities during wait<\/p>\n
\n– Automatic notification when hunter finds runner
\n– Configurable cooldown between notifications
\n– Sound and title effects
\n– Prevents duplicate notifications for continuous proximity<\/p>\n
\n– **Build Tool**: Gradle 8.8
\n– **Target JVM**: Java 21
\n– **API**: Spigot\/Paper 1.21.5(Tested)
\n– **Architecture**: Event-driven with comprehensive manager classes<\/p>\n
\n– `Main.kt` – Plugin main class
\n– `GameManager.kt` – Game state and player management
\n– `VirtualCompass.kt` – Virtual compass tracking system
\n– `EventListener.kt` – Event handling
\n– `UIManager.kt` – User interface management
\n– `EconomyManager.kt` – Currency system
\n– `MessageManager.kt` – Internationalization
\n– `ProximityTimeTracker.kt` – Time mode tracking<\/p>\n
\n2. Run `.\/gradlew build`
\n3. The plugin JAR will be in `build\/libs\/`<\/p>\n
\n“`bash
\n.\/gradlew checkMessageKeys
\n“`<\/p>\n
\n– **Achievement Reset**: Automatically resets all player achievements when game starts
\n– **Night Skip**: Automatically advances to dawn when night falls (configurable)
\n– **Warp Command**: Teleport to teammates with 100G cost and 5-second delay
\n– **Tracking Persistence Bonus**: Hunters earn 30G for continuously tracking runners<\/p>\n
\n– Fixed runner respawn visibility bug where dead runners appeared in survival mode instead of spectator mode
\n– Fixed compass tracking continuing for dead runners during respawn wait time
\n– Fixed distance display showing actual distance for dead runners (now shows 0m)
\n– Fixed economy bonus payouts for dead runners
\n– Prevented duplicate encounter notifications
\n– Fixed role selector GUI not working after game reset
\n– Fixed various hardcoded language strings throughout the codebase
\n– Removed unnecessary game reset countdown for instant reset after results display<\/p>\n
\n– Report bugs through GitHub Issues
\n– Suggest new features
\n– Submit pull requests
\n– Help with translations<\/p>\n
\n– Modrinth Page
\n– GitHub Repository
\n– Issue Tracker<\/p>\n