Po co system uprawnień?

Wbudowany system Minecrafta zna tylko dwa poziomy dostepu: zwykły gracz i operator (OP). OP ma dostęp do wszystkiego: /stop, /ban, /gamemode, bloków komend. Nie ma nic pomiedzy. Na serwerze dla 3 znajomych to wystarczy. Na serwerze publicznym to recepta na katastrofe.

Plugin uprawnień rozwiązuje ten problem, dając granularna kontrole. Możesz stworzyć range "Moderator", która pozwala na /kick i /mute, ale nie na /stop ani /op. Albo range "Budowniczy" z dostępem do WorldEdit, ale bez komend administracyjnych.

LuckPerms to standardowy plugin uprawnień od lat. Jest darmowy, open source, aktywnie rozwijany i obsługuje Paper, Spigot, BungeeCord, Velocity, Fabric i Forge. Nie ma powodu, żeby używać czegoś innego.

Instalacja LuckPerms

Pobierz LuckPerms z oficjalnej strony luckperms.net/download. Wybierz wersje odpowiednia dla swojego serwera (Bukkit/Spigot, BungeeCord, Velocity, Fabric, Forge).
Wrzuć plik .jar do folderu plugins/ (lub mods/ dla Fabric/Forge).
Zrestartuj serwer. LuckPerms wygeneruje folder konfiguracyjny plugins/LuckPerms/ z plikiem config.yml.
Sprawdź działanie: wpisz /lp w konsoli. Powinienes zobaczyć informacje o wersji i dostępnych komendach.

Baza danych: Domyślnie LuckPerms używa pliku H2 (lokalnego). Na większych serwerach lub sieciach serwerów przełacz na MySQL/MariaDB w config.yml, żeby moc synchronizować uprawnienia między serwerami.

Tworzenie rang (grup)

Grupa (group) w LuckPerms to ranga. Każdy gracz należy do co najmniej jednej grupy. Domyślna grupa to default, do której trafiają wszyscy nowi gracze.

 # Stwórz grupy
/lp creategroup vip
/lp creategroup helper
/lp creategroup moderator
/lp creategroup admin

# Usuń grupę
/lp deletegroup stara_grupa

# Lista grup
/lp listgroups 

Przypisywanie graczy do rang

 # Ustaw główna grupę gracza
/lp user Gracz parent set vip

# Dodaj dodatkowa grupę (gracz może być w wielu grupach)
/lp user Gracz parent add helper

# Usuń grupę od gracza
/lp user Gracz parent remove vip

# Sprawdź grupy gracza
/lp user Gracz parent info

# Tymczasowa ranga (np. VIP na 30 dni)
/lp user Gracz parent addtemp vip 30d 

Tymczasowe rangi to świetny mechanizm dla serwerów ze sklepem. Gracz kupuje VIP na miesiąc, a LuckPerms automatycznie odbierze range po upływie czasu.

Przypisywanie uprawnień

Każdy plugin definiuje własne permisje (permissions). Na przykład EssentialsX używa essentials.home, essentials.tpa, essentials.fly. Dodajesz je do grupy tak:

 # Dodaj permisje do grupy
/lp group default permission set essentials.home
/lp group default permission set essentials.tpa
/lp group default permission set essentials.spawn

# Odmow permisji (jawne zablokowanie)
/lp group default permission set essentials.fly false

# Usuń permisje z grupy
/lp group vip permission unset essentials.fly

# Dodaj permisje z wildcardem (wszystkie komendy EssentialsX)
/lp group admin permission set essentials.*

# Sprawdź permisje grupy
/lp group default permission info 

Gdzie znaleźć permisje pluginów?

Dokumentacja pluginu (np. EssentialsX Permissions)
Strona pluginu na SpigotMC/BukkitDev (sekcja "Permissions")
Plik plugin.yml wewnątrz .jar pluginu
Komenda /lp verbose on - pokazuje, jakie permisje sa sprawdzane w czasie rzeczywistym

Verbose to Twój najlepszy przyjaciel. Nie wiesz, jaka permisja kontroluje dana komendę? Włącz /lp verbose on, wykonaj komendę jako gracz testowy, a w logach zobaczysz dokładnie, jaka permisja została sprawdzona i czy przeszla. To oszczędza godziny szukania po dokumentacji.

Dziedziczenie rang

Dziedziczenie (inheritance) to mechanizm, dzięki któremu wyższa ranga automatycznie posiada permisje nizszej. Zamiast kopiować te same permisje do każdej grupy, budujesz hierarchie:

 # Moderator dziedziczy po VIP (ma wszystko co VIP + swoje)
/lp group moderator parent add vip

# Admin dziedziczy po Moderator
/lp group admin parent add moderator

# VIP dziedziczy po default
/lp group vip parent add default 

Efekt: Admin ma permisje Admina + Moderatora + VIPa + default. Wystarczy dodać nowa permisje do grupy default, a wszystkie wyższe rangi tez ja dostaną.

Typowa hierarchia rang

 default (wszyscy nowi gracze)
  └── vip (dodatkowe komendy, np. /fly, więcej homow)
        └── helper (kick, mute, sprawdzanie logów)
              └── moderator (ban, tempban, vanish, inspekcja)
                    └── admin (pełna kontrola, konfiguracja pluginów) 

Wagi rang (weight)

Waga określa priorytet rangi. Wyższa waga = ważniejsza ranga. Ma znaczenie przy prefiksach (wyświetlany jest prefiks rangi o najwyższej wadze) i przy konfliktach uprawnien.

 /lp group default meta setweight 1
/lp group vip meta setweight 10
/lp group helper meta setweight 20
/lp group moderator meta setweight 30
/lp group admin meta setweight 100 

