LuckPerms na serwerze Minecraft: instalacja, rangi i konfiguracja uprawnień

LuckPerms to jeden z najpopularniejszych i najbardziej rozbudowanych pluginów do zarządzania uprawnieniami na serwerach Minecraft Java. Umożliwia tworzenie rang, nadawanie dostępu do komend, budowanie hierarchii grup, ustawianie prefixów i suffixów, stosowanie uprawnień tymczasowych oraz ograniczanie ich do konkretnego świata, serwera lub innego kontekstu.

W tym poradniku pokażemy kompletną konfigurację LuckPerms — od instalacji, przez utworzenie pierwszych rang, aż po dziedziczenie uprawnień, tracki promowania graczy, konteksty i Web Editor.

Co to jest LuckPerms?

LuckPerms jest menedżerem uprawnień. Sam plugin nie dodaje komend typu /home czy /fly. Odczytuje natomiast wtyczki, które takie komendy posiadają, i decyduje, którzy gracze lub grupy mogą z nich korzystać.

W LuckPerms uprawnienia przypisuje się użytkownikom albo grupom. Najczęściej tworzy się kilka rang, na przykład:

• default — podstawowe uprawnienia każdego gracza;
• vip — dodatkowe funkcje dla wspierających serwer;
• moderator — narzędzia do pilnowania porządku;
• admin — rozbudowane uprawnienia administracyjne.

Gracz może należeć do grupy, a grupa może dziedziczyć uprawnienia z innej grupy. Dzięki temu nie trzeba powtarzać tych samych permisji w każdej randze.

Wymagania i instalacja

Przed instalacją sprawdź, czy pobierasz wersję LuckPerms odpowiednią dla silnika serwera. Plugin udostępnia wydania między innymi dla Paper, Spigot, Bukkit, Fabric, Forge, NeoForge, BungeeCord i Velocity. Nie instaluj pliku przeznaczonego dla innego typu serwera.

1. Pobierz plik LuckPerms dla używanego silnika serwera.
2. Wyłącz serwer albo zatrzymaj go w panelu administracyjnym.
3. Wgraj plik JAR do katalogu plugins w przypadku Paper/Spigot/Bukkit.
4. Uruchom serwer ponownie.
5. Sprawdź, czy LuckPerms pojawił się na liście pluginów.

Po pierwszym uruchomieniu wtyczka utworzy własny katalog konfiguracyjny. Nie edytuj plików przechowywania danych bez potrzeby. Do codziennej konfiguracji używaj komend albo Web Editora, ponieważ zmniejsza to ryzyko uszkodzenia struktury danych.

Podstawową komendą LuckPerms jest:

/lp

Jeżeli komenda nie działa, wykonaj ją z konsoli serwera. W grze potrzebujesz odpowiedniego uprawnienia albo operatora.

Gdzie LuckPerms przechowuje dane?

LuckPerms może przechowywać dane w plikach albo w zewnętrznej bazie danych. Przy pojedynczym serwerze najprostszy jest storage plikowy. Przy większej sieci serwerów warto rozważyć wspólną bazę danych, na przykład MySQL/MariaDB, aby grupy i uprawnienia były dostępne dla wielu instancji.

Zmianę typu storage wykonuje się w pliku konfiguracyjnym LuckPerms. Przed migracją wykonaj kopię zapasową całego katalogu pluginu i sprawdź dokumentację dla wybranej wersji. Nie zmieniaj typu bazy na działającym serwerze bez wcześniejszego backupu.

Najważniejsze pojęcia

Permission node

Permission node to nazwa konkretnego uprawnienia, na przykład:

essentials.home
essentials.sethome
worldedit.wand
worldguard.region.claim

To, jakie node istnieją, zależy od konkretnego pluginu. LuckPerms nie zgaduje ich nazw. Zawsze sprawdź dokumentację pluginu, który chcesz skonfigurować.

Grupa

Grupa zawiera uprawnienia i meta dane wspólne dla wielu graczy. Grupy są używane do tworzenia rang.

Parent i dziedziczenie

Jeżeli grupa vip dziedziczy po default, otrzymuje wszystkie uprawnienia grupy default i może mieć dodatkowe własne uprawnienia.

Context

Context ogranicza działanie wpisu do określonych warunków, np. konkretnego świata, serwera lub trybu. Dzięki temu dana permisja może działać na survivalu, ale nie na lobby.

Tworzenie pierwszych grup

