LuckPerms: skupiny a oprávnění na Minecraft serveru krok za krokem

LuckPerms je plugin pro správu oprávnění. Určuje, kdo smí jaký příkaz a funkci, a přiděluje hráčům skupiny jako VIP, Moderátor nebo Admin včetně prefixu v chatu. Projdeme, jak oprávnění fungují, a pak krok za krokem postavíme kompletní strukturu skupin pro běžný server.

Jak oprávnění fungují#

Názvy oprávnění najdete v dokumentaci každého pluginu. Oprávnění příkazů samotného Minecraftu mají na Paperu tvar minecraft.command.<příkaz>, například minecraft.command.kick nebo minecraft.command.teleport (příkaz /tp). Když oprávnění neznáte, LuckPerms ho umí odhalit sám, viz Kontrola a hledání chyb.

Instalace a úložiště dat#

1. V záložce Pluginy › Procházet vyhledejte LuckPerms a klikněte na Instalovat (případně nahrajte soubor z luckperms.net/download (otevře se v novém okně) do složky plugins, viz Instalace pluginů).
2. Restartujte server.
3. V konzoli ověřte, že se LuckPerms zapnul (řádek [LuckPerms] Enabling LuckPerms … bez chyb). Při prvním startu si plugin stáhne své knihovny, start proto může trvat o chvíli déle.

LuckPerms vytvoří složku plugins/LuckPerms s nastavením v souboru config.yml. Kam ukládá data, určuje volba storage-method:

Pro jeden server nechte h2. Nastavení MySQL popisuje článek MySQL pro pluginy. Pokud úložiště měníte později, data se nepřenesou sama:

1. Exportujte je příkazem lp export prevod. Vznikne soubor plugins/LuckPerms/prevod.json.gz.
2. Vypněte server a v plugins/LuckPerms/config.yml změňte storage-method (u MySQL i přihlašovací údaje).
3. Spusťte server a data načtěte příkazem lp import prevod.json.gz. Název souboru pište i s příponou .json.gz.

Místo prevod můžete použít libovolný název bez mezer a diakritiky.

Plná práva pro sebe#

Po instalaci nemá k příkazům LuckPerms přístup nikdo kromě konzole a operátorů. Operátoři příkazy LuckPerms ve výchozím stavu používat smějí (volba commands-allow-op: true v plugins/LuckPerms/config.yml).

1. Připojte se na server, aby LuckPerms znal váš účet.

2. V záložce Konzole zadejte:

   lp user <NICK> permission set luckperms.* true

   • lp – zkratka příkazu LuckPerms (dlouhý tvar je luckperms).
   • user <NICK> – upravujeme hráče. Za <NICK> dosaďte své herní jméno, například Steve.
   • permission set – nastavujeme oprávnění.
   • luckperms.* – všechna oprávnění LuckPerms, tedy přístup ke všem jeho příkazům.
   • true – oprávnění dát (false by ho výslovně zakázalo).

Ve hře pak používáte příkazy s lomítkem (/lp …), v konzoli bez lomítka.

Vytvoření skupin a dědičnosti#

Postavíme strukturu, která se hodí pro většinu serverů:

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

Každá skupina dědí všechno ze skupiny nad sebou. Admin tedy umí vše co moderátor, moderátor vše co helper a všichni vše co default. VIP je samostatná větev, takže VIP nedostane práva týmu.

1. Vytvořte skupiny i s vahou. Zadávejte postupně do konzole:

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

   • creategroup <skupina> – vytvoří prázdnou skupinu. Názvy pište malými písmeny bez diakritiky a mezer.
   • Číslo za názvem je váha. Vyšší váha má přednost. Mezery po stovkách nechávají místo na pozdější skupiny (třeba vip-plus s vahou 150).

2. Nastavte dědičnost:

   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 dědit oprávnění rodiče. Dědičnost se řetězí, owner tak získá oprávnění všech skupin pod sebou.

3. Pojmenujte skupiny tak, jak je uvidí hráči (nepovinné):

   lp group moderator setdisplayname Moderátor

   Zobrazovaný název smí obsahovat diakritiku. Skupinu default takto můžete přejmenovat na „Hráč“ bez skutečné změny jejího názvu.

Oprávnění skupinám#

Oprávnění přidáte příkazem lp group <skupina> permission set <oprávnění> [true|false] [kontext…]. Když hodnotu vynecháte, použije se true.

1. Základ pro všechny hráče (skupina default), příklad pro 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 dostanou domovy (/home, /sethome, /delhome), návrat na spawn, žádosti o teleport (/tpa, /tpaccept, /tpdeny), návrat na poslední místo (/back), soukromé zprávy a warpy.

