LuckPerms: groepen en rechten op een Minecraft-server, stap voor stap

LuckPerms is een plugin voor het beheren van rechten. Hij bepaalt wie welk commando en welke functie mag gebruiken, en kent spelers groepen toe zoals VIP, Moderator of Admin, inclusief een prefix in de chat. We lopen door hoe rechten werken en bouwen daarna stap voor stap een complete groepsstructuur voor een gewone server.

Hoe rechten werken#

De namen van rechten vind je in de documentatie van elke plugin. De rechten voor de commando's van Minecraft zelf hebben op Paper de vorm minecraft.command.<commando>, bijvoorbeeld minecraft.command.kick of minecraft.command.teleport (het commando /tp). Ken je een recht niet, dan kan LuckPerms het zelf opsporen, zie Controleren en fouten opsporen.

Installatie en gegevensopslag#

1. Zoek op het tabblad Plugins › Bladeren naar LuckPerms en klik op Installeren (of upload het bestand van luckperms.net/download (opent in een nieuw venster) naar de map plugins, zie Plugins installeren).
2. Herstart de server.
3. Controleer in de console of LuckPerms is ingeschakeld (de regel [LuckPerms] Enabling LuckPerms … zonder fouten). Bij de eerste start downloadt de plugin zijn bibliotheken, daardoor kan het starten iets langer duren.

LuckPerms maakt de map plugins/LuckPerms aan, met de instellingen in het bestand config.yml. Waar de gegevens worden opgeslagen, bepaalt de optie storage-method:

Laat het voor één server op h2 staan. Het instellen van MySQL staat in het artikel MySQL voor plugins. Wijzig je de opslag later, dan gaan de gegevens niet vanzelf mee:

1. Exporteer ze met het commando lp export prevod. Er ontstaat een bestand plugins/LuckPerms/prevod.json.gz.
2. Stop de server en wijzig in plugins/LuckPerms/config.yml de waarde storage-method (bij MySQL ook de inloggegevens).
3. Start de server en laad de gegevens met het commando lp import prevod.json.gz. Typ de bestandsnaam inclusief de extensie .json.gz.

In plaats van prevod kun je elke naam zonder spaties en accenten gebruiken.

Volledige rechten voor jezelf#

Na de installatie heeft niemand toegang tot de commando's van LuckPerms, behalve de console en operators. Operators mogen de commando's van LuckPerms standaard gebruiken (de optie commands-allow-op: true in plugins/LuckPerms/config.yml).

1. Verbind met de server, zodat LuckPerms je account kent.

2. Voer op het tabblad Console in:

   lp user <NICK> permission set luckperms.* true

   • lp – de afkorting van het LuckPerms-commando (de lange vorm is luckperms).
   • user <NICK> – we bewerken een speler. Vervang <NICK> door je naam in het spel, bijvoorbeeld Steve.
   • permission set – we stellen een recht in.
   • luckperms.* – alle rechten van LuckPerms, dus toegang tot al zijn commando's.
   • true – het recht geven (false zou het uitdrukkelijk verbieden).

In het spel gebruik je de commando's daarna met een slash (/lp …), in de console zonder slash.

Groepen en overerving aanmaken#

We bouwen een structuur die bij de meeste servers past:

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

Elke groep erft alles van de groep erboven. Een admin kan dus alles wat een moderator kan, een moderator alles wat een helper kan en iedereen alles wat default kan. VIP is een aparte tak, dus een VIP krijgt niet de rechten van het team.

1. Maak de groepen aan, meteen met hun gewicht. Voer de regels een voor een in de console in:

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

   • creategroup <groep> – maakt een lege groep aan. Schrijf namen in kleine letters, zonder accenten en spaties.
   • Het getal na de naam is het gewicht. Een hoger gewicht gaat voor. De stappen van honderd laten ruimte voor latere groepen (bijvoorbeeld vip-plus met gewicht 150).

2. Stel de overerving in:

   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 <groep> – we bewerken een groep.
   • parent add <oudergroep> – de groep gaat de rechten van de oudergroep erven. Overerving werkt door in een keten, zo krijgt owner de rechten van alle groepen eronder.

3. Geef de groepen de naam die spelers te zien krijgen (optioneel):

   lp group moderator setdisplayname Moderator

   De weergavenaam mag accenten bevatten. Zo kun je de groep default ook “Speler” noemen zonder dat de echte naam verandert.

Rechten voor groepen#

Een recht voeg je toe met het commando lp group <groep> permission set <recht> [true|false] [context…]. Laat je de waarde weg, dan wordt true gebruikt.

1. De basis voor alle spelers (de groep default), een voorbeeld voor 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

   Spelers krijgen zo homes (/home, /sethome, /delhome), terugkeer naar de spawn, teleportverzoeken (/tpa, /tpaccept, /tpdeny), terugkeer naar de laatste plek (/back), privéberichten en warps.

2. VIP met meer homes en overal een werkbank:

   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

   Het aantal homes voor “vip” stel je in via plugins/Essentials/config.yml, in de sectie sethome-multiple (standaard 5), zie Aanbevolen plugins.

