# CMS21_Multiplayer – Einrichten

Diese Anleitung ist für Mitspieler gedacht. Sie beschreibt Windows; für Linux steht der
Unterschied ganz unten.

Du brauchst dafür etwa zehn Minuten und ein **Spieler-Token**, das du von Morpheus bekommst.
Das Token ist dein Schlüssel – gib es nicht weiter.

---

## Der schnelle Weg: dein fertiges Paket (Windows)

Auf [cms21.morpheushub.ch/mod/](https://cms21.morpheushub.ch/mod/) dein Token eintragen,
Spielstand-Platz wählen, **Paket herunterladen**. Du bekommst ein ZIP (rund 18 MB), in dem alles
schon drin ist: MelonLoader 0.5.7, der Mod und deine Konfiguration mit eingetragenem Token.

1. **Spielstand sichern** (siehe unten, dauert eine Minute).
2. **Spielordner öffnen:** in Steam Rechtsklick auf das Spiel → *Verwalten* →
   *Lokale Dateien durchsuchen*.
3. **Den Inhalt des ZIP dort hineinentpacken.** Danach liegt neben
   `Car Mechanic Simulator 2021.exe` eine `version.dll` und ein Ordner `Mods`.
4. Weiter bei **Schritt 4: Ausprobieren**.

Kein Skript, keine Konsole, nichts abzutippen. Der Grund: Windows PowerShell lädt auf den
meisten Rechnern gar keine `.ps1` (*ExecutionPolicy*), und das war beim ersten echten Versuch
am 2026-09-20 genau die Hürde, an der es scheiterte.

**Hast du schon MelonLoader** in einer anderen Version im Spielordner, frag vorher bei Morpheus
nach – CMS21 startet nur mit 0.5.7. **Fragt Windows beim Entpacken**, ob Dateien ersetzt werden
sollen: bei den MelonLoader-Dateien ja; hast du aber schon eine eigene
`UserData/CMS21_Multiplayer.cfg`, wäre dein bisheriges Token weg.

## Der schnelle Weg unter Linux: das Einrichtungsskript

Unter Linux macht es weiterhin ein Skript – dort muss zusätzlich die Steam-Startoption gesetzt
werden, und das kann ein ZIP nicht:

```
curl -O https://cms21.morpheushub.ch/mod/installieren.sh
bash installieren.sh
```

Das Skript löscht nichts, sichert vorher deine Spielstände und fragt nach, bevor es etwas
überschreibt.

---

## Vorher: Spielstand sichern

Der Mod verändert deinen Spielstand (er legt Teile hinein und nimmt sie heraus). Mach vorher
eine Kopie, dann kannst du jederzeit zurück:

Drücke **Windows-Taste + R**, füge das ein und drücke Enter:

```
%USERPROFILE%\AppData\LocalLow\Red Dot Games\Car Mechanic Simulator 2021
```

Kopiere den Ordner **Save** an einen sicheren Ort, zum Beispiel auf den Desktop.

---

## 1. MelonLoader 0.5.7 installieren

**Wichtig: genau diese Version.** Neuere laufen mit CMS21 nicht – 0.7.3 startet das Spiel
gar nicht erst, es bleibt schwarz.

1. Lade `MelonLoader.x64.zip` der Version **0.5.7** herunter:
   https://github.com/LavaGang/MelonLoader/releases/tag/v0.5.7
2. Finde deinen Spielordner: In Steam mit der rechten Maustaste auf
   **Car Mechanic Simulator 2021** → **Verwalten** → **Lokale Dateien durchsuchen**.
3. Entpacke den Inhalt des Zip direkt in diesen Ordner. Danach liegen dort unter anderem
   `version.dll`, ein Ordner `MelonLoader` und `Car Mechanic Simulator 2021.exe` nebeneinander.
4. Starte das Spiel einmal ganz normal. Beim ersten Start dauert es ein paar Minuten länger –
   MelonLoader bereitet im Hintergrund etwas vor. Ein schwarzes Konsolenfenster gehört dazu.
5. Beende das Spiel wieder.

Im Spielordner gibt es jetzt die Ordner `Mods` und `UserData`.

---

## 2. Den Mod einsetzen

1. Kopiere die Datei **`CMS21_Multiplayer.dll`** (bekommst du von Morpheus) in den Ordner
   **`Mods`** im Spielordner.
2. Starte das Spiel und lade deinen Spielstand.
3. Drücke **F5**. Es öffnet sich ein Fenster. Steht dort *„Kein Token für Profil 0"*, ist alles
   richtig – das Token kommt im nächsten Schritt.
   Die Fenster: **F5** Shop, **F6** Tausch (Geben, Post, Geld), **F7** Werkstatt (Einkaufshilfe),
   **F8** Aufträge und Rennen, **F9** Einstellungen.
4. Beende das Spiel.

---

## 3. Token eintragen

Im Ordner **`UserData`** liegt jetzt die Datei `CMS21_Multiplayer.cfg`. Öffne sie mit dem
Editor (Rechtsklick → *Öffnen mit* → *Editor*).

Trage dein Token ein. Die Zahl hinter `profil` ist der **Spielstand-Platz**, den du benutzt –
der oberste Spielstand im Menü ist `profil0`, der zweite `profil1` und so weiter:

```
server=https://cms21.morpheushub.ch
profil0=DEIN-TOKEN-HIER
```

Speichern, Datei schliessen, Spiel starten.

> Jeder Spielstand braucht ein eigenes Token. Wenn du mit zwei Spielständen tauschen willst,
> frag nach einem zweiten.

---

## 4. Ausprobieren

1. Spiel starten, Spielstand laden, **in die Werkstatt gehen** (im Hauptmenü geht nichts).
2. **F5** drücken – der **Shop** öffnet sich. Oben steht jetzt dein Spielername statt „nicht verbunden".
3. **F6** drücken: Im Reiter **Geben** siehst du dein Inventar mit Bildern. Oben wählst du aus, wer
   etwas bekommen soll – oder stellst es in den **Shop** für alle.

Fertig. Was du bekommst, landet automatisch in deinem Spiel – meist innerhalb einer halben
Minute, nachdem du es angenommen hast.

---

## Updates

Gibt es eine neue Version, steht oben rechts im Fenster ein gelber Knopf **„Update v…“**. Ein Klick
lädt sie herunter; eingesetzt wird sie beim **nächsten Spielstart**. Der Mod installiert nur
Dateien, die Morpheus unterschrieben hat – passt die Unterschrift nicht, lehnt er ab.

Dafür braucht es einmalig die Datei **`Plugins\CMS21_Updater.dll`** im Spielordner. Im Paket ist
sie schon drin. Wer den Mod von Hand eingerichtet hat, lädt sie von
[cms21.morpheushub.ch/mod/CMS21_Updater.dll](https://cms21.morpheushub.ch/mod/CMS21_Updater.dll)
und legt sie in den Ordner `Plugins` (neben `Mods`).

> Schlägt ein Virenscanner an: Den Spielordner als Ausnahme eintragen. Bei einem Mitspieler hat
> der Scanner den ganzen `Mods`-Ordner geleert – im MelonLoader-Protokoll stand dann
> `0 Mods loaded`.

---

## Die Fenster

| Taste | Fenster | Bedeutung |
|---|---|---|
| **F5** | **Shop** | Was alle anbieten, mit Preis – hier kaufst du. Oben suchen und nach Kategorie filtern (Motor, Aufhängung, Bremsen, Abgas, Getriebe, Karosserie, Räder, Gruppen, Autos, Sonstiges) |
| **F6** | **Tausch** | Reiter **Geben** (dein Inventar: Teile, Motoren, Autos, Geld), **Post** (was dir jemand persönlich anbietet), **Unterwegs** (was du weggegeben hast), **Geld** (Geld senden und eigene Konten) |
| **F7** | **Werkstatt** | Einkaufshilfe und Motorbau |
| **F8** | **Aufträge** | Reparaturaufträge und Rennen |
| **F9** | **Einstellungen** | Stand des Mods, dazu die **Marge** für deine Angebote |

Die Knöpfe sind eingefärbt: **grün** heisst ja, **rot** heisst nein.

### Etwas in den Shop stellen

Im Reiter **Geben** stellst du oben den Empfänger auf **„In den Shop (alle)"** – dann sehen es
alle Mitspieler. Willst du es nur einer bestimmten Person geben, wählst du stattdessen ihren Namen.

Darunter legst du den **Preis** fest, in Schritten von 1 bis 10 000 CR. Bleibt er auf
*geschenkt*, verlangst du nichts dafür. Schneller geht es mit dem gelben Knopf **„… als Preis"**:
Das ist der Verkaufswert des Spiels plus deine **Marge**. Die Marge stellst du in **F9** für alle
Angebote ein (+0/+10/+20/+25 %) und kannst sie daneben je Angebot ändern.

> **Was du einstellst, ist sofort aus deinem Inventar weg** – mit Absicht, damit du es nicht
> versehentlich noch verbaust. Du bekommst es jederzeit zurück: im Reiter **Shop** steht bei
> deinen eigenen Angeboten „Zurückholen".

In der **Werkstatt (F7)** steht bei einem Teil grün **„Shop 2x ab 150 CR"**, wenn es ein Mitspieler
gerade anbietet – dann lohnt ein Blick in den Shop, bevor du beim Spiel kaufst.

Steht bei einem Auto ein roter Knopf **„GEHT NICHT"**, kann dein Spiel dieses Auto nicht laden –
weil dir das passende DLC fehlt oder das Auto für deine Stufe noch nicht freigeschaltet ist.
Nimm es dann **nicht** an, sondern gib es mit **„Weg"** zurück. Der Mod lässt dich in diesem Fall
gar nicht erst annehmen, damit dein Spielstand heil bleibt.

---

## Konten (F6 → Geld)

Im Reiter **Geld** kannst du eigene **Konten** anlegen, zum Beispiel „Motor-Projekt" oder „Rücklage".
Das Geld darauf liegt **auf dem Server**: Was du einzahlst, ist vom Spielkonto weg und lässt sich im
Spiel nicht aus Versehen ausgeben.

- **Anlegen:** unten einen Namen tippen, „Konto anlegen".
- **Einzahlen / Abheben:** Konto anklicken, Betrag mit den Knöpfen einstellen (oder „= Spielkonto" /
  „= Kontostand"), dann „Einzahlen" bzw. „Abheben". Abgehobenes Geld ist nach wenigen Sekunden auf dem
  Spielkonto.
- **Überweisen:** „An: …" auf den Mitspieler stellen, „Überweisen" und bestätigen. Das Geld liegt dann
  in seiner **Post**. Lehnt er ab oder nimmt er es nicht innert 7 Tagen an, kommt es **aufs Konto zurück**.
- **Sparziel:** mit „Ziel" einen Betrag einstellen und setzen – ein grüner Balken zeigt, wie weit du bist.
- **Zinsen:** Auf dem Konto wächst das Geld jeden Tag ein wenig (im Moment 0.5 % pro Tag).
- **Buchungen:** rechts unten stehen die letzten Ein- und Auszahlungen, Überweisungen und Zinsen.
- Die Konten gehören zu deinem **Spielstand** – ein anderes Profil hat eigene Konten.
- Löschen geht nur, wenn ein Konto leer ist.

## Reparaturaufträge (F8)

Du kannst ein **eigenes Auto** von einem Mitspieler reparieren lassen – oder selbst Autos anderer reparieren
und dafür Lohn bekommen. Alles im Fenster **F8**.

| Reiter | Bedeutung |
|---|---|
| **Brett** | Aufträge der anderen, die **du** machen kannst (Stufe und DLC passen). Was nicht geht, ist ausgeblendet – ein Knopf zeigt es trotzdem. |
| **Erteilen** | Auto wählen, Aufgaben anklicken (Motor, Bremsen, Fahrwerk …), Lohn einstellen. Dabei steht, welche Mitspieler das Auto überhaupt laden können. |
| **Meine** | Deine erteilten Aufträge. Zurückziehen, solange niemand angenommen hat. |
| **In Arbeit** | Der Auftrag, an dem du arbeitest, und wo das Auto gerade steht. |

So läuft ein Auftrag:

1. **Erteilen:** Auto und Lohn gehen zum Server. Das Auto ist so lange aus deinem Parkhaus weg.
2. **Annehmen:** Der Mitspieler bekommt das Auto in sein Parkhaus. Es gehört weiter dir – der Mod lässt ihn es
   nicht weitergeben.
3. **Fertig melden:** Das Auto kommt zu dir zurück.
4. **Abnehmen oder reklamieren:** Schau dir das Auto im Spiel selbst an. Bist du zufrieden, bekommt er den Lohn.
   Wenn nicht, klickst du an, was nicht erledigt ist, und das Auto geht zurück zu ihm.

Jeder hat höchstens **einen** erteilten und **einen** angenommenen Auftrag gleichzeitig. Gibt der Reparierer
auf, bekommst du Auto und Lohn zurück.

**Meldungen** (Teil erhalten, Auto zurück, Lohn …) erscheinen als Band oben am Bildschirm.

---

## Bestenliste (Rennstrecke)

Fährst du auf der **Rennstrecke** des Spiels eine vollständige Runde (alle Kontrollpunkte), meldet der Mod deine
Zeit von selbst – oben erscheint „Runde … – neue Bestzeit, Platz 1“. Die Liste aller Spieler steht auf
[cms21.morpheushub.ch](https://cms21.morpheushub.ch) unter **Bestenliste**, je Spieler und Auto die beste Runde.
Die Teststrecke zählt nicht, sie hat keinen Rundentimer.

**Gegen einen Geist fahren:** Im Fenster **F8**, Reiter **Rennen**, steht dieselbe Liste. Bei jeder Bestzeit mit
dem Vermerk „Als Geist“ kannst du sie als Gegner wählen – auch deine eigene. Fährst du dann auf die Rennstrecke,
steht das Auto des anderen, so wie er es gebaut hat, an der Startlinie und fährt mit deiner Runde los. Man kann
durch ihn hindurchfahren. Nach der Runde steht oben, wie viele Sekunden du vor oder hinter ihm warst.

**Rennen über 1, 3 oder 5 Runden:** Das Spiel zählt Runden endlos. Der Mod macht daraus ein Rennen: Es beginnt
mit dem Start an der Ampel und endet nach der Zahl Runden, die du in **F8 → Rennen** wählst. Danach steht oben
„Rennen beendet“ mit der Gesamtzeit, und das Rennen kommt in eine eigene Bestenliste – samt Geist, der das ganze
Rennen fährt. Für ein neues Rennen startest du im Spiel neu.

---

## Wenn etwas nicht klappt

| Problem | Ursache und Lösung |
|---|---|
| F5 macht nichts | Bist du in der Werkstatt? Im Hauptmenü ist das Fenster wirkungslos. |
| „nicht verbunden" oben | Token fehlt oder steht beim falschen `profil`. Zahl prüfen: oberster Spielstand = `profil0`. |
| „Kein Token für Profil 2" | Du spielst einen anderen Spielstand als eingetragen. Trage `profil2=…` nach. |
| Spiel startet schwarz | Falsche MelonLoader-Version. Es muss **0.5.7** sein. |
| Gar keine Wirkung | Liegt die `.dll` wirklich im Ordner `Mods`? Öffne `MelonLoader\Logs`, dort steht der letzte Start. Steht dort `0 Mods loaded`, fehlt sie – oft hat der Virenscanner sie entfernt. |

Wenn du nicht weiterkommst, schick Morpheus die neueste Datei aus `MelonLoader\Logs` – dort
steht, was schiefging.

---

## Mod wieder entfernen

- **Nur den Tausch abschalten:** `Mods\CMS21_Multiplayer.dll` löschen.
- **Alles rückgängig:** Zusätzlich `version.dll`, die Ordner `MelonLoader`, `Mods`, `UserData`
  und `Plugins` aus dem Spielordner löschen. Danach ist es wieder ein normales CMS21.

Dein Spielstand bleibt in beiden Fällen, wie er ist – getauschte Teile und Autos gehören dann
einfach dir. Über Steam kannst du mit *Verwalten → Eigenschaften → Installierte Dateien →
Dateien überprüfen* alles Ursprüngliche wiederherstellen.

---

## Linux (Steam Proton)

Es gilt dasselbe, mit zwei Unterschieden:

1. In den **Startoptionen** des Spiels muss stehen:
   ```
   WINEDLLOVERRIDES="version=n,b" %command%
   ```
   Ohne das `%command%` am Ende lädt Proton die `version.dll` nicht, und MelonLoader startet gar nicht.
2. Die Spielstände liegen unter
   `steamapps/compatdata/1190000/pfx/drive_c/users/steamuser/AppData/LocalLow/Red Dot Games/Car Mechanic Simulator 2021/Save`.

Getestet mit Proton 7.0 und Linux Mint. SteamOS (Steam Deck, ROG Ally) siehe unten.

---

## Steam Deck / ROG Ally (SteamOS)

SteamOS ist Linux, es gilt also der Linux-Weg oben. Dazu kommt:

1. **Einrichten im Desktop-Modus:** Steam-Taste → *Ein/Aus* → *Zum Desktop wechseln*, dann die
   Konsole (*Konsole* im Startmenü) öffnen und die beiden Befehle aus „Der schnelle Weg unter Linux"
   eingeben. Das Skript findet das Spiel auch auf der **microSD-Karte**.
2. **Startoption** wie oben setzen. Sie gilt danach auch im Spielmodus.
3. **Tasten:** Der Mod kennt nur Tastatur und Maus. Im Spielmodus beim Spiel das Controller-Symbol →
   *Controller-Layout bearbeiten* → **F5 bis F9** auf die Rücktasten oder ein Radialmenü legen.
4. **Klicken:** In den Mod-Fenstern tippst du auf den Touchscreen oder nimmst den rechten Stick als Maus.
5. **Tippen** (Suche im Shop, Kontoname): **Steam + X** öffnet die Bildschirmtastatur.

> Spielst du **denselben Spielstand** auch am PC (Steam Cloud), dürfen die beiden **nie gleichzeitig**
> laufen – sonst holen zwei Spiele dieselben Lieferungen ab. Am einfachsten ist ein eigener Spielstand
> mit eigenem Token.
