Permissions instellen

Met het Oxide permission systeem bepaal je precies welke spelers of groepen toegang hebben tot bepaalde functies van plugins. Wil je dat alleen VIP-spelers kunnen teleporteren? Of dat moderators speciale commando's kunnen gebruiken? Dan heb je permissions nodig. In dit artikel leggen we uit hoe het systeem werkt en hoe je het instelt.

Hoe werkt het permission systeem?

Het Oxide permission systeem werkt met twee belangrijke concepten:

Permissions -- Dit zijn specifieke rechten die een plugin aanbiedt. Bijvoorbeeld: nteleportation.home geeft toegang tot het /home commando van de NTeleportation plugin.
Groepen -- Je kunt spelers indelen in groepen (zoals "VIP", "Moderator", "Admin") en permissions toewijzen aan een hele groep in plaats van aan individuele spelers.

Standaard bestaan er twee groepen:

default -- Alle spelers zitten automatisch in deze groep. Permissions die je aan "default" toekent, gelden voor iedereen.
admin -- Beheerders van de server.

Het permission systeem is additief: spelers krijgen alle permissions van alle groepen waar ze in zitten, plus eventuele individuele permissions die direct aan hen zijn toegewezen. Permissions kunnen niet worden "ontnomen" als ze door een groep worden gegeven -- je moet de permission van de groep verwijderen.

Permissions van een plugin bekijken

Voordat je permissions kunt toewijzen, moet je weten welke permissions een plugin aanbiedt. Dit kun je op twee manieren opzoeken:

Op umod.org -- Op de pluginpagina staat een sectie "Permissions" waar alle beschikbare permissions worden beschreven.
Via de console -- Typ oxide.show perms om een lijst te zien van alle geregistreerde permissions van alle geladen plugins.

Groepen aanmaken en beheren

Het is verstandig om groepen aan te maken in plaats van permissions per speler toe te wijzen. Zo kun je eenvoudig rechten beheren voor grote groepen spelers. Alle groep-commando's voer je uit via de Console tab:

Een groep aanmaken

oxide.group add VIP

Dit maakt een nieuwe groep aan met de naam "VIP". Je kunt elke naam kiezen die je wilt, zoals "Moderator", "Donator", "Builder", enzovoort.

Een groep aanmaken met een titel en rang

oxide.group add VIP "VIP Speler" 1

Hierbij is "VIP Speler" de weergavetitel en 1 de rang (hoe hoger het getal, hoe hoger de prioriteit). De rang is belangrijk als een speler in meerdere groepen zit, want de groep met de hoogste rang bepaalt de weergave.

Een groep verwijderen

oxide.group remove VIP

Een overzicht van alle groepen bekijken

oxide.show groups

Permissions toewijzen aan een groep

Nu je een groep hebt aangemaakt, kun je permissions eraan toewijzen. Dit doe je met het oxide.grant commando:

Een permission aan een groep geven

oxide.grant group VIP nteleportation.home

Dit geeft alle spelers in de groep "VIP" toegang tot het /home commando van NTeleportation.

Meerdere permissions toewijzen

Je moet elke permission apart toewijzen. Er is geen manier om meerdere permissions in een keer toe te kennen. Voer het commando dus meerdere keren uit:

oxide.grant group VIP nteleportation.home
oxide.grant group VIP nteleportation.tpr
oxide.grant group VIP backpacks.use
oxide.grant group VIP backpacks.size.48

Een permission verwijderen van een groep

oxide.revoke group VIP nteleportation.home

Permissions van een groep bekijken

oxide.show group VIP

Dit toont alle permissions die aan de groep "VIP" zijn toegewezen.

Spelers aan groepen toevoegen

Om een speler aan een groep toe te voegen, heb je het SteamID (ook wel Steam64 ID genoemd) van de speler nodig. Dit is een lang getal dat er bijvoorbeeld uitziet als 76561198012345678. Je kunt het SteamID van een speler opzoeken via steamid.io.

Een speler aan een groep toevoegen

oxide.usergroup add 76561198012345678 VIP

Een speler uit een groep verwijderen

oxide.usergroup remove 76561198012345678 VIP

Bekijken in welke groepen een speler zit

oxide.show user 76561198012345678

Dit toont alle groepen en individuele permissions van de opgegeven speler.

Per-speler permissions

In sommige gevallen wil je een permission aan een specifieke speler geven zonder een groep aan te maken. Dit kan ook:

Een permission aan een speler geven

oxide.grant user 76561198012345678 nteleportation.home

Een permission van een speler verwijderen

oxide.revoke user 76561198012345678 nteleportation.home

Tip: Het is bijna altijd beter om permissions via groepen te beheren in plaats van per speler. Zo houd je het overzichtelijk, vooral als je veel spelers hebt. Gebruik per-speler permissions alleen in uitzonderlijke gevallen.

Overzicht van alle permission commando's

Hieronder vind je een handig overzicht van alle veelgebruikte permission commando's:

Commando	Beschrijving
`oxide.show perms`	Toon alle geregistreerde permissions
`oxide.show groups`	Toon alle groepen
`oxide.show group Naam`	Toon details en permissions van een groep
`oxide.show user SteamID`	Toon groepen en permissions van een speler
`oxide.group add Naam`	Maak een nieuwe groep aan
`oxide.group remove Naam`	Verwijder een groep
`oxide.grant group Naam permission`	Geef een permission aan een groep
`oxide.revoke group Naam permission`	Verwijder een permission van een groep
`oxide.grant user SteamID permission`	Geef een permission aan een speler
`oxide.revoke user SteamID permission`	Verwijder een permission van een speler
`oxide.usergroup add SteamID Groep`	Voeg een speler toe aan een groep
`oxide.usergroup remove SteamID Groep`	Verwijder een speler uit een groep

Voorbeeld: een VIP systeem opzetten

Stel dat je een VIP-groep wilt aanmaken met extra teleportatie-rechten en een grotere rugzak. Dit is hoe je dat doet:

oxide.group add VIP "VIP" 1
oxide.grant group VIP nteleportation.home
oxide.grant group VIP nteleportation.tpr
oxide.grant group VIP nteleportation.town
oxide.grant group VIP backpacks.use
oxide.grant group VIP backpacks.size.48
oxide.usergroup add 76561198012345678 VIP

De speler met het opgegeven SteamID kan nu /home, /tpr en /town gebruiken en heeft een rugzak met 48 slots. Alle andere spelers die je later aan de VIP-groep toevoegt, krijgen automatisch dezelfde rechten.