Player-Bounty

# 🎯 flyingBounties — Lightweight, configurable bounty system with GUI & Vault support *🧭 Let players create bounties on others (online or offline). Vault-compatible, multilingual, paginated GUI and automated expiry/refunds.* --- ## 🔎 Quick overview flyingBounties is a lightweight and performant plugin that lets players place time-limited bounties on other players. It supports Vault economy for deposits/payouts, a fully configurable paginated GUI, multi-language support (`langs/`), and automatic expiry with refunds. ✅ --- ## ✨ Key features - 🎯 **Place bounties on players (online or offline)** — stores UUID + name. - 💰 **Vault economy integration** — works with EssentialsX, iConomy and other Vault-compatible economy plugins. - 🖼️ **Configurable GUI** — paginated menu editable through `menu.yml` (hex colors supported in format `#RRGGBB`). - 🔁 **Stacking option** — pay out all bounties for a target at once (stacked) or one-by-one. - ⏳ **Automatic expiry & refunds** — expired bounties are removed and funds refunded to issuers. - 🔒 **Per-issuer limits** — default limit plus permission-based overrides (`playerbounty.limit.X`). - 🌐 **Language files** — editable `langs/en.yml` and `langs/pl.yml` (text + multi-line help). - 🗄️ **Simple YAML storage** — bounties saved in `bounties.yml` for easy backups / editing. --- ## 🛠️ Commands ```txt /playerbounty - Open bounty GUI (default) 📋 /playerbounty create - Create a bounty (player may be offline) 🎯💸 /playerbounty delete - Remove a bounty (issuer or admin) 🗑️ /playerbounty reload - Reload config and language files 🔁 /playerbounty help - Show plugin help ❓ ``` --- ## 🔐 Permissions - `playerbounty.create` — place bounties ✍️ - `playerbounty.menu` — open GUI 🖥️ - `playerbounty.delete` — remove bounties 🗑️ - `playerbounty.admin` — admin actions (remove any bounty) 👑 - `playerbounty.limit.` — override default personal limit (e.g. `playerbounty.limit.5`) 🔢 - `playerbounty.limit.unlimited` — unlimited bounties for issuer ♾️ --- 📦 Installation Install Vault and a Vault-compatible economy plugin (EssentialsX, iConomy, etc.). 💼 Place flyingBounties.jar into your server’s plugins/ folder. 📂 Start the server once — plugin will generate: config.yml, menu.yml, langs/ (en.yml, pl.yml) and bounties.yml. ⚙️ Edit config.yml, menu.yml and langs/*.yml to taste. Use /playerbounty reload to reload language/config without restarting. 🔁 --- ❓ FAQ & Notes Do funds return when a bounty expires? — Yes. Expired bounties are refunded to the issuer (support for offline issuers included). 💸 Does it require Vault? — Yes, Vault is required for proper economy integration and payouts/refunds. 🧩 Can I create a bounty on offline players? — Yes, the plugin stores UUID and will match victims by UUID. 👥 How does stacking work? — When Bounty.Stacked is true, a single kill will claim all active bounties on the target and pay the total reward to the killer. When false, only the oldest bounty is claimed per kill. 🔢 Multilang support — Put/edit translations in langs/en.yml or langs/pl.yml. The plugin loads the locale from config.yml -> settings.locale. 🌐 --- 🖼️ Screenshots  --- 📬 Contact / Support If you need help or want to suggest features, open an issue on the repository or ping me on the project’s Discord.