Plugins konfigurieren

Die meisten Rust-Plugins funktionieren direkt nach der Installation, aber die wahre Stärke liegt im Konfigurieren. Durch das Anpassen der Plugin-Einstellungen machst du deinen Server einzigartig. In diesem Artikel erklären wir, wie Konfigurationsdateien funktionieren, wie du sie bearbeitest und worauf du achten solltest.

Wie funktionieren Konfigurationsdateien?

Jedes Oxide-Plugin mit konfigurierbaren Einstellungen erstellt beim ersten Laden automatisch eine Konfigurationsdatei. Diese Datei wird im Ordner oxide/config/ gespeichert und hat denselben Namen wie das Plugin mit der Endung .json.

Zum Beispiel:

Das Plugin GatherManager.cs erstellt die Konfigurationsdatei oxide/config/GatherManager.json.
Das Plugin NTeleportation.cs erstellt die Konfigurationsdatei oxide/config/NTeleportation.json.

Wichtig: Die Konfigurationsdatei wird erst erstellt, nachdem das Plugin zum ersten Mal erfolgreich geladen wurde. Wenn du keine Konfigurationsdatei siehst, prüfe zuerst, ob das Plugin korrekt installiert ist und ohne Fehler läuft.

Eine Konfigurationsdatei öffnen und bearbeiten

Du kannst Konfigurationsdateien über den integrierten Dateieditor im HytaleNode-Panel bearbeiten:

Gehe zu mijn.hytalenode.nl und logge dich ein.
Klicke auf deinen Rust-Server.
Gehe zum Tab Bestanden.
Navigiere zu oxide > config.
Klicke auf die .json-Datei des Plugins, das du konfigurieren möchtest.
Die Datei öffnet sich im integrierten Texteditor, wo du die Einstellungen anpassen kannst.

JSON-Grundlagen: Wie liest man eine Konfigurationsdatei?

Konfigurationsdateien sind in JSON (JavaScript Object Notation) geschrieben. Das klingt technisch, ist aber eigentlich ganz einfach. Hier ist ein Beispiel, wie eine Konfigurationsdatei aussehen kann:

{
  "Gather Rates": {
    "Wood": 2.0,
    "Stone": 2.0,
    "Metal Ore": 3.0,
    "Sulfur Ore": 3.0
  },
  "Enable Pickup Messages": true,
  "Message Color": "#ffffff"
}

Schauen wir uns die JSON-Grundlagen an:

Geschweifte Klammern { } -- Gruppieren Einstellungen. Jede Konfigurationsdatei beginnt und endet mit geschweiften Klammern.
Anführungszeichen " " -- Text (Strings) steht immer in doppelten Anführungszeichen. Das gilt sowohl für den Namen einer Einstellung als auch für den Wert (wenn es Text ist).
Kommas , -- Jede Einstellung wird durch ein Komma getrennt, außer der letzten Einstellung in einer Gruppe.
Zahlen -- Zahlen stehen ohne Anführungszeichen. Dezimalzahlen verwenden einen Punkt (kein Komma): 2.5.
true / false -- Das sind Ein/Aus-Werte (Booleans). Sie stehen ohne Anführungszeichen und immer in Kleinbuchstaben.
Doppelpunkt : -- Trennt den Namen einer Einstellung vom Wert: "Name": Wert.

Häufige JSON-Fehler

Ein kleiner Tippfehler in einer JSON-Datei kann dazu führen, dass die gesamte Konfiguration nicht mehr eingelesen wird. Achte auf diese häufigen Fehler:

Fehlendes Komma -- Vergiss kein Komma nach jeder Einstellung, außer der allerletzten.
Extra Komma -- Ein Komma nach der letzten Einstellung in einer Gruppe verursacht einen Fehler. Das ist einer der häufigsten Fehler.
Fehlende Anführungszeichen -- Text muss immer in doppelten Anführungszeichen stehen.
Falsche Klammern -- Stelle sicher, dass jede { eine passende } hat und jede [ eine passende ].

Tipp: Wenn du unsicher bist, ob dein JSON korrekt ist, kannst du einen kostenlosen Online-JSON-Validator verwenden. Gehe zu jsonlint.com, füge deine Konfiguration ein und klicke auf "Validate JSON". Das Tool zeigt genau, wo eventuelle Fehler sind.

Änderungen übernehmen: Plugin neu laden

Nachdem du eine Konfigurationsdatei angepasst und gespeichert hast, musst du das Plugin neu laden, damit die neuen Einstellungen eingelesen werden. Das machst du über die Konsole:

Speichere die Konfigurationsdatei, indem du im Dateieditor auf Opslaan klickst.
Gehe zum Tab Console deines Servers.
Gib den Befehl oxide.reload PluginNaam ein und drücke Enter.

Ersetze PluginNaam durch den exakten Namen des Plugins. Zum Beispiel:

oxide.reload GatherManager -- Lädt das Gather Manager Plugin neu.
oxide.reload NTeleportation -- Lädt das NTeleportation Plugin neu.
oxide.reload BetterChat -- Lädt das BetterChat Plugin neu.

Wichtig: Du musst deinen Server nicht vollständig neu starten, um Konfigurationsänderungen zu übernehmen. Das Neuladen eines einzelnen Plugins reicht und ist viel schneller. Spieler merken davon nichts.

Standardkonfiguration wiederherstellen

Hast du versehentlich eine Konfigurationsdatei zerstört und willst zu den Standardeinstellungen zurück? Das geht einfach:

Gehe zu Bestanden > oxide > config.
Lösche die Konfigurationsdatei des Plugins (zum Beispiel GatherManager.json).
Gehe zum Tab Console und lade das Plugin mit oxide.reload PluginNaam neu.
Oxide erstellt automatisch eine neue Konfigurationsdatei mit den Standardeinstellungen.

Tipp: Erstelle immer ein Backup deiner Konfigurationsdatei, bevor du große Änderungen vornimmst. Du kannst die Datei kopieren oder den Inhalt in einer Textdatei auf deinem Computer speichern. So kannst du immer zu einer funktionierenden Version zurückkehren.

Beispiel: Gather Manager konfigurieren

Nehmen wir als Beispiel das beliebte Gather Manager Plugin, um die Gather Rates zu erhöhen. Öffne die Datei oxide/config/GatherManager.json und suche die Gather-Rate-Einstellungen:

{
  "Options": {
    "Use Permission": false
  },
  "Gather Rates": {
    "Wood": 1.0,
    "Stones": 1.0,
    "Metal Ore": 1.0,
    "Sulfur Ore": 1.0,
    "HQM Ore": 1.0
  }
}

Willst du, dass Spieler dreimal so viele Ressourcen sammeln? Ändere dann alle Werte auf 3.0:

{
  "Options": {
    "Use Permission": false
  },
  "Gather Rates": {
    "Wood": 3.0,
    "Stones": 3.0,
    "Metal Ore": 3.0,
    "Sulfur Ore": 3.0,
    "HQM Ore": 3.0
  }
}

Speichere die Datei und gib oxide.reload GatherManager in der Konsole ein. Die neuen Gather Rates sind sofort aktiv!

Plugins konfigurieren