2. VIP s více domovy a pracovním stolem odkudkoli:

   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 domovů pro „vip“ se nastavuje v plugins/Essentials/config.yml v sekci sethome-multiple (výchozí 5), viz Doporučené 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ávnění CoreProtect, WorldEdit a WorldGuard vysvětluje článek Doporučené pluginy. Zástupný znak worldedit.* dá všechna oprávnění WorldEditu.

Zákaz a výjimky#

Hodnota false oprávnění výslovně zakáže, i když ho skupina dědí. Příklad: hráči ve výchozím stavu na Paperu smějí vypsat seznam pluginů příkazem /plugins. Pokud ho chcete skrýt:

lp group default permission set bukkit.command.plugins false

Příkaz lp group <skupina> permission unset <oprávnění> nastavení naopak odebere úplně (oprávnění se vrátí do stavu „nenastaveno“).

Oprávnění jen někde: kontexty#

Na konec příkazu můžete přidat kontext. Oprávnění pak platí jen za dané podmínky:

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

• world=world – VIP smí létat jen ve světě se složkou world (ne v Netheru world_nether).
• world=pvp_arena – v aréně nefunguje /home.

Další kontexty jsou gamemode=creative nebo server=<NAZEV_SERVERU> pro sítě serverů (název serveru nastavuje volba server v plugins/LuckPerms/config.yml).

Dočasné oprávnění#

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

settemp přidá oprávnění na dobu určitou. Délka se zapisuje jako 30m (minuty), 12h (hodiny), 7d (dny), 1mo (měsíc) nebo kombinace, například 1mo3d12h.

Prefixy v chatu#

Prefix je text před jménem hráče v chatu, například [Admin] Steve: ahoj. LuckPerms ho jen ukládá. Zobrazí ho až plugin, který formátuje chat (například EssentialsX Chat), a ten si ho přečte přes plugin Vault. Bez obou se prefix v chatu neobjeví.

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[Majitel] "

   • meta setprefix – nastaví prefix a předchozí prefix skupiny nahradí.
   • Číslo (100 až 500) je priorita prefixu. Když hráč patří do více skupin, zobrazí se prefix s nejvyšší prioritou. Moderátor s VIP tedy uvidí [Moderátor].
   • Text v uvozovkách je prefix. Uvozovky jsou nutné kvůli mezeře na konci, která odděluje prefix od jména.
   • &6, &a … jsou barevné kódy (tabulka níže).

2. Ověřte, že chatový plugin prefix čte: v konzoli zadejte vault-info. Výpis musí uvádět LuckPerms jako zdroj oprávnění a chatu.

Formátovací kódy (&l, &o, &n) dávejte za barevný kód, například &c&l[Admin].

Přidání hráče do skupiny#

Hráč by se měl na server aspoň jednou připojit, aby LuckPerms znal jeho účet.

lp user <NICK> parent add vip

• parent add <skupina> – přidá hráči skupinu. Ostatní skupiny mu zůstanou. Hodí se pro VIP u člena týmu.

lp user <NICK> parent set moderator

• parent set <skupina> – nastaví hráči jen tuto skupinu a ostatní mu odebere. Hodí se pro změnu hodnosti.

lp user <NICK> parent remove vip

• parent remove <skupina> – skupinu odebere. Když hráč nemá žádnou jinou, vrátí se do default.

lp user <NICK> parent addtemp vip 30d

• parent addtemp <skupina> <doba> – skupina na dobu určitou (tady 30 dní), třeba pro VIP na měsíc. Po uplynutí ji LuckPerms sám odebere.

Webový editor#

Místo příkazů můžete všechno upravit v prohlížeči.

1. V konzoli zadejte lp editor.

2. LuckPerms vypíše odkaz. Otevřete ho v prohlížeči.

3. Vlevo vyberte skupinu nebo hráče. Oprávnění přidáte do pole Add Permission (editor našeptává známá oprávnění), hodnoty upravíte kliknutím do tabulky. Kontext přidáte tlačítkem Add Contexts.

4. Klikněte na Save (nebo Ctrl+S).

5. Editor zobrazí příkaz ve tvaru /lp applyedits <KOD>. Kliknutím ho zkopírujete.

6. Vložte ho do konzole bez lomítka na začátku a stiskněte Enter.

   Konzole vypíše souhrn změn. Teprve teď se uložily.

V editoru se váha, prefix a rodič zapisují jako zvláštní oprávnění: weight.400, prefix.400.&c[Admin] a group.moderator.

Povýšení po žebříčku (tracks)#

Track je žebříček skupin, po kterém hráče povyšujete jedním příkazem. Na dědičnost nemá vliv.

1. Vytvořte track a přidejte do něj skupiny ve správném pořadí:

   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 – posune hráče o stupeň výš a předchozí skupinu z tracku mu odebere. Pokud na tracku ještě není, dostane první skupinu (helper).
   • demote – posune hráče o stupeň níž.

