LuckPerms to plugin do zarządzania uprawnieniami, dzięki któremu na serwerze Paper lub Spigot ustalisz, kto może używać których komend. Bez takiego pluginu istnieją tylko dwa poziomy: operator, który może wszystko, i zwykli gracze, którzy nie mogą prawie nic. LuckPerms wprowadza pomiędzy nie grupy: gości, budowniczych, moderację. Każda grupa ma przypisane węzły uprawnień, a gracze dziedziczą węzły swoich grup.

Ten poradnik przeprowadzi Cię od instalacji po utworzenie pierwszej grupy moderatorów. Komendy pochodzą z oficjalnej dokumentacji LuckPerms, a zrzuty ekranu z serwera testowego z Paper 1.21.4 i LuckPerms 5.5.71.

Instalacja przez panel

W panelu serwera znajdziesz LuckPerms w sekcji Plugins → Browser. Wyszukiwarka pobiera dane z Modrinth; loader i wersja serwera są sprawdzane pod kątem zgodności z metadanymi pluginu, zanim plik trafi do folderu plugins/. Jeśli chcesz mieć cały pakiet, asystent ochrony świata na stronie pluginów zainstaluje LuckPerms razem z WorldGuard i WorldEdit w jednym kroku. Po restarcie i dołączeniu do serwera plugin pokaże swoją wersję i autora.

Czat po dołączeniu do serwera: LuckPerms 5.5.71 jest załadowany, widać stronę internetową i autora (Enlarge image)

Ten komunikat pojawia się, gdy wpiszesz /luckperms lub w skrócie /lp bez argumentów. To najszybszy sposób, aby sprawdzić, czy plugin naprawdę działa.

Jak zbudowane są uprawnienia w LuckPerms

Węzeł uprawnień to ciąg znaków, taki jak essentials.home lub worldedit.region.set. Każdy plugin ma własne węzły i opisuje je w swojej dokumentacji. Węzeł może mieć wartość true albo false. Gwiazdka w worldedit.* obejmuje wszystkie węzły danego pluginu, co jest wygodne dla moderacji, ale niebezpieczne w przypadku zwykłych graczy.

LuckPerms ma trzy poziomy:

  • Grupy łączą węzły w zestawy. Do grupy default automatycznie należy każdy gracz.
  • Gracze dziedziczą węzły ze swoich grup i mogą dodatkowo mieć własne.
  • Konteksty ograniczają działanie węzłów, na przykład do jednego świata lub trybu gry.

Utrzymuj płaską strukturę. Na większości serwerów wystarczą od dwóch do czterech grup.

Tworzenie pierwszej grupy

Poniższe komendy możesz wykonać w konsoli serwera lub w grze jako operator:

/lp creategroup mod
/lp group mod permission set worldedit.* true
/lp group mod permission set essentials.kick true
/lp user NazwaGracza parent add mod

Pierwsza linia tworzy grupę. Dwie linie z permission set dają jej pełny dostęp do WorldEdit oraz komendę kick z EssentialsX. Ostatnia linia dodaje gracza do grupy. Wynik sprawdzisz komendą /lp user Spielername permission check essentials.kick, podając w niej nazwę gracza.

W przypadku grupy default warto pójść w odwrotną stronę i odebrać komendy, których gracze nie potrzebują. Bez uprawnienia bukkit.command.plugins Paper w ogóle nie udostępni komendy /plugins, a gracz zobaczy jedynie komunikat o nieznanej komendzie.

Bez uprawnienia bukkit.command.plugins serwer zgłasza nieznaną komendę (Enlarge image)
/lp group default permission set bukkit.command.plugins false

Nie jest to zabezpieczenie w ścisłym sensie, ale chroni listę pluginów przed ciekawskimi gośćmi.

Edytor webowy

Przy większych zmianach praca w konsoli jest niewygodna. Komenda /lp editor generuje link do edytora webowego na luckperms.net. Zobaczysz tam wszystkie grupy i graczy w tabeli, ustawisz węzły myszą, a na koniec jednym kliknięciem prześlesz sesję z powrotem na serwer. Link jest ważny przez kilka minut i działa tylko z wygenerowanym kodem. Sesje zawierają nazwy graczy i identyfikatory UUID, więc nie udostępniaj nikomu tego linku.

Typowe błędy

  • Uprawnienie nie działa. Gracz nadal jest operatorem, a operatorzy omijają LuckPerms. Odbierz mu op i korzystaj już tylko z grup.
  • Błędnie zapisany węzeł. LuckPerms przyjmie każdy tekst, także z literówkami. Sprawdź węzeł w dokumentacji danego pluginu.
  • Gwiazdka w default. Węzeł * w grupie domyślnej daje każdemu gościowi dostęp do wszystkiego. Używaj gwiazdek tylko w grupach moderatorów.
  • Zmiany znikają po restarcie. LuckPerms domyślnie zapisuje dane w pliku H2 w folderze pluginu. Jeśli podczas restartu nie można zapisywać w tym folderze, zmiany przepadną. Błąd zobaczysz w konsoli podczas uruchamiania serwera.

Lokalizacja danych i kopia zapasowa

Wszystkie dane znajdują się w plugins/LuckPerms/. Kopia zapasowa z panelu obejmuje również ten folder. Dla sieci z wieloma serwerami LuckPerms oferuje wspólną bazę danych MySQL, a przy pojedynczym serwerze H2 pozostaje najprostszym wyborem.

Dalsze poradniki

Ogólne informacje o instalowaniu i aktualizowaniu pluginów znajdziesz w poradniku Instalowanie pluginów i zarządzanie nimi. Ochronę świata za pomocą regionów wyjaśnia poradnik WorldGuard: ochrona regionów, a narzędzia budowlane poradnik WorldEdit: budowanie i cofanie zmian.

Źródła

LuckPerms: zobacz przykład

Własne nagrania ze środowiska demonstracyjnego. Pokazana wersja i konfiguracja mogą różnić się od twojego serwera.

LuckPerms: Without permission, the tested plugin-list command is unavailable.
Without permission, the tested plugin-list command is unavailable.

LuckPerms 5.5.71 · 2026-09-12

LuckPerms: After the permission change, the same command returns the plugin list.
After the permission change, the same command returns the plugin list.

LuckPerms 5.5.71 · 2026-09-12