MCBattlepass

🎫 BattlePass

GUI-basierten Reward-Editor ist ein season-basiertes BattlePass-Plugin für GUI-basierten Reward-Editor, das Free- und Premium-Pässe, ein tägliches Claim-System und einen GUI-basierten Reward-Editor bietet.

Ideal für Server, die ihre Spieler langfristig motivieren und tägliche Belohnungen anbieten möchten.

---

✨ Features

- ✅ Free Pass Doppelkisten-GUI (54 Slots) Premium Pass (Premium über Permissions steuerbar, z. B. LuckPerms) - 📅 Seasons mit festem Startdatum - 🎁 Tägliches Claim-System basierend auf dem Season-Startdatum - 👤 Spielerfortschritt mit Claim-Status pro Season - 🧰 Rewards über eine Doppelkisten-GUI (54 Slots) konfigurierbar - 🗂️ Separate Rewards für Free- und Premium-Pass - 💾 ItemStacks werden Base64-kodiert gespeichert

GUI-Slot-Logik

- Slot `0` = Tag 1 - Slot `1` = Tag 2 - Von links nach rechts, dann nächste Zeile

---

📦 Anforderungen

- Java: Paper 1.21.11 - Java: 21

---

📁 Konfiguration

- Plugin-Ordner: `plugins/BattlePass` - Seasons: `plugins/BattlePass/seasons.yml` - Spielerfortschritt: `plugins/BattlePass/players.yml`

---

⌨️ Commands

Spieler

- `/bp claim free [Spieler]` Claimt die tägliche Free-Belohnung der aktuellen Season *(Optional für andere Spieler mit `battlepass.claim.others`)*

- `/bp claim premium [Spieler]` Claimt die tägliche Premium-Belohnung der aktuellen Season *(Optional für andere Spieler mit `battlepass.claim.others`)*

Admin

- `/bp admin createseason <Name>` Erstellt eine neue Season mit heutigem Startdatum und setzt sie aktiv

- `/bp admin deleteseason <Name>` Löscht eine existierende Season

- `/bp admin givepremium <Spieler> [Season]` Gibt einem Spieler den Premium-Pass

- `/bp admin revokepremium <Spieler> [Season]` Entzieht einem Spieler den Premium-Pass

- `/bp admin edit rewards <Season>` Öffnet die GUI zum Bearbeiten der Free-Rewards

- `/bp admin edit premiumrewards <Season>` Öffnet die GUI zum Bearbeiten der Premium-Rewards

- `/bp admin seasonset <Season>` Setzt die angegebene Season als aktiv

---

🔐 Permissions

- `battlepass.use` – Grundlegender Zugriff auf `/bp` - `battlepass.claim.free` – Free-Rewards claimen - `battlepass.premium` – Markiert den Spieler als Premium - `battlepass.claim.premium` – Premium-Rewards claimen - `battlepass.claim.others` – Für andere Spieler claimen - `battlepass.admin` – Zugriff auf alle Admin-Commands

---

🚀 Nutzung (Kurzfassung)

1. Season erstellen `/bp admin createseason Season1`

2. Free-Rewards bearbeiten `/bp admin edit rewards Season1`

3. Premium-Rewards bearbeiten `/bp admin edit premiumrewards Season1`

4. Season aktiv setzen (falls nötig) `/bp admin seasonset Season1`

5. Permissions vergeben (z. B. mit LuckPerms)

6. Spieler claimen täglich ihre Belohnungen mit `/bp claim free` `/bp claim premium`