✦ PlayerLevels

A clean, lightweight progression system that makes every action feel rewarding.

PlayerLevels adds a fully configurable leveling system to your server. Players earn XP just by playing — mining, fighting, fishing, farming, enchanting — and level up to unlock rewards you define. No bloat, no required dependencies, no complicated setup. Drop it in and it works.

✨ Features

• XP from everything — mining, combat, fishing, farming, breeding, trading, enchanting, taming, and more
• Beautiful GUI — open with /level, shows your level, XP bar, progress, and stats
• Fully configurable rewards — give items, run commands, or send messages at any level you choose
• 3 formula types — Linear, Exponential, or Stepped — control exactly how hard each level is to reach
• Permission-based XP multipliers — reward donors or ranked players with 2x, 3x, 5x XP boosts
• Leaderboard — /leaderboard shows the top 10 players by level
• Admin commands — give XP, set levels, reset players, and reload config live
• Auto-save — data saves every 5 minutes and on shutdown, no data loss
• Standalone — zero dependencies, works on any Paper 1.21+ server

📖 How It Works

Players earn XP by doing normal gameplay activities. When enough XP is collected, they level up — a sound plays, a message appears, and any configured rewards for that level are granted automatically.

The amount of XP needed per level is controlled by your chosen formula:

| Formula | How it scales |
|---|---|
| LINEAR | Steady increase — each level costs a little more than the last |
| EXPONENTIAL | Slow start, steep later — great for long-term servers |
| STEPPED | You define the exact XP cost for every level |

🎮 Commands

| Command | Description |
|---|---|
| /level | Open your level GUI |
| /level <player> | View another player's level |
| /leaderboard | View the top 10 players |
| /leveladmin give <player> <xp> | Give a player XP |
| /leveladmin set <player> <level> | Set a player's level |
| /leveladmin reset <player> | Reset a player's progress |
| /leveladmin info <player> | View detailed stats |
| /leveladmin reload | Reload config without restarting |

🔑 Permissions

| Permission | Description | Default |
|---|---|---|
| playerlevels.use | Use /level | everyone |
| playerlevels.leaderboard | Use /leaderboard | everyone |
| playerlevels.admin | All admin commands | op |
| playerlevels.multiplier.2x | 2x XP multiplier | false |
| playerlevels.multiplier.3x | 3x XP multiplier | false |
| playerlevels.multiplier.5x | 5x XP multiplier | false |
| playerlevels.bypass.max | Level past the max | false |

⚙️ Configuration Highlights

Everything is configurable in config.yml:

• XP amounts per source (set any to 0 to disable it)
• Max level (or set to -1 for unlimited)
• Level-up broadcast message
• Rewards at any level — items, commands, messages
• GUI appearance
• All plugin messages and colors (supports & codes and &#RRGGBB hex)

📦 Installation

1. Download PlayerLevels.jar
2. Drop it into your plugins/ folder
3. Restart your server
4. Edit plugins/PlayerLevels/config.yml to configure rewards, XP values, and formulas
5. Run /leveladmin reload to apply changes without restarting

Requirements: Paper 1.21+ (no other plugins needed)

🆚 Why PlayerLevels?

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 — 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.

🐛 Issues / Suggestions

Found a bug or have a feature request? Open an issue on the GitHub page and I'll look at it.

Made with ❤️ for the Minecraft server community.