LuckPerms: uprawnienia na serwerze Minecraft

LuckPerms to najpopularniejszy plugin do zarządzania uprawnieniami (permissions) na serwerze Minecraft. Precyzyjnie ustalasz, co mogą robić gracze. Od podstawowych komend po zaawansowane funkcje pluginów. Przejrzysty edytor w przeglądarce i mocny system grup sprawdzają się na małych i dużych serwerach.

Do instalacji oprogramowanie serwera musi wspierać pluginy (Paper, Purpur, Spigot). Na Vanilla LuckPerms się nie uruchomi. Jeśli trzeba, zmień forka według poradnika Zmiana typu serwera Minecraft w Eternyx Dashboard.

Szybki przegląd

1. Zainstaluj LuckPerms na karcie Wtyczki (albo wgraj plik do plugins / mods).
2. Kliknij Uruchom ponownie.
3. W konsoli wpisz: /lp editor, potem otwórz link.
4. Utwórz grupę (np. gracz, vip, admin).
5. Dodaj uprawnienia (np. minecraft.command.gamemode).
6. Przypisz gracza do grupy: /lp user <gracz> parent set <grupa>.

Czym są uprawnienia (permissions)?

Na serwerze są różne komendy i funkcje. Część należy do Minecrafta, inne dodają pluginy. Do każdej z nich przypisane jest uprawnienie (permission), które określa, kto może z niej korzystać.

Uprawnienie to tekst rozdzielony kropkami, na przykład:

minecraft.command.ban

To uprawnienie do komendy /ban (zobacz Banowanie i odbanowanie gracza na serwerze Minecraft).

• Każdy plugin może mieć własną listę uprawnień
• LuckPerms jest centralnym narzędziem do ich zarządzania
• Uprawnienia przypisujesz graczom albo grupom

1. Instalacja LuckPerms

Instalator pluginów (zalecane)

1. Otwórz serwer w Eternyx Dashboard.
2. Przejdź na kartę Wtyczki.
3. Wyszukaj LuckPerms i zainstaluj.
4. Kliknij Uruchom ponownie. Samo /reload nie wystarczy.

Oprogramowanie serwera musi wspierać pluginy. Paper, Purpur albo Spigot są w porządku.

Ręczne wgranie

Jeśli wgrywasz plik sam, pobierz z oficjalnej strony LuckPerms wersję dopasowaną do serwera:

• Paper / Spigot / Purpur: wersja Bukkit
• Fabric: wersja Fabric
• Forge / NeoForge: wersja Forge / NeoForge

1. Zatrzymaj serwer.
2. Otwórz Przeglądarkę plików.
3. Wgraj plik .jar do właściwego katalogu.

4. Uruchom serwer.

2. Edytor LuckPerms (interfejs webowy)

LuckPerms oferuje przejrzysty edytor w przeglądarce.

Otwarcie edytora

W konsoli wpisz:

lp editor

Kliknij wygenerowany link.

Przy pierwszym otwarciu pojawi się okno z komendą:

/lp trusteditor <kod>

Wklej ją do konsoli serwera.

Co zrobisz w edytorze

• Tworzysz grupy (ranki)
• Dodajesz uprawnienia
• Zarządzasz graczami

Tworzenie grupy

Kliknij + obok GROUP i uzupełnij:

Dodawanie uprawnienia

Po otwarciu grupy wpisz uprawnienie w dolnym wierszu.

Przykłady:

• minecraft.command.ban: pozwala użyć /ban
• minecraft.command.gamemode: pozwala zmieniać tryb gry (np. creative, survival)
• minecraft.command.whitelist: pozwala zarządzać whitelistą

Klikając true albo false zezwalasz albo blokujesz uprawnienie. Jeśli ustawisz bukkit.command.plugins na FALSE, członkowie grupy nie użyją /pl.

3. Podstawowe komendy LuckPerms

Komendy ogólne

• /lp help: pomoc i lista dostępnych komend
• /lp creategroup <grupa>: tworzy nową grupę
• /lp deletegroup <grupa>: usuwa grupę
• /lp listgroups: listuje wszystkie grupy
• /lp editor: link do edytora webowego

Uprawnienia gracza

• /lp user <gracz>: komendy do zarządzania graczem
• /lp user <gracz> permission set <uprawnienie>: dodaje uprawnienie (do blokady dodaj false)
• /lp user <gracz> permission unset <uprawnienie>: usuwa uprawnienie
• /lp user <gracz> permission info: lista uprawnień gracza

