LuckPerms: skupiny a oprávnenia na Minecraft serveri krok za krokom

LuckPerms je plugin na správu oprávnení. Určuje, kto smie aký príkaz a funkciu, a prideľuje hráčom skupiny ako VIP, Moderátor alebo Admin vrátane prefixu v chate. Prejdeme si, ako oprávnenia fungujú, a potom krok za krokom postavíme kompletnú štruktúru skupín pre bežný server.

Ako oprávnenia fungujú#

Názvy oprávnení nájdete v dokumentácii každého pluginu. Oprávnenia príkazov samotného Minecraftu majú na Paperi tvar minecraft.command.<príkaz>, napríklad minecraft.command.kick alebo minecraft.command.teleport (príkaz /tp). Keď oprávnenie nepoznáte, LuckPerms ho dokáže odhaliť sám, pozrite Kontrola a hľadanie chýb.

Inštalácia a úložisko dát#

1. V záložke Pluginy › Prechádzať vyhľadajte LuckPerms a kliknite na Inštalovať (prípadne nahrajte súbor z luckperms.net/download (otvorí sa v novom okne) do priečinka plugins, pozrite Inštalácia pluginov).
2. Reštartujte server.
3. V konzole overte, že sa LuckPerms zapol (riadok [LuckPerms] Enabling LuckPerms … bez chýb). Pri prvom štarte si plugin stiahne svoje knižnice, štart preto môže trvať o chvíľu dlhšie.

LuckPerms vytvorí priečinok plugins/LuckPerms s nastaveniami v súbore config.yml. Kam ukladá dáta, určuje voľba storage-method:

Pre jeden server nechajte h2. Nastavenie MySQL opisuje článok MySQL pre pluginy. Ak úložisko meníte neskôr, dáta sa neprenesú samy:

1. Exportujte ich príkazom lp export prevod. Vznikne súbor plugins/LuckPerms/prevod.json.gz.
2. Vypnite server a v plugins/LuckPerms/config.yml zmeňte storage-method (pri MySQL aj prihlasovacie údaje).
3. Spustite server a dáta načítajte príkazom lp import prevod.json.gz. Názov súboru píšte aj s príponou .json.gz.

Namiesto prevod môžete použiť ľubovoľný názov bez medzier a diakritiky.

Plné práva pre seba#

Po inštalácii nemá k príkazom LuckPerms prístup nikto okrem konzoly a operátorov. Operátori smú príkazy LuckPerms v predvolenom stave používať (voľba commands-allow-op: true v plugins/LuckPerms/config.yml).

1. Pripojte sa na server, aby LuckPerms poznal váš účet.

2. V záložke Konzola zadajte:

   lp user <NICK> permission set luckperms.* true

   • lp – skratka príkazu LuckPerms (dlhý tvar je luckperms).
   • user <NICK> – upravujeme hráča. Za <NICK> dosaďte svoje herné meno, napríklad Steve.
   • permission set – nastavujeme oprávnenie.
   • luckperms.* – všetky oprávnenia LuckPerms, teda prístup ku všetkým jeho príkazom.
   • true – oprávnenie dať (false by ho výslovne zakázalo).

V hre potom používate príkazy s lomkou (/lp …), v konzole bez lomky.

Vytvorenie skupín a dedičnosti#

Postavíme štruktúru, ktorá sa hodí pre väčšinu serverov:

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

Každá skupina dedí všetko zo skupiny nad sebou. Admin teda vie všetko čo moderátor, moderátor všetko čo helper a všetci všetko čo default. VIP je samostatná vetva, takže VIP nedostane práva tímu.

1. Vytvorte skupiny aj s váhou. Zadávajte postupne do konzoly:

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

   • creategroup <skupina> – vytvorí prázdnu skupinu. Názvy píšte malými písmenami bez diakritiky a medzier.
   • Číslo za názvom je váha. Vyššia váha má prednosť. Medzery po stovkách nechávajú miesto na neskoršie skupiny (napríklad vip-plus s váhou 150).