Prefiksy i formatowanie czatu

Prefiksy to kolorowe tagi przed nickiem gracza na czacie, np. [Admin], [VIP]. LuckPerms przechowuje prefiksy, ale do ich wyświetlania potrzebujesz pluginu czatu.

Ustawianie prefiksów w LuckPerms

 # Format: /lp group [grupa] meta setprefix [waga] "[prefiks]"
/lp group default meta setprefix 1 "&7[Gracz] "
/lp group vip meta setprefix 10 "&6[VIP] "
/lp group helper meta setprefix 20 "&a[Helper] "
/lp group moderator meta setprefix 30 "&c[Mod] "
/lp group admin meta setprefix 100 "&4[Admin] "

# Sufiksy (po nicku)
/lp group vip meta setsuffix 10 " &e*" 

Kody kolorów: &0-&9 i &a-&f dla kolorów, &l bold, &o italic, &r reset.

Pluginy czatu

LuckPerms sam nie formatuje czatu. Potrzebujesz jednego z tych pluginow:

LPC (LuckPerms Chat Formatter) - minimalistyczny, wbudowany w LuckPerms (włącz w config.yml: apply-wildcards: true). Wystarczy na większość serwerow.
EssentialsX Chat - jeśli już używasz EssentialsX. Format czatu w config.yml EssentialsX.
Vault - warstwa abstrakcji między LuckPerms a pluginami czatu/ekonomii. Wiele pluginów pobiera prefiksy przez Vault.

Edytor webowy LuckPerms

Konfiguracja przez komendy działa, ale przy większej liczbie rang i permisji robi się uciazliwa. LuckPerms ma wbudowany edytor webowy, który pokazuje wszystko w przegladarce:

 # Otwórz edytor webowy
/lp editor 

Serwer wygeneruje jednorazowy link (np. https://luckperms.net/editor/xxxxx). Otwierasz go w przeglądarce i widzisz:

Wszystkie grupy i ich hierarchie (wizualna drzewo)
Permisje każdej grupy (z możliwością dodawania/usuwania)
Metadane (prefiksy, sufiksy, wagi)
Uprawnienia poszczególnych graczy

Po wprowadzeniu zmian klikasz "Save" i kopiujesz komendę, która wklejasz na serwer. Zmiany sa aplikowane natychmiast. To zdecydowanie najwygodniejszy sposób zarządzania uprawnieniami.

Wskazówka: Edytor webowy działa nawet na serwerze bez publicznego IP. Link jest generowany przez serwery LuckPerms i zawiera wszystkie dane. Nie potrzebujesz otwierania portow.

Konteksty - uprawnienia per świat

Konteksty (contexts) pozwalają na przypisanie permisji tylko w określonym świecie lub serwerze. Dzięki temu gracz może mieć /fly w świecie Creative, ale nie w Survival.

 # Permisja tylko w świecie creative
/lp group vip permission set essentials.fly true world=world_creative

# Permisja tylko w świecie survival
/lp group default permission set essentials.home.multiple.5 true world=world

# Na konkretnym serwerze w sieci (BungeeCord/Velocity)
/lp group vip permission set essentials.fly true server=creative 

Konteksty działają z Multiverse i innymi pluginami światów. To potężne narzędzie na serwerach z wieloma światami (więcej o zarządzaniu światami w poradniku o tworzeniu światów).

Przykładowa konfiguracja serwera

Oto kompletny przykład konfiguracji rang dla typowego polskiego serwera Survival z pluginami EssentialsX, WorldGuard i CoreProtect:

Grupa default (nowi gracze)

 /lp group default permission set essentials.home
/lp group default permission set essentials.home.set
/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.msg
/lp group default permission set essentials.mail
/lp group default permission set essentials.balance
/lp group default permission set essentials.pay
/lp group default permission set griefprevention.claims
/lp group default meta setprefix 1 "&7[Gracz] "
/lp group default meta setweight 1 

Grupa VIP

 /lp group vip parent add default
/lp group vip permission set essentials.fly
/lp group vip permission set essentials.home.multiple.5
/lp group vip permission set essentials.nick
/lp group vip permission set essentials.hat
/lp group vip permission set essentials.workbench
/lp group vip meta setprefix 10 "&6[VIP] "
/lp group vip meta setweight 10 

Grupa Moderator

 /lp group moderator parent add vip
/lp group moderator permission set essentials.kick
/lp group moderator permission set essentials.mute
/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 coreprotect.inspect
/lp group moderator permission set coreprotect.rollback
/lp group moderator permission set coreprotect.lookup
/lp group moderator permission set worldguard.region.bypass.*
/lp group moderator meta setprefix 30 "&c[Mod] "
/lp group moderator meta setweight 30 

Grupa Admin

 /lp group admin parent add moderator
/lp group admin permission set *
/lp group admin meta setprefix 100 "&4[Admin] "
/lp group admin meta setweight 100 

Uwaga: Permisja * (wildcard) daje dostęp do WSZYSTKIEGO. Używaj jej tylko dla grupy Admin. Nigdy dla Moderatora, VIPa czy default. Każda grupa powinna mieć tylko te permisje, które naprawdę potrzebuje.

Co dalej?

System uprawnień gotowy. Oto co warto zrobić następnie:

Zabezpiecz serwer przed griefingiem i cheaterami.
Skonfiguruj dodatkowe światy z różnymi regułami.
Dopracuj server.properties pod swoje potrzeby.
Zainstaluj więcej pluginów - ekonomie, sklep, minigry.
Skonfiguruj backupy - w tym dane LuckPerms.
Przesiadz się na Paper dla lepszej wydajności.

Zarządzanie graczami na serwerze Minecraft