> 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/mit-dem-windrose-server-verbinden.md).

# Mit dem Windrose Server verbinden

In diesem Artikel erklären wir dir, wie du dich mit deinem Windrose Server verbindest und wo du den benötigten Invite-Code findest.

Windrose verwendet für Dedicated Server in der Regel keinen klassischen Serverbeitritt nur über IP-Adresse, sondern einen Invite-Code. Diesen Code gibst du im Spiel ein, um deinen Server zu finden und beizutreten.

### Voraussetzungen

Bevor du dich verbindest, benötigst du:

* einen gestarteten Windrose Server
* den Invite-Code deines Servers
* eine installierte Windrose-Spielversion
* die gleiche Spielversion wie auf dem Server
* eine stabile Internetverbindung

Der Server muss vollständig gestartet sein, bevor du dich verbinden kannst. Direkt nach einem Neustart kann es einen Moment dauern, bis der Server im Spiel erreichbar ist.

### Invite-Code im INSTANTPANEL finden

Der Invite-Code ist der wichtigste Zugang zu deinem Windrose Server.

1. Öffne das INSTANTPANEL.
2. Melde dich mit deiner E-Mail-Adresse und deinem Passwort an.
3. Wähle deinen Windrose Server aus.
4. Öffne die Dateiverwaltung oder Konfiguration.
5. Suche nach der Datei `ServerDescription.json`.
6. Öffne die Datei.
7. Suche nach dem Eintrag `InviteCode`.
8. Kopiere den dort angegebenen Code.
9. Schaue im Reiter Startoptionen ob dort bereits ein code hinterlegt ist oder hinterlege ihn dort.

Der Invite-Code ist der Code, den du im Spiel eingibst, um deinen Server zu finden.

Beispiel: `AB12CD34`

Achte beim Kopieren auf Groß- und Kleinschreibung. Der Code muss genau so eingegeben werden, wie er in der Datei steht.

### Mit dem Windrose Server verbinden

Nachdem du den Invite-Code kopiert hast, kannst du dich im Spiel verbinden.

1. Starte Windrose.
2. Öffne das Hauptmenü.
3. Wähle **Play**.
4. Klicke auf **Connect to Server**.
5. Gib den Invite-Code deines Servers ein.
6. Suche nach dem Server.
7. Wähle den gefundenen Server aus.
8. Verbinde dich mit dem Server.

Wenn der Server korrekt gestartet ist und der Invite-Code stimmt, sollte dein Server angezeigt werden.

### Invite-Code richtig verwenden

Der Invite-Code ist nicht dasselbe wie eine IP-Adresse.

Du gibst also normalerweise nicht die Server-IP ein, sondern den Invite-Code.

Richtig: `AB12CD34`

Falsch: `123.123.123.123:7777`

Der genaue Code ist abhängig von deinem Server und steht in der Serverkonfiguration.

### Server wird nicht gefunden

Wenn dein Server nicht gefunden wird, prüfe zuerst den Invite-Code.

Häufige Ursachen sind:

* Invite-Code wurde falsch kopiert
* Groß- und Kleinschreibung stimmt nicht
* Server ist noch nicht vollständig gestartet
* Server ist abgestürzt
* Serverversion passt nicht zur Spielversion
* der Server wurde nach einer Änderung nicht neu gestartet
* die Serverdateien wurden noch nicht vollständig erzeugt

Starte den Server im INSTANTPANEL neu und versuche es danach erneut.

### ServerDescription.json wurde noch nicht erstellt

Die Datei `ServerDescription.json` wird normalerweise nach dem ersten Start des Servers erzeugt.

Wenn du die Datei nicht findest:

1. Starte den Windrose Server einmal.
2. Warte, bis der Startvorgang abgeschlossen ist.
3. Stoppe den Server wieder.
4. Öffne die Dateiverwaltung erneut.
5. Suche erneut nach `ServerDescription.json`.

Die offiziellen Dedicated-Server-Hinweise beschreiben, dass die Standard-Konfigurationsdateien beim ersten Start automatisch erstellt werden. Dazu gehören `ServerDescription.json` für allgemeine Servereinstellungen und `WorldDescription.json` für weltspezifische Einstellungen. :contentReference\[oaicite:0]{index=0}

### Gleiche Spielversion verwenden

Client und Server müssen dieselbe oder eine kompatible Version verwenden.

Wenn dein Spiel aktueller ist als der Server oder der Server aktueller ist als dein Spiel, kann die Verbindung fehlschlagen.

Typische Anzeichen sind:

* Server wird nicht gefunden
* Verbindung bricht ab
* Fehlermeldung wegen unterschiedlicher Version
* Spieler können nach einem Update nicht mehr beitreten

Prüfe in diesem Fall:

* wurde dein Spiel aktualisiert?
* wurde der Server aktualisiert?
* läuft der Server nach dem Update vollständig?
* wurde der Server nach dem Update neu gestartet?

