Oxide (uMod) auf einem Rust-Server installieren: Windows und Linux
In dieser Anleitung installieren Sie das Plugin-Framework Oxide auf Ihrem Rust-Server unter Windows und Linux, überprüfen die Installation und richten Ihr erstes Plugin ein. Außerdem sehen Sie sich die Ordner oxide/plugins und oxide/config, die Neuinstallation nach jedem Rust-Update und das alternative Framework Carbon an. Pfade und Skriptnamen entsprechen der Anleitung zur Einrichtung eines Rust-Servers.
Bevor Sie beginnen
Oxide ist ein Modding-Framework, das in C# geschriebene Plugins (.cs-Dateien) in einen Rust-Server lädt; auf einem Vanilla-Server (unverändert) funktionieren Teleport-, Clan- oder Economy-Plugins nicht. uMod ist der Name von umod.org, der Plattform, auf der die Plugins veröffentlicht werden; deshalb werden die beiden Namen oft zusammen genannt. Die Software, die Sie auf dem Server installieren, ist jedoch Oxide: Auch der Rust-Download-Link auf umod.org lädt direkt die neueste Oxide-Version von GitHub herunter.
- Ein funktionierender Rust-Server: Er muss mit SteamCMD installiert und mindestens einmal gestartet worden sein. Die Pfade lauten unter Windows
C:\Rust\Server(der Ordner mitRustDedicated.exe) und unter Linux/home/rust/rustserver; die Server-Identity istmyserver. Weichen Ihre Angaben ab, passen Sie die Pfade entsprechend an. - unzip unter Linux: Wird zum Entpacken des Oxide-Archivs benötigt. Da der Benutzer
rustkeinesudo-Rechte hat, installieren Sie es in einer root-Sitzung:sudo apt install unzip - Ausgehender HTTPS-Zugriff: Bei jedem Start prüft Oxide das Programm
Oxide.Compiler, das die Plugins kompiliert, und lädt es bei Bedarf vondownloads.oxidemod.comherunter. - Versionskompatibilität: Oxide und der Rust-Server müssen zum selben Update gehören; kurz nach jedem Facepunch-Update erscheint eine neue Oxide-Version. Nicht zueinander passende Versionen können verhindern, dass der Server startet.
- Backups: Automatische Backups sind in den VDS-Paketen nicht enthalten; sichern Sie vor dem Start den Ordner
server/myserverund nach der Installation von Oxide regelmäßig auch den Ordneroxide.
1. Server stoppen
Kopieren Sie keine Oxide-Dateien, während der Server läuft; die Oxide-Dokumentation warnt, dass dies Serverdaten beschädigen kann. Um den Server zu speichern und herunterzufahren, geben Sie in der Konsole quit ein:
- Windows: Geben Sie im Serverfenster
quitein; da die Schleifegoto startden Server sonst erneut starten würde, schließen Sie nach dem Herunterfahren auch das Fenster. - Linux: Senden Sie
quitüber Ihr RCON-Tool (Fernverwaltung). Der Server speichert und fährt herunter, und diescreen-Sitzung endet.
2. SteamCMD-Zeile aus dem Startskript entfernen
Die Skripte start.bat und start.sh aus der Einrichtungsanleitung aktualisieren den Server bei jedem Start mit SteamCMD. Die Seite zur Servereinrichtung von Facepunch weist darauf hin, dass ein SteamCMD-Aufruf im Startskript die Dateien immer im Vanilla-Zustand hält; Oxide wird also entfernt, ohne dass Sie es bemerken.
- Windows: Öffnen Sie die Datei
C:\Rust\Server\start.batim Editor (Notepad) und löschen Sie die Zeile, die mitC:\Rust\SteamCMD\steamcmd.exebeginnt. Die ZeileRustDedicated.exeund die Schleifegoto startbleiben erhalten. - Linux: Öffnen Sie die Datei mit
nano ~/start.shund löschen Sie die Zeile, die mit/usr/games/steamcmdbeginnt. Die ZeilenSERVER_DIR=,cd,export LD_LIBRARY_PATHund./RustDedicatedmüssen bleiben. Die Zeilecdist wichtig, weil Oxide den Ordneroxidein dem Ordner anlegt, aus dem der Server läuft.
Ab jetzt aktualisieren Sie mit dem separaten Skript aus Schritt 8 und installieren dabei Oxide neu.
3. Oxide herunterladen
Oxide wird über die offizielle Release-Seite auf GitHub verteilt. Wählen Sie dort die neueste Version ohne die Kennzeichnung „Pre-release“ und laden Sie im Bereich Assets das Archiv für Ihr Betriebssystem herunter:
https://github.com/OxideMod/Oxide.Rust/releases| Server | Datei | Direkter Link zur neuesten Version |
|---|---|---|
| Windows | Oxide.Rust.zip | https://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust.zip |
| Linux | Oxide.Rust-linux.zip | https://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust-linux.zip |
Die beiden Archive werden getrennt erstellt und sind nicht austauschbar; installieren Sie das Windows-Archiv nicht auf einem Linux-Server. Oxide-Versionen werden im Format 2.0.xxxx nummeriert, und die Release Notes geben an, für welches Rust-Update die jeweilige Version veröffentlicht wurde. Die offizielle Installationsanleitung finden Sie in der Installationsdokumentation von Oxide.
4. Dateien in den Serverordner entpacken
Im Stammverzeichnis des Archivs liegt nur der Ordner RustDedicated_Data; die Dateien von Oxide landen im darunterliegenden Ordner Managed. Entpacken Sie das Archiv in den Stammordner des Servers (den Ordner mit RustDedicated.exe bzw. RustDedicated) und lassen Sie das Überschreiben vorhandener Dateien zu.
Windows
- Klicken Sie mit der rechten Maustaste auf die Datei
Oxide.Rust.zipund entpacken Sie sie mit Extract All in einen temporären Ordner (zum Beispiel auf den Desktop). - Kopieren Sie den entpackten Ordner
RustDedicated_Dataund fügen Sie ihn inC:\Rust\Serverein. - Wenn Windows nach gleichnamigen Dateien fragt, wählen Sie Replace the files in the destination.
Nach der Installation sollte die Datei C:\Rust\Server\RustDedicated_Data\Managed\Oxide.Rust.dll vorhanden sein. Fügen Sie den Ordner versehentlich innerhalb von RustDedicated_Data ein, entsteht ein zweiter, verschachtelter Ordner, und Oxide wird nicht geladen.
Linux
Verbinden Sie sich als Benutzer rust, laden Sie dann das Archiv herunter und entpacken Sie es in den Serverordner:
cd ~
curl -fL -o Oxide.Rust-linux.zip https://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust-linux.zip
unzip -o Oxide.Rust-linux.zip -d /home/rust/rustserver
ls /home/rust/rustserver/RustDedicated_Data/Managed/Oxide.Rust.dllunzip -o überschreibt vorhandene Dateien ohne Rückfrage. Gibt der letzte Befehl den Dateipfad aus, ist Oxide an Ort und Stelle.
5. Server starten und die Installation überprüfen
Starten Sie den Server wie gewohnt: unter Windows mit start.bat, unter Linux mit screen -S rust_server ~/start.sh. Beim ersten Start legt Oxide den Ordner oxide an und lädt den Compiler in den Serverordner herunter (unter Windows Oxide.Compiler.exe, unter Linux Oxide.Compiler); das sehen Sie an Konsolenzeilen, die mit [CSharp] beginnen.
Sobald der Server läuft, geben Sie unter Windows im Serverfenster bzw. unter Linux in Ihrem RCON-Tool Folgendes ein:
oxide.versionEnthält die Ausgabe eine Zeile im Format Oxide.Rust Version: 2.0.xxxx, ist die Installation abgeschlossen. Sie können den Befehl auch im Spiel über die F1-Konsole ausführen; dort wird die Version mit einem anderen Wortlaut angezeigt. Standardmäßig verschiebt Oxide Ihren Server in der Serverliste in den Tab „Modded“.
6. Den Ordner oxide kennenlernen
Alle Plugin-Dateien liegen im Ordner oxide innerhalb des Serverordners:
| Ordner / Datei | Inhalt | Wann Sie ihn verwenden |
|---|---|---|
oxide/plugins | Die .cs-Dateien der Plugins | Beim Hinzufügen, Aktualisieren oder Entfernen von Plugins |
oxide/config | Plugin-Einstellungen; pro Plugin eine nach ihm benannte .json-Datei | Beim Ändern der Einstellungen eines Plugins |
oxide/data | Die dauerhaften Daten der Plugins; die Berechtigungs- und Gruppeneinträge von Oxide (oxide.users.data, oxide.groups.data) | Wird meist nicht angefasst; immer sichern |
oxide/lang | Sprachdateien für Plugin-Meldungen (in Unterordnern wie oxide/lang/en) | Beim Übersetzen von Plugin-Meldungen |
oxide/logs | Logs von Oxide und dem Compiler | Wenn ein Plugin nicht geladen wird |
oxide/oxide.config.json | Die eigenen Einstellungen von Oxide | Für Einstellungen zur Serverliste und zu Chatbefehlen |
7. Erstes Plugin installieren
ExamplePlugin dient als Beispielname; die Schritte sind für jedes Plugin gleich.
- Laden Sie das Plugin von umod.org oder von einem Entwickler herunter, dem Sie vertrauen; prüfen Sie auf seiner Seite das letzte Update und die Kommentare. Ändern Sie weder Dateinamen noch Dateiendung.
- Legen Sie die Datei
ExamplePlugin.csin den Ordneroxide/plugins. Unter Windows können Sie sie per RDP kopieren; unter Linux verbinden Sie sich mit einem SFTP-Client wie WinSCP oder FileZilla als Benutzerrustund laden sie in den Ordner/home/rust/rustserver/oxide/pluginshoch. - Ein Neustart des Servers ist nicht nötig: Oxide erkennt die Änderung im Ordner, kompiliert das Plugin und lädt es. In der Konsole sollte eine Zeile erscheinen, die mit
Loaded pluginbeginnt. - Konfigurierbare Plugins legen beim ersten Laden die Datei
oxide/config/ExamplePlugin.jsonan. Nachdem Sie die Datei bearbeitet und gespeichert haben, laden Sie das Plugin mit dem ersten der folgenden Befehle neu. - Verwendet das Plugin Berechtigungen, vergeben Sie die Berechtigung wie im zweiten Befehl an eine Gruppe. Die Namen der Berechtigungen stehen auf der Seite des Plugins.
oxide.reload ExamplePlugin
oxide.grant group default exampleplugin.useDie Gruppe default umfasst alle, die sich mit dem Server verbinden, und die Gruppe admin die Spieler, die Sie mit ownerid zu Admins gemacht haben. JSON-Syntaxregeln, eigene Gruppen wie VIP, das Entziehen von Berechtigungen und die Fehlersuche in den Logs werden Schritt für Schritt in der Anleitung zu Rust-Plugins erklärt; zu Admin-Rechten lesen Sie die Anleitung zu Rust-Admin-Befehlen. Um ein Plugin zu entfernen, löschen Sie einfach seine .cs-Datei; Oxide entlädt das Plugin, und seine Einstellungsdatei bleibt in oxide/config erhalten.
8. Oxide nach einem Rust-Update neu installieren
Wenn Facepunch ein Update veröffentlicht, ersetzt SteamCMD die von Oxide geänderten Dateien durch die Originale; deshalb müssen Sie Oxide nach jedem Server-Update neu installieren. Plugins, Einstellungen und Berechtigungen bleiben im Ordner oxide erhalten; eine Neuinstallation von Oxide überschreibt nur die Dateien unter RustDedicated_Data/Managed.
- Prüfen Sie auf der GitHub-Release-Seite, ob eine neue Oxide-Version erschienen ist; falls nicht, warten Sie.
- Fahren Sie den Server mit
quitherunter und sichern Sie den Ordneroxide. - Führen Sie das folgende Skript aus: Es aktualisiert zuerst Rust, lädt dann die neueste Oxide-Version herunter und entpackt sie über die vorhandenen Dateien.
- Starten Sie den Server und bestätigen Sie die neue Version mit
oxide.version.
Die Oxide-Dokumentation empfiehlt, beim Aktualisieren mit SteamCMD -beta public anzugeben; so bleibt der Server auf dem öffentlichen Branch von Rust.
Windows: C:\Rust\update.bat
@echo off
C:\Rust\SteamCMD\steamcmd.exe +force_install_dir C:\Rust\Server\ +login anonymous +app_update 258550 -beta public +quit
powershell -NoProfile -Command "$ErrorActionPreference='Stop'; [Net.ServicePointManager]::SecurityProtocol='Tls12'; Invoke-WebRequest -UseBasicParsing -Uri 'https://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust.zip' -OutFile 'C:\Rust\Oxide.Rust.zip'; Expand-Archive -Path 'C:\Rust\Oxide.Rust.zip' -DestinationPath 'C:\Rust\Server' -Force"
pause-UseBasicParsing vermeidet die Sicherheitsabfrage in Windows PowerShell 5.1; der Teil Tls12 erzwingt auf älteren Windows-Server-Versionen TLS 1.2 für die Verbindung zu GitHub. $ErrorActionPreference='Stop' verhindert, dass das Archiv entpackt wird, wenn der Download fehlschlägt, -Force überschreibt die Dateien, und pause hält das Fenster offen.
Linux: ~/update.sh
#!/bin/bash
SERVER_DIR=/home/rust/rustserver
/usr/games/steamcmd +force_install_dir "$SERVER_DIR" +login anonymous +app_update 258550 -beta public +quit
curl -fL -o ~/Oxide.Rust-linux.zip https://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust-linux.zip && unzip -o ~/Oxide.Rust-linux.zip -d "$SERVER_DIR"&& stellt sicher, dass das Archiv nur entpackt wird, wenn der Download erfolgreich war. Machen Sie das Skript ausführbar; führen Sie es bei jedem Update aus und starten Sie danach den Server neu:
chmod +x ~/update.sh
~/update.sh
screen -S rust_server ~/start.sh9. Alternative: ein kurzer Blick auf Carbon
Carbon ist ein weiteres Modding-Framework für Rust und bezeichnet sich selbst als Drop-in-Ersatz für Oxide; seine Ordner- und Plugin-Struktur ähnelt der von Oxide. Testen Sie nach einem Wechsel trotzdem jedes Plugin.
| Oxide | Carbon | |
|---|---|---|
| Archiv | Oxide.Rust.zip / Oxide.Rust-linux.zip | Carbon.Windows.Release.zip / Carbon.Linux.Release.tar.gz |
| Installationsort | RustDedicated_Data/Managed | Ein Ordner carbon im Server-Stammverzeichnis |
| Einstellungsordner | oxide/config | carbon/configs |
| Befehlspräfix | oxide. oder o. | c. |
Die beiden funktionieren nicht gemeinsam in derselben Installation. Wenn Sie wechseln möchten, stoppen Sie den Server, deaktivieren Sie die Skripte, die Oxide installieren oder aktualisieren, führen Sie SteamCMD mit validate aus, um die Dateien in den Vanilla-Zustand zurückzusetzen, und installieren Sie Carbon. Beim ersten Start kopiert Carbon die Einstellungs-, Daten-, Sprach- und Berechtigungsdateien von Oxide in seinen eigenen Ordner. Details finden Sie auf der Seite von Carbon zur Migration von Oxide.
Beispieleinstellungen und grundlegende Befehle
Die ersten beiden Abschnitte der Datei oxide/oxide.config.json sehen so aus (die übrigen Abschnitte sind ausgelassen). Starten Sie den Server nach Änderungen neu.
{
"Options": {
"Modded": true,
"PluginWatchers": true,
"DefaultGroups": {
"Players": "default",
"Administrators": "admin"
},
"WebRequestIP": "0.0.0.0"
},
"Commands": {
"Chat command prefixes": [
"/"
]
}
}| Befehl / Einstellung | Funktion |
|---|---|
oxide.version (o.version) | Zeigt die installierte Oxide-Version an. |
oxide.plugins | Listet die Plugins mit Version, Autor, gesamter Hook-Zeit und Speicherverbrauch auf; zeigt bei Plugins, die nicht geladen werden konnten, den Grund an. |
oxide.load / oxide.unload PluginName | Lädt bzw. entlädt das Plugin. |
oxide.reload PluginName | Entlädt das Plugin und lädt es neu; oxide.reload * lädt alle neu. |
oxide.grant / oxide.revoke | Vergibt oder entzieht einem Benutzer oder einer Gruppe eine Berechtigung. |
"Modded": true | Listet den Server im Tab „Modded“; bei false wechselt er in den Tab „Community“. |
"DefaultGroups" | Die Gruppen, denen alle (default) und Admins (admin) zugeordnet werden. |
"Chat command prefixes" | Das Präfix für Chatbefehle; Standard ist /. |
Häufige Fehler
oxide.versionwird nicht erkannt: Die Dateien wurden an die falsche Stelle entpackt (ein verschachteltesRustDedicated_Data), oder die SteamCMD-Zeile im Startskript hat die Dateien zurückgesetzt. Prüfen Sie, ob der OrdnerManageddie DateiOxide.Rust.dllenthält; wiederholen Sie die Schritte 2 und 4.- Der Server startet nach einem Update nicht: Die Versionen von Oxide und Rust passen nicht zusammen; warten Sie auf die neue Oxide-Version und installieren Sie sie. Um den Server in der Zwischenzeit ohne Oxide zu starten, führen Sie SteamCMD mit
validateaus; die Dateien kehren in den Vanilla-Zustand zurück und der Ordneroxidebleibt erhalten, die Plugins funktionieren dann aber nicht. - Ein Plugin wird nicht geladen oder meldet einen Kompilierfehler:
oxide.pluginszeigt den Grund an, Details stehen inoxide/logs. Möglicherweise handelt es sich um eine alte Version des Plugins, die nicht an das letzte Rust-Update angepasst wurde; laden Sie die aktuelle Version herunter. Compiler may not be set as executableunter Linux: Geben Sie dem Compiler als BenutzerrustAusführungsrechte und starten Sie den Server neu:chmod +x /home/rust/rustserver/Oxide.Compiler- Der Compiler lässt sich nicht herunterladen oder startet nicht: Prüfen Sie die ausgehende HTTPS-Verbindung; in seiner Fehlermeldung nennt Oxide die Adresse, unter der Sie die Datei manuell herunterladen können, und den Pfad, unter dem Sie sie speichern müssen. Enthält der Serverpfad einen Apostroph (
'), läuft der Compiler nicht; benennen Sie den Ordner um. - Eine Änderung der Einstellungen wird nicht übernommen: Das JSON ist möglicherweise ungültig, oder das Plugin hat seine Einstellungen beim Entladen neu geschrieben; halten Sie sich an die Reihenfolge aus dem Konfigurationsschritt der Plugin-Anleitung.
- Ein Plugin-Befehl funktioniert nicht: Das Plugin ist möglicherweise nicht geladen, der Befehl falsch geschrieben oder eine Berechtigung fehlt. Prüfen Sie das mit
oxide.pluginsundoxide.show user.
Häufig gestellte Fragen
Landet mein Server nach der Installation von Oxide in der Modded-Liste?
Ja, standardmäßig schon. Ist die Einstellung Modded in oxide.config.json auf false gesetzt, erscheint der Server im Tab „Community“; laut dem Hinweis von Oxide erlaubt Facepunch dort jedoch nur Admin-Tools, die das Gameplay nicht beeinflussen.
Muss ich den Server stoppen, wenn ich ein Plugin hinzufüge?
Nein. Oxide überwacht den Ordner oxide/plugins; wird eine Datei hinzugefügt, geändert oder gelöscht, lädt, aktualisiert oder entlädt es das Plugin automatisch. Wenn Sie Oxide selbst installieren oder aktualisieren, muss der Server jedoch gestoppt sein.
Werden meine Plugins und Einstellungen nach einem Rust-Update gelöscht?
Nein, der Ordner oxide bleibt erhalten; nur die von Oxide geänderten Spieldateien im Ordner Managed werden in den Originalzustand zurückversetzt. Sobald Sie Oxide neu installieren, laufen die Plugins dort weiter, wo sie aufgehört haben; erstellen Sie vor dem Update trotzdem ein Backup.
Verlangsamen Plugins den Server?
Jedes Plugin hängt sich in die Ereignisse des Spiels ein, und die dafür benötigte Zeit erscheint in der Ausgabe von oxide.plugins; Plugins mit hohen Hook-Zeiten belasten die CPU. Mit steigender Zahl an Spielern und Plugins wird die Single-Core-Geschwindigkeit der CPU zum entscheidenden Faktor. Deshalb wird für einen gemoddeten Rust-Server die Familie AMD Ryzen 9 9950X VDS mit hoher Single-Core-Leistung empfohlen. Details finden Sie in der Anleitung zur Rust-Performance.
Verwandte Anleitungen
- Rust-Server einrichten: SteamCMD-Anleitung für Windows und Linux
- Rust-Plugins installieren: Oxide-Konfiguration, Berechtigungen und Fehler
- Rust-Admin-Befehle und Rechte (Auth Level) vergeben
- Ports auf einem Rust-Server öffnen und sichere Fernverwaltung mit RCON
- Lag auf dem Rust-Server beheben: FPS, Entities und Plugins prüfen
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.