FlyingBounties

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

/playerbounty                       - Open bounty GUI (default) 📋
/playerbounty create <player> <amt> - Create a bounty (player may be offline) 🎯💸
/playerbounty delete <id>           - 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.<n> — 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.