Ranks en permissies op je Minecraft server met LuckPerms

Met LuckPerms bepaal je per groep wat spelers op je Minecraft server mogen. Zo kunnen moderators kicken en bannen zonder dat je ze operator hoeft te maken. LuckPerms werkt als plugin op Paper en Purpur, en als mod op Fabric en NeoForge.

LuckPerms installeren

Open je server in het gamepaneel, ga naar Plugins en zoek op LuckPerms. Klik op Select version, kies de nieuwste versie voor je servertype en klik op Install plugin. Op een Paper- of Purpur-server is dat de Bukkit-versie. Herstart daarna je server.

Op een Fabric- of NeoForge-server is LuckPerms een mod. Zoek het dan onder Mods, of download de juiste versie van luckperms.net en zet die in de map mods. Zie ook Mods, modpacks en werelden installeren.

LuckPerms bewaart je groepen en rechten in een eigen map, op Paper is dat plugins/LuckPerms. Verwijder die map niet, want dan ben je alles kwijt.

Commando's typen

Alle LuckPerms-commando's kun je in de console typen, zonder /. In de game typ je hetzelfde commando met / ervoor, dus /lp in plaats van lp.

Wil je LuckPerms ook in de game gebruiken? Geef jezelf dan eerst alle LuckPerms-rechten via de console:

lp user JouwNaam permission set luckperms.* true

Groepen maken

Iedere speler zit vanzelf in de groep default. Rechten die voor alle spelers gelden, geef je dus aan die groep. Maak daarnaast een groep voor elke rank:

lp creategroup vip
lp creategroup moderator
lp creategroup admin

Met lp listgroups zie je welke groepen er zijn.

Rechten geven en afnemen

Een recht (permission) geef je met lp group <groep> permission set <recht> true. Bijvoorbeeld:

lp group moderator permission set minecraft.command.kick true
lp group moderator permission set minecraft.command.ban true
lp group admin permission set minecraft.command.gamemode true
lp group vip permission set essentials.fly true

Het laatste voorbeeld werkt alleen als je EssentialsX gebruikt. Met permission unset haal je een recht weer weg. Zet je een recht op false, dan mag die groep het juist niet.

Welk recht een commando nodig heeft, staat meestal in de uitleg van de plugin. Je kunt het ook opzoeken: typ lp verbose on Spelersnaam en laat die speler het commando gebruiken. De console toont dan welke rechten de server controleert. Zet het daarna uit met lp verbose off.

Ranks op elkaar laten voortbouwen

Een hogere rank hoort alles te kunnen wat een lagere rank kan. Dat regel je met overerving: een groep krijgt een andere groep als parent.

lp group vip parent add default
lp group moderator parent add default
lp group admin parent add moderator

Nu heeft admin alle rechten van moderator, en hebben vip en moderator alle rechten van default. Je geeft een recht dus maar aan één groep, en de hogere ranks krijgen het vanzelf.

Spelers een rank geven

lp user Steve parent set vip
lp user Alex parent add moderator

• parent set zet de speler in alleen deze groep en haalt de speler uit alle andere groepen.
• parent add voegt een groep toe en laat de andere groepen staan.
• lp user Alex parent remove moderator haalt iemand weer uit een groep.
• lp user Alex info laat zien in welke groepen iemand zit.

Werkt een spelersnaam niet? Laat die speler dan eerst één keer op je server joinen.

Een prefix in de chat

Met een prefix ziet iedereen in de chat welke rank iemand heeft, zoals [Admin] Steve. Je stelt per groep een prefix in:

lp group vip meta setprefix 10 "&a[VIP] "
lp group moderator meta setprefix 50 "&9[Mod] "
lp group admin meta setprefix 100 "&c[Admin] "

Het getal is de prioriteit. Erft een speler meerdere prefixes, dan wint het hoogste getal. Een admin krijgt dus [Admin] en niet [Mod]. De codes &a, &9 en &c maken de tekst groen, blauw en rood.

LuckPerms zet de prefix niet zelf in de chat. Daarvoor heb je een chatplugin nodig, zoals EssentialsX Chat of VaultChatFormatter. Die lezen de prefix via Vault, dus installeer Vault er ook bij. Met vault-info in de console controleer je of Vault de gegevens uit LuckPerms haalt. Staat een plugin niet onder Plugins, upload dan zelf het .jar-bestand: zie Plugins installeren.

Liever klikken? De web-editor

Typ lp editor in de console. Je krijgt een link naar de web-editor van LuckPerms. Open die link in je browser en pas daar je groepen, rechten en prefixes aan met een paar klikken. Klik op Save als je klaar bent. Toont de editor of de console daarna een commando, voer dat dan uit in de console.

Tips

• Geef een groep nooit het recht *. Dan mag iedereen in die groep alles, ook zichzelf admin maken.
• Maak staff geen operator, maar zet ze in een groep. Een operator mag standaard bijna alles, ook dingen die je niet bedoelt.
• Wil je spelers stap voor stap promoveren? Maak een track met lp createtrack staff, lp track staff append moderator en lp track staff append admin. Daarna promoveer je iemand met lp user Steve promote staff en zet je iemand een stap terug met lp user Steve demote staff.
• Draai je meerdere servers achter Velocity? Installeer LuckPerms dan op elke server en laat ze één MySQL-database delen. Die maak je aan onder Databases.
• Met de standaardopslag staan je LuckPerms-gegevens tussen je serverbestanden, dus een back-up bewaart ze ook.