ServerDescription.json erklären

In diesem Artikel erklären wir dir, wofür die ServerDescription.json bei einem Windrose Server verwendet wird und wie du die wichtigsten Einstellungen verwaltest.

Bei INSTANTROOT musst du viele Einstellungen nicht direkt in der Datei bearbeiten. Im INSTANTPANEL findest du im Reiter Startoptionen mehrere auswählbare Einstellungen. Diese Startoptionen sind einfacher zu verwalten und überschreiben die entsprechenden Werte aus der ServerDescription.json.

Was ist die ServerDescription.json?

Die ServerDescription.json ist eine Konfigurationsdatei deines Windrose Servers.

In dieser Datei speichert der Server wichtige Informationen und Einstellungen, zum Beispiel:

• Servername

• Serverbeschreibung

• Invite-Code

• Weltinformationen

• Spielparameter

• technische Serverwerte

Die Datei wird vom Windrose Dedicated Server verwendet, um den Server mit den passenden Einstellungen zu starten.

Wo finde ich die Datei?

Du findest die ServerDescription.json in den Serverdateien deines Windrose Servers.

Je nach Serverstruktur kann der genaue Pfad unterschiedlich sein. Öffne im INSTANTPANEL den Dateimanager oder verbinde dich per SFTP, um die Serverdateien zu prüfen.

Typische Bereiche sind:

• Server-Hauptverzeichnis

• Konfigurationsordner

• Savegame- oder Dedicated-Server-Ordner

Wenn du dir nicht sicher bist, suche im Dateimanager nach ServerDescription.json.

Startoptionen im INSTANTPANEL verwenden

Viele wichtige Einstellungen kannst du direkt im INSTANTPANEL ändern.

Gehe dazu so vor:

1. Öffne das INSTANTPANEL.

2. Wähle deinen Windrose Server aus.

3. Öffne den Reiter Startoptionen.

4. Passe die gewünschten Werte an.

5. Speichere die Änderungen.

6. Starte den Server neu.

Die Startoptionen sind der empfohlene Weg, um häufig genutzte Einstellungen zu ändern.

Warum Startoptionen besser sind

Die Startoptionen sind einfacher und sicherer als eine manuelle Bearbeitung der ServerDescription.json.

Vorteile:

• übersichtliche Eingabefelder

• weniger Risiko für Formatierungsfehler

• Einstellungen sind schneller auffindbar

• Änderungen können gezielt angepasst werden

• kein direktes Bearbeiten von JSON notwendig

• Werte bleiben besser nachvollziehbar

JSON-Dateien müssen eine genaue Struktur einhalten. Schon ein fehlendes Komma, eine falsche Klammer oder ein falsch gesetztes Anführungszeichen kann dazu führen, dass der Server nicht mehr korrekt startet.

Wichtig: Startoptionen überschreiben Dateiwerte

Wenn eine Einstellung im Reiter Startoptionen vorhanden ist, wird dieser Wert beim Start des Servers verwendet.

Das bedeutet:

Eine Einstellung aus den Startoptionen kann den entsprechenden Wert aus der ServerDescription.json überschreiben.

Beispiel:

Einstellung	Wert in ServerDescription.json	Wert in Startoptionen	Verwendeter Wert
Servername	Mein Windrose Server	INSTANTROOT Windrose	INSTANTROOT Windrose
Spielerlimit	8	12	12
Beschreibung	Private Welt	Community Server	Community Server

Wenn du also eine Einstellung direkt in der Datei änderst, diese Einstellung aber auch in den Startoptionen gesetzt ist, kann deine Änderung beim nächsten Start überschrieben werden.

Welche Einstellungen sollte ich in den Startoptionen ändern?

Nutze die Startoptionen für alle Werte, die dort angeboten werden.

Dazu können je nach Servertemplate zum Beispiel gehören:

• Servername

• Serverbeschreibung

• Invite-Code

• Spielerlimit

