Berechtigungen auf einem Rust-Server: oxide.grant, Gruppen und Rechte

Die meisten Plugins tun nichts, solange Sie keinem Spieler und keiner Gruppe eine Berechtigung vergeben. Diese Anleitung erklärt, wie das Berechtigungssystem in Oxide und Carbon funktioniert, wie Sie einem einzelnen Spieler und einer ganzen Gruppe Rechte geben, wie Sie VIP- und Moderatorengruppen einrichten und wie Sie die häufigsten Fehler beheben.

So funktionieren Berechtigungen#

• Eine Berechtigung ist eine Zeichenkette im Format plugin.aktion, zum Beispiel kits.admin oder nteleportation.home. Ein Plugin registriert sie beim Laden. Die Liste der Berechtigungen steht meist auf der Seite des Plugins.
• Berechtigungen vergeben Sie an einen Benutzer (einen bestimmten Spieler) oder an eine Gruppe. Ein Spieler hat die Summe seiner eigenen Berechtigungen und der Berechtigungen aller seiner Gruppen.
• Eine Gruppe kann eine übergeordnete Gruppe haben. Sie erbt dann alle Berechtigungen der übergeordneten Gruppe. So müssen Sie dieselben Rechte nicht mehrfach vergeben.
• Standardgruppen:
  • default – das Framework nimmt automatisch jeden Spieler auf, der sich verbindet.
  • admin – das Framework nimmt automatisch Spieler mit Owner-Stufe (ownerid) auf.
  • moderator – nur Carbon, automatisch für Spieler mit Moderator-Stufe (moderatorid).
• Berechtigungen addieren sich nur. Ein „Verbieten“ gibt es nicht: Hat eine Gruppe eine Berechtigung, hat sie jedes Mitglied, auch wenn Sie sie ihm direkt entzogen haben.
• Bei den Namen von Berechtigungen und Gruppen spielt Groß- und Kleinschreibung keine Rolle.

Plugin-Berechtigungen sind nicht dasselbe wie die Admin-Rechte des Spiels. Die Owner- oder Moderator-Stufe (ownerid, moderatorid) gibt Zugriff auf die eigenen Befehle von Rust (Teleport, Noclip, Ban …). Plugin-Berechtigungen steuern nur Funktionen von Plugins. Sie können einem Moderator also zum Beispiel die Unsichtbarkeit aus dem Plugin Vanish geben, ohne ihm alle Admin-Befehle des Spiels zu geben.

Oxide speichert Benutzer und Gruppen in den Dateien oxide/data/oxide.users.data und oxide/data/oxide.groups.data. Sichern Sie sie und löschen Sie sie nie (Sie würden alle vergebenen Rechte verlieren).

Wo Sie Befehle eingeben#

• Serverkonsole (bei einem Gameserver-Hoster die Registerkarte Konsole) – der empfohlene Ort; hier funktionieren die Befehle immer.
• RCON (RustAdmin, Webkonsole) – dasselbe wie die Serverkonsole, nur aus der Ferne.
• Die F1-Konsole im Spiel – wenn Sie auf dem Server Owner sind (ownerid).

Geben Sie Befehle ohne Schrägstrich ein. Namen mit Leerzeichen setzen Sie in Anführungszeichen: "Max Mustermann".

Steam-ID statt Name#

Geben Sie Spieler per Steam ID64 an (eine 17-⁠stellige Zahl, die mit 7656119 beginnt). Ein Name kann sich ändern, und zwei Spieler können ähnliche Namen haben; die ID ist eindeutig und ändert sich nie. Oxide und Carbon akzeptieren auch die ID eines Spielers, der sich noch nie mit dem Server verbunden hat. Wie Sie die ID herausfinden, steht in Admin und RCON.

Die Beispiele verwenden 76561198000000000 – ersetzen Sie sie durch die echte ID des Spielers.

Berechtigungen für einen einzelnen Spieler#

