Vault Plugin Minecraft: Wirtschaft und Berechtigungen Brücke (2026)

Wer schon mal EssentialsX, ChestShop, mcMMO, Jobs oder fast irgendein Wirtschafts-Plugin installiert hat, kennt Vault als Abhängigkeit. Sofort die Frage: was ist diese magische jar, warum verlangen sie dutzende Plugins, und was geht kaputt ohne sie. Kurze Antwort: Vault ist eine API-Brücke. Allein macht es nichts, aber ohne es können Plugins nicht mit deiner Wirtschaft oder deinem Berechtigungssystem reden.

Dieser Guide klärt: wie Vault intern arbeitet, was Service Provider sind, wie man es installiert, welche Wirtschafts- und Permission-Provider 2026 lebendig sind, wie man "no compatible economy plugin found" abfängt, wann auf den VaultUnlocked-Fork wechseln, und wann Vault gar nicht nötig ist.

Vault ist eine API, kein Feature

Das größte Missverständnis: Leute denken, Vault selbst betreibt Wirtschaft, vergibt Berechtigungen, regelt Chat. Falsch.

Vault ist eine Abstraktionsschicht. Wenn ChestShop den Kontostand eines Spielers wissen will, ruft es nicht direkt EssentialsX an. Es ruft Vault: "gib mir den Stand von Spieler X". Vault leitet die Anfrage an das Plugin weiter, das sich als Economy Provider registriert hat. Das kann EssentialsX Eco, CMI, TNE, GemsEconomy, BeastTokens sein.

Wozu diese Schicht? Damit ein Shop-Plugin auf jeder Wirtschaft läuft, ohne deren Innereien zu kennen. Der ChestShop-Entwickler schreibt einmal gegen die Vault API, der Server-Admin wählt das Backend.

Bei Berechtigungen genauso. mcMMO will wissen, ob ein Spieler mcmmo.skills.mining hat. Es fragt Vault, Vault holt sich den registrierten Permission Provider (LuckPerms, GroupManager, PermissionsEx etc.), bekommt true oder false zurück.

Vault stellt drei APIs bereit:

• Economy (net.milkbowl.vault.economy.Economy)
• Permission (net.milkbowl.vault.permission.Permission)
• Chat (net.milkbowl.vault.chat.Chat)

Ohne registrierten Provider existiert die API zwar, gibt aber Stub-Werte zurück. Daher heißt der Fehler "no compatible economy plugin found": Vault läuft, aber niemand hat sich als Wirtschafts-Provider registriert.

Wie der Service Provider Mechanismus funktioniert

Bukkit/Paper hat eine eingebaute ServicesManager Klasse. Ein Service-Register: jedes Plugin kann eine Implementierung eines Interfaces registrieren, jedes andere Plugin kann diese Implementierung anfordern.

Unter der Haube läuft es etwa so. EssentialsX beim Start:

Bukkit.getServicesManager().register(
    Economy.class,
    new EssentialsEconomy(),
    essentialsPlugin,
    ServicePriority.Normal
);

ChestShop beim Start:

RegisteredServiceProvider<Economy> rsp =
    Bukkit.getServicesManager().getRegistration(Economy.class);
if (rsp == null) {
    log.severe("No compatible economy plugin found!");
    return;
}
Economy econ = rsp.getProvider();

Vault selbst registriert sich in diesem Schema nicht als Implementierung. Es definiert nur die Interfaces und kümmert sich um Versionskompatibilität. Daher heißt "Hooked into Vault" im Log: ein Plugin hat Vault-Klassen im Classpath gefunden und kann jetzt mit dem registrierten Provider reden.

Falls die Lade-Reihenfolge falsch ist (Wirtschafts-Plugin startet später als der Shop), kommt die Registrierung verspätet. Vault löst das per lazy lookup: ein Shop sollte die Economy-Referenz nicht in onEnable cachen, lieber bei der ersten Anfrage holen.

Vault installieren

Kürzestes Kapitel. Vault ist eine jar.

1. Auf github.com/MilkBowl/Vault/releases die letzte stabile Version laden (in 2026 ist das Branch 1.7.x).
2. Vault.jar ins plugins/ Verzeichnis kopieren.
3. Server neu starten. Nicht /reload, das zerstört die Service-Registrierung.

Verifikation:

/plugins

Vault erscheint grün in der Liste. Dann zeigt /vault-info alle Provider:

/vault-info

Gesunder Server:

Vault v1.7.3-SNAPSHOT Information
Economy: EssentialsX Economy [Enabled]
Permissions: LuckPerms [Enabled]
Chat: LuckPerms-Chat [Enabled]

Falls bei Economy (Disabled) oder none steht, hat sich kein Plugin registriert. Siehe Troubleshooting.