• Weltname

• Weltparameter

• Schwierigkeitsgrad

• Passwort oder Zugangsbeschränkung

• Ports

• sonstige Startparameter

Die genaue Auswahl kann je nach Windrose-Version und INSTANTPANEL-Template abweichen.

Wann sollte ich die ServerDescription.json direkt bearbeiten?

Bearbeite die Datei nur dann direkt, wenn eine gewünschte Einstellung nicht im Reiter Startoptionen verfügbar ist.

Eine direkte Bearbeitung kann sinnvoll sein bei:

• erweiterten Windrose-Einstellungen

• speziellen Weltparametern

• Einstellungen, die nicht im Panel angezeigt werden

• manueller Fehlerprüfung

• Anpassungen nach offizieller Anleitung

Wenn du unsicher bist, nutze zuerst die Startoptionen oder kontaktiere den Support.

Vor der Bearbeitung ein Backup erstellen

Bevor du die ServerDescription.json manuell bearbeitest, solltest du ein Backup erstellen.

So gehst du vor:

1. Stoppe den Windrose Server.

2. Öffne den Dateimanager im INSTANTPANEL.

3. Suche die Datei ServerDescription.json.

4. Lade die Datei herunter oder kopiere sie.

5. Bearbeite erst danach die Datei.

So kannst du die alte Version wiederherstellen, falls der Server nach einer Änderung nicht mehr startet.

Datei nur bei gestopptem Server bearbeiten

Bearbeite die ServerDescription.json nur, wenn der Server gestoppt ist.

Wenn du die Datei während des laufenden Betriebs änderst, kann es passieren, dass:

• Änderungen nicht übernommen werden

• der Server die Datei beim Beenden überschreibt

• Werte beschädigt werden

• der Server beim nächsten Start Fehler ausgibt

Empfohlene Reihenfolge:

1. Server stoppen.

2. Backup erstellen.

3. Datei bearbeiten oder Startoptionen ändern.

4. Änderungen speichern.

5. Server starten.

6. Logs prüfen.

JSON-Grundlagen

Die ServerDescription.json ist eine JSON-Datei.

JSON ist ein strukturiertes Dateiformat. Es besteht aus Namen und Werten.

Ein einfacher Wert sieht zum Beispiel so aus:

"ServerName": "Mein Windrose Server"

Ein Zahlenwert sieht zum Beispiel so aus:

"MaxPlayers": 10

Ein Wahr/Falsch-Wert sieht zum Beispiel so aus:

"IsPrivate": true

Wichtig bei JSON:

• Texte stehen in Anführungszeichen.

• Zahlen stehen ohne Anführungszeichen.

• Wahr/Falsch-Werte heißen true oder false.

• Einträge werden meistens mit Komma getrennt.

• Klammern müssen vollständig geschlossen sein.

Häufige JSON-Fehler

Wenn du die Datei manuell bearbeitest, vermeide diese Fehler:

Fehler	Beispiel
fehlendes Komma	Zwei Werte stehen direkt hintereinander
falsche Anführungszeichen	typografische Anführungszeichen statt normaler "
fehlende Klammer	Datei endet unvollständig
falscher Datentyp	Zahl als Text oder Text ohne Anführungszeichen
zusätzlicher Text	Kommentare oder Notizen in der JSON-Datei

JSON erlaubt normalerweise keine Kommentare. Schreibe deshalb keine eigenen Hinweise direkt in die Datei.

Servername ändern

Wenn der Servername in den Startoptionen verfügbar ist, ändere ihn dort.

Empfohlener Weg:

1. INSTANTPANEL öffnen.

2. Windrose Server auswählen.

3. Reiter Startoptionen öffnen.

4. Feld für Servername ändern.

5. Speichern.

6. Server neu starten.

Wenn kein Startoptionsfeld vorhanden ist, kann der Servername direkt in der ServerDescription.json angepasst werden.

Serverbeschreibung ändern

