?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
MCBattlepass

MCBattlepass

This Plugin adds a Battlepass to a Paper 1.21.11 Minecraft Server

17
1
17
1

Compatibility

Minecraft: Java Edition

1.21.11

Platforms

Creators

Details

Licensed ARR
Published 3 months ago

🎫 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