🚀 ExoLevels

ExoLevels is a lightweight, modern, and highly customizable leveling + quest system built for performance-focused Minecraft servers. Reward players for their actions, keep them engaged with quests, and fully control progression with flexible configuration.

---

✨ Features

📊 Dynamic XP System

Reward players for almost any action:

• Mining & block breaking
• Killing mobs (including bosses)
• Placing blocks
• Exploring & traveling

---

🎯 Built-in Quest System

• Create custom quests with GUI support
• Track player progress in real-time
• Reward completion with XP

---

📈 Fully Customizable Leveling

• Define your own XP curve
• Control level progression in levels.yml
• Balance your server exactly how you want

---

🏗️ Decimal XP Support

Fine-tune rewards with precision:

• Example: 0.5 XP per block mined

---

🎵 Sound Customization

• Customize level-up sounds
• Customize quest completion sounds
• Or disable sounds completely

---

💾 Efficient Data Storage

• Uses SQLite for fast and reliable local storage

---

🔗 PlaceholderAPI Support

Easily integrate with scoreboards, chat, and tablists:

• %exo_player_xp%
• %exo_player_level%
• %exo_xp_needed%

---

🛠️ Commands & Permissions

Command	Aliases	Description	Permission
/exolevels	el, exo, exolevel	Main help command	None
/exolevels quests	q, /quests	Open quests GUI	None
/exolevels level [player]	lvl, /level	View level	None / exolevels.admin
/exolevels xp [player]	/xp	View XP	None / exolevels.admin
/exolevels reload	—	Reload configs	exolevels.admin
/exolevels xp <add|set|take> <player> <amount>	—	Manage XP	exolevels.admin
/exolevels reset <player>	—	Reset player data	exolevels.admin

---

🧩 Placeholders

Use with PlaceholderAPI:

• %exo_player_xp% → Current XP
• %exo_player_level% → Current level
• %exo_xp_needed% → XP needed for next level

---

💻 Developer API

Integrate ExoLevels into your own plugins:

import org.notainamx.exolevels.ExoLevels;
import org.notainamx.exolevels.manager.PlayerManager;

PlayerManager playerManager = ExoLevels.getInstance().getPlayerManager();

// Add XP
playerManager.addXp(player, 50.5, "CustomSource");

// Get data
PlayerData data = playerManager.getPlayerData(player.getUniqueId());
double xp = data.getXp();
int level = data.getLevel();