Die Serverbeschreibung wird genutzt, um deinen Server im Spiel besser zu erkennen oder kurz zu beschreiben.

Beispiele:

• Privater Server für Freunde

• Deutscher Community Server

• PvE Abenteuerwelt

Auch hier gilt: Wenn die Beschreibung in den Startoptionen vorhanden ist, ändere sie dort.

Invite-Code finden

Der Invite-Code wird verwendet, damit Spieler deinem Windrose Server beitreten können.

Je nach Einrichtung findest du den Invite-Code:

• im INSTANTPANEL

• in den Startoptionen

• in der ServerDescription.json

• in den Serverlogs nach dem Start

Wenn der Invite-Code in den Startoptionen verwaltet wird, solltest du ihn dort prüfen.

Invite-Code teilen

Teile den Invite-Code nur mit Spielern, die Zugriff auf deinen Server erhalten sollen.

Wenn der Code öffentlich geteilt wird, können möglicherweise unerwünschte Spieler versuchen, deinem Server beizutreten.

Spielerlimit ändern

Wenn dein Server ein Spielerlimit unterstützt, sollte dieses nach Möglichkeit über die Startoptionen geändert werden.

Ein zu hohes Spielerlimit kann zu Performance-Problemen führen.

Achte darauf, dass das Spielerlimit zur Serverleistung passt.

Welt-Einstellungen ändern

Windrose kann je nach Version und Servertemplate verschiedene Welt-Einstellungen verwenden.

Dazu können gehören:

• Weltname

• Spielmodus

• Schwierigkeit

• Seed oder Weltparameter

• PvE- oder PvP-Einstellungen

• Fortschritts- oder Weltoptionen

Nutze auch hier zuerst die Startoptionen, wenn die gewünschte Einstellung dort verfügbar ist.

Änderungen übernehmen

Nach Änderungen an Startoptionen oder der ServerDescription.json muss der Server neu gestartet werden.

Ein einfacher Speichervorgang reicht meistens nicht aus.

Empfohlene Reihenfolge:

1. Änderung speichern.

2. Server stoppen, falls er noch läuft.

3. Server starten.

4. Logs prüfen.

5. Verbindung testen.

Änderungen werden nicht übernommen

Wenn deine Änderungen nicht übernommen werden, prüfe zuerst:

• Hast du den Server neu gestartet?

• Hast du die richtige Datei bearbeitet?

• Gibt es dieselbe Einstellung in den Startoptionen?

• Wird der Wert beim Start durch eine Startoption überschrieben?

• Wurde die Datei während des laufenden Servers bearbeitet?

• Gibt es einen JSON-Fehler?

• Hat der Server die Datei beim Start neu erzeugt?

In vielen Fällen liegt es daran, dass der Wert in den Startoptionen gesetzt ist und deshalb die Datei überschrieben wird.

Server startet nach Änderung nicht

Wenn der Server nach einer Änderung nicht mehr startet, gehe so vor:

1. Öffne die Konsole und Logs im INSTANTPANEL.

2. Prüfe, ob ein Fehler zur ServerDescription.json angezeigt wird.

3. Mache die letzte Änderung rückgängig.

4. Stelle dein Backup wieder her.

5. Starte den Server erneut.

Typische Ursachen sind:

• ungültiges JSON

• falscher Wert

• fehlendes Komma

• fehlerhafte Klammer

• Startoption und Datei widersprechen sich

• nicht unterstützter Wert

Empfohlene Vorgehensweise

Für die meisten Kunden ist diese Reihenfolge am besten:

1. Startoptionen im INSTANTPANEL prüfen.

2. Gewünschte Einstellung dort ändern, wenn vorhanden.

3. Server neu starten.

4. Prüfen, ob die Änderung übernommen wurde.

5. Datei nur direkt bearbeiten, wenn es keine passende Startoption gibt.

6. Vor manuellen Änderungen immer ein Backup erstellen.