A powerful and lightweight Paper plugin that tracks each player’s **lifetime XP** and executes **custom rewards** when XP milestones are reached.
\nFully configurable, translation-ready, and built for modern Paper servers (1.21+).<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– **Global Total XP Tracking** \ud83d\udcc8
\n – Tracks XP from killing mobs, mining, **and** vanilla commands (`\/xp`, `\/experience`).
\n – Never resets, even after death.
\n – **Async Caching**: High-performance data handling prevents server lag.
\n– **BossBar Progress System** \ud83d\udcca
\n – Displays a customizable BossBar showing progress to the next rank.
\n – **Dynamic Mode**: Auto-hides the bar when not gaining XP.
\n – **Rich Text support**: Supports **MiniMessage** (Gradients, RGB) AND Legacy Color Codes (`&a`) simultaneously!
\n– **Reward System** \ud83c\udf81
\n – Execute multiple commands when reaching a threshold.
\n – Send custom broadcast messages.
\n – Supports **Minecraft Target Selectors** in commands (e.g., `@a`, `@p`).
\n– **Full Customization** \ud83d\udee0\ufe0f
\n – **PlaceholderAPI** support.
\n – Complete language control via `lang.yml` (including “Max Rank” text).
\n – **SQLite** storage with automatic schema migration (external apps can read `current_rank`).<\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Download the latest release from the **Releases** page.
\n2. Drop the `.jar` file into your server’s `plugins` folder.
\n3. Start the server to generate config files.
\n4. Adjust `config.yml` and `lang.yml` to your liking.
\n5. Restart or run:
\n “`
\n \/txp reload
\n “`<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### `config.yml` (example)<\/p>\n
“`yaml rewards: “50000”: —<\/p>\n ## \ud83e\udde9 Placeholders<\/p>\n Available for use in **Chat**, **Broadcasts**, and **BossBar**:<\/p>\n | Placeholder | Description | —<\/p>\n ## \ud83d\udd27 Commands<\/p>\n | Command | Description | Permission | —<\/p>\n ## \ud83d\udcbe Storage<\/p>\n XP and reward history are stored via **SQLite**, located in: **External Access**: —<\/p>\n ## \ud83e\udde9 Plugin Support<\/p>\n – **LuckPerms** (for rank rewards) The plugin does not depend on them but integrates automatically if installed.<\/p>\n —<\/p>\n ## \ud83d\udee1\ufe0f Disclaimer<\/p>\n This plugin was developed with the assistance of **Google DeepMind’s AI**. —<\/p>\n ## \ud83d\udcc4 License<\/p>\n This project is licensed under the **MIT License**. —<\/p>\n ## \ud83e\udd1d Contributing<\/p>\n Pull requests and feature suggestions are welcome! —<\/p>\n ## \u2b50 Support the Project<\/p>\n If you enjoy this plugin, consider leaving a star on GitHub \u2014 it helps a lot!<\/p>\n","protected":false},"excerpt":{"rendered":" Track lifetime XP and trigger custom rewards! Includes a dynamic BossBar system.<\/p>\n","protected":false},"featured_media":158127,"template":"","meta":{"_minecraft_slug":"total-xp-rewards","_minecraft_project_id":"QrphsAHI","_minecraft_author":"CelduinX","_minecraft_license":"MIT","_minecraft_downloads":45,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"total-xp-rewards.zip","_minecraft_size_bytes":118382,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T21:30:38.502555Z","_minecraft_date_created":"2025-12-10T01:08:55.094860Z","_minecraft_date_modified":"2025-12-08T07:48:34.275548Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/total-xp-rewards","_minecraft_icon_attachment_id":158127,"_minecraft_imported_at":"2026-06-09T13:30:53+00:00","_minecraft_import_hash":"39e2a3e1f62aeb884afaf99c6f21158e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-158126","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nbossbar:
\n enabled: true
\n # Hybrid Support: Mix Legacy (&) and MiniMessage (
\n title: “&bCurrent Rank: &e%current_rank% &7|
\n color: BLUE
\n style: SOLID
\n dynamic-mode: true # Bar appears on XP gain and hides after timeout
\n timeout: 10<\/p>\n
\n “1000”:
\n name: “
\n commands:
\n – “give %player% diamond 1”
\n – “eco give %player% 250”
\n broadcast: “&a%player% reached %threshold% XP (Novice)!”<\/p>\n
\n name: “Master”
\n commands:
\n – “give %player% netherite_ingot 1”
\n broadcast: “&6%player% is now a Master!”
\n“`<\/p>\n
\n| :— | :— |
\n| `%player%` | Player’s name |
\n| `%xp%` | Player’s total lifetime XP |
\n| `%current_rank%` | Name of the current rank (e.g. “Novice”) |
\n| `%next_rank%` | Name of the next rank (e.g. “Master”) |
\n| `%required_xp%` | XP required for the next rank |
\n| `%threshold%` | The specific threshold reached (Rewards only) |<\/p>\n
\n| :— | :— | :— |
\n| `\/txp get
\n| `\/txp show` | Show your BossBar | `totalxp.use` |
\n| `\/txp hide` | Hide your BossBar | `totalxp.use` |
\n| `\/txp set
\n| `\/txp reset
\n| `\/txp reload` | Reload config & language | `totalxp.admin` |<\/p>\n
\n`plugins\/TotalXPRewards\/database.db`<\/p>\n
\nThe database now includes a `current_rank` and `username` column, making it easy to integrate with web leaderboards (e.g. Node.js apps).<\/p>\n
\n– **Vault** (for economy)
\n– **PlaceholderAPI** (for extra placeholders)<\/p>\n
\nAll code and design decisions were reviewed and finalized manually.<\/p>\n
\nYou are free to use, modify, and contribute.<\/p>\n
\nFeel free to open an issue if you encounter bugs or have ideas.<\/p>\n