Rechte Spieler für Spieler zu vergeben, ist für Ausnahmen in Ordnung. Für mehrere Personen mit denselben Rechten verwenden Sie Gruppen.

Gruppen#

Beispiel: eine Gruppe vip, die alles von default erbt und zusätzlich das VIP-Kit nutzen darf.

Auflisten und Prüfen#

oxide.show perms (c.show perms) ist der schnellste Weg, den genauen Namen einer Berechtigung zu finden, wenn Sie ihn nicht aus der Dokumentation des Plugins kennen.

Platzhalter#

Ein Stern * vergibt mehrere Berechtigungen auf einmal:

oxide.grant group admin nteleportation.*

• nteleportation.* – alle Berechtigungen, die mit nteleportation. beginnen.
• Ein einzelner * – alle Berechtigungen aller Plugins.

Unter Carbon funktioniert das genauso: c.grant group admin nteleportation.*.

Empfohlene Gruppenstruktur#

Die Namen der Berechtigungen in der Tabelle entsprechen den Plugins aus dem Artikel Empfohlene Plugins. Unter Oxide legen Sie die Gruppe moderator selbst an (oxide.group add moderator "Moderator" 2); unter Carbon existiert sie bereits.

Die Kette der übergeordneten Gruppen unter Oxide einrichten:

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

Ein Moderator hat dann die Rechte eines Spielers und eines VIP, ein Admin die Rechte aller.

Beispiel: komplette Einrichtung eines neuen Servers#

Ein Satz von Oxide-Befehlen, der die Struktur aus der Tabelle oben für die Plugins NTeleportation, Backpacks, Kits, Vanish, Admin Radar, BetterChat und Remover Tool aufbaut. Geben Sie die Befehle einzeln in die Serverkonsole ein, sobald alle Plugins geladen sind (sonst existieren die Berechtigungen nicht). Unter Carbon ersetzen Sie oxide. durch c. und legen die Gruppe moderator nicht an, sondern legen nur ihre übergeordnete Gruppe fest.

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

• Der erste Block gibt allen Spielern Grundfunktionen (Homes, Teleportanfragen, einen Rucksack, das Entfernen eigener Bauten).
• Der Block vip legt die Gruppe an, verknüpft sie mit default und ergänzt das VIP-Kit (ein Kit mit der Berechtigung kits.vip müssen Sie zuerst erstellen), VIP-Limits für Teleports und einen Rucksack mit 24 Plätzen.
• Der Block moderator ergänzt Unsichtbarkeit und das Radar.
• Der Block admin verknüpft die bestehende Gruppe admin mit den Moderatoren, gibt ihr den höchsten Rang (3; Oxide hat sie mit Rang 1 angelegt) und ergänzt die Verwaltung von Kits, Chat, Entfernen und Rucksäcken. Unter Carbon setzen Sie den Rang mit c.group set admin rank 3.

Fügen Sie danach Personen hinzu: oxide.usergroup add <ID> vip oder oxide.usergroup add <ID> moderator. Admins (Owner) landen automatisch in der Gruppe admin.

Die Gruppe admin und ownerid#

• ownerid (Stufe 2) sind die Admin-Rechte des Spiels. Sie werden in Rust selbst festgelegt, siehe Admin und RCON.

• Die Gruppe admin ist eine Berechtigungsgruppe des Frameworks. Das Framework nimmt Spieler mit Stufe 2 beim Verbinden automatisch auf.

• Oxide entfernt Spieler nicht von selbst aus der Gruppe admin. Wenn Sie jemandem ownerid entziehen (removeowner), bleibt er in der Gruppe admin und behält seine Plugin-Rechte. Entfernen Sie ihn manuell:

  oxide.usergroup remove 76561198000000000 admin

• Carbon gleicht die Gruppen admin und moderator beim nächsten Verbinden mit der tatsächlichen Stufe des Spielers ab.

Die Gruppe admin bekommt nicht automatisch alle Plugin-Berechtigungen. Vergeben Sie ihr selbst, was sie haben soll.