Windrose befindet sich in aktiver Entwicklung. Nach Updates können Verbindungsprobleme oder Versionsunterschiede auftreten. Halte Server und Spiel möglichst auf demselben Stand.

### Freunde einladen

Damit Freunde deinem Windrose Server beitreten können, gibst du ihnen den Invite-Code.

Deine Freunde gehen anschließend genauso vor:

1. Windrose starten.
2. **Play** öffnen.
3. **Connect to Server** auswählen.
4. Invite-Code eingeben.
5. Server suchen.
6. Server beitreten.

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

### Invite-Code öffentlich teilen

Veröffentliche den Invite-Code nicht unüberlegt.

Wer den Code kennt, kann versuchen, deinem Server beizutreten. Wenn dein Server nur für Freunde gedacht ist, teile den Code nur privat.

Sinnvolle Wege sind zum Beispiel:

* private Nachricht
* geschlossener Discord-Kanal
* Freundesgruppe
* internes Community-Forum

### Server nach Änderungen neu starten

Wenn du Einstellungen in `ServerDescription.json` oder anderen Konfigurationsdateien änderst, solltest du den Server danach neu starten.

Gehe dabei so vor:

1. Server stoppen.
2. Datei bearbeiten.
3. Änderungen speichern.
4. Server starten.
5. Verbindung erneut testen.

Ändere Konfigurationsdateien nach Möglichkeit nicht, während der Server läuft. Dadurch können Einstellungen überschrieben oder nicht korrekt übernommen werden.

### Verbindung per IP-Adresse

Windrose wird häufig über Invite-Code verbunden. Je nach Serverversion und Konfiguration kann es zusätzlich direkte Verbindungsmöglichkeiten geben.

Für die normale Nutzung im INSTANTPANEL ist der Invite-Code der wichtigste und einfachste Weg.

Wenn eine direkte Verbindung per IP und Port angeboten wird, findest du die benötigten Daten in der Serverübersicht oder Konfiguration. Verwende in diesem Fall genau die Adresse, die dir im Panel angezeigt wird.

### Häufige Probleme

#### Der Server wird nicht angezeigt

Prüfe:

* ist der Server im INSTANTPANEL gestartet?
* wurde der Invite-Code richtig eingegeben?
* stimmt Groß- und Kleinschreibung?
* nutzt du die aktuelle Spielversion?
* wurde der Server nach einem Update neu gestartet?
* ist die Datei `ServerDescription.json` vorhanden?
* wurde der Server nach Änderungen an der Konfiguration neu gestartet?

#### Invite-Code funktioniert nicht

Mögliche Ursachen:

* Code falsch kopiert
* Leerzeichen am Anfang oder Ende
* falscher Code aus alter Konfiguration
* `ServerDescription.json` wurde neu erzeugt
* Server wurde zurückgesetzt
* Server ist noch nicht vollständig gestartet

Kopiere den Code erneut direkt aus der Datei `ServerDescription.json`.

#### Verbindung bricht ab

Wenn die Verbindung abbricht, kann das verschiedene Ursachen haben.

Prüfe:

* Serverlogs im INSTANTPANEL
* Spielversion
* Serverstatus
* Internetverbindung
* ob andere Spieler ebenfalls betroffen sind
* ob der Server gerade neu startet
* ob kurz zuvor ein Update durchgeführt wurde

#### Freunde können nicht beitreten

Wenn du selbst verbinden kannst, Freunde aber nicht, prüfe:

* wurde der richtige Invite-Code weitergegeben?
* nutzen deine Freunde dieselbe Spielversion?
* wurde der Code vollständig kopiert?
* gibt es Leerzeichen beim Einfügen?
* ist der Server weiterhin online?
* wurde der Server nach einer Änderung neu gestartet?

#### Server lädt sehr lange

Beim ersten Beitritt oder nach einem Welt-Update kann das Laden länger dauern.

Das kann besonders passieren bei:

* neu erstellten Welten
* großen Spielständen
* Serverneustart direkt vor dem Beitritt
* Updates
* hoher Serverlast
* langsamer Verbindung

Warte einen Moment und versuche es erneut, wenn der Verbindungsversuch abbricht.

#### Version mismatch

Ein Version-Mismatch bedeutet, dass Spiel und Server nicht zusammenpassen.

Lösung:

1. Prüfe, ob dein Spiel aktuell ist.
2. Aktualisiere den Server im INSTANTPANEL.
3. Starte den Server neu.
4. Versuche die Verbindung erneut.

Wenn das Problem direkt nach einem Spielupdate auftritt, kann es sein, dass der Server ebenfalls aktualisiert werden muss.

#### Server startet, aber niemand kann verbinden

Prüfe in diesem Fall die Logs.

Achte besonders auf:

* Fehlermeldungen beim Start
* fehlende Konfigurationsdateien
* beschädigte JSON-Dateien
* falsche Werte in `ServerDescription.json`
* Probleme nach einem Update
* Abstürze direkt nach dem Start

Wenn du kurz vorher eine Datei geändert hast, mache die letzte Änderung rückgängig oder stelle ein Backup wieder her.