2. Nastavte dedičnosť:

   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 <skupina> – upravujeme skupinu.
   • parent add <rodič> – skupina začne dediť oprávnenia rodiča. Dedičnosť sa reťazí, owner tak získa oprávnenia všetkých skupín pod sebou.

3. Pomenujte skupiny tak, ako ich uvidia hráči (nepovinné):

   lp group moderator setdisplayname Moderátor

   Zobrazovaný názov smie obsahovať diakritiku. Skupinu default takto môžete premenovať na „Hráč“ bez skutočnej zmeny jej názvu.

Oprávnenia skupinám#

Oprávnenie pridáte príkazom lp group <skupina> permission set <oprávnenie> [true|false] [kontext…]. Keď hodnotu vynecháte, použije sa true.

1. Základ pre všetkých hráčov (skupina default), príklad pre 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

   Hráči tak dostanú domovy (/home, /sethome, /delhome), návrat na spawn, žiadosti o teleport (/tpa, /tpaccept, /tpdeny), návrat na posledné miesto (/back), súkromné správy a warpy.

2. VIP s viacerými domovmi a pracovným stolom odkiaľkoľvek:

   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

   Počet domovov pre „vip“ sa nastavuje v plugins/Essentials/config.yml v sekcii sethome-multiple (predvolene 5), pozrite Odporúčané pluginy.

