🏃 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

1. Join the server and run /manhunt roles
2. Select your role using menu (GUI menu)
3. Wait for minimum players and automatic game start
4. 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

1. Clone the repository
2. Run ./gradlew build
3. 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

• Official Guide
• Modrinth Page
• GitHub Repository
• Issue Tracker

---

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