Zum Inhalt springen
+90 850 303 07 52 [email protected]
Support Kundenbereich
Bei ausgewählten Hosting-Paketen mit Jahreslaufzeit und VDS-Paketen mit 3 Monaten Laufzeit: .com / .com.tr-Domain im ersten Jahr kostenlos · Pakete ansehen

Anleitungen

Schritt-für-Schritt-Anleitungen, um Ihren eigenen Server, Gameserver und Ihre Website einzurichten und zu betreiben – vom Team, das unsere Infrastruktur in Istanbul betreibt.

Rust

Rust-Plugins installieren: Oxide-Konfiguration, Berechtigungen und Fehler

26 August 2026 12 Min. Lesezeit Aktualisiert:
Diesen Beitrag teilen

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.version in 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\Server unter Windows und /home/rust/rustserver unter 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 ownerid zum Admin machen, werden automatisch der Oxide-Gruppe admin hinzugefü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 / DateiInhaltManuell bearbeiten?
pluginsDie .cs-Quelldateien der PluginsDateien werden nur hinzugefügt oder ersetzt
configDie Einstellungsdatei jedes Plugins, benannt nach dem Plugin (PluginName.json)Ja
dataPlugin-Daten (Spieler-Homes, Kit-Nutzung); die Berechtigungen liegen in den Dateien oxide.users.data und oxide.groups.dataNein
langPlugin-Nachrichten, in Ordnern nach Sprachcode (en, de)Ja
logsLogdateienNur lesen
oxide.config.jsonDie Einstellungen von Oxide selbstBei 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.

TypPlugin (Datei)FunktionBerechtigung / Befehl
SammelrateGather Manager (GatherManager.cs)Multiplikatoren für Abbau, Steinbrüche (Quarries) und AufsammelnKeine Berechtigung; gather.rate erfordert Admin-Rechte
TeleportNTeleportation (NTeleportation.cs)/sethome, /home; Anfrage mit /tpr, Annahme mit /tpanteleportation.home, nteleportation.tpr
Starter-KitKits (Kits.cs)Menü /kit; Kits erstellen mit /kit newkits.admin; eine eigene Berechtigung pro Kit, etwa kits.vip
Chat und TitelBetter Chat (BetterChat.cs)Chat-Titel und -Farben anhand von Oxide-Gruppenbetterchat.admin (Befehl /chat)
KomfortAuto Doors (AutoDoors.cs)Schließt Türen nach einigen Sekunden; /adautodoors.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 Ordner plugins.
  • Permission 'autodoors.use' doesn't exist: Der Name der Berechtigung ist falsch geschrieben, oder das Plugin ist nicht geladen. Prüfen Sie das mit oxide.plugins und oxide.show perms.
  • Group 'vip' doesn't exist: Legen Sie die Gruppe mit oxide.group add vip an, 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; statt vip schreiben Sie kits.vip.
  • Unter Linux Compiler may not be set as executable: Der Oxide-Compiler ist nicht ausführbar. Führen Sie chmod +x /home/rust/rustserver/Oxide.Compiler aus 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

Weitere Artikel finden Sie auf der Seite Rust-Anleitungen.

Kommentare0

Noch keine Kommentare

Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.

Diskutieren Sie mit

Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.

Keinen Beitrag verpassen

Erhalten Sie unsere neuesten Tutorials, Anleitungen und Produktneuigkeiten direkt in Ihr Postfach.

Sie haben unseren Newsletter abonniert.