Plugin Minecraft AxVaults

🔌 O AxVaults

AxVaults to lekki plugin do Minecrafta oparty na uprawnieniach, który zapewnia wirtualne skrytki dla każdego gracza (magazyn). Projekt jest utrzymywany przez Artillex-Studios i został zaprojektowany tak, aby przechowywać dowolne przedmioty (w tym przedmioty z NBT), zapobiegać duplikacji oraz oferować dostęp administracyjny do podglądu i modyfikacji skrytek.

🎯 Cel

AxVaults rozwiązuje potrzebę trwałego, odizolowanego magazynu gracza, który działa z niestandardowymi przedmiotami i danymi NBT, jednocześnie dążąc do uniknięcia exploitów duplikacji. Jest przeznaczony dla serwerów, które chcą konfigurowalnych, kontrolowanych uprawnieniami skrytek jako alternatywy lub uzupełnienia fizycznych skrzyń.

⚙️ Funkcje

• Dostęp do skrytek oparty na uprawnieniach z użyciem nodów w formie axvaults.vault.<number>.
• Nielimitowana liczba slotów skrytki na gracza (w praktyce ograniczona przez limity liczb całkowitych).
• Bezpieczne dla NBT przechowywanie: przedmioty są zapisywane binarnie, aby zachować dane niestandardowych przedmiotów.
• Ochrona przed duplikacją z założenia (przechowywanie zarządzane przez plugin zamiast surowej serializacji przedmiotów).
• GUI/menu wyboru do przeglądania stron skrytek z obsługą paginacji.
• System czarnej listy, aby zapobiec umieszczaniu określonych przedmiotów w skrytkach.
• Konfigurowalne ikony pozwalające graczom wybierać ikony skrytek.
• Narzędzia administracyjne do podglądu i modyfikacji skrytek graczy, w tym dostęp offline dla staffu.
• Obsługa baz danych H2 i SQLite jako backendów przechowywania.

🧩 Dla kogo

• Serwery Survival i SMP, które potrzebują prywatnego magazynu dla każdego gracza.
• Serwery używające niestandardowych przedmiotów lub crate'ów i wymagające bezpiecznego przechowywania NBT.
• Serwery moderowane przez administratorów, które potrzebują dostępu staffu do sprawdzania lub modyfikowania skrytek graczy.

🏗️ Przykładowe zastosowania

• Przyznawanie graczom stałej liczby skrytek za pomocą uprawnień (np. axvaults.vault.1, axvaults.vault.5).
• Użycie menu wyboru, aby gracze mogli szybko otwierać różne strony skrytek.
• Zablokowanie przechowywania kluczy do crate'ów lub innych przedmiotów ekonomii w skrytkach za pomocą czarnej listy.
• Staff pobiera lub dostosowuje skrytkę gracza, gdy ten jest offline.

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik jar pluginu i umieść go w katalogu plugins/ serwera opartego na Bukkit/Spigot/Paper.
• Zrestartuj serwer i sprawdź konsolę, aby potwierdzić, że plugin został załadowany.
• Skonfiguruj uprawnienia (przyznaj nody axvaults.vault.<number> w razie potrzeby) za pomocą swojego pluginu do uprawnień.

📦 Zależności

• Domyślnie nie są wymagane zależności w czasie uruchomienia (nie potwierdzono żadnych wymaganych pluginów). Plugin używa własnych backendów przechowywania.

🧾 Konfiguracja

• Plugin korzysta z konfigurowalnych backendów przechowywania (H2 i SQLite zostały udokumentowane jako obsługiwane).
• Czarna lista, ustawienia ikon i wiersze przechowywania skrytek są konfigurowalne (szczegóły w oficjalnej dokumentacji).

🧠 Uwagi techniczne

• Repozytorium projektu i oficjalne zasoby są utrzymywane przez Artillex-Studios.
• Plugin deklaruje obsługę przechowywania H2 i SQLite.
• Administratorzy mogą uzyskiwać dostęp do skrytek graczy offline (dokumentowany jest dostęp offline dla administracji).
• Plugin twierdzi, że z założenia chroni przed duplikacją i przechowuje przedmioty binarnie, aby zachować NBT.
• Przed wdrożeniem potwierdź wymagania dotyczące Javy oraz obsługiwane wersje serwera w oficjalnych informacjach o wydaniu.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz bezpiecznego dla NBT, kontrolowanego uprawnieniami wirtualnego magazynu dla graczy, z narzędziami do inspekcji dla staffu i prostym przechowywaniem opartym na bazie danych (H2/SQLite), AxVaults oferuje wyspecjalizowane rozwiązanie bez konieczności instalowania dodatkowych zależności.