Plugins konfigurieren

Die meisten Plugins funktionieren direkt nach der Installation mit Standardeinstellungen. Um das Maximum aus deinen Plugins herauszuholen, möchtest du sie aber nach deinen Wünschen konfigurieren. In diesem Artikel erklären wir, wie Konfigurationsdateien funktionieren und wie du sie über das HytaleNode-Panel anpasst.

Was sind Konfigurationsdateien?

Wenn ein Plugin zum ersten Mal geladen wird, erstellt es automatisch einen eigenen Ordner im plugins-Verzeichnis. In diesem Ordner liegen die Konfigurationsdateien des Plugins. Die Struktur sieht so aus:

plugins/
├── EssentialsX/
│   ├── config.yml
│   ├── messages.properties
│   └── ...
├── LuckPerms/
│   ├── config.yml
│   └── ...
├── EssentialsX.jar
├── LuckPerms.jar
└── ...

Die wichtigste Datei ist fast immer config.yml. Das ist eine Textdatei im YAML-Format, in der alle Einstellungen des Plugins stehen. Manche Plugins haben mehrere Konfigurationsdateien für verschiedene Bereiche.

Konfigurationsdateien über das Panel bearbeiten

Du kannst Konfigurationsdateien direkt im Dateimanager des HytaleNode-Panels bearbeiten. Das ist der einfachste Weg und du brauchst kein extra Programm.

Melde dich bei mijn.hytalenode.nl an und wähle deinen Server.
Gehe zum Dateien-Tab.
Öffne den plugins-Ordner.
Klicke auf den Ordner des Plugins, das du konfigurieren möchtest (zum Beispiel EssentialsX).
Klicke auf die Datei config.yml. Die Datei öffnet sich jetzt im integrierten Texteditor.
Passe die Einstellungen an, die du ändern möchtest.
Klicke oben rechts auf „Speichern“.
Starte deinen Server neu, damit die Änderungen geladen werden.

YAML-Syntax: die Grundlagen

YAML ist das Format, das praktisch alle Minecraft-Plugins für ihre Konfiguration verwenden. Es ist darauf ausgelegt, leicht lesbar zu sein, aber es gibt ein paar Regeln, die du beachten musst. Wenn du einen Syntaxfehler machst, lädt das Plugin nicht korrekt!

Die wichtigsten Regeln:

Verwende Leerzeichen, NIEMALS Tabs – Das ist der häufigste Fehler. YAML verwendet Leerzeichen (meist 2) für die Einrückung. Tabs sehen gleich aus, verursachen aber Fehler. Der Texteditor im Panel verwendet automatisch Leerzeichen, also wenn du dort bearbeitest, bist du auf der sicheren Seite.
Achte auf den Doppelpunkt – Jede Einstellung hat das Format schlüssel: wert. Nach dem Doppelpunkt muss immer ein Leerzeichen stehen.
Text mit Sonderzeichen – Wenn ein Wert Sonderzeichen enthält (wie & für Farbcodes), setze ihn in Anführungszeichen: prefix: "&6[Admin]"
Wahr/Unwahr – Verwende true oder false (ohne Anführungszeichen) für An/Aus-Einstellungen.
Listen – Elemente in einer Liste beginnen mit einem Bindestrich und einem Leerzeichen: - item

Beispiel für korrektes YAML:

# Das ist eine Kommentarzeile
server-name: "Mein Minecraft Server"
max-spieler: 20
pvp-aktiviert: true
willkommensnachricht: "&aWillkommen auf dem Server!"
blockierte-befehle:
  - /op
  - /deop
  - /stop

Beispiel für FEHLERHAFTES YAML:

# FEHLER: Tab statt Leerzeichen verwendet
server-name:	"Mein Server"

# FEHLER: kein Leerzeichen nach Doppelpunkt
max-spieler:20

# FEHLER: Sonderzeichen ohne Anführungszeichen
willkommensnachricht: &aWillkommen!

Änderungen anwenden

Nach dem Speichern einer Konfigurationsdatei musst du die Änderungen aktivieren. Es gibt zwei Möglichkeiten:

Server neu starten (empfohlen) – Das ist der sicherste Weg. Alle Plugins werden mit den neuen Einstellungen neu geladen. Tippe restart in der Console oder verwende den Neustart-Button.
/reload-Befehl (nicht immer zuverlässig) – Der Befehl /reload oder /reload confirm lädt alle Plugins neu, ohne den Server vollständig neu zu starten. Das ist schneller, kann aber bei manchen Plugins Probleme verursachen wie Speicherlecks oder unvollständige Neuladevorgänge. Verwende dies nur, wenn du schnell etwas testen möchtest.
Plugin-spezifischer Reload – Manche Plugins haben ihren eigenen Reload-Befehl, wie /essentials reload oder /lp reload. Das lädt nur dieses spezifische Plugin neu und ist sicherer als ein vollständiger /reload.

Tipp: Erstelle ein Backup deiner config.yml, bevor du große Änderungen vornimmst. Im Dateimanager kannst du die Datei herunterladen oder kopieren. So kannst du immer zu den vorherigen Einstellungen zurückkehren, wenn etwas nicht funktioniert.

Tipp: Viele Plugins haben ein Wiki oder eine Dokumentationsseite, auf der alle Konfigurationsoptionen erklärt werden. Suche auf der SpigotMC- oder GitHub-Seite des Plugins nach Links zur Dokumentation.

Plugins konfigurieren