ChickenHunt - Fun & Custom Chicken Hunting Game!
Tired of the same old events? Bring new excitement to your server with ChickenHunt!

ChickenHunt is a minigame plugin that allows players to hunt special chickens within predefined regions. These aren't ordinary chickens; they can't be killed but are "caught" by right-clicking to obtain valuable "Chicken Heads"! These heads can be sold for money (if Vault is integrated) or exchanged for other exciting rewards.

⭐ Key Features ⭐

• Unique Gameplay:
  • Catch special chickens by right-clicking, not killing!
  • Obtain customizable Chicken Head items (name, lore, texture).
  • Sell Chicken Heads for monetary rewards via Vault integration.
• ✨ Rare Golden Chickens:
  • Configure the appearance of "Golden Chickens" with custom textures and names.
  • Provide bigger rewards or special items when a Golden Chicken is caught.
• ️ Flexible Region Management:
  • Use a "Wand" item (customizable) to easily create and define game areas.
  • Commands: /ch wand, /ch create <regionName>, /ch delete <regionName>, /ch list.
• ⏱️ Full Game Control:
  • Start and stop games manually: /ch start <regionName> [durationSeconds], /ch stop <regionName>.
  • Set game durations or let them run indefinitely.
• Stats & Leaderboards:
  • Track the number of chickens caught and money earned by each player.
  • Display top players via /ch top [caught|money].
• Tiered Rewards System:
  • Automatically give rewards (items, commands, money) to players who reach specific catch milestones.
  • Very easy to configure via config.yml.
  • Players can view their reward progress with /ch rewards.
• Auto-Scheduler:
  • Set games to start automatically at specified intervals in randomly selected regions.
  • Configure game duration, warning times, and announcement messages.
  • Players can see the next scheduled game with /ch schedule.
• ❄️ Catch Cooldown:
  • Prevent spam-clicking by adding a cooldown between chicken catches.
  • An action bar message will inform players of the remaining cooldown time.
• Smart Chicken AI:
  • Chickens will attempt to flee from approaching players.
  • Chickens are ensured to stay within the game region boundaries.
• Highly Configurable:
  • All messages, item names, wand materials, sound effects, and particles can be changed via config.yml.
  • Easily reload the configuration: /ch reload.
• PlaceholderAPI Integration:
  • Display ChickenHunt stats in other plugins!
  • Examples: %chickenhunt_caught%, %chickenhunt_money_earned%, %chickenhunt_next_game_time%, and many more.

Main Commands
Admin:

• /ch wand - Get the region selection wand.
• /ch create <regionName> - Create a new region.
• /ch delete <regionName> - Delete a region.
• /ch list - List all regions.
• /ch start <regionName> [durationSeconds] - Start the game.
• /ch stop <regionName> - Stop the game.
• /ch reload - Reload plugin configuration.

Player:

• /ch sell - Sell all Chicken Heads.
• /ch top [caught|money] - View leaderboards.
• /ch status [regionName] - View game status.
• /ch schedule - View the next auto-scheduled game.
• /ch rewards - View available rewards and progress.
• /ch help - Display the help message.

Permissions

• chickenhunt.use: Allows basic use of ChickenHunt commands. (Default: true)
• chickenhunt.admin: Allows access to all admin commands for ChickenHunt. (Default: op)
  • chickenhunt.admin.wand: Allows use of /ch wand. (Default: op)
  • chickenhunt.admin.create: Allows use of /ch create. (Default: op)
  • chickenhunt.admin.delete: Allows use of /ch delete. (Default: op)
  • chickenhunt.admin.list: Allows use of /ch list. (Default: op)
  • chickenhunt.admin.start: Allows use of /ch start. (Default: op)
  • chickenhunt.admin.stop: Allows use of /ch stop. (Default: op)
  • chickenhunt.admin.reload: Allows use of /ch reload. (Default: op)
  • chickenhunt.admin.config: Allows use of /ch config. (Default: op)
• chickenhunt.player.sell: Allows use of /ch sell. (Default: true)
• chickenhunt.player.top: Allows use of /ch top. (Default: true)
• chickenhunt.player.help: Allows use of /ch help. (Default: true)
• chickenhunt.player.status: Allows use of /ch status. (Default: true)
• chickenhunt.player.rewards: Allows use of /ch rewards. (Default: true)
• chickenhunt.player.schedule: Allows use of /ch schedule. (Default: true) (This was added in a previous step, ensure it's in your plugin.yml)

⚙️ Dependencies ⚙️

• Vault (Required if you want to use the economy feature for selling chicken heads)
• PlaceholderAPI (Optional, to use placeholders in other plugins)

Future Development Plans

• /ch tp <regionName> command for admins.
• /ch redefine <regionName> command for admins to modify existing region boundaries.
• More detailed game time remaining notifications.
• In-game scoreboard for active regions.
• GUI menus for admins and players.

Download ChickenHunt now and add an addictive and fun hunting event to your server! Feel free to provide feedback and suggestions in the discussion section.