FoBounty

!Cover Image Let players put money on targets, hunt bounties, and claim Money rewards through a clean in-game bounty system using Vault.

FoBounty adds a player-driven bounty loop for survival, SMP, factions, and PvP servers. Players can set bounties with /bounty add, browse active targets in a GUI, track claim history, and get paid automatically when a bounty is claimed.

!Main bounty GUI

Features

• Let players create bounties with server economy money through Vault.
• Pay killers automatically when they claim an active bounty.
• Browse active targets in a 54-slot GUI with bounty totals, contributors, pagination, refresh, search, and filters.
• Sort bounties by newest, oldest, highest, or lowest so players can find the best target quickly.
• Track claim and loss history in chat or a dedicated history GUI.
• Store active bounties, contribution data, earned totals, and history in SQLite.

!Showing lore of skull in GUI

Admin Tools

• Edit key settings from an admin GUI, including min/max bounty price, natural death behavior, announcements, anti-abuse options, update checker, and history cap.
• Remove active bounties with an admin command.
• Reload config.yml and message.yml without restarting the server.
• Block suspicious bounty claims by same IP, same subnet, or same FoTeams team.

!Admin Editor GUI

Integrations

• Vault - Handles economy withdrawals and bounty payouts.
• PlaceholderAPI - Optional, adds placeholders for current bounty and total earned values.
• Discord webhooks - Optional embed notifications for bounty creation, admin removal, and bounty claims.
• FoTeams - Optional same-team claim blocking when FoTeams is installed.
• SQLite - Local persistence for bounties, contributors, earned totals, and history, shaded inside plugin, no need to add seperately.

!Discord Webhook Showcase

Dependencies

• Vault and a Vault-compatible economy plugin are needed for bounty payments.
• PlaceholderAPI is optional for placeholders.
• FoTeams is optional for same-team claim blocking.
• Built for Minecraft server API 1.21.

Commands

• /fobounty or /bounty - Open the main bounty GUI.
• /fobounty add <player> <amount> or /bounty add <player> <amount> - Place money on a target.
• /fobounty history [player] or /bounty history [player] - View bounty history.
• /fobountyadmin editor or /bountyadmin editor - Open the admin editor.
• /fobountyadmin remove <player> or /bountyadmin remove <player> - Remove a player's active bounty.
• /fobountyadmin reload or /bountyadmin reload - Reload config and messages.
• /fobountyadmin version or /bountyadmin version - Show the installed plugin version.

Permissions

• fobounty.use - Use player commands and the bounty GUI. Default: everyone.
• fobounty.admin - Use admin commands and admin tools. Default: operators.

Optional Discord webhooks, PlaceholderAPI placeholders, and FoTeams claim protection are available for servers that want more automation around bounty activity.

Placeholders

• %fobounty_total_earned%
• %fobounty_total_earned_formatted%
• %fobounty_current_bounty%
• %fobounty_current_bounty_formatted%