Diese Anleitung beschreibt, wie Sie das Oxide/uMod- oder Carbon-Modding-Framework auf Ihrem Rust-Server installieren, Community-Plugins hinzufügen und diese über die Konsole verwalten. Für allgemeine Serverkonfiguration und Startvariablen siehe die Rust Server-Konfigurationsanleitung.

Oxide/uMod oder Carbon installieren

Oxide (jetzt als uMod weitergeführt) und Carbon sind Modding-Frameworks für Rust, mit denen Sie von der Community erstellte Plugins installieren können. Diese Frameworks fügen Funktionen wie Wirtschaftssysteme, benutzerdefinierte Kits, Abstimmungsbelohnungen, PvE-Schutzzonen und vieles mehr hinzu.

Sie müssen keine Dateien manuell hochladen. Das Modding-Framework wird automatisch installiert, indem eine einzige Startvariable gesetzt wird:

1. Stoppen Sie Ihren Server über den GPanel-Reiter Console.
2. Melden Sie sich bei GPanel an und gehen Sie zum Reiter Startup.
3. Suchen Sie die Variable FRAMEWORK und setzen Sie sie auf:
   • oxide — für Oxide/uMod (das am weitesten verbreitete Framework mit der größten Plugin-Bibliothek)
   • carbon — für das Carbon-Framework (eine Alternative mit eigenem Plugin-Ökosystem)
   • vanilla — um ohne Modding-Framework zu spielen
4. Starten Sie den Server. Die Framework-Dateien werden automatisch heruntergeladen und angewendet. Beim ersten Start mit Oxide wird die oxide/-Verzeichnisstruktur erstellt.
5. Überprüfen Sie das Konsolenprotokoll auf eine Zeile wie Loaded plugin Oxide.Core, um zu bestätigen, dass Oxide aktiv ist.

Plugins installieren

Plugins werden als .cs-Dateien (C#-Quellcode) verteilt. Oxide kompiliert sie zur Laufzeit auf dem Server — eine Vorkompilierung ist nicht erforderlich.

1. Laden Sie die Plugin-.cs-Datei von umod.org oder einer anderen vertrauenswürdigen Quelle herunter.
2. Laden Sie die .cs-Datei in das Verzeichnis oxide/plugins/ auf Ihrem Server hoch, entweder per SFTP oder über den GPanel-Dateimanager. Für Hilfe mit SFTP siehe Dateien per SFTP hochladen.
3. Wenn der Server läuft, wird das Plugin innerhalb weniger Sekunden automatisch erkannt und kompiliert. In der Konsole erscheint eine Bestätigung, z. B. Loaded plugin MyPlugin v1.2.3 by Author.
4. Wenn der Server nicht läuft, wird das Plugin beim nächsten Start geladen.

Oxide-Verzeichnisstruktur

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

Plugins konfigurieren

Die meisten Plugins erzeugen beim ersten Laden automatisch eine JSON-Konfigurationsdatei in oxide/config/. Um ein Plugin anzupassen:

1. Lassen Sie das Plugin mindestens einmal laden, damit es seine Standard-Konfigurationsdatei erstellt.
2. Stoppen Sie Ihren Server (oder beachten Sie, dass einige Plugins ein Live-Neuladen der Konfiguration unterstützen).
3. Öffnen Sie die Konfigurationsdatei des Plugins unter oxide/config/PluginName.json über den GPanel-Dateimanager oder SFTP.
4. Bearbeiten Sie die Einstellungen und speichern Sie die Datei.
5. Laden Sie das Plugin mit oxide.reload PluginName neu oder starten Sie den Server neu.

Plugins über die Konsole verwalten

Diese Befehle können über die GPanel-Konsole oder einen RCON-Client ausgeführt werden. Für die RCON-Einrichtung siehe Rust RCON-Zugang und Admin-Befehle.

Plugins aktualisieren

Um ein Plugin auf eine neuere Version zu aktualisieren:

1. Laden Sie die aktualisierte .cs-Datei von der Plugin-Seite auf umod.org herunter.
2. Laden Sie die neue Datei nach oxide/plugins/ hoch und überschreiben Sie die vorhandene Datei.
3. Wenn der Server läuft, erkennt Oxide die Dateiänderung und kompiliert und lädt das Plugin automatisch neu. Alternativ können Sie oxide.reload PluginName ausführen.
4. Überprüfen Sie die Konsole auf Fehler. Einige Plugin-Updates erfordern möglicherweise Änderungen an der Konfigurationsdatei in oxide/config/.

Plugins entfernen

Um ein Plugin vollständig zu entfernen:

1. Führen Sie oxide.unload PluginName aus, um das Plugin zu entladen, während der Server läuft.
2. Löschen Sie die .cs-Datei aus oxide/plugins/.
3. Löschen Sie optional die Konfigurationsdatei des Plugins aus oxide/config/ und die Datendateien aus oxide/data/, wenn Sie diese nicht mehr benötigen.

Beliebte Plugins

Fehlerbehebung bei Plugin-Problemen

Wenn Ihre Plugins nicht laden, überprüfen Sie Folgendes:

• Bestätigen Sie, dass Oxide installiert und aktiv ist. Im GPanel-Reiter Startup muss die Variable FRAMEWORK auf oxide gesetzt sein. Das Konsolenprotokoll sollte beim Start Loaded plugin Oxide.Core anzeigen.
• Plugin-Dateien müssen direkt in oxide/plugins/ mit der exakten Endung .cs abgelegt werden. Dateien in Unterverzeichnissen oder mit falschen Endungen werden ignoriert.
• Überprüfen Sie die Konsole und oxide/logs/ auf Kompilierungsfehler. Ein Plugin mit einem Syntaxfehler wird nicht geladen, und die Fehlermeldung beschreibt das Problem.
• Einige Plugins haben Abhängigkeiten von anderen Plugins (z. B. benötigen viele Shop-Plugins Economics). Installieren Sie zuerst alle erforderlichen Abhängigkeiten.

Für weitere häufige Serverprobleme siehe Rust Server-Fehlerbehebung.

Brauchen Sie Hilfe?

Wenn Sie auf ein Problem stoßen, das in dieser Anleitung nicht behandelt wird, steht Ihnen unser Support-Team gerne zur Verfügung. Erstellen Sie ein Support-Ticket und geben Sie Ihre Server-ID, eine Beschreibung des Problems und relevante Konsolenausgaben an.