LuckPerms: grupy i uprawnienia na serwerze Minecraft krok po kroku

LuckPerms to plugin do zarządzania uprawnieniami. Decyduje, kto może używać których poleceń i funkcji, oraz przydziela graczom grupy takie jak VIP, Moderator czy Admin, łącznie z prefiksem na czacie. Najpierw wyjaśnimy, jak działają uprawnienia, a potem krok po kroku zbudujemy kompletną strukturę grup dla typowego serwera.

Jak działają uprawnienia#

Nazwy uprawnień znajdziesz w dokumentacji każdego pluginu. Uprawnienia poleceń samego Minecrafta mają na Paperze postać minecraft.command.<polecenie>, na przykład minecraft.command.kick albo minecraft.command.teleport (polecenie /tp). Jeśli nie znasz uprawnienia, LuckPerms potrafi je wykryć sam, zobacz Sprawdzanie i szukanie błędów.

Instalacja i przechowywanie danych#

1. W zakładce Pluginy › Przeglądaj wyszukaj LuckPerms i kliknij Zainstaluj (albo prześlij plik z luckperms.net/download (otwiera się w nowym oknie) do folderu plugins, zobacz Instalacja pluginów).
2. Zrestartuj serwer.
3. W konsoli sprawdź, czy LuckPerms się włączył (linia [LuckPerms] Enabling LuckPerms … bez błędów). Przy pierwszym starcie plugin pobiera swoje biblioteki, więc start może potrwać nieco dłużej.

LuckPerms tworzy folder plugins/LuckPerms z ustawieniami w pliku config.yml. Gdzie zapisuje dane, decyduje opcja storage-method:

Przy jednym serwerze zostaw h2. Konfigurację MySQL opisuje artykuł MySQL dla pluginów. Jeśli zmieniasz magazyn danych później, dane nie przeniosą się same:

1. Wyeksportuj je poleceniem lp export prevod. Powstanie plik plugins/LuckPerms/prevod.json.gz.
2. Zatrzymaj serwer i w plugins/LuckPerms/config.yml zmień storage-method (przy MySQL także dane logowania).
3. Uruchom serwer i wczytaj dane poleceniem lp import prevod.json.gz. Nazwę pliku wpisz razem z rozszerzeniem .json.gz.

Zamiast prevod możesz użyć dowolnej nazwy bez spacji i polskich znaków.

Pełne prawa dla siebie#

Po instalacji do poleceń LuckPerms nie ma dostępu nikt poza konsolą i operatorami. Operatorzy mogą domyślnie używać poleceń LuckPerms (opcja commands-allow-op: true w plugins/LuckPerms/config.yml).

1. Połącz się z serwerem, aby LuckPerms poznał Twoje konto.

2. W zakładce Konsola wpisz:

   lp user <NICK> permission set luckperms.* true

   • lp – skrót polecenia LuckPerms (długa forma to luckperms).
   • user <NICK> – edytujemy gracza. Zamiast <NICK> wpisz swoją nazwę w grze, na przykład Steve.
   • permission set – ustawiamy uprawnienie.
   • luckperms.* – wszystkie uprawnienia LuckPerms, czyli dostęp do wszystkich jego poleceń.
   • true – nadaj uprawnienie (false wyraźnie by go zabroniło).

W grze używasz potem poleceń z ukośnikiem (/lp …), w konsoli bez ukośnika.

Tworzenie grup i dziedziczenia#

Zbudujemy strukturę, która pasuje do większości serwerów:

default
├── vip
└── helper
    └── moderator
        └── admin
            └── owner

Każda grupa dziedziczy wszystko po grupie nad sobą. Admin może więc wszystko to, co moderator, moderator wszystko to, co helper, a wszyscy wszystko to, co default. VIP to osobna gałąź, więc VIP nie dostaje praw ekipy.

1. Utwórz grupy razem z wagą. Wpisuj do konsoli po kolei:

   lp creategroup vip 100
   lp creategroup helper 200
   lp creategroup moderator 300
   lp creategroup admin 400
   lp creategroup owner 500

   • creategroup <grupa> – tworzy pustą grupę. Nazwy pisz małymi literami, bez polskich znaków i spacji.
   • Liczba za nazwą to waga. Wyższa waga ma pierwszeństwo. Odstępy co sto zostawiają miejsce na późniejsze grupy (na przykład vip-plus z wagą 150).