Wirtschafts-Provider

Vault speichert keine Kontostände. Das macht der Provider. 2026 auf Paper 1.21+ ist die Auswahl so.

EssentialsX Economy

Beliebteste Variante. Teil von EssentialsX. Du lädst das volle Paket: EssentialsX.jar, EssentialsXChat.jar, plus separat Geo, AntiBuild und so weiter. Das Wirtschaftsmodul sitzt im Haupt-EssentialsX.jar.

Konfiguration in plugins/Essentials/config.yml:

currency-symbol: '$'
starting-balance: 100.0
max-money: 10000000000000
min-money: -10000

Nach dem Start zeigt /bal den Stand, /pay überweist, /eco admin. Vault übernimmt die Registrierung automatisch.

CMI Economy

CMI ist ein kostenpflichtiges All-in-One (ersetzt EssentialsX, AdminFun, vieles mehr). Hat eigene Wirtschaft.

In plugins/CMI/config.yml:

Economy:
  Enabled: true
  StartingMoney: 100.0
  Currency:
    Format: '$ {amount}'

CMI registriert sich in Vault mit Normal-Priorität. Läuft EssentialsX Eco parallel, gibt es Konflikt: beide registrieren, der zuerst geladene gewinnt. Lösung: in einem Plugin Wirtschaft abschalten oder ServicePriority im Config setzen.

TheNewEconomy (TNE)

TheNewEconomy ist ein eigenständiges Wirtschafts-Plugin ohne Beiwerk. Multi-Währung (mehrere Währungen auf einem Server), Banken, Zinsen, regionale Einstellungen.

Core:
  Currency:
    Default:
      Major_Name: Dollar
      Major_Plural: Dollars
      Symbol: '$'
      Decimal_Places: 2

TNE glänzt auf Servern mit mehreren Währungen (z.B. Hauptwährung + Voting-Tokens).

GemsEconomy

GemsEconomy auch Multi-Währung, einfacher als TNE in Features, aber bequemer in der Verwaltung. Speichert in MySQL, läuft sauber im BungeeCord/Velocity-Netz.

Vault Wirtschafts-Kompatibilität

Provider	Vault	VaultUnlocked	Multi-Währung	Speicher
EssentialsX Eco	ja	ja	nein	YAML
CMI Economy	ja	ja	nein	SQLite/MySQL
TheNewEconomy	ja	ja	ja	MySQL/H2
GemsEconomy	ja	ja	ja	MySQL
BeastTokens	ja	per Adapter	ja (Tokens)	MySQL
iConomy	tot	nein	nein	YAML

Fazit: für klassisches SMP nimm EssentialsX Eco, für komplexes RPG/PvP schau auf TNE oder GemsEconomy.

Permission-Provider

Bei Berechtigungen 2026 gibt es eine echte Wahl, LuckPerms. Der Rest ist tot oder Legacy.

LuckPerms

LuckPerms ist König. Standard-Installation, LuckPerms-Bukkit-5.x.x.jar ins plugins/, fertig. Vault sieht sowohl Permission- als auch Chat-Provider (für Präfixe/Suffixe) automatisch.

Verifikation:

/vault-info

Soll zeigen:

Permissions: LuckPerms [Enabled]
Chat: LuckPerms-Chat [Enabled]

LuckPerms implementiert die Vault API nativ. Keine Extra-Konfig.

GroupManager

GroupManager kam mit dem alten EssentialsX, moderne Versionen haben ihn rausgeworfen. Falls du aus irgendwelchen Gründen auf 1.8 mit GroupManager bist: längst nicht mehr gewartet, und Vault-Wirtschafts-Hooks laufen schief.

PermissionsEx (PEX)

Totes Projekt. Nicht nutzen, hat kritische Bugs mit Permission-Verlust. Wenn du PEX hast, migriere mit /lp import pex zu LuckPerms.

Bukkit superperms

Falls überhaupt kein Permission-Plugin installiert, fällt Vault auf Bukkit superperms zurück. Permissions kommen aus permissions.yml und nur /op Befehle laufen wirklich. Für ernsthafte Server unbrauchbar.

Permission-Provider Vergleich

Provider	Wartung	Vault	Kontexte	Empfehlung
LuckPerms	aktiv	ja	ja	nehmen
GroupManager	tot	ja	nein	weglassen
PermissionsEx	tot	ja	teilweise	wegmigrieren
Bukkit superperms	basic	Stub	nein	weglassen

Chat-Provider

Vault Chat API geht um Präfixe, Suffixe, Gruppenanzeige. EssentialsXChat oder Carbon zieht den Präfix vom Chat-Provider.

