AzHuntMan

Minecraft 版本： 1.2.1 1.2.2 1.2.3 1.2.4 1.2.5 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7

平台： bukkit paper spigot

标签： equipment minigame

? 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

? Commands | Command | Description | Permission | |---------|-------------|------------| | `/huntman` or `/hm` | Open main role selection GUI | `huntman.use` | | `/huntman admin` | Access admin control panel | `huntman.admin` | | `/huntman force ` | 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` | ? Permissions | 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` |

---

? In-Game Messages

Messages support Minecraft color codes and emojis:

# Example messages with colors and emojis
game:
  started: "&8[&6? &bᴀᴢʜᴜɴᴛᴍᴀɴ&8] &a▶ The hunt has begun! Hunters vs Runners!"
  hunter-freeze-started: "&8[&6? &bᴀᴢʜᴜɴᴛᴍᴀɴ&8] &e? Hunters are frozen for {time} seconds!"
  hunting-phase-started: "&8[&6? &bᴀᴢʜᴜɴᴛᴍᴀɴ&8] &c? Hunting phase has begun!"

role:
  selected:
    hunter: "&8[&6? &bᴀᴢʜᴜɴᴛᴍᴀɴ&8] &c? You are now a Hunter!"
    runner: "&8[&6? &bᴀᴢʜᴜɴᴛᴍᴀɴ&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

?️ config.yml Example ```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 ``` ? messages.yml Example ```yaml # Customize every message with colors and emojis prefix: "&8[&6? &bᴀᴢʜᴜɴᴛᴍᴀɴ&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!" ```

---

? 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: All Rights Reserved

---