🏃 Minecraft Manhunt Latest - Project Summary

A comprehensive multiplayer Manhunt plugin for Minecraft servers featuring advanced tracking systems, economy integration, and full internationalization support.

✨ Features

🎯 Core Manhunt Gameplay

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

⏱️ Game Modes

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

💰 Economy & Shop System

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

🌍 Full Internationalization

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

📊 Advanced Statistics & Results

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

🎮 Enhanced User Experience

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

🎯 Game Objectives

🏃 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

📋 Requirements

Minecraft Version: 1.21.4
Server Software: Spigot or Paper
Java Version: 21 or higher
Minimum Players: 2 (configurable)

🎮 Quick Start

Join the server and run /manhunt roles
Select your role using menu (GUI menu)
Wait for minimum players and automatic game start
Use /manhunt help for all available commands

⚙️ Configuration

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

🎯 Commands

Player Commands

/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)

Admin Commands

/manhunt start - Force start game
/manhunt stop or /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

🏆 Economy System

Earning Methods

🗡 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

Shop Categories

⚔️ 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

🌟 Advanced Features

Spawn Placement System

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

Proximity Warning System

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

Virtual Compass Tracking System

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

Team Coordination

Private team chat with /r <message>
Coordinate sharing with /pos
Real-time teammate positions in Tab list
Buddy system for enhanced teamwork

Buddy System

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

Respawn System

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

Encounter Notifications

Automatic notification when hunter finds runner
Configurable cooldown between notifications
Sound and title effects
Prevents duplicate notifications for continuous proximity

🔧 Technical Details

Language: Kotlin 1.9.24
Build Tool: Gradle 8.8
Target JVM: Java 21
API: Spigot/Paper 1.21.5(Tested)
Architecture: Event-driven with comprehensive manager classes

Core Components

Main.kt - Plugin main class
GameManager.kt - Game state and player management
VirtualCompass.kt - Virtual compass tracking system
EventListener.kt - Event handling
UIManager.kt - User interface management
EconomyManager.kt - Currency system
MessageManager.kt - Internationalization
ProximityTimeTracker.kt - Time mode tracking

Building

Clone the repository
Run ./gradlew build
The plugin JAR will be in build/libs/

Message Key Validation

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 checkMessageKeys

If any keys are missing, the build will fail and provide suggestions for the missing keys.

📝 Latest Updates (2025-07-22)

New Features

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

Bug Fixes

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

🤝 Contributing

We welcome contributions! Please feel free to:

Report bugs through GitHub Issues
Suggest new features
Submit pull requests
Help with translations

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

🎮 Ready to start your Manhunt adventure? Download now and experience the ultimate chase!

Man Hunt latest