2. Ustaw dziedziczenie:

   lp group vip parent add default
   lp group helper parent add default
   lp group moderator parent add helper
   lp group admin parent add moderator
   lp group owner parent add admin

   • group <grupa> – edytujemy grupę.
   • parent add <rodzic> – grupa zaczyna dziedziczyć uprawnienia rodzica. Dziedziczenie łączy się w łańcuch, więc owner dostaje uprawnienia wszystkich grup pod sobą.

3. Nadaj grupom nazwy, które zobaczą gracze (opcjonalnie):

   lp group moderator setdisplayname Moderator

   Wyświetlana nazwa może zawierać polskie znaki. W ten sposób możesz pokazywać grupę default jako „Gracz” bez faktycznej zmiany jej nazwy.

Uprawnienia dla grup#

Uprawnienie dodasz poleceniem lp group <grupa> permission set <uprawnienie> [true|false] [kontekst…]. Jeśli pominiesz wartość, zostanie użyte true.

1. Podstawy dla wszystkich graczy (grupa default), przykład dla EssentialsX:

   lp group default permission set essentials.home
   lp group default permission set essentials.sethome
   lp group default permission set essentials.delhome
   lp group default permission set essentials.spawn
   lp group default permission set essentials.tpa
   lp group default permission set essentials.tpaccept
   lp group default permission set essentials.tpdeny
   lp group default permission set essentials.back
   lp group default permission set essentials.msg
   lp group default permission set essentials.warp
   lp group default permission set essentials.warp.list

   Gracze dostają w ten sposób domy (/home, /sethome, /delhome), powrót na spawn, prośby o teleport (/tpa, /tpaccept, /tpdeny), powrót do ostatniego miejsca (/back), prywatne wiadomości i warpy.

2. VIP z większą liczbą domów i stołem rzemieślniczym w dowolnym miejscu:

   lp group vip permission set essentials.sethome.multiple
   lp group vip permission set essentials.sethome.multiple.vip
   lp group vip permission set essentials.workbench
   lp group vip permission set essentials.hat

   Liczbę domów dla „vip” ustawia się w plugins/Essentials/config.yml w sekcji sethome-multiple (domyślnie 5), zobacz Polecane pluginy.

3. Ekipa (helper, moderator, admin):

   lp group helper permission set essentials.mute
   lp group helper permission set essentials.kick
   lp group helper permission set coreprotect.inspect
   lp group helper permission set coreprotect.lookup
   lp group moderator permission set essentials.tempban
   lp group moderator permission set essentials.vanish
   lp group moderator permission set essentials.invsee
   lp group moderator permission set essentials.tp
   lp group moderator permission set coreprotect.rollback
   lp group moderator permission set coreprotect.restore
   lp group admin permission set essentials.ban
   lp group admin permission set essentials.unban
   lp group admin permission set essentials.gamemode
   lp group admin permission set essentials.fly
   lp group admin permission set worldedit.*
   lp group admin permission set worldguard.region.*
   lp group owner permission set luckperms.*
   lp group owner permission set essentials.*

   Uprawnienia CoreProtect, WorldEdit i WorldGuard wyjaśnia artykuł Polecane pluginy. Symbol wieloznaczny worldedit.* nadaje wszystkie uprawnienia WorldEdita.

Zakazy i wyjątki#

Wartość false wyraźnie zabrania uprawnienia, nawet jeśli grupa je dziedziczy. Przykład: na Paperze gracze mogą domyślnie wyświetlić listę pluginów poleceniem /plugins. Jeśli chcesz ją ukryć:

lp group default permission set bukkit.command.plugins false

Polecenie lp group <grupa> permission unset <uprawnienie> z kolei całkowicie usuwa ustawienie (uprawnienie wraca do stanu „nieustawione”).

Uprawnienia tylko w niektórych miejscach: konteksty#

Na końcu polecenia możesz dodać kontekst. Uprawnienie obowiązuje wtedy tylko pod danym warunkiem:

lp group vip permission set essentials.fly true world=world
lp group default permission set essentials.home false world=pvp_arena

• world=world – VIP może latać tylko w świecie z folderem world (nie w Netherze, world_nether).
• world=pvp_arena – na arenie nie działa /home.

Inne konteksty to gamemode=creative albo server=<NAZWA_SERWERA> dla sieci serwerów (nazwę serwera ustawia opcja server w plugins/LuckPerms/config.yml).

Uprawnienia tymczasowe#

lp user <NICK> permission settemp essentials.fly true 1d

settemp dodaje uprawnienie na określony czas. Czas zapisuje się jako 30m (minuty), 12h (godziny), 7d (dni), 1mo (miesiąc) albo ich kombinację, na przykład 1mo3d12h.

Prefiksy na czacie#

