LuckPerms to standardowy plugin uprawnień dla serwerów z API Bukkit/Spigot/Paper. Zamienia gołe komendy op na system rang: tworzysz rangi (VIP, MOD, ADMIN), przypisujesz je graczom i definiujesz, co każda grupa może robić.
LuckPerms działa na silnikach pluginowych: Paper, Spigot, CraftBukkit, Purpur, Folia, Leaves, Pufferfish. Na Vanilla, Forge i Fabric nie zadziała — patrz Silnik i wersja serwera.
#Instalacja
- Pobierz najnowszy plik
LuckPerms.jarze strony projektu (luckperms.net). - Zatrzymaj serwer (Stop).
- W FILES wejdź do katalogu
pluginsi wgraj plik (UPLOAD). - Uruchom serwer — przy starcie plugin wygeneruje katalog z konfiguracją.
#Pierwsze komendy
W CONSOLE albo w grze (z uprawnieniami administratora):
lp creategroup vip
lp creategroup mod
lp creategroup admin
lp user Steve parent add vip
lp user Anna parent set mod
lp user Tom parent add admincreategroup— tworzy rangę,parent add/parent set— dodaje / nadaje główną rangę graczowi,lp user Steve info— pokazuje przypisane rangi.
#Przypisywanie uprawnień
Uprawnienie to np. essentials.fly (komenda /fly z EssentialsX) albo minecraft.command.give. Wgraj w grze:
lp group vip permission set essentials.fly true
lp group admin permission set * true
lp group mod meta set prefix "[MOD] "permission set— włącza/wyłącza uprawnienie dla grupy,meta set prefix— kolorowy prefiks przy nicku gracza.
Buduj hierarchię: default → vip → mod → admin. Wyższa dziedziczy wszystko z niższych, więc na ADMIN nie musisz powtarzać uprawnień VIP-a.
#Uprawnienia, które warto ustawić na start
| Grupa | Co ustawić |
|---|---|
default (każdy gracz) |
ochrona przed kickiem, limit /msg, ukryte online |
vip |
kolorowy nick, essentials.fly (opcjonalnie), priorytet wejścia |
mod |
kick, ban, temp-ban, repair, enderchest |
admin |
* (wszystko), minecraft.command.* |
admin z * obejmuje też komendy niszczenia świata (setblock, fill). Jeśli nie chcesz, żeby moderator miał fill — wyłącz je w grupie mod jawnie: lp group mod permission set minecraft.command.fill false.
#Pliki i backup
Dane LuckPerms siedzą w plugins/LuckPerms/ (data/, yml/). Kopia zapasowa serwera obejmuje je automatycznie — rangi nie znikną przy resetcie plików.
#Najczęstsze problemy
#Komenda nie działa, mimo że nadałem rangę
Gracz ma wygasłą sesję — komendy uprawnień wczytują się przy wejściu. Poproś o wyjście i wejście na serwer albo zrób restart.
#lp nic nie robi w grze
Nie masz uprawnień na wykonywanie komend pluginu. Najpierw nadaj sobie rangę w konsoli (lp user TwojNick parent set admin), potem zarządzaj z gry.
#Rangi zniknęły po reinstalacji
Reinstalacja kasuje katalog plugins. Przywróć kopię zapasową albo wgraj plik plugins/LuckPerms/data/*.yml z backupu przez SFTP.
#Co dalej
- Instalacja pluginów
- Whitelist, OP i bany — co zostaje w czystym Minecrafcie
- EssentialsX — komendy, których uprawnienia tu zarządzasz