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