Kontrola a hledání chyb#

Když nevíte, jaké oprávnění příkaz potřebuje, použijte verbose:

1. V konzoli zadejte lp verbose record <NICK>.
2. Ať hráč ve hře spustí příkaz, který nefunguje.
3. Zadejte lp verbose upload. LuckPerms vypíše odkaz na přehled všech kontrol oprávnění. Hledejte řádky s výsledkem false.

Doporučená struktura pro běžný server#

Zásady: dávejte jen oprávnění, která skupina opravdu potřebuje. Nová oprávnění přidávejte nejnižší skupině, která je má mít, a vyšší skupiny je zdědí. Výjimky řešte hodnotou false nebo kontextem, ne kopírováním oprávnění do více skupin.

LuckPerms na Fabricu, Forge a NeoForge#

LuckPerms existuje i jako mód. Příkazy jsou stejné, soubor leží ve složce mods a nastavení najdete ve složce config v podsložce LuckPerms. Rozdíl: Fabric u příkazů samotného Minecraftu oprávnění nekontroluje, takže oprávnění typu minecraft.command.gamemode na Fabricu bez dalšího módu nefungují. Příkazy módů, které LuckPerms podporují, fungují normálně.

Rychlé recepty#

Za <NICK> dosaďte herní jméno hráče. Příkazy ve hře pište s lomítkem (/lp …).

LuckPerms v síti serverů (Velocity)#

Když provozujete několik serverů propojených proxy Velocity, chcete obvykle stejné skupiny všude. Postup v kostce:

1. Nainstalujte LuckPerms na každý server a na proxy (verzi pro Velocity). Na proxy se příkazy zadávají jako lpv místo lp.
2. Vytvořte jednu databázi MariaDB nebo MySQL, ke které se připojí všechny instance, viz MySQL pro pluginy.
3. Na každé instanci upravte plugins/LuckPerms/config.yml (při vypnutém serveru):

4. Restartujte všechny servery i proxy. Změna provedená na jednom serveru se pak projeví i na ostatních.

Nastavení samotné sítě popisuje článek Síť serverů přes Velocity.

Ověření#

1. Zadejte lp user <NICK> info u testovacího hráče. Ve výpisu uvidíte jeho skupiny a prefix.
2. Připojte se jako běžný hráč (bez operátora, příkaz deop <NICK>) a vyzkoušejte příkazy, které má skupina umět, i ty, které umět nemá.
3. Napište zprávu do chatu a zkontrolujte prefix.

Když něco nefunguje#

Po zadání /lp se vypíše jen verze pluginu#

Nemáte oprávnění k žádnému příkazu LuckPerms. Dejte si ho z konzole příkazem lp user <NICK> permission set luckperms.* true.

Oprávnění nefungují, i když je hráč ve skupině#

• Na serveru je jiný plugin na oprávnění (PermissionsEx, GroupManager a podobně). LuckPerms musí být jediný, jiné odeberte.
• Testujete jako operátor. Operátor má oprávnění pluginů automaticky a výsledek zkresluje. Testujte bez opa.
• Překlep v názvu oprávnění. Ověřte ho přes lp verbose (výše).
• Oprávnění je někde nastavené na false. Příkaz lp user <NICK> permission check <oprávnění> ukáže, odkud hodnota pochází.

Prefix se v chatu nezobrazuje#

Chybí Vault nebo plugin na formát chatu. Nainstalujte Vault (nebo VaultUnlocked) a EssentialsX Chat a server restartujte. U EssentialsX Chat musí formát chatu obsahovat {DISPLAYNAME} nebo {PREFIX}. Pokud hráč vidí jiný prefix, než čekáte, porovnejte priority v lp user <NICK> meta info.

Změny z webového editoru se neprojevily#

Nespustili jste příkaz lp applyedits <KOD> vygenerovaný po uložení. Uložte znovu a příkaz spusťte.

lp user hráče nenajde#

Hráč se na server ještě nepřipojil a LuckPerms nezná jeho účet. Nechte ho se připojit, nebo použijte jeho UUID místo jména.

Hráč ve skupině nemá prefix ani oprávnění po přidání přes parent set#

Zkontrolujte název skupiny (lp listgroups). Příkaz parent set se skupinou, která neexistuje, skončí chybou a hráči nic nepřidá.

Další zdroje#

• LuckPerms wiki: začínáme (otevře se v novém okně)
• LuckPerms wiki: přehled příkazů (otevře se v novém okně)
• LuckPerms wiki: prefixy a meta (otevře se v novém okně)
• Paper: oprávnění příkazů (otevře se v novém okně)