Utwórz grupy odpowiadające rangom na swoim serwerze:

/lp creategroup vip
/lp creategroup moderator
/lp creategroup admin

Grupa default jest zwykle tworzona automatycznie. Jeżeli jej nie ma, możesz sprawdzić listę grup:

/lp listgroups

Informacje o grupie wyświetlisz poleceniem:

/lp group vip info

Nadawanie uprawnień grupie

Aby nadać grupie VIP dostęp do domów z pluginu EssentialsX, użyj:

/lp group vip permission set essentials.home true
/lp group vip permission set essentials.sethome true

Jeżeli chcesz odebrać uprawnienie, ustaw wartość false:

/lp group vip permission set essentials.fly false

Usunięcie wpisu z grupy, zamiast ustawienia wartości false, wykonuje się tak:

/lp group vip permission unset essentials.fly

To są trzy różne stany:

• true — uprawnienie jest przyznane;
• false — uprawnienie jest jawnie zabronione;
• unset — grupa nie ma własnego wpisu dla tego node.

Przypisywanie gracza do grupy

Aby ustawić graczowi rangę VIP:

/lp user NickGracza parent set vip

Polecenie parent set zastępuje dotychczasową grupę. Jeżeli chcesz dodać grupę bez usuwania pozostałych:

/lp user NickGracza parent add vip

Sprawdzenie danych użytkownika:

/lp user NickGracza info

Usunięcie gracza z grupy:

/lp user NickGracza parent remove vip

Dziedziczenie grup

Zamiast kopiować podstawowe uprawnienia do każdej rangi, ustaw dziedziczenie:

/lp group vip parent add default
/lp group moderator parent add vip
/lp group admin parent add moderator

W tym układzie administrator otrzymuje uprawnienia moderatora, VIP-a i grupy podstawowej. Jest to wygodne, ale wymaga przemyślanej hierarchii. Nie dodawaj wzajemnego dziedziczenia, ponieważ może powstać pętla.

Rodzic grupy może zostać usunięty poleceniem:

/lp group moderator parent remove vip

Prefixy, suffixy i nazwy rang

Prefix jest tekstem wyświetlanym przed nazwą gracza, a suffix tekstem po niej. Przykład ustawienia prefixu:

/lp group vip meta setprefix 100 "&a[VIP] "
/lp group moderator meta setprefix 100 "&2[MOD] "
/lp group admin meta setprefix 100 "&c[ADMIN] "

Liczba 100 jest wagą wpisu. Gdy istnieje kilka prefixów, pluginy obsługujące meta dane mogą wybrać wpis o odpowiedniej wadze. Sam LuckPerms przechowuje meta dane, ale sposób ich wyświetlania zależy od pluginu chatu, np. Vault i kompatybilnego pluginu chatowego.

Suffix ustawia się analogicznie:

/lp group vip meta setsuffix 100 " &7★"

Tracki, czyli ścieżki awansu

Track pozwala zdefiniować kolejność rang i używać komend awansu lub degradacji. Utwórz track:

/lp createtrack staff

Dodaj grupy w kolejności od najniższej do najwyższej:

/lp track staff append helper
/lp track staff append moderator
/lp track staff append admin

Awans gracza:

/lp user NickGracza promote staff

Degradacja:

/lp user NickGracza demote staff

Tracki sprawdzają się na serwerach, na których gracze lub członkowie ekipy przechodzą przez ustaloną ścieżkę rang.

Uprawnienia tymczasowe

LuckPerms obsługuje czasowe nadawanie grup i uprawnień. Przykładowo, aby nadać graczowi rangę VIP na 30 dni:

/lp user NickGracza parent addtemp vip 30d

Tymczasowe uprawnienie można nadać podobnie:

/lp user NickGracza permission settemp essentials.fly true 7d

Czas może być wyrażony między innymi w sekundach, minutach, godzinach lub dniach. Przed użyciem na produkcji sprawdź składnię poleceniem /lp help lub w dokumentacji swojej wersji pluginu.

Konteksty — różne permisje w różnych światach

Za pomocą kontekstu możesz ograniczyć wpis do konkretnego świata. Przykład pozwala grupie VIP korzystać z komendy tylko w świecie survival:

/lp group vip permission set essentials.fly true world=survival

W przypadku sieci serwerów można używać również kontekstu serwera, na przykład:

/lp group vip permission set some.plugin.feature true server=survival