Prefiks to tekst przed nazwą gracza na czacie, na przykład [Admin] Steve: cześć. LuckPerms tylko go przechowuje. Wyświetla go dopiero plugin, który formatuje czat (na przykład EssentialsX Chat), a ten odczytuje go przez plugin Vault. Bez obu prefiks na czacie się nie pojawi.

1. Ustaw prefiksy grupom:

   lp group vip meta setprefix 100 "&6[VIP] "
   lp group helper meta setprefix 200 "&a[Helper] "
   lp group moderator meta setprefix 300 "&9[Moderator] "
   lp group admin meta setprefix 400 "&c[Admin] "
   lp group owner meta setprefix 500 "&4[Właściciel] "

   • meta setprefix – ustawia prefiks i zastępuje poprzedni prefiks grupy.
   • Liczba (od 100 do 500) to priorytet prefiksu. Gdy gracz należy do kilku grup, wyświetla się prefiks z najwyższym priorytetem. Moderator, który jest też VIP-em, dostanie więc prefiks [Moderator].
   • Tekst w cudzysłowie to prefiks. Cudzysłów jest potrzebny ze względu na spację na końcu, która oddziela prefiks od nazwy.
   • &6, &a … to kody kolorów (tabela niżej).

2. Sprawdź, czy plugin czatu odczytuje prefiks: w konsoli wpisz vault-info. Wynik musi podawać LuckPerms jako źródło uprawnień i czatu.

Kody formatowania (&l, &o, &n) wstawiaj za kodem koloru, na przykład &c&l[Admin].

Dodawanie gracza do grupy#

Gracz powinien przynajmniej raz połączyć się z serwerem, aby LuckPerms znał jego konto.

lp user <NICK> parent add vip

• parent add <grupa> – dodaje graczowi grupę. Pozostałe grupy zostają. Przydaje się do nadania VIP-a członkowi ekipy.

lp user <NICK> parent set moderator

• parent set <grupa> – ustawia graczowi tylko tę grupę, a pozostałe mu odbiera. Przydaje się do zmiany rangi.

lp user <NICK> parent remove vip

• parent remove <grupa> – usuwa grupę. Jeśli gracz nie ma żadnej innej, wraca do default.

lp user <NICK> parent addtemp vip 30d

• parent addtemp <grupa> <czas> – grupa na określony czas (tutaj 30 dni), na przykład VIP na miesiąc. Po upływie czasu LuckPerms sam ją usunie.

Edytor WWW#

Zamiast poleceń możesz wszystko edytować w przeglądarce.

1. W konsoli wpisz lp editor.

2. LuckPerms wypisze link. Otwórz go w przeglądarce.

3. Po lewej wybierz grupę lub gracza. Uprawnienia dodasz w polu Add Permission (edytor podpowiada znane uprawnienia), wartości zmienisz kliknięciem w tabelę. Kontekst dodasz przyciskiem Add Contexts.

4. Kliknij Save (albo Ctrl+S).

5. Edytor pokaże polecenie w postaci /lp applyedits <KOD>. Kliknięciem je skopiujesz.

6. Wklej je do konsoli bez ukośnika na początku i naciśnij Enter.

   Konsola wypisze podsumowanie zmian. Dopiero teraz zostały zapisane.

W edytorze waga, prefiks i rodzic są zapisywane jako specjalne uprawnienia: weight.400, prefix.400.&c[Admin] i group.moderator.

Awanse po drabince (tracks)#

Track to drabinka grup, po której awansujesz graczy jednym poleceniem. Nie wpływa na dziedziczenie.

1. Utwórz track i dodaj do niego grupy we właściwej kolejności:

   lp createtrack tym
   lp track tym append helper
   lp track tym append moderator
   lp track tym append admin

2. Awansuj i degraduj:

   lp user <NICK> promote tym
   lp user <NICK> demote tym

   • promote – przesuwa gracza o stopień wyżej i odbiera mu poprzednią grupę z tracka. Jeśli gracza jeszcze nie ma na tracku, dostaje pierwszą grupę (helper).
   • demote – przesuwa gracza o stopień niżej.

Sprawdzanie i szukanie błędów#

Gdy nie wiesz, jakiego uprawnienia potrzebuje polecenie, użyj trybu verbose:

1. W konsoli wpisz lp verbose record <NICK>.
2. Poproś gracza, aby w grze użył polecenia, które nie działa.
3. Wpisz lp verbose upload. LuckPerms wypisze link do przeglądu wszystkich sprawdzeń uprawnień. Szukaj linii z wynikiem false.

Zalecana struktura dla typowego serwera#