3. Het team (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.*

   De rechten van CoreProtect, WorldEdit en WorldGuard worden uitgelegd in het artikel Aanbevolen plugins. De wildcard worldedit.* geeft alle rechten van WorldEdit.

Verbieden en uitzonderingen#

De waarde false verbiedt een recht uitdrukkelijk, ook als de groep het erft. Een voorbeeld: op Paper mogen spelers standaard de lijst met plugins opvragen met het commando /plugins. Wil je die verbergen:

lp group default permission set bukkit.command.plugins false

Het commando lp group <groep> permission unset <recht> haalt de instelling juist helemaal weg (het recht gaat terug naar de toestand “niet ingesteld”).

Rechten die alleen ergens gelden: contexten#

Aan het einde van het commando kun je een context toevoegen. Het recht geldt dan alleen onder die voorwaarden:

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

• world=world – een VIP mag alleen vliegen in de wereld met de map world (niet in de Nether, world_nether).
• world=pvp_arena – in de arena werkt /home niet.

Andere contexten zijn gamemode=creative of server=<SERVER_NAME> voor servernetwerken (de servernaam stel je in met de optie server in plugins/LuckPerms/config.yml).

Tijdelijk recht#

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

settemp voegt een recht toe voor een bepaalde tijd. De duur schrijf je als 30m (minuten), 12h (uren), 7d (dagen), 1mo (maand) of een combinatie, bijvoorbeeld 1mo3d12h.

Prefixen in de chat#

Een prefix is de tekst vóór de naam van een speler in de chat, bijvoorbeeld [Admin] Steve: hoi. LuckPerms slaat hem alleen op. Getoond wordt hij pas door een plugin die de chat opmaakt (bijvoorbeeld EssentialsX Chat), en die leest hem uit via de plugin Vault. Zonder beide verschijnt de prefix niet in de chat.

1. Stel de prefixen voor de groepen in:

   lp group vip meta setprefix 100 "&6[VIP] "
   lp group helper meta setprefix 200 "&a[Helper] "
   lp group moderator meta setprefix 300 "&9[Moderator] "
   lp group admin meta setprefix 400 "&c[Admin] "
   lp group owner meta setprefix 500 "&4[Eigenaar] "

   • meta setprefix – stelt een prefix in en vervangt de vorige prefix van de groep.
   • Het getal (100 tot en met 500) is de prioriteit van de prefix. Hoort een speler bij meerdere groepen, dan wordt de prefix met de hoogste prioriteit getoond. Een moderator met VIP ziet dus [Moderator].
   • De tekst tussen aanhalingstekens is de prefix. De aanhalingstekens zijn nodig vanwege de spatie aan het einde, die de prefix van de naam scheidt.
   • &6, &a … zijn kleurcodes (tabel hieronder).

2. Controleer of de chatplugin de prefix uitleest: voer in de console vault-info in. De uitvoer moet LuckPerms noemen als bron voor rechten en chat.

Zet opmaakcodes (&l, &o, &n) achter de kleurcode, bijvoorbeeld &c&l[Admin].

Een speler aan een groep toevoegen#

De speler moet minstens één keer met de server verbonden zijn geweest, zodat LuckPerms zijn account kent.

lp user <NICK> parent add vip

• parent add <groep> – voegt een groep toe aan de speler. Zijn andere groepen blijven staan. Handig voor VIP bij een teamlid.

lp user <NICK> parent set moderator

• parent set <groep> – geeft de speler alleen deze groep en haalt de andere weg. Handig bij een rangwijziging.

lp user <NICK> parent remove vip

• parent remove <groep> – haalt de groep weg. Heeft de speler geen andere groep, dan gaat hij terug naar default.

lp user <NICK> parent addtemp vip 30d

• parent addtemp <groep> <duur> – een groep voor een bepaalde tijd (hier 30 dagen), bijvoorbeeld voor een maand VIP. Na afloop haalt LuckPerms de groep zelf weg.

Webeditor#

In plaats van met commando's kun je alles ook in je browser aanpassen.

1. Voer in de console lp editor in.

2. LuckPerms toont een link. Open die in je browser.

3. Kies links een groep of speler. Een recht voeg je toe in het veld Add Permission (de editor stelt bekende rechten voor), waarden pas je aan door in de tabel te klikken. Een context voeg je toe met de knop Add Contexts.

4. Klik op Save (of Ctrl+S).

5. De editor toont een commando in de vorm /lp applyedits <CODE>. Met een klik kopieer je het.

6. Plak het in de console zonder de slash aan het begin en druk op Enter.

   De console toont een samenvatting van de wijzigingen. Pas nu zijn ze opgeslagen.

In de editor worden het gewicht, de prefix en de oudergroep genoteerd als bijzondere rechten: weight.400, prefix.400.&c[Admin] en group.moderator.

Promoveren via een ladder (tracks)#

Een track is een ladder van groepen waarlangs je een speler met één commando promoveert. Op de overerving heeft een track geen invloed.

1. Maak een track aan en voeg de groepen in de juiste volgorde toe:

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

2. Promoveer en degradeer:

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

   • promote – zet de speler een trede hoger en haalt zijn vorige groep van de track weg. Staat hij nog niet op de track, dan krijgt hij de eerste groep (helper).
   • demote – zet de speler een trede lager.

Controleren en fouten opsporen#

Weet je niet welk recht een commando nodig heeft, gebruik dan verbose:

1. Voer in de console lp verbose record <NICK> in.
2. Laat de speler in het spel het commando uitvoeren dat niet werkt.
3. Voer lp verbose upload in. LuckPerms toont een link naar een overzicht van alle rechtencontroles. Zoek de regels met het resultaat false.

Aanbevolen structuur voor een gewone server#

Uitgangspunten: geef alleen de rechten die een groep echt nodig heeft. Voeg nieuwe rechten toe aan de laagste groep die ze moet hebben, de hogere groepen erven ze dan. Los uitzonderingen op met de waarde false of met een context, niet door rechten naar meerdere groepen te kopiëren.

LuckPerms op Fabric, Forge en NeoForge#

LuckPerms bestaat ook als mod. De commando's zijn hetzelfde, het bestand staat in de map mods en de instellingen vind je in de map config, in de submap LuckPerms. Het verschil: Fabric controleert bij de commando's van Minecraft zelf geen rechten, dus rechten zoals minecraft.command.gamemode werken op Fabric niet zonder een extra mod. Commando's van mods die LuckPerms ondersteunen, werken gewoon.

Snelle recepten#

Vervang <NICK> door de naam van de speler in het spel. In het spel typ je de commando's met een slash (/lp …).

LuckPerms in een servernetwerk (Velocity)#

Draai je meerdere servers die via de proxy Velocity met elkaar verbonden zijn, dan wil je meestal overal dezelfde groepen. De aanpak in het kort:

1. Installeer LuckPerms op elke server en op de proxy (de versie voor Velocity). Op de proxy voer je de commando's in als lpv in plaats van lp.
2. Maak één MariaDB- of MySQL-database aan waarmee alle instanties verbinden, zie MySQL voor plugins.
3. Pas op elke instantie plugins/LuckPerms/config.yml aan (terwijl de server uit staat):

4. Herstart alle servers en de proxy. Een wijziging op één server is daarna ook op de andere zichtbaar.

Het instellen van het netwerk zelf staat in het artikel Een servernetwerk met Velocity.

Controle#

1. Voer lp user <NICK> info in voor een testspeler. In de uitvoer zie je zijn groepen en prefix.
2. Verbind als gewone speler (zonder operator, commando deop <NICK>) en probeer de commando's die de groep moet kunnen gebruiken, en ook de commando's die de groep niet mag kunnen gebruiken.
3. Typ een bericht in de chat en controleer de prefix.

Als iets niet werkt#

Na het invoeren van /lp verschijnt alleen de versie van de plugin#

Je hebt voor geen enkel LuckPerms-commando het recht. Geef het jezelf vanuit de console met het commando lp user <NICK> permission set luckperms.* true.

Rechten werken niet, terwijl de speler wel in de groep zit#

• Op de server staat nog een andere plugin voor rechten (PermissionsEx, GroupManager en dergelijke). LuckPerms moet de enige zijn, verwijder de andere.
• Je test als operator. Een operator heeft de rechten van plugins automatisch, en dat vertekent het resultaat. Test zonder op.
• Een typefout in de naam van het recht. Controleer die met lp verbose (hierboven).
• Het recht staat ergens op false. Het commando lp user <NICK> permission check <recht> laat zien waar de waarde vandaan komt.

De prefix verschijnt niet in de chat#

Vault of een plugin voor de chatopmaak ontbreekt. Installeer Vault (of VaultUnlocked) en EssentialsX Chat en herstart de server. Bij EssentialsX Chat moet de chatopmaak {DISPLAYNAME} of {PREFIX} bevatten. Ziet een speler een andere prefix dan je verwacht, vergelijk dan de prioriteiten in lp user <NICK> meta info.

Wijzigingen uit de webeditor zijn niet doorgevoerd#

Je hebt het commando lp applyedits <CODE> dat na het opslaan is gegenereerd, niet uitgevoerd. Sla opnieuw op en voer het commando uit.

lp user vindt de speler niet#

De speler heeft nog niet met de server verbonden en LuckPerms kent zijn account niet. Laat hem verbinden, of gebruik zijn UUID in plaats van zijn naam.

Een speler in een groep heeft geen prefix en geen rechten na toevoegen via parent set#

Controleer de naam van de groep (lp listgroups). Het commando parent set met een groep die niet bestaat, eindigt met een fout en voegt niets toe aan de speler.

Meer bronnen#

• LuckPerms-wiki: aan de slag (opent in een nieuw venster)
• LuckPerms-wiki: overzicht van commando's (opent in een nieuw venster)
• LuckPerms-wiki: prefixen en meta (opent in een nieuw venster)
• Paper: rechten voor commando's (opent in een nieuw venster)