# \u2726 PlayerLevels<\/p>\n
> **A clean, lightweight progression system that makes every action feel rewarding.**<\/p>\n
PlayerLevels adds a fully configurable leveling system to your server. Players earn XP just by playing \u2014 mining, fighting, fishing, farming, enchanting \u2014 and level up to unlock rewards you define. No bloat, no required dependencies, no complicated setup. Drop it in and it works.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– **XP from everything** \u2014 mining, combat, fishing, farming, breeding, trading, enchanting, taming, and more
\n– **Beautiful GUI** \u2014 open with `\/level`, shows your level, XP bar, progress, and stats
\n– **Fully configurable rewards** \u2014 give items, run commands, or send messages at any level you choose
\n– **3 formula types** \u2014 Linear, Exponential, or Stepped \u2014 control exactly how hard each level is to reach
\n– **Permission-based XP multipliers** \u2014 reward donors or ranked players with 2x, 3x, 5x XP boosts
\n– **Leaderboard** \u2014 `\/leaderboard` shows the top 10 players by level
\n– **Admin commands** \u2014 give XP, set levels, reset players, and reload config live
\n– **Auto-save** \u2014 data saves every 5 minutes and on shutdown, no data loss
\n– **Standalone** \u2014 zero dependencies, works on any Paper 1.21+ server<\/p>\n
—<\/p>\n
## \ud83d\udcd6 How It Works<\/p>\n
Players earn XP by doing normal gameplay activities. When enough XP is collected, they level up \u2014 a sound plays, a message appears, and any configured rewards for that level are granted automatically.<\/p>\n
The amount of XP needed per level is controlled by your chosen formula:<\/p>\n
| Formula | How it scales |
\n|—|—|
\n| `LINEAR` | Steady increase \u2014 each level costs a little more than the last |
\n| `EXPONENTIAL` | Slow start, steep later \u2014 great for long-term servers |
\n| `STEPPED` | You define the exact XP cost for every level |<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands<\/p>\n
| Command | Description | —<\/p>\n ## \ud83d\udd11 Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## \u2699\ufe0f Configuration Highlights<\/p>\n Everything is configurable in `config.yml`:<\/p>\n – XP amounts per source (set any to `0` to disable it) —<\/p>\n ## \ud83d\udce6 Installation<\/p>\n 1. Download `PlayerLevels.jar` **Requirements:** Paper 1.21+ (no other plugins needed)<\/p>\n —<\/p>\n ## \ud83c\udd9a Why PlayerLevels?<\/p>\n Most leveling plugins are either abandoned, require Vault, have terrible configs, or are stuffed with features you’ll never use. PlayerLevels does one thing and does it well \u2014 clean progression that works out of the box and is easy to customize. The config is fully annotated so you always know what each value does.<\/p>\n —<\/p>\n ## \ud83d\udc1b Issues \/ Suggestions<\/p>\n Found a bug or have a feature request? Open an issue on the GitHub page and I’ll look at it.<\/p>\n —<\/p>\n *Made with \u2764\ufe0f for the Minecraft server community.*<\/p>\n","protected":false},"excerpt":{"rendered":" player progression plugin that rewards XP for everyday gameplay<\/p>\n","protected":false},"featured_media":122747,"template":"","meta":{"_minecraft_slug":"playerlevels+","_minecraft_project_id":"25EKklm8","_minecraft_author":"veberyotam","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":6,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playerlevels+.zip","_minecraft_size_bytes":40165,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:24:55.160658Z","_minecraft_date_created":"2026-04-29T01:53:24.061830Z","_minecraft_date_modified":"2026-04-18T17:42:16.531109Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playerlevels+","_minecraft_icon_attachment_id":122747,"_minecraft_imported_at":"2026-06-07T05:14:31+00:00","_minecraft_import_hash":"2d300b2796a004c2fd9de0b8d18f9793","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,126,127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-122746","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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
\n|—|—|
\n| `\/level` | Open your level GUI |
\n| `\/level
\n| `\/leaderboard` | View the top 10 players |
\n| `\/leveladmin give
\n| `\/leveladmin set
\n| `\/leveladmin reset
\n| `\/leveladmin info
\n| `\/leveladmin reload` | Reload config without restarting |<\/p>\n
\n|—|—|—|
\n| `playerlevels.use` | Use `\/level` | everyone |
\n| `playerlevels.leaderboard` | Use `\/leaderboard` | everyone |
\n| `playerlevels.admin` | All admin commands | op |
\n| `playerlevels.multiplier.2x` | 2x XP multiplier | false |
\n| `playerlevels.multiplier.3x` | 3x XP multiplier | false |
\n| `playerlevels.multiplier.5x` | 5x XP multiplier | false |
\n| `playerlevels.bypass.max` | Level past the max | false |<\/p>\n
\n– Max level (or set to `-1` for unlimited)
\n– Level-up broadcast message
\n– Rewards at any level \u2014 items, commands, messages
\n– GUI appearance
\n– All plugin messages and colors (supports `&` codes and `&#RRGGBB` hex)<\/p>\n
\n2. Drop it into your `plugins\/` folder
\n3. Restart your server
\n4. Edit `plugins\/PlayerLevels\/config.yml` to configure rewards, XP values, and formulas
\n5. Run `\/leveladmin reload` to apply changes without restarting<\/p>\n