Zasady: nadawaj tylko uprawnienia, których grupa naprawdę potrzebuje. Nowe uprawnienia dodawaj najniższej grupie, która ma je mieć, a wyższe grupy je odziedziczą. Wyjątki rozwiązuj wartością false albo kontekstem, a nie kopiowaniem uprawnień do kilku grup.

LuckPerms na Fabricu, Forge i NeoForge#

LuckPerms istnieje też jako mod. Polecenia są takie same, plik trafia do folderu mods, a ustawienia znajdziesz w folderze config, w podfolderze LuckPerms. Różnica: Fabric nie sprawdza uprawnień przy poleceniach samego Minecrafta, więc uprawnienia typu minecraft.command.gamemode nie działają na Fabricu bez dodatkowego moda. Polecenia modów, które obsługują LuckPerms, działają normalnie.

Szybkie przepisy#

Zamiast <NICK> wpisz nazwę gracza w grze. W grze wpisuj polecenia z ukośnikiem (/lp …).

LuckPerms w sieci serwerów (Velocity)#

Gdy prowadzisz kilka serwerów połączonych proxy Velocity, zwykle chcesz mieć wszędzie te same grupy. Procedura w skrócie:

1. Zainstaluj LuckPerms na każdym serwerze i na proxy (wersję dla Velocity). Na proxy polecenia wpisuje się jako lpv zamiast lp.
2. Utwórz jedną bazę danych MariaDB lub MySQL, z którą połączą się wszystkie instancje, zobacz MySQL dla pluginów.
3. Na każdej instancji edytuj plugins/LuckPerms/config.yml (przy zatrzymanym serwerze):

4. Zrestartuj wszystkie serwery i proxy. Zmiana wprowadzona na jednym serwerze pojawi się wtedy także na pozostałych.

Konfigurację samej sieci opisuje artykuł Sieć serwerów przez Velocity.

Weryfikacja#

1. Wpisz lp user <NICK> info dla testowego gracza. W wyniku zobaczysz jego grupy i prefiks.
2. Połącz się jako zwykły gracz (bez operatora, polecenie deop <NICK>) i wypróbuj polecenia, które grupa ma móc używać, oraz te, których nie powinna.
3. Napisz wiadomość na czacie i sprawdź prefiks.

Rozwiązywanie problemów#

Po wpisaniu /lp wyświetla się tylko wersja pluginu#

Nie masz uprawnienia do żadnego polecenia LuckPerms. Nadaj je sobie z konsoli poleceniem lp user <NICK> permission set luckperms.* true.

Uprawnienia nie działają, choć gracz jest w grupie#

• Na serwerze jest inny plugin do uprawnień (PermissionsEx, GroupManager i podobne). LuckPerms musi być jedyny, inne usuń.
• Testujesz jako operator. Operator ma uprawnienia pluginów automatycznie, co zafałszowuje wynik. Testuj bez opa.
• Literówka w nazwie uprawnienia. Sprawdź ją przez lp verbose (wyżej).
• Uprawnienie jest gdzieś ustawione na false. Polecenie lp user <NICK> permission check <uprawnienie> pokaże, skąd pochodzi wartość.

Prefiks nie wyświetla się na czacie#

Brakuje Vaulta albo pluginu formatującego czat. Zainstaluj Vault (lub VaultUnlocked) i EssentialsX Chat, a potem zrestartuj serwer. W EssentialsX Chat format czatu musi zawierać {DISPLAYNAME} albo {PREFIX}. Jeśli gracz widzi inny prefiks, niż oczekujesz, porównaj priorytety w lp user <NICK> meta info.

Zmiany z edytora WWW nie zadziałały#

Nie uruchomiono polecenia lp applyedits <KOD> wygenerowanego po zapisaniu. Zapisz ponownie i uruchom polecenie.

lp user nie znajduje gracza#

Gracz jeszcze nie łączył się z serwerem, więc LuckPerms nie zna jego konta. Poproś go, żeby się połączył, albo użyj jego UUID zamiast nazwy.

Gracz w grupie nie ma prefiksu ani uprawnień po dodaniu przez parent set#

Sprawdź nazwę grupy (lp listgroups). Polecenie parent set z grupą, która nie istnieje, kończy się błędem i niczego graczowi nie dodaje.

Dalsza lektura#

• LuckPerms wiki: pierwsze kroki (otwiera się w nowym oknie)
• LuckPerms wiki: przegląd poleceń (otwiera się w nowym oknie)
• LuckPerms wiki: prefiksy i meta (otwiera się w nowym oknie)
• Paper: uprawnienia poleceń (otwiera się w nowym oknie)