⚔️ ApxBounty

A modern, high-performance, and modular player bounty plugin designed for Paper and Spigot servers (1.26+ / Java 17+).

Give your server players an engaging, competitive bounty-hunting experience! Set rewards, hunt targets, climb leaderboards, and claim riches with zero server lag.

---

🌟 Key Features

• ⚡ Asynchronous SQLite Engine:

  • All database queries run completely off the main server thread.
  • Guarantees smooth, uninterrupted 20.0 TPS performance.

• 🖥️ Modern & Intuitive GUIs (54-slot Layout):

  • Displays up to 45 active bounty player heads per page in real-time.
  • Dynamic Sorting: Cycle easily between High-to-Low, Low-to-High, Newest, and Oldest bounties.
  • In-GUI Search: Instantly find specific players' bounties.
  • Quick Refresh: Refresh heads and data on the fly.
  • Dedicated Leaderboard GUI, Player Stats GUI, and Bounty History GUI.

• 💰 Robust Economy & Vault Integration:

  • Fully compatible with Vault economy (EssentialsX, Economy plugins, etc.).
  • Configurable minimum/maximum bounty amounts, placement fees, and claim taxes.
  • Auto-Refunds: Contributors receive their money back if bounties expire or are canceled.
  • Supports multiple contributors adding to the same player's bounty pool.

• 📊 PlaceholderAPI Support:

  • Rich collection of placeholders for leaderboards, player stats, kill counts, and top targets for your scoreboards, tablists, or chat formatting.

• 🎨 100% Fully Configurable:

  • Full support for standard Minecraft color codes (&6, &a) and modern HEX colors (&#RRGGBB).
  • Action bars, chat announcements, sound effects, and title notifications.

---

📋 Requirements

Requirement	Details
Java Version	Java 17 or higher
Server Software	Paper, Purpur, or Spigot (1.20 - 1.20.6+)
Required Dependency	Vault (with an economy provider)
Optional Dependency	PlaceholderAPI (for custom scoreboard/tab placeholders)

---

⌨️ Commands & Permissions

Player Commands

Command	Description	Permission
/bounty	Opens the main interactive bounties GUI	apxbounty.use
/bounty <player> <amount>	Places or increases a bounty on a target	apxbounty.place
/bounty search <player>	Searches and filters the bounty GUI for a player	apxbounty.search

Admin Commands

Command	Description	Permission
/bountyadmin info	Displays plugin information and version check	apxbounty.admin
/bountyadmin set <player> <amount>	Force-sets a bounty on a player	apxbounty.admin.set
/bountyadmin remove <player>	Force-removes a bounty from a player	apxbounty.admin.remove
/bountyadmin clear	Clears all active bounties across the server	apxbounty.admin.clear
/bountyadmin reload	Reloads all config, message, and GUI files	apxbounty.admin.reload
/bountyadmin debug	Toggles debug logging mode	apxbounty.admin.debug

Special Permissions

• apxbounty.bypass.limit - Bypasses min/max bounty restrictions.
• apxbounty.bypass.fee - Bypasses placement fees.
• apxbounty.admin - Full access to all administrative commands.

---

🧩 Placeholders (PlaceholderAPI)

• %apxbounty_bounty% - Current active bounty on the player.
• %apxbounty_target% - Name of the player with the highest bounty.
• %apxbounty_total% - Total number of active server bounties.
• %apxbounty_kills% - Total bounty kills by the player.
• %apxbounty_placed% - Total bounties placed by the player.
• %apxbounty_claimed% - Total bounties claimed by the player.
• %apxbounty_spent% - Total money spent placing bounties.
• %apxbounty_earned% - Total money earned from hunting bounties.
• %apxbounty_top_bounty_<rank>_name% - Top bounty target name at rank.
• %apxbounty_top_bounty_<rank>_value% - Top bounty amount at rank.

---

⚙️ Installation

1. Download ApxBounty.jar.
2. Make sure Vault (and an economy provider like EssentialsX) is installed on your server.
3. Place ApxBounty.jar into your server's plugins/ directory.
4. Restart your server.
5. Edit config.yml, messages.yml, or gui.yml to your liking, then run /bountyadmin reload!