Update docs and README: launcher, downloads, accounts, MySQL, new game, updates, tags, riding along, models, version scheme

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

README.md

@@ -6,43 +6,62 @@ Multiplayer-Mod für **My Summer Car** (MSCLoader). Spiel mit bis zu 3 Spielern
 - Mod: dieses Repository
 - Dedizierter Server: [MSCO-Dedicated-Server](https://git.mbm.wtf/MrMaho/MSCO-Dedicated-Server)
 - Keymaster & Serverliste: [MSCO-Keymaster](https://git.mbm.wtf/MrMaho/MSCO-Keymaster) – live unter https://msco.mbm.wtf
+- Launcher (installiert und aktualisiert die Mod): [MSCO-Launcher](https://git.mbm.wtf/MrMaho/MSCO-Launcher)
+- Download: https://msco.mbm.wtf/download
 
 ## Features
 
 **Verbinden**
-- Launcher im Hauptmenü: P2P-Seite und Server-Browser
+- Launcher im Hauptmenü (Vollbild, automatisch skaliert): P2P-Seite, Server-Browser und Favoriten; mit **–** einklappen,
+  dann ist das Startmenü des Spiels wieder bedienbar
 - **P2P über Steam:** HOST GAME, Freunde einladen, Beitritt über die Steam-Freundesliste (max. 3 Spieler)
 - **Server-Browser:** Suche, Filter (Steam / Non-Steam / volle ausblenden), Ping, Server-Profil
   (Besitzer, Version, Laufzeit, Spieler), lokale Server auf diesem PC werden automatisch gefunden
 - **Direct Connect** per Adresse, JOIN-Links von der Website (`msco://`) starten das Spiel und verbinden direkt
-- Server ohne Steam („Non-Steam“) werden unterstützt, andere Mod-Version = Warnung statt Sperre
+- **Favoriten** mit Herz und Kurzname, schnell wechseln mit `/switch <kurzname>`
+- **P2P: neues Spiel oder weiterspielen** – der Host startet ein frisches Spiel oder lädt seinen Spielstand
+- Server ohne Steam („Non-Steam“) werden unterstützt; Versionen passen, solange die ersten zwei Stellen gleich sind
+- Nach einem Kick/Bann ein Fenster mit dem Grund; nach Welt-Reset oder Server-Neustart verbindet man automatisch neu
 - Der Host-Spielstand wird beim Start automatisch an alle übertragen; der eigene Spielstand wird vorher gesichert
   und nach dem Spielen wiederhergestellt
 
 **Synchronisiert**
-- Spieler als eigene Figur im MSC-Stil (Karohemd, Jeans, Schnurrbart, Kappe – je Spieler etwas anders) mit
-  Blickrichtung, Laufen, Ducken/Lehnen, Sitzen, gehaltenem Item und Namensschild
+- Spieler als **echte MSC-Menschen** (derselbe Körper wie die Leute im Spiel, je Spieler anderes Hemd, Hose, Gesicht)
+  mit Blickrichtung, Laufen, Springen, Ducken/Lehnen, Sitzen, gehaltenem Item und Namensschild (`model classic` = einfache
+  MSCO-Figur)
 - Items, lose Teile, Schrauben und Fahrzeuge (auch mit G geschoben) mit Besitzer-System – inkl. was jemand in der Hand hält
-- Fahrzeuge: Position, Lichter, Motorgeräusch; als **Beifahrer** mitfahren (Taste P)
-- **Fahrzeugzustand:** Tank, Öl, Kühlwasser, Bremsflüssigkeit, Batterie, Schrauben-Festigkeit, Schäden, Verschleiß,
-  Kilometerstand, Lack, Vergaser-/Zündungseinstellungen
+- Fahrzeuge: Position, Lichter, Motorgeräusch, Bedienelemente (Zündung, Licht, Blinker, Wischer, Handbremse …), Tacho,
+  Lenkrad, drehende Räder, Türen/Haube/Kofferraum, Unfallschäden
+- **Mitfahren**: wer im Fahrzeug ist (Kabine, offene Tür, Ladefläche), fährt genau dort mit – mit oder ohne Fahrer
+- **Fahrzeugzustand:** Tank, Öl, Kühlwasser, Bremsflüssigkeit, Batterie, Schäden, Verschleiß, Kilometerstand,
+  Vergaser-/Zündungseinstellungen; beim Satsuma zusätzlich jedes Teil (Verschleiß, kaputte Teile, Reifen, Ölwanne,
+  Fahrwerk) und der **Lack**
 - Anbauen/Abbauen von Teilen und Schrauben (PlayMaker-Events)
-- Türen, Tore, Hauben (z.B. Garagentor), Geld, Uhrzeit und Wetter
+- Türen, Tore, Hauben (z.B. Garagentor), Geld, Uhrzeit und Wetter, NPC-Verkehr
+- Jobs und Events: Laden, Werkstatt, Prüfstelle, Müllkippe, Tanzhalle, Rallye, Dragrace, Kilju-Käufer, Theater, Fußball,
+  Peräjärvi, Ferienhaus, Hütte
+- Pro Spieler auf dem Server: letzte Position und Bedürfnisse (Hunger, Durst, Stress …)
 
 **Im Spiel**
 - **T** – Chat
 - **F7** – MSCO-Konsole mit allen Befehlen
-- **/admin** – Admin-Menü für Server-Admins bzw. den P2P-Host: Spieler kicken/bannen, GOTO/BRING (teleportieren),
-  Cheats (+1.000 / +10.000 MK, Bedürfnisse auffüllen, Satsuma zu sich holen) – Cheats werden im Chat angezeigt
-- **P** – als Beifahrer ein-/aussteigen
+- **/admin** – Admin-Menü für Server-Admins bzw. den P2P-Host: Spieler kicken/bannen, **Admin geben/nehmen**,
+  GOTO/BRING (teleportieren), Cheats (+1.000 / +10.000 MK, Bedürfnisse auffüllen, Satsuma zu sich holen), Items spawnen,
+  Welt zurücksetzen/Backups – Cheats werden im Chat angezeigt
+- **P** / **Leertaste** – aussteigen; **P** neben einem Auto – auf den Beifahrersitz
 - Alle Tasten sind in den MSCLoader-Einstellungen der Mod änderbar
 - Rich Presence: zeigt Freunden deinen Status („In the Menus“, Server, Spielerzahl)
 
 ## Installation
 
+**Mit dem Launcher (empfohlen):** den [MSCO Launcher](https://msco.mbm.wtf/download) installieren – er installiert
+und aktualisiert MSCO und startet das Spiel. [MSCLoader](https://github.com/piotrulos/MSCModLoader) muss installiert sein.
+
+**Von Hand:**
+
 1. [MSCLoader](https://github.com/piotrulos/MSCModLoader) installieren.
-2. `MSCO.dll` von den [Releases](https://git.mbm.wtf/MrMaho/MSCO/releases/latest) herunterladen und in den
-   Mods-Ordner kopieren (Standard: `Documents\MySummerCar\Mods`).
+2. `MSCO.dll` von der [Download-Seite](https://msco.mbm.wtf/download) laden und in den Mods-Ordner kopieren
+   (Standard: `Documents\MySummerCar\Mods`).
 3. Spiel **über Steam** starten – ohne Steam gehen nur Non-Steam-Server.
 
 ### Einen eigenen Server betreiben
@@ -56,7 +75,8 @@ unter https://msco.mbm.wtf/keys.
 |---|---|
 | Server fehlt im Browser | REFRESH drücken; Filter (STEAM / NON-STEAM) prüfen; der Server muss von außen erreichbar sein |
 | „This server requires Steam“ | Spiel über Steam starten |
-| Warnung „Version mismatch“ | Mod und Server auf dieselbe Version bringen (Releases) |
+| Warnung „Version mismatch“ | Die ersten zwei Stellen unterscheiden sich – Mod (Launcher) oder Server aktualisieren |
+| Mod lässt sich nicht aktualisieren | Spiel schließen – solange es läuft, ist `MSCO.dll` gesperrt |
 | Eigener Spielstand weg | Wird nach dem Verlassen automatisch wiederhergestellt; Sicherung liegt in `AppData\LocalLow\Amistech\My Summer Car\MSCO_Backup` |
 | Absturz / Hänger beim Beitreten | `output_log.txt` im Spielordner an den Server-Betreiber bzw. als Issue schicken |
 
@@ -71,6 +91,10 @@ In der F7-Konsole direkt, in der MSCLoader-Konsole mit `mp` davor (z.B. `mp conn
 | `host [port]` / `join <ip> [port]` | LAN-Testsitzung ohne Steam |
 | `save` | Spiel speichern (Host / Einzelspieler) |
 | `ping [on\|off]` | Ping zum Server oben rechts anzeigen (grün < 80 ms, gelb < 150 ms, rot darüber) |
+| `fps [on\|off]` | Bilder pro Sekunde oben rechts |
+| `switch <kurzname>`, `fav …` | Zu einem Favoriten wechseln, Favoriten verwalten |
+| `model [game\|classic]` | Mitspieler als MSC-Menschen oder als einfache Figur |
+| `vars <filter>` | Diagnose: synchronisierte Fahrzeugwerte |
 | `admin` bzw. `/admin` im Chat | Admin-Menü |
 | `vehicles`, `rig` | Diagnose: Fahrzeuge / Spielermodelle |
 | `debug` | Sync-Debugausgaben an/aus |
@@ -97,7 +121,8 @@ msbuild MSCO.csproj -p:Configuration=Release
   Server erhöhen (z.B. `2.9`), `ModVersion` auf `2.9.0`. Dann brauchen alle die neue Mod und den neuen Server.
 - Verglichen werden immer nur die ersten zwei Stellen; übers Netz geht nur die Netzwerk-Version.
 - **Automatisch hochladen**: Ist lokal `MSCO_RELEASE_TOKEN` gesetzt (= `RELEASE_TOKEN` des Keymasters, oder in
-  `%AppData%\MSCO␍elease-token.txt`), lädt jeder Release-Build eine neue Version selbst auf den Keymaster
+  `%AppData%\MSCO
+elease-token.txt`), lädt jeder Release-Build eine neue Version selbst auf den Keymaster
   (`release.ps1`, Changelog aus dem passenden Abschnitt in `CHANGELOG.md`). Gibt es die Version schon, passiert nichts.
 
 ## Aufbau
@@ -112,7 +137,9 @@ msbuild MSCO.csproj -p:Configuration=Release
 | `ObjectSync.cs` | Items/Teile/Fahrzeuge mit Besitzer-System |
 | `VehicleStateSync.cs`, `VehicleFx.cs`, `Passenger.cs` | Fahrzeugzustand, Lichter/Sound, Beifahrer |
 | `FsmSync.cs`, `DoorSync.cs`, `WorldSync.cs`, `MoneySync.cs` | Montage-Events, Türen, Zeit/Wetter, Geld |
-| `RemotePlayer.cs` | Spielfiguren der Mitspieler |
+| `RemotePlayer.cs`, `GameCharacter.cs` | Spielfiguren der Mitspieler (Animation, MSC-Körper mit eigenem Skelett) |
+| `HingeSync.cs`, `ControlSync.cs`, `DamageSync.cs`, `WorldVarSync.cs` | Türwinkel, Schalter, Unfallschäden, Jobs/Events |
+| `Favorites.cs`, `Commands.cs`, `PlayerNeeds.cs` | Favoriten, Konsolenbefehle, Bedürfnisse pro Spieler |
 | `SaveSync.cs`, `MenuHelper.cs` | Spielstand übertragen/sichern, Laden aus dem Menü |
 | `SteamLobby.cs`, `JoinLinks.cs`, `DiscordPresence.cs` | Steam-Lobbys, `msco://`-Links, Rich Presence |
 | `SafetyPatches.cs`, `InputLock.cs`, `SceneCache.cs` | Absturzschutz, Eingabesperre, geteilte FSM-Suche |
@@ -121,7 +148,7 @@ msbuild MSCO.csproj -p:Configuration=Release
 
 - Teile, die nach dem Server-Spielstand montiert wurden, werden für neue Spieler nachgespielt – das klappt nicht immer
   perfekt. `reset-world` auf dem Server setzt den Stand zurück.
-- Maximal 3 Spieler.
+- Maximal 3 Spieler im P2P-Spiel (dedizierte Server: so viele wie eingestellt).
 
 ## Lizenz