Składnia kontekstu zależy od obsługi danego typu kontekstu przez pluginy i platformę serwera. Jeżeli wpis nie działa, sprawdź dokładną nazwę świata lub serwera oraz użyj polecenia sprawdzającego dostęp.

Sprawdzanie, dlaczego gracz ma albo nie ma uprawnienia

Jedną z najważniejszych funkcji LuckPerms jest sprawdzanie efektywnego uprawnienia:

/lp user NickGracza permission check essentials.fly

Jeżeli wynik jest nieoczekiwany, sprawdź:

1. grupę użytkownika;
2. dziedziczenie grup;
3. wpisy ustawione na true i false;
4. kontekst świata lub serwera;
5. czy plugin rozpoznaje dokładnie tę nazwę permission node;
6. czy inny plugin nie zmienia sposobu wykonywania komendy.

Web Editor — konfiguracja w przeglądarce

LuckPerms posiada Web Editor, który pozwala wygodnie edytować użytkowników, grupy, permisje, rodziców i meta dane w przeglądarce.

Uruchom go komendą:

/lp editor

Plugin wygeneruje jednorazowy adres URL. Otwórz go w przeglądarce, wprowadź zmiany i kliknij przycisk zapisu. Następnie wróć do konsoli serwera i wykonaj komendę, którą pokaże edytor, aby zastosować konfigurację.

Web Editor jest wygodny przy rozbudowanych konfiguracjach, ale traktuj wygenerowany link jak dostęp do konfiguracji serwera. Nie publikuj go i nie przesyłaj osobom, które nie powinny zarządzać uprawnieniami.

Kopia zapasowa i eksport

Przed większymi zmianami wykonaj backup danych LuckPerms. Możesz również użyć eksportu konfiguracji, aby otrzymać plik możliwy do odtworzenia lub przeniesienia.

/lp export backup.yml

Przechowuj kopie poza serwerem i opisuj je datą. Backup całego katalogu pluginu jest dodatkowo przydatny, gdy używasz storage plikowego.

Najczęstsze błędy

Komenda zwraca tylko wersję pluginu

Najczęściej oznacza to brak uprawnień do komend LuckPerms. Wykonaj konfigurację z konsoli serwera albo nadaj administratorowi odpowiednie uprawnienia.

Permisja nie działa

Sprawdź pisownię node, grupę gracza, dziedziczenie i kontekst. Nazwa plugin.command nie musi być poprawna tylko dlatego, że tak nazywa się komenda. W dokumentacji pluginu znajdź właściwy permission node.

Prefix nie wyświetla się na chacie

LuckPerms może przechowywać prefix, ale za jego wyświetlenie odpowiada plugin chatu lub integracja korzystająca z Vault. Sprawdź, czy te komponenty są zainstalowane i poprawnie skonfigurowane.

Zmiany nie pojawiają się na innym serwerze

W sieci serwerów sprawdź wspólny storage, połączenie z bazą danych oraz mechanizm synchronizacji. Przy storage plikowym każda instancja może mieć oddzielną konfigurację.

Bezpieczny model rang

Dobrym rozwiązaniem jest nadawanie uprawnień grupom zamiast pojedynczym osobom. Ułatwia to audyt i późniejsze zmiany. Zacznij od minimalnych uprawnień, testuj je na koncie bez operatora i unikaj szerokich wildcardów, takich jak *, chyba że dokładnie rozumiesz konsekwencje.

Uprawnienia administracyjne nadawaj tylko zaufanym osobom. Szczególnie ostrożnie używaj uprawnień umożliwiających wykonywanie komend, zarządzanie pluginami i zmianę konfiguracji serwera.

Podsumowanie

Podstawowy schemat konfiguracji LuckPerms wygląda tak:

/lp creategroup vip
/lp group vip parent add default
/lp group vip permission set essentials.home true
/lp group vip meta setprefix 100 "&a[VIP] "
/lp user NickGracza parent set vip
/lp user NickGracza info

LuckPerms pozwala zacząć od prostych rang, a później rozbudować system o dziedziczenie, tracki, konteksty, uprawnienia czasowe i wspólną bazę danych. Najważniejsze jest utrzymywanie czytelnej hierarchii i regularne wykonywanie kopii zapasowych.

Oficjalna dokumentacja

• LuckPerms Wiki
• LuckPerms — podstawy użycia
• LuckPerms — komendy grup
• LuckPerms — komendy użytkowników
• LuckPerms — tracki