Rechten op een Rust-server: oxide.grant, groepen en permissies

De meeste plugins doen niets zolang je een speler of een groep geen recht toekent. We leggen uit hoe het rechtensysteem in Oxide en Carbon werkt, hoe je rechten toekent aan één speler en aan een hele groep, hoe je groepen voor VIP's en moderators opzet en hoe je de meest voorkomende fouten oplost.

Hoe rechten werken#

• Een recht is een tekst in de vorm plugin.actie, bijvoorbeeld kits.admin of nteleportation.home. De plugin registreert het zodra hij wordt geladen. De lijst met rechten staat meestal op de pagina van de plugin.
• Je kent een recht toe aan een gebruiker (een specifieke speler) of aan een groep. Een speler heeft de optelsom van zijn eigen rechten en de rechten van al zijn groepen.
• Een groep kan een ouder hebben (parent). Dan erft ze alle rechten van de oudergroep. Daardoor hoef je dezelfde rechten niet meerdere keren toe te kennen.
• Standaardgroepen:
  • default – hierin plaatst het framework automatisch elke speler die verbinding maakt.
  • admin – hierin plaatst het framework automatisch spelers met het eigenaarsniveau (ownerid).
  • moderator – alleen in Carbon, automatisch voor spelers met het moderatorniveau (moderatorid).
• Rechten worden alleen opgeteld. Er bestaat geen “verbod”: heeft een groep een recht, dan heeft elk lid het, ook als je het bij die speler zelf intrekt.
• Bij de namen van rechten en groepen maakt het niet uit of je hoofdletters of kleine letters gebruikt.

De rechten van plugins zijn iets anders dan de adminrechten van het spel. Het eigenaars- of moderatorniveau (ownerid, moderatorid) geeft toegang tot de commando's van Rust (teleport, noclip, ban…). De rechten van plugins bepalen alleen de functies van plugins. Zo kun je een moderator bijvoorbeeld onzichtbaarheid uit de plugin Vanish geven zonder dat hij alle admincommando's van het spel krijgt.

Oxide slaat gebruikers en groepen op in de bestanden oxide/data/oxide.users.data en oxide/data/oxide.groups.data. Maak er een back-up van en verwijder ze nooit (je zou alle toegekende rechten kwijtraken).

Waar je de commando's invoert#

• De console van de server (bij gamehosting het tabblad Console) – de aanbevolen plek, de commando's werken hier altijd.
• RCON (RustAdmin, webconsole) – hetzelfde als de console van de server, alleen op afstand.
• De console F1 in het spel – als je op de server eigenaar bent (ownerid).

Typ de commando's zonder schuine streep. Zet namen met spaties tussen aanhalingstekens: "Jan Novák".

Steam ID in plaats van een naam#

Duid een speler aan met zijn Steam ID64 (een getal van 17 cijfers dat begint met 7656119). Een naam kan veranderen en twee spelers kunnen een vergelijkbare naam hebben, het ID is uniek en verandert nooit. Oxide en Carbon accepteren het ID bovendien ook voor een speler die nog geen verbinding met de server heeft gemaakt. Hoe je het ID vindt, staat in Admin en RCON.

In de voorbeelden gebruiken we 76561198000000000 – vul het echte ID van de speler in.

Rechten voor één speler#

Rechten per speler toekennen is geschikt voor uitzonderingen. Voor meerdere mensen met dezelfde rechten gebruik je groepen.

Groepen#

Voorbeeld: de groep vip, die alles van default erft en daarnaast de VIP-kit mag gebruiken.

Opvragen en controleren#

oxide.show perms (c.show perms) is de snelste manier om de exacte naam van een recht te achterhalen als je die niet uit de documentatie van de plugin kent.

Wildcards#

Een sterretje * kent meerdere rechten tegelijk toe:

oxide.grant group admin nteleportation.*

• nteleportation.* – alle rechten die beginnen met nteleportation..
• Alleen * – werkelijk alle rechten van alle plugins.

In Carbon gaat het op dezelfde manier: c.grant group admin nteleportation.*.

Aanbevolen groepsstructuur#

De namen van de rechten in de tabel horen bij de plugins uit het artikel Aanbevolen plugins. In Oxide maak je de groep moderator zelf aan (oxide.group add moderator "Moderator" 2), in Carbon bestaat ze al.

Zo zet je de keten van ouders op in Oxide:

oxide.group parent vip default
oxide.group parent moderator vip
oxide.group parent admin moderator

Een moderator heeft zo de rechten van een speler en van een VIP, een admin heeft de rechten van iedereen.

Voorbeeld: volledige instelling van een nieuwe server#

Een reeks commando's voor Oxide die de structuur uit de tabel hierboven opzet voor de plugins NTeleportation, Backpacks, Kits, Vanish, Admin Radar, BetterChat en Remover Tool. Voer ze één voor één in de console van de server in zodra alle plugins geladen zijn (anders bestaan de rechten niet). In Carbon vervang je oxide. door c. en stel je voor de groep moderator alleen de ouder in, in plaats van de groep aan te maken.

oxide.grant group default nteleportation.home
oxide.grant group default nteleportation.tpr
oxide.grant group default backpacks.use
oxide.grant group default backpacks.gui
oxide.grant group default removertool.normal

oxide.group add vip "VIP" 1
oxide.group parent vip default
oxide.grant group vip kits.vip
oxide.grant group vip nteleportation.vip
oxide.grant group vip backpacks.size.24