Grupy

• /lp group <grupa>: komendy do zarządzania grupą
• /lp group <grupa> permission set <uprawnienie>: uprawnienie dla grupy
• /lp group <grupa> permission unset <uprawnienie>: usuwa uprawnienie z grupy
• /lp group <grupa> permission info: lista uprawnień grupy
• /lp group <grupa> meta setprefix <prefix>: ustawia prefix grupy

Przypisywanie grup

• /lp user <gracz> parent set <grupa>: ustawia główną grupę gracza
• /lp user <gracz> parent addtemp <grupa> 7d: tymczasowa grupa (np. na 7 dni)

Dziedziczenie grup

• /lp group <grupa> parent set <grupa-nadrzedna>: ustawia dziedziczenie (grupa przejmuje uprawnienia rodzica)

4. Baza MySQL (zaawansowane)

Bez bazy uprawnienia zapisują się tylko lokalnie i nie da się ich dzielić między serwerami. Przy sieci (BungeeCord / Velocity) do synchronizacji potrzebujesz MySQL.

1. Otwórz plik /plugins/LuckPerms/config.yml.
2. Ustaw te wartości:

storage-method: MySQL
data:
  address: <IP>
  database: <nazwa-bazy>
  username: <uzytkownik>
  password: '<haslo>'

Jeśli nie wiesz, jak utworzyć bazę, zobacz Tworzenie bazy danych w Eternyx Dashboard.

5. Proxy (BungeeCord / Velocity)

LuckPerms działa też na proxy (BungeeCord albo Velocity). To częste rozwiązanie w większych sieciach.

• Wgraj LuckPerms na proxy (wersję BungeeCord albo Velocity)
• Wgraj LuckPerms też na każdy backend (Paper / Spigot itd.)
• Wszystkie serwery muszą używać tej samej bazy MySQL, inaczej uprawnienia się nie zsynchronizują

Dzięki temu gracze mają te same grupy i prawa w całej sieci.

Komendy na proxy

Jeśli nie masz wspólnego MySQL między proxy a backendem, używasz innych komend:

• /lpb: dla BungeeCord
• /lpv: dla Velocity

Przy poprawnie ustawionej wspólnej bazie wszędzie działa klasyczna komenda:

• /lp: działa na wszystkich serwerach

6. Ustawianie prefixów

LuckPerms tylko przechowuje i zarządza prefixami. Wyświetlanie w grze (chat albo lista TAB) zapewniają inne pluginy.

Pluginy do wyświetlania prefixów

Chat

• LPC (LuckPerms Chat). Zalecane.
• EssentialsX Chat. Część ekosystemu Instalacja i konfiguracja EssentialsX na serwerze Minecraft.

Lista TAB

• TAB (by NEZNAMY)

Częste problemy

Komendy LuckPerms nie działają

• Miej prawa OP: /op <twoj-nick> (zobacz Nadawanie OP na serwerze Minecraft)
• Sprawdź, czy LuckPerms jest wgrany i serwer załadował go bez błędów

Prefixy nie widać na chacie ani na TAB

• Gracz musi być we właściwej grupie
• Jeśli prefix widać tylko w jednym miejscu (np. na TAB, a nie na chacie), brakuje pluginu do chatu
• Sprawdź weight (wagę) grup. Większa liczba = wyższy priorytet.
• Używaj kompatybilnych pluginów (LPC, EssentialsX Chat, TAB)

Uprawnienia nie działają

• Używaj tylko jednego pluginu permission (LuckPerms)
• Sprawdź, czy podane uprawnienie naprawdę istnieje
• Upewnij się, że nie ustawiłeś wartości false
• Po większych zmianach zrestartuj serwer

Uwaga: Na Fabric uprawnienia vanilla Minecraft nie zawsze działają. To ograniczenie Fabric.

Uprawnienia nie synchronizują się między serwerami

• Brak ustawionej bazy MySQL
• Każdy serwer zapisuje lokalnie. Użyj MySQL (patrz sekcja wyżej).
• Sprawdź, czy wszystkie serwery mają te same dane dostępowe do bazy

Prefixy wyświetlają się w złej kolejności

• Źle ustawione wartości weight
• Kilka grup może się gryźć (np. gracz ma kilka ranków)
• Sprawdź kolejność i priorytet grup

Do prywatnego dostępu na serwer przyda Ci się też Ustawianie whitelist na serwerze Minecraft.