AzHuntMan

# 🧱 AzHuntMan - Hunter vs Runner Plugin Transform your server into an adrenaline-pumping battleground where hunters track down runners in the ultimate survival game! --- ## ✨ Features 🎯 **Role-Based Gameplay** - Choose between Hunter, Runner, or Spectator 🧭 **Compass Tracking** - Hunters get tracking compasses to find their prey ✨ **Glow Effects** - Hunters glow with unique colors for easy identification 👑 **Admin Control Panel** - Complete game management through intuitive GUIs 🚫 **PvP Protection** - Prevents hunter-vs-hunter combat for fair gameplay ❄️ **Hunter Freeze** - 30-second head start for runners to escape 📊 **Dynamic Scoreboards** - Real-time game status and player information 🎨 **Full Customization** - Every message, color, and setting is configurable 📡 **PlaceholderAPI** - Integration for external plugin compatibility ⚡ **Auto-Start Games** - Automatic game initiation when minimum players join --- ## 📋 Commands & Permissions <details> <summary><b>🔧 Commands</b></summary> | Command | Description | Permission | |---------|-------------|------------| | `/huntman` or `/hm` | Open main role selection GUI | `huntman.use` | | `/huntman admin` | Access admin control panel | `huntman.admin` | | `/huntman force <player> <role>` | Force assign player roles | `huntman.admin.force` | | `/huntman reload` | Reload plugin configurations | `huntman.admin.reload` | | `/huntman start` | Start the game manually | `huntman.admin.game` | | `/huntman stop` | Stop the current game | `huntman.admin.game` | | `/huntman finish` | End game with runners winning | `huntman.admin.game` | | `/huntman leave` | Leave game and remove items | `huntman.use` | </details> <details> <summary><b>🔐 Permissions</b></summary> | Permission | Description | Default | |------------|-------------|---------| | `huntman.use` | Basic plugin usage | `true` | | `huntman.admin` | Admin GUI access | `op` | | `huntman.admin.force` | Force assign roles | `op` | | `huntman.admin.reload` | Reload configurations | `op` | | `huntman.admin.game` | Start/stop games | `op` | </details> --- ## 🎮 In-Game Messages Messages support Minecraft color codes and emojis: ```yaml # Example messages with colors and emojis game: started: "&8 &a▶ The hunt has begun! Hunters vs Runners!" hunter-freeze-started: "&8 &e🧊 Hunters are frozen for {time} seconds!" hunting-phase-started: "&8 &c🏹 Hunting phase has begun!" role: selected: hunter: "&8 &c🏹 You are now a Hunter!" runner: "&8 &b🏃 You are now a Runner!" ``` --- ## ⚙️ Requirements - **Minecraft Version:** 1.20 - 1.21.7+ - **Server Software:** Spigot/Paper/Bukkit - **Java Version:** 17+ - **Dependencies:** PlaceholderAPI (optional) --- ## 📁 Configuration <details> <summary><b>🎛️ config.yml Example</b></summary> ```yaml # 🎯 AzHuntMan Configuration 🚀 game: max-hunters: 3 # Maximum hunters (-1 = unlimited) max-runners: -1 # Maximum runners (-1 = unlimited) auto-start: true # Auto-start when min players join min-players: 2 # Minimum players to start hunter-freeze-time: 30 # Hunter freeze duration (seconds) features: compass-tracking: true # Enable hunter tracking compasses glow-effect: true # Add glow effects to hunters runner-tracking: true # Allow runners to track each other no-hunter-pvp: true # Prevent hunter vs hunter combat gui: use-small-font: true # Use Minecraft small font styling refresh-interval: 20 # GUI refresh rate (ticks) placeholders: enabled: true # Enable PlaceholderAPI integration debug: enabled: false # Enable debug console messages ``` </details> <details> <summary><b>💬 messages.yml Example</b></summary> ```yaml # Customize every message with colors and emojis prefix: "&8 " role-prefix: hunter: "&c &f" runner: "&b &f" game: started: "{prefix}&a▶ The hunt has begun! Hunters vs Runners!" countdown-starting: "{prefix}&e⏰ Game starting in 10 seconds!" hunter-freeze-started: "{prefix}&e🧊 Hunters frozen for {time} seconds!" ``` </details> --- ## 🚀 Installation 1. Download the latest `AzHuntMan-1.0.0.jar` from releases 2. Place in your server's `plugins/` folder 3. Restart your server 4. Configure `config.yml` and `messages.yml` to your liking 5. Use `/huntman reload` to apply changes without restart --- ## 🎯 PlaceholderAPI Support Available placeholders for external plugins: - `%azhuntman_role%` - Player's current role - `%azhuntman_hunters%` - Number of hunters - `%azhuntman_runners%` - Number of runners - `%azhuntman_game_status%` - Current game state --- ## 🎪 Discord Community Join our community for support, updates, and discussions: **Discord:** `https://discord.gg/R4XmFc9qCq` --- ## 📜 License & Credits **Version:** 1.0.0 **API Version:** 1.20+ **License:**