LexBounty

LexBounty is a professional bounty system for Paper 1.21+, built to work perfectly on both single servers and large multi-server networks. It allows players to place bounties on other players using Vault economy, automatically tracks and ranks the highest bounties in a clean Top Bounties menu, and pays out rewards only when the target is killed by a real player. In local mode (multi-server disabled), LexBounty stores everything in

plugins/LexBounty/data/bounty.yml

, making it lightweight and easy to run without any external services. In network mode (multi-server enabled), LexBounty uses MySQL as the source of truth for all bounty data and Redis to broadcast cross-server events, ensuring that bounty updates and player notifications are delivered instantly even if players are on different servers. If a player dies to mobs, fall damage, or any non-player cause, the bounty remains unchanged; only a player kill triggers the payout and resets the bounty, preventing abuse and keeping the system fair.

2) Commands

/bounty add <player> <amount> — Place or increase a bounty on a player (uses Vault to withdraw money from the sender).
/bounty remove <player> <amount> — Remove/decrease a bounty from a player (admin only).
/bounty — Open the Top Bounties GUI.
/bounty reload — Reload configuration/messages and reconnect services if needed (admin only).

3) Permissions

lexbounty.admin — default: op
- Allows admin actions such as /bounty remove and /bounty reload.
lexbounty.protected — default: op
- Players with this permission cannot have bounties placed on them by anyone.

4) Dependency

- Vault

5) Tutorial

1 - Install LexBounty on every Paper 1.21+ server where you want the bounty system to be available.

2 - Restart each server once to generate the plugin files and the data folder.

3 - If you want single-server mode only, disable multi-server mode in the config and make sure the plugin stores data locally in plugins/LexBounty/data/bounty.yml.

4 - If you want multi-server mode, enable multi-server mode in the config.

5 - Enter your MySQL credentials in the config so LexBounty can store and read bounty data from the database.

6 - Enter your Redis credentials in the config so LexBounty can broadcast events and notify players across servers.

7 - Make sure all servers in the network use the same MySQL database and the same Redis instance for consistent syncing.

8 - Restart all servers to connect to MySQL and Redis and enable cross-server notifications and updates.

By LExtremeTY