EzBounty

Professional bounty system plugin for Minecraft servers.

Features

• Interactive GUI - View all bounties in a paginated inventory interface
• Multi-contributor Support - Multiple players can add to the same bounty
• Flexible Storage - Choose between YAML or MySQL storage
• Vault Integration - Full economy support with safe transactions
• Configurable Limits - Set min/max amounts, cooldowns, and tax rates
• Admin Commands - Remove bounties and manage the system

Installation

1. Place EzBounty-1.0.0.jar in your plugins folder
2. Ensure Vault and an economy plugin are installed
3. Restart the server
4. Configure plugins/EzBounty/config.yml as needed

Enable MySQL

To use MySQL storage set storage.type to mysql and configure the storage.mysql section in your config.yml. Example settings:

storage:
	type: mysql
	mysql:
		host: "localhost"
		port: 3306
		database: "ezbounty"
		user: "ezbounty"
		password: "secret"
		max-pool-size: 10
		useSSL: false

Ensure the database user has the required privileges (create/alter/insert/update/select). Restart the server after saving config.yml. The plugin will create or migrate the necessary tables on first run if the database user has sufficient rights.

Commands

• /bounty - Open bounty list GUI
• /bounty create <player> <amount> - Place a bounty
• /bounty add <player> <amount> - Add to existing bounty
• /bounty list - View bounties in chat
• /bounty info <player> - View bounty details
• /bounty remove <player> - Remove a bounty (admin)
• /bounty reload - Reload configuration (admin)

Permissions

• ezbounty.use - View bounties (default: true)
• ezbounty.create - Create bounties (default: true)
• ezbounty.claim - Claim bounties (default: true)
• ezbounty.admin - Admin commands (default: op)
• ezbounty.admin.remove - Remove bounties (default: op)

GUI

• Open: Use /bounty to open the interactive bounty list GUI.
• Features: Paginated list of active bounties, quick-create flow, add to existing bounties, view bounty details, claim handling, and payout history.
• Navigation: Inventory-style buttons for previous/next page, create bounty, and close. Bounties show total amount and top contributors.
• Customization: Titles, page size and items-per-page are configurable (see Configuration Options below).

Configuration Options

Edit plugins/EzBounty/config.yml to change behavior. Important keys:

• Storage: storage.type — yaml or mysql. MySQL settings live under storage.mysql.
• Bounty: bounty.min-amount, bounty.max-amount, bounty.max-total-per-player, bounty.allow-self-bounty, bounty.create-cooldown, bounty.tax-percentage, bounty.announce-create, bounty.announce-collect, bounty.refund-on-ban, bounty.min-add-amount.
• GUI: gui.list.title, gui.list.size, gui.list.items-per-page, gui.create.title, gui.info.title, gui.history.title, gui.history.items-per-page, gui.history.date-format.
• Currency: currency.symbol, currency.symbol-position, currency.decimal-places, currency.thousands-separator, currency.decimal-separator.
• Performance: performance.save-interval, performance.async-save.

Example GUI-related defaults are set in the plugin's config.yml (list size must be a multiple of 9 and items-per-page should leave room for navigation buttons).