Vault - most między pluginami ekonomii i uprawnien
Vault to plugin-API, który sam nie dodaje żadnych widocznych funkcji, ale jest wymagany przez wiekszosc pluginow serwerowych. Łączy systemy ekonomii, uprawnien i chatu, pozwalając pluginom komunikowac sie ze soba bez bezposredniej zależności.
Czym jest Vault
Vault to biblioteka posredniczaca (API), która definiuje standardowy interfejs do trzech systemow serwerowych: ekonomii (salda, przelewy), uprawnien (rangi, grupy) i chatu (prefixy, sufixy). Vault nie implementuje żadnego z tych systemow sam - zamiast tego łączy pluginy, które je dostarczaja, z pluginami, które z nich korzystaja.
Analogia: Vault to jak gniazdko elektryczne. Sam z siebie nie produkuje pradu ani nie zasilacza urzadzenia. Ale bez niego lodowka (plugin sklepu) nie może podlaczyc sie do elektrowni (plugin ekonomii). Vault standaryzuje "ksztalt wtyczki", zeby dowolny plugin ekonomii dzialal z dowolnym pluginem sklepu.
Plugin istnieje od 2011 roku i jest instalowany na praktycznie każdym serwerze Minecraft, który używa ekonomii lub systemu rang. Pobierasz go z SpigotMC i wrzucasz do folderu plugins/ - to cała "konfiguracja".
Dlaczego każdy serwer potrzebuje Vault
Bez Vault każdy plugin ekonomiczny musialby bezpośrednio wspierac każdy plugin sklepowy. Jeżeli istnieje 5 silnikow ekonomii i 10 pluginow sklepow, potrzeba 50 indywidualnych integracji. Z Vault każdy silnik ekonomii implementuje jeden interfejs Vault, a każdy sklep również - i wszystko działa ze wszystkim. 5 + 10 = 15 integracji zamiast 50.
W praktyce Vault jest wymagany przez:
- Pluginy sklepow - ShopGUI+, QuickShop Hikari, EconomyShopGUI, ChestShop, AuctionHouse
- Pluginy minigier - BedWars1058, SkyWars - nagrody pieniezne za wygrana
- Pluginy chatu - ChatManager, DeluxeChat - odczytuja prefixy rang z Vault
- Pluginy zawodow - Jobs Reborn - wyplaty za aktywności
- Pluginy narzędzi - PlaceholderAPI - zmienne
%vault_eco_balance%,%vault_prefix% - Pluginy claim - GriefPrevention, Towny - koszty claimow i miast
Jeśli probujesz zainstalowac ktorykolwiek z powyzszych pluginow bez Vault, zobaczysz błąd w logach: "Vault not found" lub "Economy provider not registered". Rozwiazanie jest zawsze takie samo: zainstaluj Vault.
Jak działa Vault
Vault operuje na trzech "usługach" (service providers):
| Usluga | Co robi | Kto dostarcza |
|---|---|---|
| Economy | Salda, przelewy, sprawdzanie stanu konta | EssentialsX, CMI, TheNewEconomy, iConomy |
| Permissions | Grupy, rangi, sprawdzanie uprawnien | LuckPerms, UltraPermissions (dawniej: PEX, GroupManager) |
| Chat | Prefixy, sufixy, metadata czatu | LuckPerms (przechowuje prefixy), EssentialsX Chat (wyswietla) |
Po starcie serwera Vault skanuje zainstalowane pluginy i rejestruje dostępnych dostawcow uslug. Następnie, gdy inny plugin (np. ShopGUI+) chce sprawdzić saldo gracza, pyta Vault, a Vault przekazuje pytanie do aktualnie zarejestrowanego silnika ekonomii (np. EssentialsX). Cały proces jest przezroczysty - gracz nie widzi różnic.
W konsoli serwera po starcie zobaczysz komunikaty potwierdzajace, ze Vault znalazł dostawcow:
[Vault] [Economy] EssentialsX Economy found: Linked
[Vault] [Permission] LuckPerms found: Linked
[Vault] [Chat] LuckPerms found: LinkedJeśli zamiast "Linked" widzisz "No compatible plugins found", oznacza to, ze brakuje silnika ekonomii lub uprawnien. Zainstaluj EssentialsX (ekonomia) i LuckPerms (uprawnienia).
Integracje z popularnymi pluginami
Typowy zestaw pluginow korzystajacych z Vault na serwerze survival:
- EssentialsX - dostarcza silnik ekonomii (salda, /pay, /baltop) i rejestruje sie w Vault jako Economy provider
- LuckPerms - dostarcza system uprawnien i rang, rejestruje sie jako Permission i Chat provider (prefixy)
- ShopGUI+ / QuickShop - pluginy sklepow, które pytaja Vault o saldo gracza przy każdej transakcji
- Jobs Reborn - wyplaca zarobki przez Vault Economy API
- AuctionHouse - pobiera oplaty i prowizje przez Vault
- PlaceholderAPI - udostępnia zmienne Vault innym pluginom:
%vault_eco_balance%,%vault_eco_balance_fixed%,%vault_prefix%
Jeżeli zmienisz silnik ekonomii (np. z EssentialsX na CMI), wystarczy zainstalowac nowy plugin i usunąć stary. Vault automatycznie przelacza sie na nowego dostawce, a wszystkie pluginy sklepow, minigier i zawodow działają dalej bez zmian w ich konfiguracji.
Instalacja i konfiguracja
Vault to jeden z najprostszych pluginow do zainstalowania:
- Pobierz plik
Vault.jarze SpigotMC - Umiesc go w folderze
plugins/na serwerze - Zainstaluj przynajmniej jeden silnik ekonomii (np. EssentialsX) i uprawnien (np. LuckPerms)
- Zrestartuj serwer
- Sprawdź logi - powinienes zobaczyć komunikaty "Linked" dla Economy, Permission i Chat
Vault nie wymaga konfiguracji. Nie ma pliku config.yml, nie ma komend w grze (poza /vault-info i /vault-convert). Po instalacji działa w tle, posredniczac między pluginami.
Kolejnosc ladowania pluginow ma znaczenie: Vault musi zaladowac sie przed pluginami, które go używają. W wiekszosci przypadkow serwer automatycznie rozwiazuje zależności, ale jeśli masz problemy, upewnij sie, ze w pliku plugin.yml Twoich pluginow Vault jest wymieniony w sekcji depend lub softdepend.
Czeste pytania
Czy Vault jest wymagany, jeśli uzywam tylko LuckPerms?
Jeśli nie masz ekonomii ani pluginow chatu korzystajacych z Vault - technicznie nie. Ale wiele pluginow sprawdza obecnosc Vault nawet jeśli nie korzysta bezpośrednio z ekonomii. Bezpieczniej jest zawsze miec Vault zainstalowany, bo nie zuzywa praktycznie żadnych zasobow.
Czy moge miec dwa silniki ekonomii jednoczesnie?
Vault obsługuje tylko jednego dostawce na raz. Jeśli masz EssentialsX i CMI, Vault wybierze jednego (zazwyczaj tego ladowanego później). To prowadzi do nieprzewidywalnych zachowan - nie instaluj dwoch silnikow ekonomii.
Vault nie łączy sie z ekonomia - co robic?
Sprawdź kolejnosc: (1) Vault musi byc zainstalowany, (2) silnik ekonomii (np. EssentialsX) musi byc zainstalowany i poprawnie skonfigurowany, (3) zrestartuj serwer (nie /reload). Sprawdź logi pod katem błędów.
Powiązane: EssentialsX (silnik ekonomii), LuckPerms (system uprawnien), serwer z ekonomia (pełna konfiguracja ekonomii).