In 99% der Fälle ist der Chat-Provider derselbe LuckPerms, weil er sowohl Permission- als auch Chat-Interface implementiert. Nichts Extra: LuckPerms installiert, Chat-Provider erscheint.

Mit GroupManager (warum?) registriert er sich auch als Chat. CMI hat ein eigenes Chat-Modul und registriert sich als Chat wenn Chat.Vault aktiviert ist.

Verifikation per /vault-info und /papi parse

Schnellster Weg sicherzugehen, dass Vault alles sieht:

/vault-info

oder kurz:

/vault

Drei Zeilen: Economy, Permissions, Chat, jede mit Provider-Name und Status.

Auch über PlaceholderAPI prüfbar. PAPI installieren plus die vault Erweiterung (/papi ecloud download Vault):

/papi parse <player_name> %vault_eco_balance%
/papi parse <player_name> %vault_eco_balance_formatted%
/papi parse <player_name> %vault_prefix%
/papi parse <player_name> %vault_suffix%
/papi parse <player_name> %vault_group%

Geben Placeholder einen leeren String oder Originaltext zurück, fand Vault keinen Provider. Liefern sie eine Zahl oder Präfix, alles okay.

Programmatischer Check aus dem Plugin-Config (z.B. Citizens, Quests):

hooks:
  vault: true

Nach Restart sollte das Plugin im Log "Hooked into Vault" oder Ähnliches melden.

Typischer Fehler: no compatible economy plugin found

Häufigstes Support-Ticket. Im Log:

[ChestShop] No compatible economy plugin found!
[Jobs] Vault dependency found, but no economy plugin registered.
[mcMMO] Could not find Vault economy hook.

Ursachen und Diagnose-Reihenfolge.

1. Vault nicht installiert

/plugins

Falls Vault nicht grün in der Liste, jar laden und ins plugins/ legen.

2. Vault installiert, aber kein Wirtschafts-Provider

/vault-info

Wenn Economy: None oder Disabled. EssentialsX, CMI oder TNE installieren. Eines davon.

3. Provider installiert, aber Wirtschaftsmodul aus

Häufig bei CMI. In plugins/CMI/config.yml:

Economy:
  Enabled: false

Auf true setzen, Restart.

Bei EssentialsX seltener Fall: Wirtschaftsmodul fehlt physisch. Vollen EssentialsX Bundle von essentialsx.net laden (nicht nur Chat).

4. Konflikt zweier Provider

/vault-info zeigt einen Provider, aber Plugins sagen, der Stand ändert sich nicht. Möglich: ein Plugin schreibt nach EssentialsX Eco, ein anderes liest CMI Eco. Zwei verschiedene Stände. Lösung: einen Provider behalten, beim anderen Registrierung deaktivieren.

5. Veralteter Vault

Vault vor 1.7 kennt moderne Paper 1.21+ API-Änderungen nicht. Auf 1.7.3+ updaten.

6. Proxy-Konflikt

In einem Velocity-Netz steht das Wirtschafts-Plugin auf jedem Backend einzeln. Steht es nur auf einem, schreiben die anderen "no economy". Vault propagiert die Registrierung nicht durch den Proxy: jeder Server hat seinen eigenen Plugin-Satz.

VaultUnlocked: Fork für moderne Bedürfnisse

Original-Vault gibt es seit 2011 und hängt manchmal hinterher: keine native Multi-Währung, kein BigDecimal für riesige Zahlen, keine asynchronen Operationen. Daher der Fork VaultUnlocked.

VaultUnlocked bringt:

• Multi-Währung auf API-Ebene
• BigDecimal statt double für präzise Mathematik
• Async balance lookup
• Rückwärtskompatibel mit klassischer Vault API (für Vault geschriebene Plugins laufen weiter)

Installation identisch: eine jar in plugins/. Nur nicht beide gleichzeitig, entweder Vault, oder VaultUnlocked.

# Ersetzen
rm plugins/Vault.jar
cp ~/downloads/VaultUnlocked.jar plugins/

Nach Restart prüfen:

/vault-info

VaultUnlocked zeigt dasselbe plus markiert, welche Provider die erweiterte API nutzen. EssentialsX, CMI, LuckPerms laufen mit VaultUnlocked unverändert.

Wann wechseln:

• Server hat Multi-Währung (Dollar + Tokens + Kristalle)
• Du nutzt TNE oder GemsEconomy und willst async raushauen
• Du schreibst eigene Plugins und brauchst BigDecimal

Wann nicht: alles läuft auf klassischem Vault, nicht anfassen.

Wann Vault nicht nötig ist

Nicht jeder Server braucht Vault. Fälle, in denen man es weglassen kann:

• PvP-Server ohne Wirtschaft und ohne komplexe Gruppen. Keine Shops, kein EssentialsX Eco, Berechtigungen per op + Basis-LuckPerms, niemand ruft Vault.
• Survival mit einem Shop-Plugin mit eingebauter Wirtschaft. QuickShop läuft ohne Vault wenn TNE oder Treasury installiert ist.
• Minigames hinter BungeeCord/Velocity. Bedwars/Skywars nutzen meist eigene Coin-Plugins, kein Vault.
• Rein technischer Server. Test, Build, Creative wo alle op sind.

Aktueller Trend ist Treasury, eine Alternative zur Vault-Brücke. Wenn alle Plugins sowohl Vault als auch Treasury unterstützen, kannst du ohne Vault leben. Realität 2026: 90% beliebter Plugins hooken sich nach wie vor in Vault.

Migration alter Plugins zu modernem Stack

Neuer Server in 2026, Basis-Stack:

plugins/
  Vault.jar             # oder VaultUnlocked.jar
  LuckPerms-Bukkit.jar
  EssentialsX.jar
  EssentialsXChat.jar
  PlaceholderAPI.jar

Reicht für:

• Wirtschaft (/bal, /pay, /eco)
• Berechtigungen über LuckPerms (/lp, Web-Editor)
• Präfixe/Suffixe im Chat
• Alles andere mit Vault-Anforderung

Migration vom alten Server: Backup, Vault auf 1.7.x, EssentialsX auf neueste (mind. 2.20+), LuckPerms auf 5.5+, Restart, /vault-info prüfen. Kontostände und Gruppen überleben, falls Plugin-Speicher unverändert bleibt.

Feinjustierung der Prioritäten

Selten, aber: zwei Wirtschafts-Provider, Hauptwahl gefragt. Schau ins Config des Hauptplugins. EssentialsX Essentials/config.yml:

update-bed-at-daytime: true
# Vault-Registrierungspriorität ist nicht direkt einstellbar,
# wird über die Plugin-Lade-Reihenfolge gesteuert

Echter Workaround: Plugin-jar umbenennen, damit es früher oder später lädt. Alphabetische Reihenfolge. AAA-EssentialsX.jar lädt vor CMI.jar. Hack, funktioniert.

Zivilisierter Weg: nur einen Wirtschafts-Provider auf dem Server. Zwei parallele Wirtschaften bedeuten praktisch immer ein vergessenes Plugin oder eine Fehlkonfiguration.

FAQ

Erstellt Vault selbst Geld oder Berechtigungen?

Nein. Vault ist eine API-Brücke. Es definiert die Economy-, Permission-, Chat-Interfaces und liefert einen ServicesManager-Wrapper. Geld speichert der Provider (EssentialsX, CMI, TNE), Permissions speichert LuckPerms.

Was passiert ohne registrierten Provider?

Vault lädt, abhängige Plugins laden, aber bei Anfragen nach Stand oder Permission gibt es null. Logs zeigen "no compatible economy plugin found" oder Ähnliches.

Vault und VaultUnlocked gleichzeitig?

Nein. Zwei jars mit denselben Paketen und Klassen. Server lädt entweder gar nicht oder verhält sich unvorhersehbar. Eines wählen.

LuckPerms und GroupManager parallel?

Bukkit lässt es technisch zu, mach es aber nicht. Sie kollidieren, kämpfen um die Registrierung, Permissions gehen verloren. Migration von GroupManager zu LuckPerms: /lp import groupmanager, GroupManager entfernen.

Vault auf einem Velocity-Proxy nötig?

Proxy-Plugins (auf Velocity selbst) nutzen meist kein Vault. Vault ist Bukkit-API. Auf Backend-Servern hinter dem Proxy schon. Pro Server.

Warum sagt ChestShop "no economy" obwohl EssentialsX läuft?

/vault-info prüfen, dass Economy nicht None ist. Falls None: EssentialsX Wirtschaftsmodul deaktiviert oder nicht geladen, Essentials/server.log checken. Falls grün, Server neu starten: ChestShop kann das null-Ergebnis vom Laden gecachet haben.

Abschließende Gedanken

Vault ist Infrastruktur. Einmal aufsetzen und vergessen. Schwierig wird es, wenn die Wahl von Wirtschaft oder Permissions ohne Verständnis stattfindet, welcher Provider was registriert. Regel: ein Provider pro API, nach Start sollten alle drei Zeilen grün sein, jeder "no compatible plugin" Fehler löst sich in dreißig Sekunden mit /vault-info.

Steht dein Server gerade unter Beschuss und du versuchst gleichzeitig den Plugin-Stack zu konfigurieren, fahr eine geprüfte DDoS-Schutz wie MineGuard hoch und befass dich in Ruhe mit der Konfig. Vault und Provider zu sortieren ist viel angenehmer, wenn der Traffic stabil bleibt.