> For the complete documentation index, see [llms.txt](https://docs.instantroot.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.instantroot.de/gameserver/windrose/serverdescription.json-erklaren.md). # 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.