Das CodeRedeemPlugin ist ein Spigot/Bukkit-Plugin, das es Serveradministratoren ermöglicht, benutzerdefinierte Codes zu erstellen. Diese Codes können von Spielern eingelöst werden, um vordefinierte Konsolenbefehle auszuführen. Das Plugin bietet eine flexible Methode, um Belohnungen, Aktionen oder Berechtigungen an Spieler zu verteilen. Zusätzlich können Codes mit einer maximalen Nutzungsanzahl und einem Ablaufdatum versehen werden.

Kernfunktionen:

1. Code-Erstellung (
   
   • Ein Spieler mit der Berechtigung code.erstellen (konfigurierbar in config.yml) kann einen neuen Code erstellen.
     
     
   • Der Befehl hat die folgende Syntax:
     
     • /scode erstellen <CODE> <consolecommand> [maxuses:<Anzahl>] [expire:<Zeit>]
       
       
     • <CODE>: Der eindeutige Code, den Spieler zum Einlösen verwenden.
       
       
     • <consolecommand>: Der Befehl, der in der Serverkonsole ausgeführt wird, wenn der Code eingelöst wird. Der Platzhalter SPIELER wird durch den Namen des einlösenden Spielers ersetzt.
       
       
     • [maxuses:<Anzahl>]: Optional. Legt fest, wie oft der Code maximal eingelöst werden kann. -1 (oder nicht angegeben) bedeutet unbegrenzte Nutzung.
       
       
     • [expire:<Zeit>]: Optional. Legt die Zeit fest, nach der der Code abläuft. Die Zeit kann in Tagen (d), Stunden (h) oder Minuten (min) angegeben werden (z.B., 1d, 2h, 30min).
       
   • Beispiele:
     
     • /scode erstellen geheim123 eco give SPIELER 500 (gibt dem Spieler 500 Geld, unbegrenzte Nutzung, kein Ablaufdatum)
       
       
     • /scode erstellen vipcode lp user SPIELER parent add vip maxuses:1 expire:7d (gibt dem Spieler den VIP-Rang, einmalige Nutzung, läuft nach 7 Tagen ab)
       
       
     • /scode erstellen diamanten give SPIELER diamond 1 maxuses:10 (gibt dem Spieler einen Diamanten, maximal 10 Mal verwendbar)
       
       
     • /scode erstellen trank give SPIELER potion 1 expire:1h (gibt dem Spieler einen Trank, läuft nach 1 Stunde ab)
       
2. Code-Einlösung (
   
   • Ein Spieler verwendet den Befehl /code <CODE>, um einen Code einzulösen.
     
     
   • Wenn der Code existiert, noch nicht abgelaufen ist und die maximale Nutzung nicht überschritten wurde, wird der zugehörige Konsolenbefehl ausgeführt.
     
     
   • Nach dem Einlösen wird die Nutzungsanzahl des Codes aktualisiert und der Code ggf. aus dem Speicher entfernt.
     
3. Konfiguration (
   
   • Das Plugin verwendet eine config.yml Datei, um Nachrichten und Einstellungen zu speichern.
     
     
   • Folgende Optionen sind konfigurierbar:
     
     • : Die Berechtigung, um Codes zu erstellen (Standard: code.erstellen).
       
       
     • : Alle vom Plugin versendeten Nachrichten, einschließlich Erfolgs- und Fehlermeldungen.
       
   • Die Konfigurationsdatei wird mit UTF-8 geladen, um Umlaute korrekt darzustellen.