🎯 AsBounty

---

🌟 Overview

AsBounty is a next-generation bounty hunting plugin engineered specifically for modern Minecraft servers (1.21.x). Built with performance, aesthetics, and ease of use in mind, AsBounty gives your players an engaging bounty board with interactive menus, skull skin caching, sign input, and flawless Vault economy integration.

Whether you are running a Survival, SMP, Lifesteal, Factions, or PvP server, AsBounty introduces high-stakes player-versus-player excitement without causing TPS drops!

---

✨ Features

• ⚡ High Performance & 100% Async: Player heads, skins, and textures are fetched and cached asynchronously using an SQLite database to eliminate main-thread lag.
• 🍃 Folia & Paper Ready: Fully compatible with Paper, Purpur, and multi-threaded Folia servers.
• 🖥️ Interactive Menus (GUI):
  • Dynamic Multi-Page Bounty Board with pagination.
  • Sorting Options: Filter bounties by Newest, Oldest, Highest Bounty, or Lowest Bounty.
  • In-GUI Search: Search for targets in real-time.
  • Confirmation GUI: Prevents accidental bounty placement.
• ✍️ Sign GUI Input: Players can type target names and values using a smooth in-game sign editor.
• 💰 Robust Economy & Vault Integration:
  • Works with any Vault-compatible economy plugin (EssentialsX, CMI, CoinsEngine, etc.).
  • Smart Hook: Automatically detects and hooks into economy providers at runtime even if loaded or reloaded later.
  • Supports money abbreviations (e.g. 10k, 1.5M, 2B, 1T).
• 🎨 RGB & Hex Colors & Gradients: Full support for Hex color codes (&#00fc88) and custom gradient text formatting throughout messages and menus.
• 🔊 Sound & Action Bar Effects: Customizable sounds and action bar alerts whenever a bounty is placed or claimed.

---

📋 Commands & Permissions

Command	Aliases	Description	Permission	Default
/bounty	/asbounty	Opens the main Bounty GUI board	asbounty.use	Everyone
/bounty add <player> <amount>	/asbounty add	Places a bounty on a specific player	asbounty.use	Everyone
/bounty reload	/asbounty reload	Reloads all configuration and GUI files	asbounty.reload	OP

Note: Legacy bounty.use and bounty.reload permissions are also supported for backwards compatibility.

---

⚙️ Installation

1. Ensure your server is running Paper / Purpur / Folia 1.21+ with Java 21.
2. Download and install Vault and an Economy provider (e.g., EssentialsX or CMI).
3. Place AsBounty-1.0.0.jar into your server's plugins/ directory.
4. Restart your server to generate the configuration files.
5. Customize your settings in plugins/AsBounty/ to your liking!

---

📁 File Structure & Customization

All files in plugins/AsBounty/ are completely editable:

• config.yml - Set min/max bounty limits, currency formats, abbreviations (K, M, B, T), sounds, and sign GUI settings.
• lang.yml - Customize all chat messages, prefixes, and action bar notifications.
• gui/main-gui.yml - Customize the main bounty board inventory layout, titles, buttons, and lore.
• gui/confirm-gui.yml - Customize the bounty confirmation menu.

---

💬 Support & Developer Contact

Need help, have a suggestion, or want custom Minecraft development?

• 🌐 Discord Support Server: https://discord.gg/xRW5rdAvs5
• 👤 Developer: ItzAzeem (itzazeem.as)

---