🎯 FrozenBounty

Set bounties. Hunt players. Claim rewards. A fully-featured cross-server bounty system for Paper & Folia servers.

---

✨ Features

• 💰 Bounty System — Players can set money bounties on any other player
• 🖥️ Paginated GUI — Clean 6-row chest GUI showing all active bounties with player skulls
• 🔍 Search — Search bounties by player name directly from the GUI
• 🔃 Sort Modes — Toggle between sorting by highest bounty amount or most recently set
• ✅ Confirmation GUI — 3-row confirm screen before any money is charged
• 💵 Economy Support — Works with Vault (any economy plugin) or FrozenVault
• 🗄️ MySQL Support — Full cross-server bounty sync via MySQL database
• 📄 YAML Fallback — Works out of the box with no database setup required
• ⚡ Folia Ready — Fully compatible with both Paper and Folia schedulers
• 🏷️ Hex Colors — All messages and GUIs use rich hex color formatting

---

📸 Preview

Bounty List GUI	Confirm GUI
Paginated player skulls sorted by amount or time	3-slot confirm/cancel screen before charging

---

📋 Commands

Command	Description
/bounty	Open the bounty list GUI
/bounties	Alias for /bounty
/bounty add <player> <amount>	Place a bounty on a player
/bounty <player>	Check a specific player's bounty

---

🔑 Permissions

Permission	Description	Default
frozenbounty.use	Access to all bounty commands and GUI	true
frozenbounty.admin	Admin permissions	op

---

⚙️ Configuration

# FrozenBounty Configuration

# Economy type: 'vault' or 'frozenvault'
economy:
  type: vault

# MySQL settings (enable for cross-server bounty sync)
mysql:
  enabled: false
  host: localhost
  port: 3306
  database: frozenbounty
  username: root
  password: ''
  pool-size: 10

---

🔗 Dependencies

Dependency	Type	Notes
Vault	Soft	Required if economy.type: vault
FrozenVault	Soft	Required if economy.type: frozenvault

---

🖥️ Compatibility

	Supported
Paper	✅ 1.21 – 1.21.x
Folia	✅ 1.21 – 1.21.x
Java	✅ Java 21+

---

📦 Cross-Server Setup

Enable MySQL in config.yml and point all your servers to the same database — bounties will sync instantly across your entire network.

mysql:
  enabled: true
  host: your.database.host
  port: 3306
  database: frozenbounty
  username: youruser
  password: yourpassword

---

🧑‍💻 Author

Made with ❤️ by DrFrozenXD — part of the FrozenStudio plugin suite.