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 — Place a bounty
• /recompensa remover — 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_%
• %bounties_top__nome%
• %bounties_top__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; ✨s or invalid deaths are ignored.
• Data is saved to plugins/Bounties/data.yml.