🎯 BountyPlugin Ultimate

⚡ The Ultimate GUI-Driven Hitman Experience for PaperMC 1.21+

🕒 Short Description (Quick & Easy Overview)

BountyPlugin Ultimate is an advanced, fully GUI-based item bounty plugin for Minecraft servers. It allows players to wager any item from their hand—including enchanted weapons, custom gear, and rare collectibles—to put a price on an enemy's head.

Secure Claim Vault: Rewards never drop on the ground upon a kill. They are safely transferred to a private virtual vault for the killer to collect.

Dynamic Item Lore: Hovering over a target's head on the board shows a beautifully formatted list of the exact item rewards up for grabs.

100% Anti-Exploit: Built-in safeguards completely block self-bounties and securely save items during custom menu interactions.

No Server Lag: Built on a lightweight native YAML serialization system to keep your server running flawlessly.

📜 Long Description (Full Guide & Every Feature)

BountyPlugin Ultimate turns combat on your server into a thrilling, high-stakes hitman economy. It is perfect for Survival, Factions, RPG, or PvP servers. Here is exactly how the entire GUI ecosystem works, how to manage your contracts, and how your rewards are secured!

🖥️ The Bounty GUI Ecosystem

🎮 Main Bounty Board

The central hub displaying all active contracts currently out on the server.

How it looks: A sleek, modern interface framed with dark gray stained glass panes and centered navigational buttons.

Dynamic Lore: Targets are displayed as player heads. Hovering over a head reveals their status as "WANTED" alongside a clean, custom-rendered list showing the name and stack amount of every single item in their reward pool.

🟢 Place a Bounty Menu (GUI 1) The streamlined interface used to put a contract out on any player.

Mechanism: Displays a head for every player who has ever joined the server. Clicking a head opens a secure 27-slot setup inventory.

Easy Setup: Simply drop the items you want to offer as a reward into the menu and close it. The plugin instantly locks them in, creates the contract, and broadcasts it.

Safety Net: Features an automated check that prevents players from clicking their own head.

🔴 My Bounties Menu (GUI 2) A dedicated menu designed to help players easily track and manage their personal investments.

Mechanism: Displays only the active bounties that you have personally placed.

Instant Refund: Clicking a player's head inside this menu immediately cancels the contract and safely deposits all of your original reward items back into your inventory.

💰 Your Claims Menu (GUI 3) The ultimate virtual blood-money vault.

Mechanism: When you eliminate a bounty target, their reward pool does not drop into the world where thieves or teammates can steal it. Instead, it is instantly routed here.

Persistent Storage: If your inventory is full, you can grab what you need and close the menu. The remaining items stay safely stored in the config memory until your next visit.

🛡️ Threat Warnings & Anti-Exploit Protection

Live & Offline Notifications: The moment a bounty is placed on a player, they receive a critical chat warning. If they are offline, the system queues the message and alerts them the exact second they log back into the server. (Fully toggleable in the config.yml).

No Self-Bounties: Players are strictly blocked from putting bounties on themselves via commands or menus, keeping your server's competitive environment fair.

NBT & Custom Item Safe: The plugin natively preserves item metadata. Custom names, lore text, enchantments, and CustomModelData attributes from other plugins will remain 100% intact.

🔧 Commands & Setup

Compatibility: Optimized for PaperMC 1.21+ and compiled utilizing Java 21+. Features full native Tab-Completion suggestions as you type.

Player Commands:

/bounty — Opens the main Bounty Board.

/bounty info — Displays the command syntax and a quick help guide.

/bounty set <player> — Instantly sets the item in your main hand as a bounty on a target.

/bounty remove <player> — Cancels your active bounty on a player and refunds your items.

Admin Commands:

/bounty clear <player> — Forcefully wipes a contract from the board and deletes the reward items.

Permission needed: bounty.admin