🧱 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

🎮 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

# 🎯 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

# 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