LevelSystemAPI

A powerful and modular Level & XP API for Minecraft (Spigot/Paper).
Plug & Play – zero boilerplate for other plugin developers.

---

Quick Start (für Plugin-Entwickler)

// Minimal – fertig
LevelAPI api = LevelAPI.get();
api.addXP(player, 25);

// Mit Source-Tracking
api.addXP(player, 100, XPSource.MOB_KILL);

// Skill XP
Skill mining = api.getSkill("mining");
api.addXP(player, mining, 20, XPSource.ORE_MINE);

// Player-Daten lesen
LevelPlayer lp = api.getPlayer(player);
lp.getLevel();          // globales Level
lp.getXP();             // globale XP
lp.getLevel(mining);    // Skill-Level

---

Events

@EventHandler
public void onLevelUp(LevelUpEvent event) {
    Player p = event.getPlayer();
    int newLevel = event.getNewLevel();

    if (event.isSkillLevelUp()) {
        Skill skill = event.getSkill(); // nicht-null bei Skill-Level-Up
    }
}

@EventHandler
public void onXPGain(XPGainEvent event) {
    // XP-Booster
    event.setAmount(event.getAmount() * 2);

    // Blocken
    if (event.getSource() == XPSource.BLOCK_BREAK) {
        event.setCancelled(true);
    }
}

---

Rewards registrieren

LevelAPI api = LevelAPI.get();

// Für jeden Level-Up
api.registerReward(event -> {
    if (event.getNewLevel() % 10 == 0) {
        event.getPlayer().sendMessage("§6Milestone! Level " + event.getNewLevel());
    }
});

// Für einen bestimmten Level
api.registerReward(50, event -> {
    giveItem(event.getPlayer(), new ItemStack(Material.DIAMOND, 5));
});

---

Level-Formel anpassen

In config.yml:

level-formula: "100 * level^2"

Oder programmatisch:

api.setLevelFormula(level -> 100L * level * level);
api.setLevelFormula(LevelFormula.CLASSIC);   // Minecraft-Stil
api.setLevelFormula(LevelFormula.LINEAR);    // 100 × level

---

Skill-System

// Eigenen Skill registrieren
Skill woodcutting = new Skill("woodcutting", "Woodcutting", LevelFormula.MODERATE, 50);
api.registerSkill(woodcutting);

// XP hinzufügen
api.addXP(player, woodcutting, 30, XPSource.BLOCK_BREAK);

// Status abfragen
lp.getLevel(woodcutting);
lp.getXP(woodcutting);

---

PlaceholderAPI

Placeholder	Beschreibung
%levelsystem_level%	Globales Level
%levelsystem_xp%	Aktuelle XP
%levelsystem_xp_required%	XP für nächstes Level
%levelsystem_xp_to_next%	Fehlende XP
%levelsystem_progress%	Fortschritt in %
%levelsystem_multiplier%	Aktiver Multiplikator
%levelsystem_skill_mining_level%	Skill-Level
%levelsystem_skill_mining_xp%	Skill-XP

---

config.yml Übersicht

max-level: 100
level-formula: "100 * level^2"

xp:
  kill-mob: 10
  break-block: 2
  mine-ore: 8
  fish-catch: 15

multipliers:
  default: 1.0
  vip: 2.0        # Permission: levelsystem.xp.multiplier.vip
  mvp: 3.0

storage:
  type: sqlite    # sqlite | mysql | mariadb
  redis:
    enabled: false

skills:
  enabled: true
  list: [ mining, combat, fishing, farming, crafting ]

anti-exploit:
  enabled: true
  xp-cooldown-ms: 500
  max-xp-per-minute: 500

---

Commands

Command	Beschreibung
/level info [player]	Level-Status anzeigen
/level set <player> <level>	Level setzen (Admin)
/level reset <player>	Level zurücksetzen
/xp add <player> <amount> [source]	XP hinzufügen
/xp remove <player> <amount>	XP entfernen
/xp set <player> <amount>	XP setzen
/skill info <skill> [player]	Skill-Status
/skill set <skill> <player> <level>	Skill-Level setzen

---

Storage

Backend	Config	Beschreibung
SQLite	type: sqlite	Default, kein Setup
MySQL	type: mysql	Produktiv, multi-server
MariaDB	type: mariadb	Wie MySQL
Redis	redis.enabled: true	Cache + Cross-Server Sync

---

Architektur

LevelPlugin (onEnable)
 ├── LevelConfig         → config.yml parsen
 ├── StorageProvider     → SQLite / MySQL / Redis
 ├── UIManager           → Actionbar, Title, Sound, BossBar
 ├── AntiExploit         → Cooldowns, Caps, Pattern Detection
 ├── LevelAPI            → zentrale Logik, Player-Cache
 │    ├── LevelPlayer    → gecachter Spielerstatus
 │    ├── LevelFormula   → konfigurierbare Level-Kurve
 │    ├── Skill          → Multi-Skill-System
 │    └── XPSource       → Analytics + Pipeline
 ├── Events              → LevelUpEvent, XPGainEvent
 ├── Hooks               → Vault, PlaceholderAPI
 └── Commands            → /level, /xp, /skill

---

Build

mvn clean package

Output: target/LevelSystemAPI-1.0.0.jar

---

Dependencies (shaded)

• HikariCP 5.1.0
• Jedis 5.1.0
• SQLite JDBC 3.45.1.0
• MySQL Connector 8.3.0

Vault + PlaceholderAPI sind provided (soft-depend).