Rust: Oxide/uMod-Plugins installieren und einen Wipe durchführen

Zwei Dinge, die fast jeder Rust-Serverbesitzer benötigt: das Oxide (uMod) Modding-Framework, damit du Plugins ausführen kannst, und eine zuverlässige Wipe-Routine für den Fall, dass Facepunch das monatliche erzwungene Update veröffentlicht. Dieser Leitfaden behandelt beides.

Oxide (uMod) installieren

Oxide (auch uMod genannt) ist das Plugin-Framework, auf dem fast jeder modifizierte Rust-Server läuft. Auf ServerPrism ist der einfachste Weg, es zu erhalten, in deinem Servertyp integriert:

1. Öffne deinen Server und gehe zum Tab Startup.
2. Suche nach einer Option für modding framework / Oxide (viele Rust-Eggs haben einen Schalter oder eine Build-Variable wie Oxide/Carbon).
3. Stelle es auf Oxide ein und installiere es dann neu oder starte es neu, damit das Framework heruntergeladen wird.
4. Nach dem Booten zeigt die Konsole beim Start die Oxide-Version an, und ein oxide/-Ordner erscheint im Dateimanager.

Wenn dein Servertyp keinen Schalter anbietet, öffne ein Support-Ticket und wir stellen dich auf den Oxide-Build um.

Plugins installieren

Rust-Plugins sind einzelne .cs-Dateien.

1. Lade die Plugin-.cs-Datei von umod.org herunter.
2. Im File Manager lege sie in oxide/plugins/ ab.
3. Oxide lädt Plugins hot – kein Neustart erforderlich. Die Konsole gibt innerhalb weniger Sekunden Loaded plugin <Name> aus.

Konfigurations- und Datendateien werden beim ersten Laden unter oxide/config/ und oxide/data/ generiert. Bearbeite die Konfiguration und lade das Plugin dann mit oxide.reload <PluginName> in der Konsole neu.

Nützliche Konsolenbefehle:

oxide.plugins           # Liste geladener Plugins
oxide.reload PluginName  # Konfigurationsänderungen anwenden
oxide.unload PluginName  # Deaktivieren ohne zu löschen
oxide.grant group admin PluginName.permission  # Berechtigungen

Server wipen

Ein Wipe setzt den Fortschritt zurück. Es gibt zwei Stufen:

• Map-Wipe — generiert die Karte neu und löscht Gebäude/Loot, behält aber Blaupausen bei. Tue dies, wenn du eine frische Karte möchtest.
• Full Wipe (BP Wipe) — Map-Wipe plus Löschen der Spieler-Blaupausen. Dies ist, was die meisten Server beim monatlichen erzwungenen Update tun.

Wie man einen Wipe durchführt

1. Stoppe den Server über den Console-Tab.
2. Im File Manager öffne den Ordner server/<identity>/ (die Identität ist auf deinem Startup-Tab festgelegt).
3. Für einen Map-Wipe lösche die Kartendateien: *.map und *.sav (und deren .1, .2 Backups).
4. Für einen Full Wipe lösche auch die Blaupausen-Daten – entferne die Dateien player.blueprints.*.db (oder je nach Build die gesamten storage/Blaupausen-Dateien).
5. Optional ändere den world seed und/oder die map size auf dem Startup-Tab für eine brandneue Karte.
6. Starte den Server. Er generiert beim Booten eine frische Welt.

Immer zuerst ein Backup erstellen. Erstelle ein Backup, bevor du einen Wipe durchführst, damit ein Fehler rückgängig gemacht werden kann – siehe Server-Backups.

Zeitpunkt des erzwungenen Wipes

Facepunch veröffentlicht am ersten Donnerstag jedes Monats ein obligatorisches Update, das Oxide und Plugins außer Kraft setzt, bis sie aktualisiert werden. Am Tag des erzwungenen Wipes: aktualisiere den Server, warte, bis Oxide und deine Plugins aktualisierte Versionen veröffentlichen, und führe dann den Wipe durch. Das Ausführen eines veralteten Oxide nach einem erzwungenen Update führt zu einem Fehler beim Laden – dies ist zu erwarten, bis uMod aktualisiert wird.

Häufige Probleme

• Plugins werden nach dem monatlichen Update nicht geladen: Oxide/Plugins sind noch nicht für die neue Rust-Version aktualisiert – aktualisiere den Server und warte, bis uMod aufgeholt hat.
• Failed to compile ein Plugin: falsche Plugin-Version für deinen Oxide-Build oder ein fehlendes Abhängigkeits-Plugin – überprüfe die uMod-Seite des Plugins.
• Wipe "hat nicht funktioniert": Du hast Dateien im falschen Identitätsordner gelöscht oder den Server nicht zuerst gestoppt – stoppe, lösche im richtigen server/<identity>/-Ordner und starte dann.
• Server nicht im Browser: startet noch oder die Beschreibung/server.hostname ist nicht festgelegt – überprüfe die Konsole.

Brauchst du Hilfe bei einem Wipe oder einem hartnäckigen Plugin? Öffne ein Support-Ticket und wir kümmern uns darum auf dem Node.