Man Hunt latest

🏃 Minecraft Manhunt Latest - Project Summary

Modrinth Downloads

GitHub Release

Minecraft Version

Platform

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

✨ Features

🎯 Core Manhunt Gameplay

- Automatic Game Management: Players can be Hunters, Runners, or Spectators - Automatic Game Management: Virtual compass-based tracking with target switching - Automatic Game Management: Tiered warning system for Runners when Hunters approach - Automatic Game Management: Smart game state handling with reconnection support

⏱️ Game Modes

- Endless 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

- Movement Bonus: Earn coins through gameplay actions - Movement Bonus: 40+ items across 6 categories (Weapons, Armor, Tools, Consumables, Food, Special) - Movement Bonus: Different earning methods for Hunters and Runners - Movement Bonus: Item limits, cooldowns, and role-specific restrictions - Movement Bonus: Sprint movement rewards when enemies are within 3 chunks

🌍 Full Internationalization

- Dynamic UI: Complete English and Japanese localization - Dynamic UI: Individual language preferences - Dynamic UI: All items and descriptions fully translated - Dynamic UI: All interfaces adapt to player language settings

📊 Advanced Statistics & Results

- Team Rankings: Track performance, earnings, and achievements - Team Rankings: Automatic recognition of top performers - Team Rankings: Multi-stage result presentation with visual effects - Team Rankings: Performance-based team and individual rankings

🎮 Enhanced User Experience

- Achievement Reset: Intuitive graphical role selection menu - Achievement Reset: Easy teleportation system for spectators - Achievement Reset: Private team chat and coordinate sharing - Achievement Reset: Partner up with a teammate for enhanced coordination - Achievement Reset: Dynamic scoreboard, action bar, and boss bar displays - Achievement Reset: Teleport to teammates with cost and delay - Achievement Reset: Skip to dawn when night falls - Achievement Reset: Fresh start for each game

🎯 Game Objectives

- 👁 Spectators: Defeat the Ender Dragon to achieve victory - 👁 Spectators: Eliminate all Runners before they complete their objective - 👁 Spectators: Observe the game with full mobility and teleportation options

📋 Requirements

- Minimum Players: 1.21.4 - Minimum Players: Spigot or Paper - Minimum Players: 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`:

```yaml

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

- ✨ Special: Swords, axes, tridents - ✨ Special: Full armor sets in various materials - ✨ Special: Pickaxes, shovels, buckets - ✨ Special: Potions, golden apples - ✨ Special: Various food items - ✨ Special: Elytra, ender pearls, emeralds

🌟 Advanced Features

Spawn Placement System

- Safe Placement: Automatically adjusts based on total players - 2 players: Max 500m - 20 players: Max 2000m - 20+ players: Additional 500m per 20 players - Safe Placement: Minimum distance between enemy teams (default: 500m) - Safe Placement: - Minority team: Placed close together - Majority team: Spread apart based on team ratio - Safe Placement: Avoids dangerous locations, places on ground

Proximity Warning System

- Frequency Control: Hunter within 1 chunk - Frequency Control: Hunter within 2 chunks - Frequency Control: 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

- Runners: 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

- Architecture: Kotlin 1.9.24 - Architecture: Gradle 8.8 - Architecture: Java 21 - Architecture: 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: ```bash ./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

- Tracking Persistence Bonus: Automatically resets all player achievements when game starts - Tracking Persistence Bonus: Automatically advances to dawn when night falls (configurable) - Tracking Persistence Bonus: 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!