# Setup-Anleitung für shapez: Archipelago

## Schnelle Links

- Info-Seite zum Spiel
    * [English](/games/shapez/info/en)
    * [Deutsch](/games/shapez/info/de)
- [Spieler-Optionen-Seite](/games/shapez/player-options)

## Benötigte Software

- Eine installierbare und aktuelle PC-Version von shapez ([Steam](https://store.steampowered.com/app/1318690/shapez/)).
- Die shapezipelago Mod von der [mod.io-Seite](https://mod.io/g/shapez/m/shapezipelago).

## Optionale Software

- Archipelago von der [Archipelago-Release-Seite](https://github.com/ArchipelagoMW/Archipelago/releases)
    * (Für den Text-Client)
    * (Alternativ kannst du auch die eingebaute Konsole nutzen, indem du das Spiel mit dem `-dev`-Parameter 
      startest und jede Nachricht als `AP.sendAPMessage("<Nachricht>"")` schreibst)
- Universal Tracker (schau im Kanal von UT auf dem Discord-Server nach der aktuellen Anleitung und für weitere 
  Informationen)

## Installation

Da das Spiel einen eingebauten Mod-Loader hat, musst du nur die "shapezipelago@X.X.X.js"-Datei in den dafür vorgesehenen
Ordner kopieren. Wenn du nicht weißt, wo dieser ist, dann öffne das Spiel, drücke auf "MODS" und schließlich auf
"MODORDNER ÖFFNEN".

Du solltest (egal ob vor oder nach der Installation) die Einstellungen des Spiels öffnen und `HINWEISE & TUTORIALS` im 
Reiter `BENUTZEROBERFLÄCHE` ausschalten, da sie sonst den Upgrade-Shop verstecken wird, bis du ein paar Level 
abgeschlossen hast.

## Erstellen deiner YAML-Datei

### Was ist eine YAML-Datei und wofür brauche ich die?

Deine persönliche YAML-Datei beinhaltet eine Reihe von Optionen, die der Zufallsgenerator zum Erstellen von deinem 
Spiel benötigt. Jeder Spieler einer Multiworld stellt seine eigene YAML-Datei zur Verfügung. Dadurch kann jeder Spieler 
sein Spiel nach seinem eigenen Geschmack gestalten, während andere Spieler unabhängig davon ihre eigenen Optionen 
wählen können!

### Wo bekomme ich so eine YAML-Datei her?

Du kannst auf der [shapez-Spieler-Optionen-Seite](/games/shapez/player-options) eine YAML-Datei generieren oder ein 
Template herunterladen.

## Einer MultiWorld beitreten

1. Öffne das Spiel.
2. Gib im Hauptmenü den Slot-Namen, die Adresse, den Port und das Passwort (optional) in die dafür vorgesehene Box ein.
3. Drücke auf "Connect".
   - Erneutes Drücken trennt die Verbindung zum Server.
   - Ob du verbunden bist, steht direkt daneben.
4. Starte ein neues Spiel.

Nachdem der Speicherstand erstellt wurde und du zum Hauptmenü zurückkehrst, wird das erneute Öffnen des Speicherstandes 
erneut verbinden.

### Der Port/Die Adresse der MultiWorld hat sich geändert, wie trete ich mit meinem existierenden Speicherstand bei? 

Wiederhole die Schritte 1-3 und öffne den existierenden Speicherstand. Dies wird außerdem die gespeicherten Login-Daten 
überschreiben, sodass du dies nur einmal machen musst. 