Discord

Vault

API łączące pluginy ekonomii, uprawnień i chatu. Sam nie dodaje funkcji, ale jest wymagany przez dziesiątki innych pluginów jako warstwa posrednia.

API i biblioteki SpigotPaperPurpur

O pluginie Vault

Vault to plugin-posrednik (abstraction layer), który łączy ze soba pluginy ekonomii, uprawnień i chatu. Sam z siebie nie dodaje żadnych funkcji widocznych dla gracza. Zamiast tego udostępnia ujednolicone API, które inne pluginy wykorzystują do komunikacji. Przyklad: plugin sklepu (ShopGUI+, ChestShop) używa Vault, żeby pobrać saldo gracza z pluginu ekonomii, niezależnie od tego, czy ekonomie obsługuje EssentialsX Economy czy CMI.

Dzięki Vault plugin sklepowy nie musi wiedzieć, jaki konkretnie plugin ekonomii masz zainstalowany. To samo dotyczy uprawnien: plugin sprawdza range gracza przez Vault, a Vault odpytuje LuckPerms, PEX lub inny system. Vault jest jednym z najczęściej wymaganych zależności. Zainstaluj go zawsze, gdy jakikolwiek plugin wymienia "Vault" wśród dependencies.

Vault to jeden z fundamentalnych pluginów API, który powinienes rozważyć na swoim serwerze Minecraft. Wspiera wersje 1.13 - 1.21.x i działa na Spigot, Paper, Purpur.

Funkcje Vault

Poniżej lista głównych funkcji, które Vault dodaje do Twojego serwera. Każda z nich można skonfigurować w pliku konfiguracyjnym pluginu.

  • API ekonomii (saldo, przelew, sprawdzanie)
  • API uprawnień (grupy, sprawdzanie nodow)
  • API chatu (prefixy, sufixy)
  • Automatyczne wykrywanie providerow

Konfiguracja Vault

Po pierwszym uruchomieniu Vault wygeneruje plik konfiguracyjny w folderze plugins/Vault/. Poniżej najważniejsze opcje z komentarzami. Pełna lista ustawień jest w oficjalnej dokumentacji.

config.yml Przykładowa konfiguracja
# Vault nie ma własnej konfiguracji.
# Po instalacji automatycznie wykrywa pluginy
# ekonomii, uprawnień i chatu.
# Sprawdź status: /vault-info

Po zmianie konfiguracji zapisz plik i użyj komendy przeładowania pluginu (np. /reload lub dedykowanej komendy pluginu). Jeśli plugin nie pobiera zmian po przeładowaniu, zrestartuj serwer komenda /stop.

YAML to wredny format. Jeden błędny spacja albo tabulacja może zepsuć cały plik. Używaj edytora z podswietlaniem składni (VS Code, Notepad++) i sprawdzaj plik na yamllint.com przed wrzuceniem na serwer.

Jak zainstalować Vault

Pobierz Vault ze SpigotMC. Wrzuć .jar do plugins/ i zrestartuj serwer. Vault automatycznie wykryje zainstalowane pluginy ekonomii (EssentialsX, CMI) i uprawnień (LuckPerms). Sprawdź status komenda /vault-info.

  1. Pobierz Vault z oficjalnej strony. Upewnij się, ze pobierasz wersje kompatybilna z Twoja wersja Minecraft (1.13 - 1.21.x).
  2. Skopiuj pobrany plik .jar do folderu plugins/ w katalogu Twojego serwera.
  3. Zrestartuj serwer komenda /stop i uruchom go ponownie. Nie używaj /reload przy pierwszej instalacji.
  4. Sprawdź konsole serwera. Jeśli Vault załadował się poprawnie, zobaczysz komunikat z wersja pluginu. Jeśli pojawił się błąd, sprawdź czy masz zainstalowane wszystkie zaleznosciow.
  5. Skonfiguruj plugin edytujac plik plugins/Vault/config.yml (lub odpowiednik). Po zmianach użyj komendy przeladowania.
Kompatybilność serwerow: Vault działa na Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik serwera - ma lepsza wydajność i więcej API niż Spigot.

Alternatywy dla Vault

Vault nie jest jedynym pluginem w swojej kategorii. Poniżej znajdziesz alternatywy, które warto rozważyć, jeśli szukasz czegoś innego lub Vault nie spełnia Twoich oczekiwan.

Treasury

Nowsza alternatywa API ekonomii z obsługa wielu walut.

Często zadawane pytania o Vault

Jak zainstalować Vault?

Pobierz Vault ze SpigotMC. Wrzuć .jar do plugins/ i zrestartuj serwer. Vault automatycznie wykryje zainstalowane pluginy ekonomii (EssentialsX, CMI) i uprawnień (LuckPerms). Sprawdź status komenda /vault-info. Szczegolowa instrukcja z zależnościami i konfiguracja znajduje się w sekcji instalacja powyżej.

Na jakich silnikach serwerowych działa Vault?

Vault działa na: Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik - większości serwerów daje najlepsza równowagę miedzy wydajnością a kompatybilnością z pluginami. Więcej o silnikach serwerowych przeczytasz w naszym porównaniu.

Czy Vault jest darmowy?

Tak, Vault jest darmowy i dostępny na SpigotMC. Kod źródłowy jest otwarty na GitHub.

Vault nie działa - co robić?

Sprawdź plik logs/latest.log w katalogu serwera. Najczęstsze przyczyny błędów: (1) brakujaca zależność, (2) niekompatybilna wersja Minecraft (sprawdź czy masz 1.13 - 1.21.x), (3) błąd w pliku config.yml (sprawdź format YAML), (4) konflikt z innym pluginem o tej samej funkcji.

Czy mogę używać Vault na serwerze Bedrock?

Nie. Vault to plugin Java Edition i działa na serwerach Spigot/Paper/Purpur. Bedrock Edition używa innego systemu (behavior packs). Jeśli chcesz łączyć graczy Java i Bedrock na jednym serwerze, sprawdź Geyser.

Inne pluginy z kategorii API i biblioteki

Komentarze