Bounties

A lightweight and modular bounty system for PvP servers. Players can place money bounties on others; killers get paid automatically on a valid kill. Includes GUI, PlaceholderAPI, growth over time, anti-abuse, and flexible messages.

Requirements - Paper 1.21.x (Java 21) - Vault (required) - Economy plugin compatible with Vault (e.g., EssentialsX Economy) - PlaceholderAPI (optional)

Key Features - Bounties with economy integration (Vault) - GUI “Most Wanted” with pagination (Next/Previous) - Bounty growth over time (configurable percent + interval) - Anti-abuse: cooldown per killer→target and optional same-IP block - Limits: minimum bounty, per-target cap, per-player-per-day cap - Dynamic PlaceholderAPI placeholders (top and per-player) - Fully configurable messages and broadcasts (global or permission-based) - Persistent storage in YAML

Commands - /recompensa <player> <amount> — Place a bounty - /recompensa remover <player> — Admin remove a bounty - /recompensa recarregar — Reload configuration - /recompensas — Open the Most Wanted GUI

Permissions - bounties.create — Place bounties - bounties.gui — Open GUI - bounties.admin.remove — Remove bounties (admin) - bounties.admin.reload — Reload plugin (admin) - bounties.broadcast — Receive permission-based broadcasts (if enabled)

Placeholders (PlaceholderAPI) - %bounties_valor_em_mim% - %bounties_valor_<player>% - %bounties_top_<n>_nome% - %bounties_top_<n>_valor% - Note: Top placeholders are lightly cached (~10s) to reduce recalculation.

GUI - Title: “Mais Procurados” (Most Wanted) - Shows top players with bounties as player heads, name and bounty amount - Pagination for >54 targets - Clicks are protected; navigation via arrows

Config Highlights - settings.minimum-bounty: minimum amount to place - settings.payout.cooldown-seconds: per killer→target cooldown - settings.payout.block-same-ip: prevent same-IP payouts - settings.growth.enabled / interval-seconds / percent-per-interval / only-online / max-amount - settings.limits.max-per-bounty: cap per target - settings.limits.per-player-per-day: cap per player/day - settings.broadcast.enabled / mode: global|permission / permission

Installation 1. Place `Vault` and an economy plugin in `plugins/`. 2. Drop `Bounties.jar` in `plugins/`. 3. (Optional) Install `PlaceholderAPI`. 4. Restart the server. 5. Edit `plugins/Bounties/config.yml` to your needs and `/recompensa recarregar`.

Notes - All currency formatting follows the server locale. - This plugin focuses on PvP bounty rewards; suicides or invalid deaths are ignored. - Data is saved to `plugins/Bounties/data.yml`.