Anleitung
So erstellst du ein Minecraft-Economy-Plugin
Aktualisiert am 18. Oktober 2026
Ein Economy-Plugin speichert für jeden Spieler einen Kontostand und lässt Spieler einander bezahlen, Geld verdienen und es in Shops ausgeben. Das Wichtigste sind nicht die Befehle, sondern die Anbindung an Vault: Erst sie erlaubt es Shop-, Job- und Auktions-Plugins, dein Geld zu nutzen. Diese Anleitung behandelt den Aufbau, die Speicherung und wie du das Plugin baust und testest.
Starte mit diesem Beispiel und passe die Regeln an deine an.
Mit Codexe erstellenSchritt für Schritt
1.Lege fest, was das Plugin ist
Entweder ist es die Economy (es speichert die Kontostände und registriert sich als Vault-Economy), oder es nutzt eine bestehende Economy über Vault (ein Shop, Kopfgelder, ein Job-Plugin). Die meisten Server brauchen je eins davon, nicht zwei Economys.
2.Server und Version wählen
Gib die Serversoftware und die Version an, zum Beispiel Paper 1.21.4. Das Plugin wird für die API und die Java-Version dieser Version gebaut.
3.Liste Befehle und Regeln auf
/balance,/pay <player> <amount>,/baltopund Admin-Befehle wie/eco give|take|set. Ergänze das Startguthaben, den Namen der Währung, die Nachkommastellen und eine Mindestzahlung.4.Wähle, wo die Kontostände gespeichert werden
SQLite für einen einzelnen Server, MySQL, wenn sich mehrere Server dieselben Kontostände teilen müssen. Geld muss Neustarts und Abstürze überstehen, deshalb liegt es nie nur im Arbeitsspeicher.
5.Codexe schreiben und bauen lassen
Beschreibe das Plugin und nenne Vault ausdrücklich, damit es als Abhängigkeit hinzugefügt wird. Codexe schreibt den Java-Code, die
plugin.ymlund dieconfig.yml, kompiliert alles und behebt Build-Fehler, bevor das Projekt als Ready gilt.6.Zahlungen im Spiel testen
Klicke auf Jetzt testen und tritt dem Testserver bei. Zahle zwischen zwei Konten, probiere zu große, negative oder nicht numerische Beträge aus, starte dann neu und prüfe, ob die Kontostände noch da sind.
7.Installieren
Lege Vault und deine .jar in den Ordner
plugins/des Servers und starte ihn neu. Entferne alle anderen Economy-Plugins oder lege fest, welches Vault verwenden soll.
Welche Rolle Vault spielt
Vault ist eine Brücke, keine Economy. Ein Economy-Plugin implementiert das Economy-Interface von Vault und registriert es beim Services Manager des Servers; andere Plugins fragen es mit getServer().getServicesManager().getRegistration(Economy.class) ab und rufen Methoden wie getBalance, withdrawPlayer und depositPlayer auf.
Ein Shop-Plugin muss also nie wissen, welche Economy du verwendest. Nutze in der plugin.yml depend: [Vault], wenn das Plugin ohne Vault nicht funktioniert, oder softdepend, wenn Vault optional ist. Die Vault-API wird nur zum Kompilieren gebraucht; Vault selbst wird auf dem Server installiert.
Entscheidungen für deine Anfrage
- Geldformat: Name der Währung in Einzahl und Mehrzahl, Symbol, Anzahl der Nachkommastellen.
- Grenzen: Startguthaben, maximaler Kontostand, ob Kontostände negativ werden dürfen.
- Offline-Spieler: ob
/payund/ecoauch bei Spielern funktionieren, die nicht online sind. - Protokoll: ein Transaktionslog in der Datenbank oder in einer Datei, damit das Team Streitfälle prüfen kann.
- Geld verdienen: durch Mobs töten, Belohnungen für Spielzeit, Items verkaufen oder nur über Admin-Befehle.
Wo die Kontostände gespeichert werden
| Speicherung | Geeignet für | Darauf achten |
|---|---|---|
| YAML-Datei | Sehr kleine Server, leicht lesbar | Langsam bei vielen Spielern, kann bei einem Absturz leicht beschädigt werden |
| SQLite | Ein Server, keine Einrichtung | Kann nicht zwischen Servern geteilt werden |
| MySQL / MariaDB | Netzwerke mit gemeinsamem Kontostand | Braucht einen Datenbankserver und Zugangsdaten in der config.yml |
Beispielbeschreibung
„Ein Economy-Plugin für Paper 1.21.4 namens Coins, das sich als Vault-Economy registriert. /balance [player], /pay <player> <amount> mit einem Minimum von 1, /baltop mit den Top 10 und /eco give|take|set für Spieler mit coins.admin. Neue Spieler starten mit 100 Coins. Zwei Nachkommastellen. Jede Zahlung wird mit Datum, Absender, Empfänger und Betrag protokolliert. Kontostände in SQLite gespeichert. Währungsnamen und alle Nachrichten in der config.yml.“
Codexe verwendet standardmäßig SQLite, wenn du nichts anderes verlangst. Wenn du MySQL willst, bekommt das Plugin eine Einstellung storage-type, und der Testserver stellt ihm beim Ausprobieren eine eigene MySQL-Datenbank bereit.
Fragen
Brauche ich Vault?
Nicht für eine eigenständige Economy, die sonst nichts nutzt. Du brauchst es, sobald andere Plugins (Shops, Jobs, Auktionen) Kontostände lesen oder ändern sollen, denn genau nach dieser API suchen sie.
Kann ich es neben EssentialsX laufen lassen?
EssentialsX hat eine eigene Economy und registriert sie ebenfalls bei Vault. Lass immer nur eine Economy laufen oder schalte die ab, die du nicht willst, sonst nutzen andere Plugins womöglich einen anderen Kontostand als den, den deine Befehle anzeigen.
Können sich mehrere Server dieselben Kontostände teilen?
Ja, mit MySQL oder MariaDB als Speicher und derselben Datenbank in der config.yml jedes Servers. Gib das in der Anfrage an, damit das Plugin die Kontostände aus der Datenbank liest, statt sie zu lange zwischenzuspeichern.
Wie teste ich es ohne echten Server?
Mit Jetzt testen: Ein privater Paper-Server deiner Version startet mit dem kompilierten Plugin, und Plugins aus depend und softdepend, etwa Vault, werden dafür installiert. Der kostenlose Tarif bietet 3 Testserver pro Tag mit je 10 Minuten.
Erstelle die Economy deines Servers
Dieser Prompt öffnet sich versandfertig:
“Ein Economy-Plugin für Paper 1.21.4 namens Coins, das sich als Vault-Economy registriert: /balance, /pay mit einem Minimum von 1, /baltop mit den Top 10, /eco give|take|set für coins.admin, Startguthaben 100, zwei Nachkommastellen, jede Zahlung protokolliert, Kontostände in SQLite, Währungsnamen und Nachrichten in der config.yml.”
Mit Codexe erstellen