# Wechsel von YAML (File) zu MySQL (DB)

GWorld v2 verfügt über intelligente Migrations-Systeme, die den Übergang von älteren Versionen oder den Wechsel zwischen Speichermedien (Dateien zu Datenbank) so einfach wie möglich gestalten.

*Du suchst nach Informationen zur Migration von der v1 zur v2? Dann folge bitte diesem Link: [Migration von v1-legacy zu v2](https://books.gilljan.de/books/gworld-dokumentation-de/page/migration-von-v1-legacy-zu-v2 "Migration von v1-legacy zu v2")*

---

## Wechsel von YAML zu MySQL

Möchtest du deine Welten-Daten nicht mehr lokal in einer Datei, sondern zentral in einer MySQL-Datenbank speichern, bietet GWorld v2 einen automatischen Transfer-Dienst.

### Schritte zur Umstellung

1. Stoppe deinen Server.
2. Öffne die `config.yml` und setze den `Storage.Type` auf `MYSQL`.
    
    
    - <p class="callout info">Sollte `Storage.Type` fehlen, update bitte deine config.yml. Siehe: [Standard Konfigurationsdateien](https://books.gilljan.de/books/gworld-dokumentation-de/page/standard-konfigurationsdateien "Standard Konfigurationsdateien")</p>
3. Trage deine Datenbank-Zugangsdaten im Abschnitt `MySQL` ein.
4. Starte den Server neu.

### Was passiert beim Start?

- **Daten-Transfer:** GWorld stellt fest, dass MySQL aktiviert ist, aber noch eine lokale `worlds.yml` mit Daten existiert.
- **Import:** Das Plugin liest alle Welten aus der Datei und schreibt sie in die entsprechenden MySQL-Tabellen.
- **Abschluss:** Um einen doppelten Import zu verhindern, wird die lokale Datei nach erfolgreichem Abschluss in `worlds.yml.imported` umbenannt.
- **Sicherheit:** Sofern eine Welt in der Datenbank bereits existiert, wird diese zur Sicherheit der Integrität nicht migiriert.

---

### Sicherheitsmaßnahmen &amp; Voraussetzungen

Um eine reibungslose Migration zu gewährleisten, beachte bitte folgende Punkte:

#### Voraussetzungen

- **Datenbank-Verfügbarkeit:** Wenn MySQL konfiguriert ist, bricht das Plugin den Startvorgang ab, falls keine Verbindung hergestellt werden kann, um Datenverlust zu vermeiden.

#### Checkliste

- [ ] Stelle sicher, dass der Datenbank-Nutzer Berechtigungen zum Erstellen von Tabellen (`CREATE`), Einfügen (`INSERT`) und Ändern (`UPDATE`) von Daten hat.
- [ ] Erstelle vor dem Wechsel ein manuelles Backup deines gesamten Plugin-Ordners.
- [ ] Prüfe nach dem Wechsel mit dem Befehl `/gworlds`, ob alle Welten korrekt gelistet werden.

---

*Diese Dokumentation bezieht sich auf GWorld Version 2.0.1.*