3. Tím (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.*

   Oprávnenia CoreProtect, WorldEdit a WorldGuard vysvetľuje článok Odporúčané pluginy. Zástupný znak worldedit.* dá všetky oprávnenia WorldEditu.

Zákaz a výnimky#

Hodnota false oprávnenie výslovne zakáže, aj keď ho skupina dedí. Príklad: hráči v predvolenom stave na Paperi smú vypísať zoznam pluginov príkazom /plugins. Ak ho chcete skryť:

lp group default permission set bukkit.command.plugins false

Príkaz lp group <skupina> permission unset <oprávnenie> nastavenie naopak odoberie úplne (oprávnenie sa vráti do stavu „nenastavené“).

Oprávnenie len niekde: kontexty#

Na koniec príkazu môžete pridať kontext. Oprávnenie potom platí len za danej podmienky:

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

• world=world – VIP smie lietať len vo svete s priečinkom world (nie v Netheri world_nether).
• world=pvp_arena – v aréne nefunguje /home.

Ďalšie kontexty sú gamemode=creative alebo server=<NAZEV_SERVERU> pre siete serverov (názov servera nastavuje voľba server v plugins/LuckPerms/config.yml).

Dočasné oprávnenie#

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

settemp pridá oprávnenie na dobu určitú. Dĺžka sa zapisuje ako 30m (minúty), 12h (hodiny), 7d (dni), 1mo (mesiac) alebo kombinácia, napríklad 1mo3d12h.

Prefixy v chate#

Prefix je text pred menom hráča v chate, napríklad [Admin] Steve: ahoj. LuckPerms ho len ukladá. Zobrazí ho až plugin, ktorý formátuje chat (napríklad EssentialsX Chat), a ten si ho prečíta cez plugin Vault. Bez oboch sa prefix v chate neobjaví.

1. Nastavte prefixy skupinám:

   lp group vip meta setprefix 100 "&6[VIP] "
   lp group helper meta setprefix 200 "&a[Helper] "
   lp group moderator meta setprefix 300 "&9[Moderátor] "
   lp group admin meta setprefix 400 "&c[Admin] "
   lp group owner meta setprefix 500 "&4[Majiteľ] "

   • meta setprefix – nastaví prefix a predchádzajúci prefix skupiny nahradí.
   • Číslo (100 až 500) je priorita prefixu. Keď hráč patrí do viacerých skupín, zobrazí sa prefix s najvyššou prioritou. Moderátor s VIP teda uvidí [Moderátor].
   • Text v úvodzovkách je prefix. Úvodzovky sú nutné kvôli medzere na konci, ktorá oddeľuje prefix od mena.
   • &6, &a … sú farebné kódy (tabuľka nižšie).

2. Overte, že chatový plugin prefix číta: v konzole zadajte vault-info. Výpis musí uvádzať LuckPerms ako zdroj oprávnení aj chatu.

Formátovacie kódy (&l, &o, &n) dávajte za farebný kód, napríklad &c&l[Admin].

Pridanie hráča do skupiny#

Hráč by sa mal na server aspoň raz pripojiť, aby LuckPerms poznal jeho účet.

lp user <NICK> parent add vip

• parent add <skupina> – pridá hráčovi skupinu. Ostatné skupiny mu zostanú. Hodí sa pre VIP pri členovi tímu.

lp user <NICK> parent set moderator

• parent set <skupina> – nastaví hráčovi len túto skupinu a ostatné mu odoberie. Hodí sa na zmenu hodnosti.

lp user <NICK> parent remove vip

• parent remove <skupina> – skupinu odoberie. Keď hráč nemá žiadnu inú, vráti sa do default.

lp user <NICK> parent addtemp vip 30d

• parent addtemp <skupina> <doba> – skupina na dobu určitú (tu 30 dní), napríklad pre VIP na mesiac. Po uplynutí ju LuckPerms sám odoberie.

Webový editor#

Namiesto príkazov môžete všetko upraviť v prehliadači.

1. V konzole zadajte lp editor.

2. LuckPerms vypíše odkaz. Otvorte ho v prehliadači.

3. Vľavo vyberte skupinu alebo hráča. Oprávnenie pridáte do poľa Add Permission (editor našepkáva známe oprávnenia), hodnoty upravíte kliknutím do tabuľky. Kontext pridáte tlačidlom Add Contexts.

4. Kliknite na Save (alebo Ctrl+S).

5. Editor zobrazí príkaz v tvare /lp applyedits <KOD>. Kliknutím ho skopírujete.

6. Vložte ho do konzoly bez lomky na začiatku a stlačte Enter.

   Konzola vypíše súhrn zmien. Až teraz sa uložili.

V editore sa váha, prefix a rodič zapisujú ako zvláštne oprávnenia: weight.400, prefix.400.&c[Admin] a group.moderator.

Povýšenie po rebríčku (tracks)#

Track je rebríček skupín, po ktorom hráčov povyšujete jedným príkazom. Na dedičnosť nemá vplyv.

1. Vytvorte track a pridajte doň skupiny v správnom poradí:

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

2. Povyšujte a degradujte:

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

   • promote – posunie hráča o stupeň vyššie a predchádzajúcu skupinu z tracku mu odoberie. Ak na tracku ešte nie je, dostane prvú skupinu (helper).
   • demote – posunie hráča o stupeň nižšie.

Kontrola a hľadanie chýb#

Keď neviete, aké oprávnenie príkaz potrebuje, použite verbose:

1. V konzole zadajte lp verbose record <NICK>.
2. Nech hráč v hre spustí príkaz, ktorý nefunguje.
3. Zadajte lp verbose upload. LuckPerms vypíše odkaz na prehľad všetkých kontrol oprávnení. Hľadajte riadky s výsledkom false.

Odporúčaná štruktúra pre bežný server#

Zásady: dávajte len oprávnenia, ktoré skupina naozaj potrebuje. Nové oprávnenia pridávajte najnižšej skupine, ktorá ich má mať, a vyššie skupiny ich zdedia. Výnimky riešte hodnotou false alebo kontextom, nie kopírovaním oprávnení do viacerých skupín.

LuckPerms na Fabricu, Forge a NeoForge#

LuckPerms existuje aj ako mod. Príkazy sú rovnaké, súbor leží v priečinku mods a nastavenia nájdete v priečinku config v podpriečinku LuckPerms. Rozdiel: Fabric pri príkazoch samotného Minecraftu oprávnenia nekontroluje, takže oprávnenia typu minecraft.command.gamemode na Fabricu bez ďalšieho modu nefungujú. Príkazy modov, ktoré LuckPerms podporujú, fungujú normálne.

Rýchle recepty#

Za <NICK> dosaďte herné meno hráča. Príkazy v hre píšte s lomkou (/lp …).

LuckPerms v sieti serverov (Velocity)#

Keď prevádzkujete niekoľko serverov prepojených proxy Velocity, chcete zvyčajne rovnaké skupiny všade. Postup v skratke:

1. Nainštalujte LuckPerms na každý server aj na proxy (verziu pre Velocity). Na proxy sa príkazy zadávajú ako lpv namiesto lp.
2. Vytvorte jednu databázu MariaDB alebo MySQL, ku ktorej sa pripoja všetky inštancie, pozrite MySQL pre pluginy.
3. Na každej inštancii upravte plugins/LuckPerms/config.yml (pri vypnutom serveri):

4. Reštartujte všetky servery aj proxy. Zmena vykonaná na jednom serveri sa potom prejaví aj na ostatných.

Nastavenie samotnej siete opisuje článok Sieť serverov cez Velocity.

Overenie#

1. Zadajte lp user <NICK> info pri testovacom hráčovi. Vo výpise uvidíte jeho skupiny a prefix.
2. Pripojte sa ako bežný hráč (bez operátora, príkaz deop <NICK>) a vyskúšajte príkazy, ktoré má skupina vedieť, aj tie, ktoré vedieť nemá.
3. Napíšte správu do chatu a skontrolujte prefix.

Keď niečo nefunguje#

Po zadaní /lp sa vypíše len verzia pluginu#

Nemáte oprávnenie na žiadny príkaz LuckPerms. Dajte si ho z konzoly príkazom lp user <NICK> permission set luckperms.* true.

Oprávnenia nefungujú, aj keď je hráč v skupine#

• Na serveri je iný plugin na oprávnenia (PermissionsEx, GroupManager a podobne). LuckPerms musí byť jediný, ostatné odoberte.
• Testujete ako operátor. Operátor má oprávnenia pluginov automaticky a výsledok skresľuje. Testujte bez opa.
• Preklep v názve oprávnenia. Overte ho cez lp verbose (vyššie).
• Oprávnenie je niekde nastavené na false. Príkaz lp user <NICK> permission check <oprávnenie> ukáže, odkiaľ hodnota pochádza.

Prefix sa v chate nezobrazuje#

Chýba Vault alebo plugin na formát chatu. Nainštalujte Vault (alebo VaultUnlocked) a EssentialsX Chat a server reštartujte. Pri EssentialsX Chat musí formát chatu obsahovať {DISPLAYNAME} alebo {PREFIX}. Ak hráč vidí iný prefix, než čakáte, porovnajte priority v lp user <NICK> meta info.

Zmeny z webového editora sa neprejavili#

Nespustili ste príkaz lp applyedits <KOD> vygenerovaný po uložení. Uložte znova a príkaz spustite.

lp user hráča nenájde#

Hráč sa na server ešte nepripojil a LuckPerms nepozná jeho účet. Nechajte ho pripojiť sa alebo použite jeho UUID namiesto mena.

Hráč v skupine nemá prefix ani oprávnenia po pridaní cez parent set#

Skontrolujte názov skupiny (lp listgroups). Príkaz parent set so skupinou, ktorá neexistuje, skončí chybou a hráčovi nič nepridá.

Ďalšie zdroje#

• LuckPerms wiki: začíname (otvorí sa v novom okne)
• LuckPerms wiki: prehľad príkazov (otvorí sa v novom okne)
• LuckPerms wiki: prefixy a meta (otvorí sa v novom okne)
• Paper: oprávnenia príkazov (otvorí sa v novom okne)