Minecraft-Plugin EconomyAPI

🔌 Über EconomyAPI

EconomyAPI ist ein Economy-Kernplugin und eine API-Implementierung, ursprünglich von onebone erstellt. Es wird für Server-Ökosysteme im Bedrock/PocketMine-Stil (PocketMine/Nukkit-Varianten) veröffentlicht und verteilt und soll ein gemeinsames Währungs-Backend sowie programmgesteuerte Methoden bereitstellen, die andere Plugins aufrufen können.

🎯 Zweck

EconomyAPI bietet ein zentrales Währungssystem, damit Plugin-Autoren Spielerkonten lesen und ändern, wirtschaftsbezogene Ereignisse registrieren und Serveradministratoren grundlegende Economy-Befehle für Spieler bereitstellen können. Es löst das Problem, dass mehrere Plugins separate Economy-Implementierungen benötigen, indem es eine gemeinsame API-Schicht anbietet.

⚙️ Funktionen

• Stellt programmgesteuerte API-Methoden für Abfragen und Aktualisierungen von Kontoständen bereit (Beispiele in der Doku enthalten einen Accessor im getInstance-Stil).
• Bietet spielerseitige Economy-Befehle wie Kontostand, Bezahlen und Geldanpassungen für Admins.
• Löst Ereignisse aus und bietet Hooks, auf die andere Plugins für die Transaktionsverarbeitung reagieren können.
• Weit verbreitet als Abhängigkeit/Kernkomponente für andere PocketMine/Nukkit-Economy-Addons und -Erweiterungen.

🧩 Für wen es gedacht ist

• Server- und Plugin-Entwickler, die auf Bedrock-Server-Software im PocketMine/Nukkit-Stil ein gemeinsames Economy-Backend benötigen.
• Betreiber kleiner bis mittelgroßer Bedrock-Server, die auf Plugin-Ökosysteme angewiesen sind, die sich in EconomyAPI integrieren.

🏗️ Beispiel-Anwendungsfälle

• Ein Shop- oder Marktplatz-Plugin liest und belastet Spielerkonten über EconomyAPI-Aufrufe.
• Ein Auktions- oder Belohnungs-Plugin vergibt Währung durch Aufruf der add/reduce-Methoden der API.
• Servernetzwerke, die Addon-Plugins ausliefern, welche einen gemeinsamen Economy-Anbieter erwarten.

⌨️ Befehle

(Die oben genannten Befehle und Berechtigungsknoten stammen aus veröffentlichten PocketMine/Nukkit-Ressourcenlisten; die genaue Verfügbarkeit kann je nach Build/Fork variieren.)

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Lade den offiziellen Plugin-Build für deine Server-Distribution herunter (PocketMine/Poggit oder ein Community-Build für Nukkit).
• Lege die heruntergeladene Plugin-Datei in das plugins/-Verzeichnis des Servers.
• Stoppe und starte den Server neu (Neustart) und prüfe die Konsolenausgabe, um zu bestätigen, dass das Plugin geladen wurde.

(Das genaue Paketformat kann je nach Distribution und Build variieren; befolge die Installationsschritte der gewählten Distribution.)

🧠 Technische Hinweise

• EconomyAPI wird in mehreren Builds/Forks für die PocketMine- und Nukkit-Ökosysteme verteilt; unterschiedliche Builds können leicht unterschiedliche Befehle oder API-Einstiegspunkte enthalten.
• Das Plugin stellt programmgesteuerte Zugriffsmuster bereit, die von anderen Addons verwendet werden (Beispiele in Community-Dokumentationen zeigen Aufrufe wie EconomyAPI::getInstance() oder EconomyAPI.getInstance().addMoney(...)).
• Mitunter wurde das Plugin in Distributionskanälen wegen Leistungs- oder Wartungsfragen markiert; berücksichtige den aktuellen Wartungsstatus und kompatible Alternativen, wenn du es auf Produktionsservern einsetzt.

🤝 Wann dieses Plugin nützlich ist

Wenn dein Server oder Add-on-Ökosystem einen gemeinsamen Economy-Anbieter für Bedrock/PocketMine/Nukkit-ähnliche Server erwartet, bietet EconomyAPI eine weit verbreitete API und eine Reihe grundlegender Spielerbefehle, mit denen sich viele andere Plugins integrieren.