Zum Hauptinhalt springen

Rust Plugin-Verwaltung

uMod und Oxide Grundlagen

Sobald uMod installiert ist, läuft der Betrieb von Plugins auf drei Ordner und etwa sechs Befehle hinaus. Lerne besonders den Reload-Befehl: Er macht den Unterschied zwischen einer Änderung in fünf Sekunden testen und deinen Server jedes Mal neu starten.

  • Rust Anleitungen
  • Aktualisiert
  • 6 Min. Lesezeit
  • 3 Ordner
  • 6 Kernbefehle
  • Berechtigungsgruppen
OXIDE-BEFEHLERCON-Konsoleoxide.reload BetterChatoxide.unload BetterChatoxide.reload *oxide.usergroup add VIPsoxide.grant group Admins noclip.use# Neuladen schlägt Neustart, immer

Die kurze Antwort

Lade .cs-Plugin-Dateien in oxide/plugins hoch. Ihre Einstellungen erscheinen nach dem ersten Lauf in oxide/config. Nutze oxide.reload PluginName, um Änderungen ohne Neustart zu übernehmen, und vergib Berechtigungen an Gruppen mit oxide.grant group (GROUP) (PERMISSION) statt an Einzelpersonen.

Das Wichtigste

  • Drei Ordner: plugins, config, data. Jeder hat eine Aufgabe.
  • Konfigurationsdateien erscheinen erst, nachdem das Plugin einmal gelaufen ist. Erstelle sie nicht von Hand.
  • oxide.reload schlägt einen Neustart bei fast jeder Plugin-Änderung.
  • Vergib an Gruppen, nicht an Personen. Das skaliert und ist nachvollziehbar.
  • Die Dokumentation jedes Plugins listet seine Berechtigungen. Lies sie, bevor du rätst.

Die drei Ordner

uMod erstellt drei Ordner auf deinem Server, und zu wissen, welcher was macht, erspart dir später viel Verwirrung.

oxide/plugins
Die Plugin-Dateien selbst, als .cs. Eine Datei hier hineinzulegen lädt sie automatisch.
oxide/config
Konfigurationsdateien für die meisten Plugins. Diese werden vom Plugin beim ersten Lauf erzeugt, nicht von dir bereitgestellt.
oxide/data
Gespeicherte Daten, die manche Plugins zwischen Neustarts behalten, etwa Spielerdatensätze oder Wirtschaftsguthaben. Behandle das als das Gedächtnis des Plugins, nicht als etwas, das man beiläufig bearbeitet.

Eine fehlende Konfigurationsdatei ist kein Problem, das behoben werden muss. Wenn du gerade ein Plugin hochgeladen hast und oxide/config nichts dafür enthält, liegt das daran, dass das Plugin noch nicht gelaufen ist. Starte den Server, lass es laden, und die Datei wird da sein.

Plugins hochladen

  1. Die Plugin-Datei besorgen

    Lade die .cs-Datei aus der uMod Plugin-Bibliothek herunter, oder woher auch immer der Autor sie verbreitet.

  2. In oxide/plugins hochladen

    Über den Dateimanager oder per FTP. Lade die .cs-Datei selbst hoch, nicht ein Zip davon.

  3. Laden lassen

    uMod erkennt neue Dateien automatisch. Achte in der Konsole auf eine Ladebestätigung oder einen Fehler.

  4. Konfigurieren

    Seine Konfigurationsdatei existiert jetzt in oxide/config. Bearbeite sie, führe dann oxide.reload PluginName aus, um sie zu übernehmen.

Jedes Plugin auf der uMod Website kommt mit einer Beschreibung, die seine Einrichtung, seine Konfigurationsoptionen und die von ihm definierten Berechtigungen behandelt. Lies diese Seite, bevor du bei den Einstellungen zu raten beginnst, denn die meisten Fragen, die du gleich haben wirst, sind dort bereits beantwortet.

Die Befehle, die du brauchst

Zentrale Oxide-Befehle zur Plugin-Verwaltung.
BefehlWas er macht
oxide.reload (PLUGIN NAME)Lädt das angegebene Plugin neu.
oxide.unload (PLUGIN NAME)Entlädt das angegebene Plugin.
oxide.reload *Lädt alle Plugins auf einmal neu.
oxide.usergroup add (GROUP NAME)Erstellt eine neue Oxide Nutzergruppe.
oxide.grant group (GROUP NAME) (PERMISSION)Vergibt eine Berechtigung an eine Gruppe.
oxide.grant user (USERNAME/STEAM64 ID) (PERMISSION)Vergibt eine Berechtigung an einen einzelnen Nutzer.

oxide.reload ist der Befehl, der deine Arbeitsweise verändert. Eine Konfiguration zu bearbeiten und ein einzelnes Plugin neu zu laden dauert Sekunden und trennt niemanden. Den Server neu zu starten, um dasselbe zu erreichen, kostet deine Spieler einen Map-Load und, wenn sich der Seed geändert hat, bis zu zehn Minuten.

Berechtigungsgruppen in der Praxis

Oxide-Berechtigungen können an einen einzelnen Nutzer oder an eine Gruppe vergeben werden. Beides funktioniert. Nutze Gruppen.

