Rust-Plugins installieren: Oxide-Konfiguration, Berechtigungen und Fehler
In dieser Anleitung lernen Sie, wie Sie auf einem Rust-Server mit Oxide (uMod) ein Plugin installieren, die JSON-Konfigurationsdatei des Plugins bearbeiten und Spielern oder Gruppen mit oxide.grant-Befehlen Berechtigungen erteilen. Anschließend sehen Sie, wie Sie Plugins aktuell halten, Fehler anhand der Logs im Ordner oxide/logs suchen und das Plugin finden, das den Server ausbremst.
Bevor Sie beginnen
- Ein Server mit installiertem Oxide: Wenn Sie
oxide.versionin die Serverkonsole eingeben, sollte eine Versionsnummer erscheinen. Ist Oxide noch nicht installiert, folgen Sie zuerst der Oxide-Installationsanleitung. - Dateizugriff: Mit einem Windows-VDS verbinden Sie sich per Remotedesktop (RDP), mit einem Linux-VDS per SSH; um Dateien auf Linux zu übertragen, können Sie einen SFTP-Client wie WinSCP oder FileZilla verwenden. Die Pfade in den Beispielen folgen der Struktur aus der Anleitung zur Einrichtung eines Rust-Servers:
C:\Rust\Serverunter Windows und/home/rust/rustserverunter Linux. - Konsolenzugriff: Unter Windows geben Sie Befehle direkt in das Serverfenster ein. Unter Linux nimmt die Serverkonsole keine Befehle an, daher verwenden Sie ein RCON-Tool (RCON-Anleitung). Als Admin können Sie dieselben Befehle auch in der F1-Konsole im Spiel eingeben.
- Admin-Rechte: Spieler, die Sie mit
owneridzum Admin machen, werden automatisch der Oxide-Gruppeadminhinzugefügt. Die Berechtigungsstufen werden in der Anleitung zu Rust-Admin-Befehlen erklärt. - Backup: Automatische Backups sind in VDS-Paketen nicht enthalten. Kopieren Sie den Ordner
oxide, bevor Sie Änderungen vornehmen; für regelmäßige Backups können Sie den Cloud-Backup-Speicher mit SFTP-Zugang nutzen.
1. Die Oxide-Ordner kennenlernen
Im Stammordner des Servers (dem Ordner, der RustDedicated enthält) legt Oxide einen Ordner oxide an: C:\Rust\Server\oxide unter Windows und /home/rust/rustserver/oxide unter Linux.
| Ordner / Datei | Inhalt | Manuell bearbeiten? |
|---|---|---|
plugins | Die .cs-Quelldateien der Plugins | Dateien werden nur hinzugefügt oder ersetzt |
config | Die Einstellungsdatei jedes Plugins, benannt nach dem Plugin (PluginName.json) | Ja |
data | Plugin-Daten (Spieler-Homes, Kit-Nutzung); die Berechtigungen liegen in den Dateien oxide.users.data und oxide.groups.data | Nein |
lang | Plugin-Nachrichten, in Ordnern nach Sprachcode (en, de) | Ja |
logs | Logdateien | Nur lesen |
oxide.config.json | Die Einstellungen von Oxide selbst | Bei Bedarf; wird beim Serverstart gelesen |
2. Plugin herunterladen und in den Ordner plugins legen
Plugins werden als C#-Quelldateien (.cs) verteilt, und Oxide kompiliert sie selbst, während der Server läuft. Die wichtigste Quelle für kostenlose Plugins ist die Website uMod. Prüfen Sie vor dem Download auf der Plugin-Seite das Datum der letzten Aktualisierung, die Kommentare und die Abhängigkeiten (andere benötigte Plugins). Benennen Sie die Datei nicht um; Oxide erkennt ein Plugin an seinem Dateinamen.
Sie können die Datei per RDP oder SFTP in den Ordner oxide/plugins kopieren oder direkt auf den Server herunterladen. Im Beispiel wird das Plugin Auto Doors heruntergeladen, das Türen automatisch schließt. Unter Windows mit PowerShell (die erste Zeile aktiviert TLS 1.2 auf älteren Windows-Server-Versionen):
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Invoke-WebRequest -UseBasicParsing -Uri https://umod.org/plugins/AutoDoors.cs -OutFile C:\Rust\Server\oxide\plugins\AutoDoors.cs
Unter Linux als Benutzer rust:
wget -O /home/rust/rustserver/oxide/plugins/AutoDoors.cs https://umod.org/plugins/AutoDoors.cs
Sie müssen den Server nicht herunterfahren. Oxide bemerkt die neue Datei, kompiliert und lädt sie; in der Konsole sehen Sie eine Zeile wie Loaded plugin Auto Doors v… by …. So listen Sie die geladenen Plugins auf:
oxide.plugins
Die Liste zeigt auch Plugins, die nicht geladen werden konnten, samt Grund. Zum manuellen Laden, Neuladen und Entladen eines Plugins verwenden Sie oxide.load AutoDoors, oxide.reload AutoDoors und oxide.unload AutoDoors; der Name muss dem Dateinamen ohne Endung entsprechen.
3. Konfigurationsdatei bearbeiten
Konfigurierbare Plugins schreiben beim ersten Laden eine nach ihnen benannte JSON-Datei in den Ordner oxide/config: für AutoDoors.cs ist das AutoDoors.json. Erscheint keine Datei, hat das Plugin entweder keine Einstellungen oder es konnte nicht geladen werden; sehen Sie im Log nach (Schritt 7).
Bei Gather Manager, das die Sammelraten für Ressourcen ändert, liegt diese Einstellung in GatherManager.json im Abschnitt Options unter dem Schlüssel GatherResourceModifiers und ist anfangs leer ({}). Tragen Sie die Ressourcen mit ihren englischen Namen aus dem Spiel ein und geben Sie jeder einen Multiplikator; der Schlüssel * gilt für alle Ressourcen, die Sie nicht separat festgelegt haben. Der Abschnitt sollte so aussehen:
"GatherResourceModifiers": {
"Wood": 3.0,
"Stones": 3.0,
"Metal Ore": 2.5,
"Sulfur Ore": 2.0,
"*": 2.0
}
Die gültigen Ressourcennamen listen Sie in der Serverkonsole mit dem Befehl gather.resources auf. Dieselbe Einstellung lässt sich auch über die Konsole setzen, und das Plugin schreibt den Wert selbst in die Datei: gather.rate dispenser Wood 3 (dispenser umfasst Ressourcen, die Sie durch Schlagen abbauen, etwa Bäume und Erz).
Verstößt eine Datei gegen die JSON-Regeln, lädt das Plugin möglicherweise nicht oder fällt auf seine Standardeinstellungen zurück. Häufige Fehler sind ein überzähliges oder fehlendes Komma, ein nicht geschlossenes Anführungszeichen oder eine nicht geschlossene Klammer sowie einfache Anführungszeichen ('). Text steht in doppelten Anführungszeichen, Zahlen und true/false ohne Anführungszeichen; das Dezimaltrennzeichen ist ein Punkt (2.5). Wenden Sie die Änderung nach dem Speichern an:
oxide.reload GatherManager
Manche Plugins schreiben ihre Einstellungen beim Entladen zurück auf die Festplatte; in diesem Fall kann oxide.reload Ihre Änderung überschreiben. Springt eine Einstellung immer wieder zurück, führen Sie zuerst oxide.unload GatherManager aus, bearbeiten dann die Datei und laden das Plugin zum Schluss mit oxide.load GatherManager.
4. Berechtigungen und Gruppen einrichten
Oxide-Berechtigungen sind Namen in der Form pluginname.permission (Plugin-Name, dann Berechtigung), zum Beispiel autodoors.use. Eine Berechtigung existiert nur, solange das Plugin geladen ist, das sie definiert; ist das Plugin nicht geladen, findet oxide.grant die Berechtigung nicht. Oxide bringt zwei Gruppen mit: default umfasst alle, die sich mit dem Server verbinden, und admin die mit ownerid festgelegten Admins.
Das folgende Beispiel legt eine VIP-Gruppe an, fügt ihr einen Spieler hinzu und vergibt Berechtigungen. Wenn Sie den Spieler über seine Steam64-ID statt über seinen Namen angeben, vermeiden Sie Verwechslungen mit Spielern, die ähnliche Namen haben:
oxide.group add vip "VIP" 0
oxide.usergroup add 76561198123456789 vip
oxide.grant group vip autodoors.use
oxide.grant group default nteleportation.home
oxide.grant group admin kits.admin
Auto Doors berücksichtigt diese Berechtigung nur, wenn in AutoDoors.json die Einstellung "Use permissions": true gesetzt ist; beim Standardwert false kann jeder das Plugin nutzen. Befehle zum Prüfen und Zurücknehmen:
oxide.show groups
oxide.show group vip
oxide.show user 76561198123456789
oxide.show perm autodoors.use
oxide.show perms
oxide.revoke group vip autodoors.use
oxide.usergroup remove 76561198123456789 vip
Gruppen können Berechtigungen voneinander erben: Wenn Sie mit oxide.group add moderator eine Gruppe anlegen und dann oxide.group parent moderator vip eingeben, erhalten Moderatoren zusätzlich alle VIP-Berechtigungen. Das Platzhalterzeichen (*) vergibt mehrere Berechtigungen auf einmal; oxide.grant group admin kits.* aktiviert alle Berechtigungen des Plugins Kits. oxide.grant group default * dagegen gibt jedem Spieler jede Berechtigung, einschließlich der Admin-Werkzeuge; verwenden Sie das nicht. Alle Befehle sind in der Oxide-Dokumentation zu Berechtigungen beschrieben.
5. Plugin-Nachrichten übersetzen
Plugins, die Lokalisierung unterstützen, schreiben ihre Nachrichten in eine nach dem Plugin benannte Datei, oxide/lang/en/PluginName.json. Für eine weitere Sprache legen Sie unter oxide/lang einen Ordner mit deren Sprachcode an (für Deutsch de; das folgende Beispiel zeigt Türkisch mit dem Ordner de), kopieren die englische Datei hinein und übersetzen nur die Werte:
{
"Hello": "Hallo",
"WelcomeMessage": "Willkommen auf {0}!"
}
Ändern Sie weder die Schlüssel auf der linken Seite noch Platzhalter wie {0}. Speichern Sie die Datei in UTF-8-Kodierung, sonst können Umlaute wie ä, ö und ü oder andere Sonderzeichen verstümmelt angezeigt werden. Die Standardsprache des Servers legen Sie in der Serverkonsole fest, im Beispiel mit oxide.lang de (für Deutsch oxide.lang de); Spieler können ihre eigene Sprache wählen, indem sie etwa /lang de bzw. /lang de in den Chat eingeben.
6. Plugins und Oxide aktuell halten
Um ein Plugin zu aktualisieren, überschreiben Sie einfach die alte .cs-Datei mit der neuen; Oxide erkennt die Änderung und lädt das Plugin neu, Konfigurations- und Datendateien bleiben erhalten. Verwenden Sie wget unter Linux immer mit -O: Ohne diese Option wird die neue Version, falls die Datei bereits existiert, als AutoDoors.cs.1 gespeichert; Oxide sieht sie nicht, und die alte Version läuft weiter.
Jedes Rust-Server-Update von Facepunch wird von einer neuen Oxide-Version begleitet, und beide müssen zueinander passen. Ein SteamCMD-Update setzt die Serverdateien in ihren Originalzustand (vanilla) zurück; Ihre Plugins und Einstellungen bleiben im Ordner oxide erhalten, werden aber erst wieder geladen, wenn Oxide neu installiert ist. Installieren Sie nach jedem Rust-Update die neue Oxide-Version und prüfen Sie dann in der Ausgabe von oxide.plugins, ob Plugins nicht geladen werden konnten; für ein fehlerhaftes Plugin ist womöglich bereits eine neue Version erschienen.
Um ein Plugin zu entfernen, verschieben Sie seine .cs-Datei aus dem Ordner plugins; Oxide entlädt das Plugin. Konfigurations- und Datendateien bleiben an ihrem Platz. Beispiel für Linux:
mkdir -p /home/rust/disabled
mv /home/rust/rustserver/oxide/plugins/AutoDoors.cs /home/rust/disabled/
7. Fehler im Oxide-Log nachlesen
Oxide legt jeden Tag im Ordner oxide/logs ein neues Log mit dem Namen oxide_YYYY-MM-DD.txt an. Kompilierungsfehler, Fehler, die Plugins zur Laufzeit auslösen, und Warnungen wegen Langsamkeit landen hier; das ausführliche Protokoll des Compilers steht in der Datei oxide.compiler_YYYY-MM-DD.log im selben Ordner. Unter Linux verfolgen Sie das heutige Log live und durchsuchen frühere Fehler so:
tail -n 50 -f /home/rust/rustserver/oxide/logs/oxide_$(date +%F).txt
grep -i "error" /home/rust/rustserver/oxide/logs/oxide_*.txt | tail -n 30
Unter Windows verfolgen Sie die letzten Zeilen des neuesten Logs mit PowerShell:
Get-ChildItem C:\Rust\Server\oxide\logs\oxide_*.txt | Sort-Object LastWriteTime | Select-Object -Last 1 | Get-Content -Tail 50 -Wait
Die am häufigsten gesuchten Zeilen im Log sind Error while compiling (das Plugin konnte nicht kompiliert werden), Failed to call hook (das Plugin hat zur Laufzeit einen Fehler ausgelöst) und requires missing dependency (eine Abhängigkeit fehlt).
8. Auswirkung von Plugins auf die Performance messen
Plugins arbeiten, indem sie sich über Hooks an Ereignisse im Spiel hängen: Ein Spieler erleidet Schaden, ein Bauwerk wird errichtet und so weiter. In der Ausgabe von oxide.plugins stehen neben jedem Plugin zwei Werte in Klammern: die gesamte in seinen Hooks verbrachte Zeit (in Sekunden) und der von diesen Hooks belegte Arbeitsspeicher. Sehen Sie sich die Liste an, nachdem der Server eine Weile mit Spielern gelaufen ist; ein Plugin, das deutlich mehr Zeit angesammelt hat, ist Ihr erster Verdächtiger.
Außerdem schreibt Oxide eine Warnung in folgender Form ins Log, sobald ein einzelner Hook-Aufruf länger als 100 Millisekunden dauert:
Calling 'OnEntityTakeDamage' on 'ExamplePlugin v1.0.0' took 150ms
Vereinzelte Warnungen sind kein Problem; Warnungen, die sich für dasselbe Plugin ständig wiederholen, können sich für Spieler jedoch als Lag bemerkbar machen. Stoppen Sie das verdächtige Plugin vorübergehend mit oxide.unload und beobachten Sie den Unterschied, entfernen Sie Plugins, die Sie nicht nutzen, und betreiben Sie keine zwei Plugins, die dieselbe Aufgabe erfüllen. CPU- und Arbeitsspeicherauslastung verfolgen Sie in den Live-Nutzungsdiagrammen im Kundenbereich. Deuten die Messungen auf zu knappe Ressourcen hin, ziehen Sie ein Upgrade Ihres Rust-Server-Pakets in Betracht; zu serverseitigen Einstellungen lesen Sie die Rust-Performance-Anleitung.
Beispielkonfiguration: beliebte Plugin-Typen
Die folgenden Plugins sind Beispiele für verbreitete Typen auf uMod. Die Namen der Berechtigungen können sich zwischen Versionen ändern; prüfen Sie sie nach der Installation mit oxide.show perms.
| Typ | Plugin (Datei) | Funktion | Berechtigung / Befehl |
|---|---|---|---|
| Sammelrate | Gather Manager (GatherManager.cs) | Multiplikatoren für Abbau, Steinbrüche (Quarries) und Aufsammeln | Keine Berechtigung; gather.rate erfordert Admin-Rechte |
| Teleport | NTeleportation (NTeleportation.cs) | /sethome, /home; Anfrage mit /tpr, Annahme mit /tpa | nteleportation.home, nteleportation.tpr |
| Starter-Kit | Kits (Kits.cs) | Menü /kit; Kits erstellen mit /kit new | kits.admin; eine eigene Berechtigung pro Kit, etwa kits.vip |
| Chat und Titel | Better Chat (BetterChat.cs) | Chat-Titel und -Farben anhand von Oxide-Gruppen | betterchat.admin (Befehl /chat) |
| Komfort | Auto Doors (AutoDoors.cs) | Schließt Türen nach einigen Sekunden; /ad | autodoors.use (wenn die Berechtigungsnutzung aktiviert ist) |
In der Datei oxide/oxide.config.json sind im Abschnitt Options zwei Einstellungen wichtig: PluginWatchers (Standard true) überwacht den Ordner plugins und lädt Plugins automatisch; Modded (Standard true) kennzeichnet Ihren Server in der Serverliste als „modded“. Ist Modded deaktiviert, schreibt Oxide ins Log, dass Facepunch im Bereich „Community“ nur Admin-Werkzeuge erlaubt, die das Gameplay nicht beeinflussen; lassen Sie die Einstellung bei Plugins, die das Gameplay verändern, auf true.
Häufige Fehler
Error while compiling AutoDoors: Das Plugin ist mit der aktuellen Rust- oder Oxide-Version nicht kompatibel, oder die Datei ist beschädigt; die Zeile darunter zeigt, wo das Problem liegt. Laden Sie die neueste Version des Plugins herunter und stellen Sie sicher, dass auch Oxide aktuell ist.Plugin filename AutoDoors (1).cs must match the main class AutoDoors: Der Dateiname stimmt nicht mit dem Klassennamen des Plugins überein. Benennen Sie die Datei in den am Zeilenende vorgeschlagenen Namen um (AutoDoors.cs).- Zeilen mit
plugin requires missing dependency: Das Plugin benötigt ein weiteres Plugin, dessen Name am Zeilenende steht; legen Sie auch dieses in den Ordnerplugins. Permission 'autodoors.use' doesn't exist: Der Name der Berechtigung ist falsch geschrieben, oder das Plugin ist nicht geladen. Prüfen Sie das mitoxide.pluginsundoxide.show perms.Group 'vip' doesn't exist: Legen Sie die Gruppe mitoxide.group add vipan, bevor Sie Berechtigungen vergeben.Multiple players were found, please specify: Der Spielername passt auf mehr als eine Person. Geben Sie statt des Namens die Steam64-ID ein.Permissions must start with the 'kits.' prefix: Die Berechtigung, die Sie einem Kit im Kits-Editor zuweisen, muss mit dem Plugin-Namen beginnen; stattvipschreiben Siekits.vip.- Unter Linux
Compiler may not be set as executable: Der Oxide-Compiler ist nicht ausführbar. Führen Siechmod +x /home/rust/rustserver/Oxide.Compileraus und starten Sie den Server neu.
Häufig gestellte Fragen
Muss ich den Server neu starten, um ein Plugin zu installieren?
Nein. .cs-Plugins werden hinzugefügt, aktualisiert und entfernt, während der Server läuft. Bei Erweiterungen (Extensions) ist das anders: Sie kommen als .dll-Dateien, gehören in den Ordner RustDedicated_Data/Managed, und die meisten werden erst beim Neustart des Servers geladen.
Werden Plugin-Daten beim Map-Wipe gelöscht?
Das Löschen der Map-Dateien berührt den Ordner oxide/data nicht. Manche Plugins haben dafür eine eigene Einstellung: Wipe player data when the server is wiped in Kits und Clear data on map wipe in Auto Doors. Prüfen Sie diese Einstellungen vor einem Wipe; wenn die Daten nicht zurückgesetzt werden sollen, lassen Sie sie auf false.
Wie viele Plugins kann ich installieren?
Oxide hat keine feste Obergrenze; entscheidend ist, wie viel Arbeit die Plugins verrichten. Wenige schwere Plugins können mehr Last verursachen als viele leichtgewichtige. Fügen Sie neue Plugins einzeln hinzu und prüfen Sie die Messwerte aus Schritt 8.
Verwandte Anleitungen
- Oxide (uMod) auf einem Rust-Server installieren: Windows und Linux
- Rust-Server einrichten: Windows und Linux mit SteamCMD
- Rust-Admin-Befehle und Rechtevergabe (Auth Level)
- Ports auf einem Rust-Server öffnen und sichere Fernverwaltung mit RCON
- Performance- und Lag-Probleme auf dem Rust-Server beheben
Weitere Artikel finden Sie auf der Seite Rust-Anleitungen.
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.