> 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/lokale-welt-auf-den-server-laden.md).

# Lokale Welt auf den Server laden

In diesem Artikel erklären wir dir, wie du eine lokal gespeicherte Windrose-Welt auf deinen Gameserver hochlädst.

Das ist hilfreich, wenn du bereits lokal oder mit Freunden auf deinem eigenen PC gespielt hast und diese Welt anschließend dauerhaft auf deinem INSTANTROOT Gameserver weiterverwenden möchtest.

### Voraussetzungen

Bevor du beginnst, benötigst du:

* Zugriff auf deinen lokalen PC, auf dem die Welt gespeichert ist
* Zugriff auf deinen Windrose Server im INSTANTPANEL
* SFTP- oder Dateimanager-Zugriff auf deinen Server
* eine Sicherung deiner lokalen Welt
* einen gestoppten Windrose Server

**Wichtig:** Stoppe den Server immer, bevor du Savegames hochlädst, ersetzt oder bearbeitest. Wenn der Server währenddessen läuft, können Dateien beschädigt oder beim nächsten Start überschrieben werden.

### Lokale Windrose-Welt finden

Windrose speichert lokale Spielstände unter Windows im AppData-Verzeichnis.

Der typische Pfad lautet:

`C:\Users\DEIN_WINDOWS_NAME\AppData\Local\R5\Saved\SaveProfiles\`

Du kannst den Ordner schneller öffnen:

1. Drücke `Windows-Taste + R`.
2. Gib `%LOCALAPPDATA%\R5\Saved\SaveProfiles` ein.
3. Drücke Enter.

In diesem Ordner findest du einen oder mehrere Profilordner. Bei Steam ist der Ordner häufig nach deiner Steam-ID benannt.

Der Speicherpfad sieht ungefähr so aus:

`C:\Users\DEIN_WINDOWS_NAME\AppData\Local\R5\Saved\SaveProfiles\DEINE_STEAM_ID\RocksDB\SPIELVERSION\Worlds\WELT_ID`

### Richtige Welt erkennen

Im Ordner `Worlds` können mehrere Weltordner liegen.

Jede Welt hat eine eigene ID. Diese ID sieht meistens nicht wie ein normaler Weltname aus, sondern eher wie eine technische Zeichenfolge.

Beispiel:

`7f3a9c1b4d2e4567`

Öffne die Weltordner und prüfe, ob dort Dateien und Unterordner der Windrose-Welt vorhanden sind.

Falls du mehrere Welten hast, kannst du die richtige Welt oft über Änderungsdatum und Uhrzeit erkennen.

Achte auf:

* zuletzt geändertes Datum
* Größe des Weltordners
* Zeitpunkt, wann du zuletzt gespielt hast
* vorhandene Dateien wie `WorldDescription.json`, falls vorhanden

**Wichtig:** Benenne den Weltordner nicht um. Windrose verwendet die Welt-ID intern. Wenn du den Ordner umbenennst, kann der Server die Welt möglicherweise nicht korrekt laden.

### Lokale Welt sichern

Erstelle vor dem Upload eine Kopie deiner Welt.

So gehst du vor:

1. Öffne den lokalen Weltordner.
2. Kopiere den gesamten Ordner der Welt.
3. Füge ihn an einem sicheren Ort ein, zum Beispiel auf dem Desktop.
4. Benenne nur die Sicherung eindeutig, zum Beispiel `Windrose-Welt-Backup`.

Ändere dabei nicht den Namen des originalen Weltordners, den du später hochladen möchtest.

### Server stoppen

Bevor du Dateien auf dem Server ersetzt, stoppe deinen Windrose Server.

1. Öffne das INSTANTPANEL.
2. Wähle deinen Windrose Server aus.
3. Klicke auf **Stoppen**.
4. Warte, bis der Server vollständig offline ist.

Lade die Welt erst hoch, wenn der Server wirklich gestoppt ist.

### Server-Saveordner öffnen

Öffne nun den Dateimanager oder verbinde dich per SFTP mit deinem Server.

Der typische Savegame-Pfad auf einem Windrose Dedicated Server lautet:

`R5/Saved/SaveProfiles/Default/RocksDB/`

Je nach Spielversion kann der Pfad auch so aussehen:

`R5/Saved/SaveProfiles/Default/RocksDB_v2_Backups/`

Darunter folgt normalerweise ein Ordner mit der Spielversion und anschließend der Ordner `Worlds`.

Beispiel:

`R5/Saved/SaveProfiles/Default/RocksDB/0.10.0.5.120/Worlds/`

oder:

`R5/Saved/SaveProfiles/Default/RocksDB_v2_Backups/0.10.0.5.120/Worlds/`

**Hinweis:** Die genaue Spielversion kann sich durch Updates ändern. Verwende auf dem Server den Ordner, der zu deiner aktuell installierten Windrose-Version gehört.

### Lokale Welt hochladen

Lade jetzt den kompletten lokalen Weltordner in den `Worlds`-Ordner deines Servers hoch.

Beispiel:

Lokaler Weltordner:

`7f3a9c1b4d2e4567`

Ziel auf dem Server:

`R5/Saved/SaveProfiles/Default/RocksDB/0.10.0.5.120/Worlds/7f3a9c1b4d2e4567`

Achte darauf, dass du den ganzen Ordner hochlädst und nicht nur einzelne Dateien.

Der Weltordner muss am Ende direkt im `Worlds`-Verzeichnis liegen.

Richtig:

`Worlds/7f3a9c1b4d2e4567/`

Falsch:

`Worlds/MeineWelt/7f3a9c1b4d2e4567/`

Falsch:

`Worlds/7f3a9c1b4d2e4567/7f3a9c1b4d2e4567/`

### Aktive Welt in ServerDescription.json setzen

Damit der Server deine hochgeladene Welt lädt, muss die Welt-ID in der `ServerDescription.json` eingetragen werden.

Die Datei liegt normalerweise im Windrose-Serververzeichnis unter:

`R5/ServerDescription.json`

Öffne die Datei mit dem Dateimanager oder per SFTP.

Suche nach dem Eintrag:

`WorldIslandId`

Trage dort die ID deines hochgeladenen Weltordners ein.

Beispiel:

`WorldIslandId: 7f3a9c1b4d2e4567`

Die Welt-ID muss exakt dem Ordnernamen deiner hochgeladenen Welt entsprechen.

**Wichtig:** Verwende keine andere Schreibweise und füge keine zusätzlichen Leerzeichen, Sonderzeichen oder neuen Namen hinzu. Die ID muss genau stimmen.

### Server starten

Nachdem du die Welt hochgeladen und die `WorldIslandId` gesetzt hast, kannst du den Server starten.

1. Öffne das INSTANTPANEL.
2. Starte deinen Windrose Server.
3. Beobachte die Konsole.
4. Warte, bis der Server vollständig gestartet ist.
5. Verbinde dich anschließend über den Invite-Code oder die Serververbindung.

Beim ersten Start nach dem Upload kann der Server etwas länger benötigen.

### Prüfen, ob die Welt geladen wurde

Nach dem Start solltest du prüfen, ob die richtige Welt geladen wurde.

Achte auf:

* bekannten Spawnpunkt
* bekannte Gebäude
* bekannte Schiffe
* bekannte Lager
* bekannten Fortschritt
* vorhandene Spieler- oder Weltstände

Wenn eine neue leere Welt geladen wurde, wurde wahrscheinlich die falsche Welt-ID gesetzt oder der Weltordner liegt im falschen Verzeichnis.

### Häufige Fehler

#### Server lädt eine neue Welt

Wenn der Server eine neue Welt erstellt, findet er deine hochgeladene Welt nicht oder sie wurde nicht als aktive Welt gesetzt.

Prüfe:

* liegt der Weltordner im richtigen `Worlds`-Verzeichnis?
* stimmt die `WorldIslandId` mit dem Weltordnernamen überein?
* wurde der Weltordner versehentlich umbenannt?
* liegt die Welt in einem zusätzlichen Unterordner?
* wurde der Server vor dem Upload gestoppt?
* wurde die richtige Spielversion verwendet?

#### Weltordner wurde doppelt verschachtelt

Ein häufiger Fehler ist ein falsch gepackter oder falsch hochgeladener Ordner.

Falsch:

`Worlds/WindroseBackup/7f3a9c1b4d2e4567/`

Richtig:

`Worlds/7f3a9c1b4d2e4567/`

Der Server erwartet die Welt direkt im `Worlds`-Ordner.

#### Server startet nicht nach dem Upload

Wenn der Server nach dem Upload nicht startet, prüfe die Konsole und Logs.

Mögliche Ursachen:

* unvollständiger Upload
* beschädigte Weltdateien
* falscher Speicherpfad
* falsche Spielversion
* fehlerhafte `ServerDescription.json`
* Weltordner wurde umbenannt
* Dateien wurden während laufendem Server ersetzt

Stelle in diesem Fall zuerst das vorherige Backup wieder her.

#### Welt wird geladen, aber Fortschritt fehlt

Wenn die Welt geladen wird, aber Fortschritt fehlt, wurde möglicherweise nicht der richtige Save hochgeladen.

Prüfe lokal:

* hast du den richtigen Profilordner verwendet?
* hast du die richtige Steam-ID geöffnet?
* hast du den zuletzt geänderten Weltordner gewählt?
* gibt es mehrere `RocksDB`- oder Backup-Ordner?
* wurde eventuell ein älterer Spielstand hochgeladen?

#### Upload bricht ab

Bei großen Welten kann der Upload länger dauern.

Nutze bei größeren Savegames am besten SFTP statt nur den Web-Dateimanager.

Prüfe außerdem:

* stabile Internetverbindung
* genug Speicherplatz auf dem Server
* vollständiger Upload aller Dateien
* keine laufende Serverinstanz während des Uploads

### Wichtige Hinweise zu Windrose-Versionen

Windrose befindet sich in aktiver Entwicklung. Speicherpfade und Save-Strukturen können sich durch Updates ändern.

Deshalb solltest du vor einem Welttransfer immer prüfen:

* lokale Spielversion
* Serverversion
* Ordnerstruktur auf dem Server
* vorhandene `RocksDB`- oder `RocksDB_v2_Backups`-Ordner
* aktuelle Serverlogs nach dem Start

Client und Server sollten möglichst auf derselben Version laufen.

### Backup vor Änderungen erstellen

Erstelle immer ein Backup, bevor du eine Welt ersetzt.

Sichere mindestens:

* den vorhandenen Server-Weltordner
* die `ServerDescription.json`
* die hochzuladende lokale Welt
* falls vorhanden, relevante Backup-Ordner

So kannst du den alten Zustand wiederherstellen, falls der Upload nicht funktioniert.