Der Grund ist Wartbarkeit. Vergibst du zehn Berechtigungen direkt an fünf VIPs, musst du fünfzig Vergaben im Blick behalten, und hört jemand auf, VIP zu sein, musst du dich an alle zehn erinnern. Vergib die zehn Berechtigungen an eine Gruppe VIPs, und eine Person hinzuzufügen oder zu entfernen ist ein Befehl.

  1. Die Gruppe erstellen

    oxide.usergroup add VIPs
  2. Der Gruppe ihre Berechtigungen geben

    oxide.grant group VIPs kits.vip
  3. Personen zur Gruppe hinzufügen

    Statt ihnen Berechtigungen einzeln zu vergeben. Ihr Zugriff folgt dann der Gruppendefinition.

Durchgerechnete Beispiele

Ein gerade aktualisiertes Plugin neu laden
Du hast die BetterChat-Datei ersetzt, führe also oxide.reload BetterChat aus. Kein Neustart nötig.
Admins Noclip geben
oxide.grant group Admins noclip.use gibt jedem in der Admins-Gruppe diese Berechtigung.
Eine VIP-Stufe erstellen
oxide.usergroup add VIPs, dann gib ihr, was die kostenpflichtige Stufe enthalten soll.
Einer Person vorübergehend etwas gewähren
oxide.grant user 76561198000000000 kits.event. Nutze das sparsam, und denk daran, dass du es vergeben hast.
Ein sich schlecht verhaltendes Plugin sofort abschalten
oxide.unload PluginName. Schneller und weniger störend als ein Neustart, und es sagt dir sofort, ob dieses Plugin das Problem war.

Gewohnheiten, die sich lohnen

Sichern, bevor du Plugins änderst
Erstelle eine Kopie von oxide/, bevor du etwas hinzufügst oder entfernst. Einen Ordner wiederherzustellen ist schneller, als eine Konfiguration aus dem Gedächtnis zu rekonstruieren.
Ein Plugin nach dem anderen hinzufügen
Hinzufügen, neu laden, Konsole und Server-FPS beobachten, dann weitermachen. Sechs auf einmal hinzuzufügen und dann einen unglücklichen Server vorzufinden, lässt dich mit sechs Verdächtigen zurück.
Die Performance dabei im Auge behalten
Plugins sind der Haupteinfluss auf die Rust Server Performance, und ein trivial wirkendes Plugin kann dich trotzdem jeden Tick kosten.
Plugins aktuell halten
Prüfe uMod nach jedem Rust Update. Ein veraltetes Plugin schlägt bei der Kompilierung fehl, und die Fehlermeldung nennt es, was zumindest leicht zu diagnostizieren ist.
Die Konsole lesen
uMod ist ungewöhnlich gut darin, dir zu sagen, was schiefgelaufen ist. Die meisten Plugin-Probleme sind bereits in der Ausgabe erklärt, die du noch nicht hochgescrollt hast, um sie zu lesen.

Für mehr Tiefe zum Framework selbst ist die offizielle uMod Dokumentation die maßgebliche Quelle. Wenn du es noch nicht installiert hast, starte mit unserer Anleitung zum Installieren von uMod auf einem Rust Server.

Weitere Anleitungen für alle, die einen eigenen Rust Server betreiben.

Kurze Antworten

Häufige Fragen

Lade die .cs-Plugin-Dateien in den Ordner oxide/plugins auf deinem Server hoch. Konfigurationsdateien für die meisten Plugins erscheinen in oxide/config, nachdem sie einmal gelaufen sind, und manche Plugins nutzen zusätzlich oxide/data für gespeicherte Informationen.

Führe oxide.reload PluginName in der Konsole aus. Das lädt nur dieses Plugin neu und übernimmt alle Änderungen an seiner Datei oder Konfiguration. oxide.reload * lädt alles auf einmal neu.

Nutze oxide.grant group (GROUP NAME) (PERMISSION). Zum Beispiel gibt oxide.grant group Admins noclip.use jedem in der Admins-Gruppe die Berechtigung noclip.use. Berechtigungen werden vom Plugin definiert, und seine Dokumentation listet sie auf.

oxide.usergroup add (GROUP NAME), zum Beispiel oxide.usergroup add VIPs. Vergib die Berechtigungen dann an die Gruppe statt an Einzelpersonen, sodass ein neuer VIP später ein Befehl ist statt zehn.

Nein. Bearbeite die Datei in oxide/config, führe dann oxide.reload PluginName aus, und das Plugin übernimmt die neuen Einstellungen. Ein vollständiger Server-Neustart ist für Plugin-Arbeit selten nötig.

Meist liegt die Datei am falschen Ort, ist keine .cs-Datei, oder wurde für eine andere Rust- oder uMod-Version geschrieben. Die Konsole gibt eine Fehlermeldung mit dem Plugin-Namen aus, wenn die Kompilierung fehlschlägt, lies also das, statt zu raten.

Rust Hosting mit vollem Dateizugriff

Dateimanager, FTP und Konsolenzugriff auf jedem Rust Server, den wir hosten, das Hochladen und Neuladen von Plugins ist also eine Zwei-Minuten-Aufgabe.

  • Britisches Rechenzentrum
  • Dateimanager und FTP
  • Support per Ticket und Discord