LuckPerms is de permissieplugin waarmee je op een Paper- of Spigot-server bepaalt wie welke commando's mag gebruiken. Zonder permissieplugin zijn er maar twee niveaus: operators die alles mogen en gewone spelers die bijna niets mogen. LuckPerms voegt daar groepen tussen: gasten, bouwers, moderatie. Elke groep heeft permissienodes, en spelers erven de nodes van hun groepen.
Deze guide leidt je van de installatie tot je eerste moderatiegroep. De commando's komen uit de officiële LuckPerms-documentatie; de screenshots zijn gemaakt op een testserver met Paper 1.21.4 en LuckPerms 5.5.71.
Installatie via het panel
In het serverpanel vind je LuckPerms onder Plugins → Browser. De zoekfunctie haalt de gegevens op van Modrinth; loader en serverversie worden gecontroleerd aan de hand van de metadata van de plugin voordat het bestand in de map plugins/ terechtkomt. Wil je het complete pakket, dan installeert de wereldbeveiligingsassistent op de pluginpagina LuckPerms in één stap samen met WorldGuard en WorldEdit. Na de herstart toont de plugin bij het joinen de versie en de auteur.
(Enlarge image)Deze uitvoer verschijnt als je /luckperms of kortweg /lp zonder argumenten invoert. Zo test je het snelst of de plugin echt draait.
Hoe permissies in LuckPerms zijn opgebouwd
Een permissienode is een tekenreeks zoals essentials.home of worldedit.region.set. Elke plugin heeft zijn eigen nodes en documenteert die. Een node kan op true of false staan. Het sterretje in worldedit.* dekt alle nodes van een plugin af: handig voor moderatie, gevaarlijk voor gewone spelers.
LuckPerms kent drie niveaus:
- Groepen bundelen nodes. Elke speler krijgt automatisch de groep
default. - Spelers erven van hun groepen en kunnen daarnaast eigen nodes hebben.
- Contexten beperken nodes, bijvoorbeeld tot een wereld of een spelmodus.
Houd de structuur plat. Twee tot vier groepen zijn voor de meeste servers genoeg.
De eerste groep aanmaken
De volgende commando's voer je uit in de serverconsole of als operator in het spel:
/lp creategroup mod
/lp group mod permission set worldedit.* true
/lp group mod permission set essentials.kick true
/lp user Spelernaam parent add mod
De eerste regel maakt de groep aan. De twee permission set-regels geven de groep volledige toegang tot WorldEdit en het kick-commando van EssentialsX. De laatste regel voegt een speler toe aan de groep. Het resultaat controleer je met /lp user Spielername permission check essentials.kick.
Voor de groep default werkt de omgekeerde aanpak beter: haal commando's weg die spelers niet nodig hebben. Zonder de permissie bukkit.command.plugins toont Paper het commando /plugins helemaal niet meer; de speler ziet alleen een foutmelding over een onbekend commando.
(Enlarge image)/lp group default permission set bukkit.command.plugins false
Dit is strikt genomen geen beveiligingsmaatregel, maar het houdt de pluginlijst wel uit het zicht van nieuwsgierige gasten.
De webeditor
Voor grotere wijzigingen is de console omslachtig. /lp editor genereert een link naar de webeditor op luckperms.net. Daar zie je alle groepen en spelers in een tabel, kun je nodes met de muis instellen en de sessie aan het eind met één klik terugzetten naar de server. De link is enkele minuten geldig en alleen bruikbaar met de gegenereerde code. Sessies bevatten spelersnamen en UUID's, dus deel de link niet met anderen.
Veelgemaakte fouten
- Een permissie werkt niet. De speler is nog operator. Operators omzeilen LuckPerms. Neem
opweg en werk alleen nog met groepen. - Node verkeerd gespeld. LuckPerms accepteert elke tekst, ook typefouten. Controleer de node in de documentatie van de betreffende plugin.
- Sterretje in
default. Een*-node in de standaardgroep geeft elke gast alle rechten. Gebruik sterretjes alleen in moderatiegroepen. - Wijzigingen weg na herstart. LuckPerms slaat standaard op in een H2-bestand in de pluginmap. Als de map bij de herstart niet beschrijfbaar is, gaan wijzigingen verloren. Een blik in de console bij het opstarten laat de fout zien.
Opslaglocatie en back-up
Alle gegevens staan in plugins/LuckPerms/. De back-up via het panel neemt deze map mee. Voor netwerken met meerdere servers biedt LuckPerms een gedeelde MySQL-database; voor één losse server blijft H2 de eenvoudigste keuze.
Verdere guides
Hoe je plugins in het algemeen installeert en bijwerkt, lees je in Plugins installeren en beheren. Wereldbeveiliging met regio's wordt uitgelegd in WorldGuard: regio's beveiligen, de bouwtools in WorldEdit: bouwen en ongedaan maken.
Bronnen
- LuckPerms-wiki: https://luckperms.net/wiki/Home
- Commandoreferentie: https://luckperms.net/wiki/Command-Usage
- Webeditor: https://luckperms.net/wiki/Web-Editor
LuckPerms: voorbeeld bekijken
Eigen opnames uit een demo-omgeving. De getoonde versie en instellingen kunnen afwijken van jouw server.