Entsprechende Befehle in Carbon#

Ersetzen Sie <ID> durch die Steam ID64, <PERM> durch den Namen der Berechtigung und <GROUP> durch den Namen der Gruppe, jeweils ohne spitze Klammern.

Überprüfung#

1. Geben Sie oxide.show user 76561198000000000 ein (Carbon: c.show user …) und prüfen Sie, ob der Spieler in den erwarteten Gruppen ist und die erwarteten Berechtigungen hat.
2. Bitten Sie den Spieler, einen Befehl des Plugins auszuprobieren (zum Beispiel /kit). Manche Plugins laden Berechtigungen beim Verbinden des Spielers – funktioniert die Funktion nicht sofort, soll sich der Spieler neu verbinden.

Fehlerbehebung#

Permission 'kits.vip' doesn't exist#

Unter Carbon: Couldn't grant permission - permission does not exist. Die Berechtigung hat in diesem Moment niemand registriert. Ursachen:

• Das Plugin wurde nicht geladen. Prüfen Sie oxide.plugins (c.plugins).
• Ein Tippfehler im Namen. Den genauen Namen listet oxide.show perms (c.show perms) auf.
• Bei Kits: Ein Kit mit dieser Berechtigung wurde noch nicht gespeichert.

Player 'Jan' not found#

Unter Carbon: Couldn't grant user permission - user not found, use full name or steam ID. Ein Spieler mit diesem Namen lässt sich nicht finden, weil er sich noch nicht verbunden hat oder anders heißt. Verwenden Sie die Steam ID64 (17 Ziffern).

Multiple players were found, please specify: …#

Auf den eingegebenen Namen passen mehrere Spieler. Verwenden Sie die Steam ID64.

Group 'vip' doesn't exist#

Legen Sie zuerst die Gruppe an: oxide.group add vip. Für parent müssen beide Gruppen existieren.

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

Sie haben den Befehl im Spiel eingegeben und sind auf dem Server kein Owner (ownerid). Ein Moderator (moderatorid) kann Berechtigungsbefehle im Spiel nicht verwenden (es sei denn, er hat die gleichnamige Berechtigung, zum Beispiel oxide.grant, die wir Moderatoren nicht zu geben empfehlen). Geben Sie den Befehl in der Serverkonsole oder über RCON ein. Unter Carbon erfordern c.grant, c.group und ähnliche Befehle die Owner-Stufe.

Der Spieler hat die Berechtigung, aber die Funktion geht nicht#

• Das Plugin prüft Berechtigungen womöglich nur beim Verbinden – der Spieler soll sich trennen und neu verbinden.
• Das Plugin hat für jede Funktion eine eigene Berechtigung. In NTeleportation gibt nteleportation.home zum Beispiel nur Homes; die Rückkehr zur vorherigen Position (/tpb) braucht zusätzlich nteleportation.tpb. Prüfen Sie die Dokumentation des Plugins.
• Manche Plugins prüfen statt Berechtigungen das Admin-Level im Spiel. Dann genügt keine Berechtigung, und der Spieler braucht ownerid oder moderatorid.

Ich habe eine Berechtigung entzogen, aber der Spieler hat sie weiterhin#

Er hat sie über eine Gruppe. Geben Sie oxide.show user <ID> ein und sehen Sie nach, in welchen Gruppen er ist. Entziehen Sie die Berechtigung der Gruppe oder nehmen Sie den Spieler aus der Gruppe.

Ein ehemaliger Admin hat immer noch Plugin-Rechte#

Nach removeowner ist er unter Oxide in der Gruppe admin geblieben. Entfernen Sie ihn: oxide.usergroup remove <ID> admin.

Weiterführende Links#

• Oxide: Berechtigungen (offizielle Dokumentation) (öffnet sich in einem neuen Fenster)
• Oxide: Berechtigungsbefehle (öffnet sich in einem neuen Fenster)
• Carbon: Befehlsliste (öffnet sich in einem neuen Fenster)