oxide.group add moderator "Moderator" 2
oxide.group parent moderator vip
oxide.grant group moderator vanish.allow
oxide.grant group moderator adminradar.allowed

oxide.group parent admin moderator
oxide.group set admin "Admin" 3
oxide.grant group admin kits.admin
oxide.grant group admin betterchat.admin
oxide.grant group admin removertool.admin
oxide.grant group admin backpacks.admin

• Het eerste blok geeft alle spelers de basisfuncties (homes, teleporteren op verzoek, een rugzak, het verwijderen van eigen bouwwerken).
• Het blok vip maakt de groep aan, koppelt haar aan default en voegt de VIP-kit toe (de kit met het recht kits.vip moet je eerst aanmaken), de VIP-limieten voor teleports en een rugzak met 24 vakken.
• Het blok moderator voegt onzichtbaarheid en de radar toe.
• Het blok admin koppelt de bestaande groep admin aan de moderators, geeft haar de hoogste rang (3, Oxide heeft haar met rang 1 aangemaakt) en voegt het beheer van kits, de chat, het verwijderen en rugzakken toe. In Carbon stel je de rang in met het commando c.group set admin rank 3.

Deel daarna de mensen in: oxide.usergroup add <ID> vip of oxide.usergroup add <ID> moderator. Admins (eigenaren) komen vanzelf in de groep admin terecht.

De groep admin en ownerid#

• ownerid (niveau 2) zijn de adminrechten van het spel. Je stelt het in Rust in, zie Admin en RCON.

• De groep admin is een groep met rechten van het framework. Spelers met niveau 2 plaatst het framework er automatisch in zodra ze verbinding maken.

• Oxide haalt spelers niet zelf uit de groep admin. Als je iemands ownerid intrekt (removeowner), blijft hij in de groep admin en houdt hij de rechten van plugins. Haal hem er handmatig uit:

  oxide.usergroup remove 76561198000000000 admin

• Carbon brengt de groepen admin en moderator bij de volgende verbinding van de speler in overeenstemming met zijn werkelijke niveau.

De groep admin krijgt niet automatisch alle rechten van plugins. Wat erin moet zitten, ken je zelf toe.

Equivalente commando's in Carbon#

Vervang <ID> door het Steam ID64, <PERM> door de naam van het recht en <GROUP> door de naam van de groep, alles zonder de punthaken.

Controle#

1. Voer oxide.show user 76561198000000000 in (Carbon c.show user …) en controleer of de speler in de verwachte groepen zit en de verwachte rechten heeft.
2. Vraag de speler om een commando van de plugin uit te proberen (bijvoorbeeld /kit). Sommige plugins laden de rechten bij het verbinden – werkt de functie niet meteen, laat de speler dan opnieuw verbinding maken.

Als iets niet werkt#

Permission 'kits.vip' doesn't exist#

In Carbon: Couldn't grant permission - permission does not exist. Op dat moment heeft niemand het recht geregistreerd. Oorzaken:

• De plugin is niet geladen. Controleer oxide.plugins (c.plugins).
• Een typfout in de naam. De exacte naam vind je met oxide.show perms (c.show perms).
• Bij kits: de kit met dit recht is nog niet opgeslagen.

Player 'Jan' not found#

In Carbon: Couldn't grant user permission - user not found, use full name or steam ID. Een speler met die naam is niet te vinden, omdat hij nog geen verbinding heeft gemaakt of een andere naam heeft. Gebruik het Steam ID64 (17 cijfers).

Multiple players were found, please specify: …#

De ingevoerde naam past bij meerdere spelers. Gebruik het Steam ID64.

Group 'vip' doesn't exist#

Maak de groep eerst aan: oxide.group add vip. Bij parent moeten beide groepen bestaan.

You do not have permission to use the command 'oxide.grant'!#

Je hebt het commando in het spel ingevoerd en je bent op de server geen eigenaar (ownerid). Een moderator (moderatorid) kan de rechtencommando's in het spel niet gebruiken (tenzij hij het gelijknamige recht heeft, bijvoorbeeld oxide.grant, maar we raden af om dat aan moderators te geven). Voer het commando in de console van de server in of via RCON. In Carbon vereisen de commando's c.grant, c.group en andere het eigenaarsniveau.

De speler heeft het recht, maar de functie werkt niet#

• De plugin controleert de rechten mogelijk alleen bij het verbinden – laat de speler de verbinding verbreken en opnieuw verbinden.
• De plugin heeft voor elke functie een apart recht. In NTeleportation geeft nteleportation.home bijvoorbeeld alleen homes, terugkeren naar de vorige plek (/tpb) heeft daarnaast nteleportation.tpb nodig. Raadpleeg de documentatie van de plugin.
• Sommige plugins controleren het adminniveau van het spel in plaats van een recht. Dan is een recht niet genoeg en moet de speler ownerid of moderatorid hebben.

Ik heb het recht ingetrokken, maar de speler heeft het nog steeds#

Hij heeft het via een groep. Voer oxide.show user <ID> in en kijk in welke groepen hij zit. Trek het recht van de groep in, of haal de speler uit de groep.

Een voormalige admin heeft nog steeds de rechten van plugins#

Na removeowner is hij in Oxide in de groep admin gebleven. Haal hem eruit: oxide.usergroup remove <ID> admin.

Meer bronnen#

• Oxide: rechten (officiële documentatie) (opent in een nieuw venster)
• Oxide: commando's voor rechten (opent in een nieuw venster)
• Carbon: lijst met commando's (opent in een nieuw venster)