⚔️ 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

⌨️ Commands & Permissions

Player Commands

Admin Commands

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!