MCBattlepass

🎫 BattlePass

BattlePass ist ein season-basiertes BattlePass-Plugin für Paper 1.21.11, 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 und 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

• Minecraft Server: 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