Rust Plugins installieren – uMod/Oxide Guide

Zuletzt geprüft: 27. September 2026. Rust Plugins installierst du über uMod/Oxide, indem du das Framework aktivierst, eine passende .cs-Datei von der offiziellen uMod-Pluginseite herunterlädst und sie in /oxide/plugins/ hochlädst. Danach prüfst du Konfiguration, Permissions und Konsole. Wichtig ist ein kontrollierter Ablauf, weil fehlerhafte Plugins Gameplay, Rechte oder Serverstabilität beeinflussen können.

Voraussetzungen

Du brauchst einen Rust Server mit Dateizugriff, Konsolenzugriff und aktivierbarem uMod/Oxide Framework. Bei game-serverhosting ist die typische Reihenfolge: Framework im Panel aktivieren, Server starten lassen, Plugin-Dateien hochladen und anschließend Konfiguration sowie Rechte setzen. Plane Änderungen nicht direkt während hoher Spieleraktivität ein, sondern teste sie nach Möglichkeit zuerst mit wenigen Spielern oder auf einem separaten Setup.

Die offizielle uMod-Seite ist die Primärquelle für Rust Plugins und Dokumentation. Nutze für Downloads die vorhandene Plugin-Übersicht unter umod.org/plugins?game=rust. Für die Bedienlogik von uMod ist außerdem die offizielle Dokumentation unter umod.org/documentation maßgeblich. Prüfe dort immer, ob ein Plugin aktiv gepflegt wird und welche Permissions oder Dependencies genannt werden.

Wenn du noch am Grundsetup deines Rust Servers arbeitest, hilft dir der interne Guide Rust Server mieten und einrichten. Für RAM, Einstellungen und Plugin-Planung findest du ergänzend den Guide Rust Server mieten: RAM, Einstellungen & Plugins.

uMod/Oxide installieren

uMod ist ein Plugin-Framework für Rust. Es erweitert den Server um eine Plugin-Schicht, über die C#-Plugins geladen, konfiguriert und mit Rechten versehen werden können.

1. In den Startvariablen Modding Framework (FRAMEWORK) auf oxide setzen
2. Änderung speichern und Rust-Server neu starten
3. Mit oxide.version in der Serverkonsole prüfen, ob Oxide geladen ist

Warte nach der Änderung, bis der Server vollständig gestartet ist, und prüfe oxide.version. Erst danach solltest du Dateien in /oxide/plugins/ hochladen. Wenn Ordner wie /oxide/config/, /oxide/data/ oder /oxide/logs/ noch fehlen, wurde uMod möglicherweise noch nicht vollständig initialisiert oder der Server muss einmal sauber gestartet werden.

Plugin installieren

1. Besuche umod.org/plugins?game=rust
2. Plugin herunterladen (.cs Datei)
3. In /oxide/plugins/ hochladen
4. Plugin wird in der Regel automatisch geladen; ein kompletter Restart ist oft nicht nötig, kann bei größeren Änderungen aber sinnvoll sein

Lade immer die originale .cs-Datei des Plugins hoch und ändere den Dateinamen nicht unnötig. Nach dem Upload solltest du die Serverkonsole beobachten. uMod meldet dort normalerweise, ob das Plugin kompiliert und geladen wurde oder ob Syntaxfehler, fehlende Abhängigkeiten oder Versionsprobleme auftreten.

Rust-Plugins auswählen

Für Teleportation, Chat, Kits, Sammelraten oder Inventar gibt es unterschiedliche uMod-Plugins. Suche in der offiziellen Rust-Pluginliste, öffne die jeweilige Projektseite und prüfe dort Versionsstand, Abhängigkeiten, Befehle und Permissions. Pauschale Downloadzahlen veralten schnell und sagen nichts über die Kompatibilität mit deiner Rust-Version aus.

Installiere Plugins nacheinander. Nach jedem Upload prüfst du Konsole und Funktion mit einem Testaccount. Besonders Plugins für Wirtschaft, Teleportation oder Inventar können bestehendes Gameplay verändern.

Plugin-Konfiguration und gespeicherte Daten

Konfigurierbare Plugins erzeugen nach dem erfolgreichen Laden meist eine JSON-Datei unter /oxide/config/. Plugins ohne konfigurierbare Optionen müssen dort keine Datei haben. Öffne sie erst, nachdem das Plugin einmal geladen wurde, und achte darauf, dass JSON syntaktisch gültig bleibt.

{
  "Default Multiplier": 3.0,
  "Quarry Multiplier": 3.0,
  "Pumpjack Multiplier": 3.0
}

Das ist nur ein JSON-Formbeispiel, kein garantiertes Schema einer aktuellen GatherManager-Version. Übernimm die vom Plugin selbst erzeugten Schlüssel und Werte; //-Kommentare sind in JSON ungültig.

