EaBounties

EaBounties

A lightweight, GUI-first Bounty plugin for Spigot & Paper (1.8 – 1.21+)

Version: 1.0.0 | Java: 17+ | Author: Ea

Overview

EaBounties is a modern, dependency-light bounty system inspired by NotBounties. Players and staff can manage everything directly through interactive chest GUIs—or via classic commands with tab-completion—using either
Vault economy or built-in
Player Experience (EXP) as a fallback.

• Multi-Version Support (1.8 – 1.20+ / 1.21+): Built without fragile NMS code, using safe material, sound, and player-head compatibility wrappers.
• Flexible Economy: Soft-depends on Vault (VAULT mode) with an automatic or configurable fallback to exact Experience Points (EXP mode).
• Stackable Bounties: Multiple players can contribute to the same target's head; all contributions and contributors are tracked and displayed.
• Automatic Kill Payouts: Eliminating a bountied player automatically awards the full accumulated bounty to the killer (self-kills are ignored) and optionally broadcasts it server-wide.
• Async YAML Storage: Bounties are cached in memory and saved asynchronously to bounties.yml (with synchronous save on shutdown).
• Hex & Legacy Colors: Supports standard & color codes and &#RRGGBB Hex colors (1.16+). (<Default messages in config.yml are in Spanish and fully editable.>)

100% Menu-Driven Experience

No need to memorize command syntax—running
/bounty or
/ba opens the full interactive menu suite:

• Active Bounties Menu: Paginated 54-slot chest GUI displaying player heads, total bounty, and contributor breakdown.
• Left-Click a head to add more to that player's bounty.
• Right-Click / Shift-Click a head (Admin) to remove the bounty via a confirmation GUI (no refund).
• Online Player Selector: Paginated head menu to pick any online target.
• Interactive Amount Selector: Adjust bounties with quick buttons (-5,000 / -1,000 / -100 / -50 | +50 / +100 / +1,000 / +5,000) or click Write Amount in Chat to type an exact value.
• Top Bounties Menu: Visual leaderboard showcasing up to the top 28 highest active bounties.
• Admin Panel: Add free bounties without spending money, remove active bounties, or reload config.yml in one click.
• Anti-Theft Protection: All GUI clicks and item drags are strictly blocked using custom InventoryHolder validation.

Commands & Permissions

Player Commands (
bounties.use — default:
true)

Aliases: /bounties, /recompensa, /recompensas

Code (Text):

/bounty                         - Opens the interactive Bounties GUI

/bounty add <player> <amount>   - Places or adds to a player's bounty

/bounty list | gui | menu       - Opens the Active Bounties GUI

/bounty top                     - Opens the Top Bounties GUI (chat list in console)

/bounty help                    - Shows the help menu

Admin Commands (
bounties.admin — default:
op)

Aliases: /ba, /eba

Code (Text):

/ba                             - Opens the interactive Admin Panel GUI

/ba add <player> <amount>       - Adds a free bounty on a player

/ba remove <player>             - Removes an active bounty without refund

/ba reload                      - Reloads config.yml and economy hook

/ba help                        - Shows admin help

Requirements & Installation

• Java 17 or newer.
• Spigot / Paper server running Minecraft 1.8 – 1.21+.
• (Optional) Vault + an Economy provider (such as EssentialsX) for currency support; otherwise set economy.type: "EXP" or let EaBounties fall back to EXP automatically.
• Drop EaBounties-1.0.0.jar into your /plugins folder and restart your server.

Configuration (config.yml)

Spoiler: Click to view default config.yml

Code (YAML):

economy:

  type
:
"VAULT"

  currency-symbol
:
"$"

  exp-suffix
:
" EXP"

bounty-limits:

  minimum
: 50.0

  maximum
: 1000000.0

broadcast-bounty-add
: true

broadcast-bounty-claim
: true

top-bounties-limit
: 10

gui:

  title
:
"&8Recompensas Activas (&e%page%&8/&e%total_pages%&8)"

  head-name
:
"&c&l%target%"

  head-lore
:
   -
"&7----------------------------"

    - "&eRecompensa Acumulada
:
&a%amount%"

    -
"&ePuesta por:"

    -
"%contributors%"

    -
"&7----------------------------"

    -
"&a¡Mata a este objetivo para cobrar!"