PlayerLevels+

✦ 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

- Standalone — mining, combat, fishing, farming, breeding, trading, enchanting, taming, and more - Standalone — open with `/level`, shows your level, XP bar, progress, and stats - Standalone — give items, run commands, or send messages at any level you choose - Standalone — Linear, Exponential, or Stepped — control exactly how hard each level is to reach - Standalone — reward donors or ranked players with 2x, 3x, 5x XP boosts - Standalone — `/leaderboard` shows the top 10 players by level - Standalone — give XP, set levels, reset players, and reload config live - Standalone — 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.*