Minecraft-Plugin Tebex

🔌 Über Tebex

Tebex ist ein Minecraft-Plugin, das einen laufenden Server mit einem Tebex-Webshop verbindet, sodass Online-Käufe automatisch im Spiel ausgeliefert werden. Es implementiert die offizielle Tebex Plugin API und bietet serverseitige Abwicklung von Shop-Käufen (Gegenstände, Ränge, Befehle, Abonnements) für unterstützte Serverplattformen.

🎯 Zweck

Der Hauptzweck von Tebex besteht darin, die Auslieferung von Shop-Käufen aus einem Tebex-Webshop zu automatisieren. Serverbesitzer nutzen das Plugin, um ihren Spieleserver mit dem Shop zu verbinden, konfigurierte Serverbefehle auszuführen, wenn Käufe abgewickelt werden, und Spielern Kauf-Links sowie shopbezogene Informationen im Spiel bereitzustellen.

⚙️ Funktionen

• Automatische Bestellabwicklung: Das Plugin fragt Tebex ab und führt konfigurierte Serverbefehle aus, um Käufe zu liefern, wenn Spieler online sind.
• Shop-Verbindung über geheimen Schlüssel: Verbinde einen Server mit einem Shop mithilfe eines serverseitigen Befehls für den geheimen Schlüssel.
• In-Game-Befehle für Checkout und Shop-Infos, um Zahlungslinks zu erstellen oder Shop-Daten anzuzeigen.
• Admin- und Debug-Befehle zum Senden von Links, Erzwingen von Prüfungen, Aktualisieren von Paketdaten und Aktivieren der Debug-Protokollierung.
• Unterstützung mehrerer Plattformen durch offizielle Builds für gängige Serverplattformen.

🧩 Für wen ist es

• Serverbesitzer, die Gegenstände, Ränge oder Abonnements über einen Tebex-Webshop verkaufen.
• Administratoren, die eine automatisierte Abwicklung von Online-Käufen auf Bukkit/Spigot/Paper und anderen unterstützten Plattformen benötigen.
• Netzwerke, die eine gepflegte, offizielle Integration zwischen einem Webshop und ihren Spieleservern wollen.

🏗️ Beispielanwendungen

• Ein Server verkauft kosmetische Gegenstände in seinem Tebex-Shop und das Plugin gibt dem Spieler beim nächsten Join automatisch die Gegenstände.
• Ein Admin erstellt per In-Game-Befehl einen Zahlungslink für einen Spender und sendet ihn an den Spieler.
• Ein Shop-Kauf führt einen Befehl aus, um einen Spieler zu einer Berechtigungsgruppe hinzuzufügen oder ein temporäres Abonnement zu gewähren.

⌨️ Befehle

🔐 Berechtigungen

Alle Befehle verwenden einen Berechtigungseintrag, der genau dem dokumentierten Befehlsnamen entspricht. Standardwerte sind in der offiziellen Dokumentation nicht angegeben.

⚙️ Installation

📥 Einrichtung

• Lade den offiziellen Plugin-Build für deine Serverplattform herunter.
• Lege die Plugin-JAR im Verzeichnis plugins/ deines Servers ab (oder mods/ für unterstützte modifizierte Plattformen).
• Starte den Server neu und prüfe die Konsole, um zu bestätigen, dass das Plugin geladen wurde.
• Führe als Serveradministrator den Befehl für den geheimen Schlüssel aus, um den Server mit deinem Shop zu verbinden.

📦 Abhängigkeiten

• In den offiziellen Installationshinweisen sind keine Laufzeitabhängigkeiten dokumentiert. Das Projekt zu bauen erfordert eine Java-Entwicklungsumgebung.

🧠 Technische Hinweise

• Offizielle Builds werden für mehrere Serverplattformen bereitgestellt und das Projekt wird vom Tebex-Team gepflegt.
• Das Plugin fragt den Tebex-Dienst ab und führt konfigurierte Serverbefehle aus, um Käufe auf deiner Serverplattform abzuwickeln.
• Das Repository und die offiziellen Builds sind unter GPL-3.0 lizenziert.

🤝 Wann dieses Plugin nützlich ist

Wenn du einen Tebex-Webshop betreibst und eine zuverlässige, offizielle serverseitige Abwicklung von Käufen (Gegenstände, Ränge oder Befehle) brauchst, bietet das Tebex-Plugin die Integration und die In-Game-Werkzeuge, um deinen Server mit dem Shop zu verbinden und die Auslieferung ohne eigene Skripte zu automatisieren.