Ändere nur Werte, deren Bedeutung du kennst. Nach einer Änderung lädst du das Plugin in der Serverkonsole mit oxide.reload <Pluginname> neu oder startest den Server kontrolliert neu. Die uMod-Konfigurationsdokumentation beschreibt diesen Ablauf. Wenn die Konsole nach dem Speichern JSON-Fehler meldet, prüfe zuerst Kommas, Anführungszeichen und Klammern.

Plugin-Permissions

Viele Rust Plugins sind ohne korrekt gesetzte Rechte installiert, aber für Spieler nicht nutzbar. uMod arbeitet mit Permissions für Nutzer und Gruppen. Häufig gibt die Pluginseite an, welche Permission vergeben werden muss.

oxide.grant user <steamid> <permission>
oxide.grant group default <permission>
oxide.revoke user <steamid> <permission>

user eignet sich für einzelne Administratoren oder Tester. group default betrifft grundsätzlich normale Spieler und sollte vorsichtig verwendet werden. Vergib Rechte nur so breit wie nötig, besonders bei Admin-, Teleport-, Kit-, Remove- oder Economy-Funktionen.

Ergebnis prüfen

Nach der Installation solltest du drei Dinge kontrollieren: Erstens muss das Plugin in der Konsole ohne Compile-Fehler laden. Zweitens sollte oxide.plugins das Plugin in der Liste der geladenen Plugins zeigen. Drittens muss der relevante Ingame-Befehl oder Effekt mit einem Testaccount funktionieren.

Prüfe bei konfigurierbaren Plugins die Datei unter /oxide/config/ und lies Ladefehler im Log. Sichere bei Economy-, Kit- oder Inventarplugins außerdem die zugehörigen Daten unter /oxide/data/; die .cs-Datei und Config allein enthalten nicht unbedingt den Spielerfortschritt. Wenn mehrere Plugins gleichzeitig geändert wurden, teste sie einzeln. So findest du schneller heraus, ob ein Problem vom Plugin selbst, von einer Permission, von einer fehlerhaften Config oder von einem Konflikt stammt.

Troubleshooting

• Plugin lädt nicht: Prüfe die Oxide-Version, die Rust-Serverversion und die Hinweise auf der Pluginseite.
• Fehler in Konsole: Lies die konkrete Fehlermeldung und prüfe, ob das Plugin aktuell ist. Bei Pluginfehlern ist die jeweilige umod.org-Seite der passende Ausgangspunkt.
• Performance: oxide.plugins zeigt auch fehlgeschlagene Plugins und deren Fehlergrund. Nutze Status und Hook-Zeiten als Hinweis, teste die konkrete belastende Spielsituation und entlade zuletzt geänderte Plugins einzeln mit oxide.unload <Pluginname>. Die Oxide-Befehlsreferenz erläutert Pluginstatus, Hook-Zeiten und gezieltes Entladen.
• Konflikte: Plugins einzeln testen, besonders wenn mehrere Plugins Chat, Teleport, Kits, Zonen oder Inventar verändern.
• Config wird überschrieben: Sichere Config und zugehörige Dateien unter oxide/data getrennt. Stoppe den Server oder entlade das Plugin, bearbeite erst danach die Config und lade es wieder. Ein gespeicherter Wert wird nur übernommen, wenn JSON gültig ist und der Schlüssel zur Plugin-Version passt.
• Spieler können Befehle nicht nutzen: Permission-Namen auf der Pluginseite prüfen und mit oxide.grant korrekt vergeben.

FAQ

Muss ich den Rust Server nach jedem Plugin neu starten?

Nicht immer. Viele uMod-Plugins werden nach dem Upload in /oxide/plugins/ automatisch geladen. Bei größeren Änderungen, Abhängigkeiten oder unerklärlichen Fehlern ist ein kontrollierter Neustart trotzdem sinnvoll.

Wo finde ich die Config-Dateien?

Konfigurierbare uMod-Plugins speichern ihre JSON-Dateien standardmäßig unter /oxide/config/. Ein Plugin ohne konfigurierbare Optionen legt dort keine Datei an.

Warum funktioniert ein Plugin-Befehl im Spiel nicht?

Meist fehlt eine Permission oder der Befehl ist anders benannt als erwartet. Prüfe die Pluginseite, setze die Rechte mit oxide.grant und kontrolliere anschließend die Konsole.

Kann ich mehrere Rust Plugins gleichzeitig installieren?

Technisch ja, praktisch solltest du schrittweise vorgehen. Installiere ein Plugin, prüfe Konsole und Funktion, und fahre erst dann mit dem nächsten fort.

Was mache ich bei Performance-Problemen nach einer Installation?

Deaktiviere zuletzt installierte Plugins einzeln, beobachte die Serverkonsole und prüfe oxide.plugins. So grenzt du ein, ob ein bestimmtes Plugin oder eine Kombination die Ursache ist.