## So funktioniert es

### Kein Gameserver nötig

Das Dashboard bleibt auf einem normalen PHP-Webspace erreichbar. Der lokale LS25-Mod erzeugt die Daten; die Bridge sendet ausschließlich geänderte Dateien verschlüsselt per HTTPS.

LS25 + Mods schreiben Telemetrie und LiveMap lokal
→
Windows-Bridge erkennt Änderungen und neue Karten automatisch
→
Web-Dashboard speichert und zeigt die Hofdaten an
Windows-Spiel-PC

Farming Simulator 25 und Windows PowerShell 5.1 oder neuer. Keine Administratorrechte nötig.

PHP-Webspace

PHP 8.1+, MySQL/MariaDB und HTTPS. Ein LS25-Serverpaket ist ausdrücklich nicht erforderlich.

Während des Spielens

Spiel und Bridge müssen laufen. Bereits gespeicherte Historie bleibt danach im Dashboard sichtbar.

Wichtige Abgrenzung: „Ohne Server“ bedeutet ohne Dedicated Gameserver. Für den Zugriff von Handy, Tablet und anderen PCs wird weiterhin ein kleiner PHP-/MySQL-Webspace benötigt.

## Webspace

### Dashboard vorbereiten

1

#### WEB-DASHBOARD.zip hochladen

Archiv lokal entpacken und den gesamten Inhalt einschließlich `.htaccess` in einen leeren Webordner laden, zum Beispiel `/farmdashboard`.

https://deine-domain.de/farmdashboard/
2

#### Datenbank erstellen

Im Hosting-Panel eine MySQL-/MariaDB-Datenbank anlegen. In phpMyAdmin `sql/schema.sql` importieren.

3

#### Singleplayer-Konfiguration verwenden

`config.singleplayer.example.php` zu `config.php` kopieren. Datenbankname, Benutzer und Passwort eintragen. Der Bereich `gportal` bleibt deaktiviert.

'gportal' => [ 'enabled' => false, 'pull_on_dashboard_request' => false, 'sources' => [], ],
4

#### Administrator und Spielwelt anlegen

`setup.html` im Browser öffnen. Administrator, Passwort und Namen der Spielwelt eingeben. Den angezeigten API-Schlüssel sofort kopieren; er wird im nächsten Abschnitt benötigt und nur einmal vollständig angezeigt.

5

#### Installation absichern

`setup.html` vom Webspace löschen oder umbenennen. Dashboard über die normale URL öffnen und die Anmeldung testen.

## Spiel & Bridge

### Lokale Übertragung starten

1

#### Beide Mods installieren

`FS25_FarmDashboardV2.zip` und `FS25_LiveMap.zip` unverändert in deinen lokalen Modordner kopieren. ZIP-Dateien nicht entpacken.

%USERPROFILE%\Documents\My Games\FarmingSimulator2025\mods

Bei OneDrive kann der Ordner unter `%USERPROFILE%\OneDrive\Documents\My Games\…` liegen.

2

#### Mods im Spielstand aktivieren

LS25 starten, den gewünschten Spielstand auswählen und beide Mods aktivieren. Spielstand vollständig laden. Danach sollten diese lokalen Dateien entstehen:

...\modSettings\FS25_FarmDashboardV2\telemetry.json ...\modSettings\livemap_static.json ...\modSettings\livemap_dynamic.json ...\modSettings\livemap_fast.json ...\modSettings\livemap_overview.dds
3

#### Bridge einrichten

Den Ordner `SINGLEPLAYER-BRIDGE` an einen dauerhaften Ort entpacken. `1 - Einrichtung starten.cmd` doppelt anklicken und eingeben:

- vollständige Dashboard-URL mit `https://`
- API-Schlüssel aus `setup.html`
- Dateipfad leer lassen, damit er automatisch erkannt wird

Die Zugangsdaten werden nur lokal in `singleplayer-config.json` gespeichert. Diese Datei niemals weitergeben.

4

#### Übertragung starten

Während der Spielstand läuft, `2 - Dashboard-Bridge starten.cmd` öffnen. Das Fenster geöffnet lassen. Grüne Meldungen bestätigen Telemetrie, LiveMap-Daten und Kartenbild.

[OK] Telemetrie erfolgreich übertragen. [OK] LiveMap-Felddaten erfolgreich übertragen. [OK] Kartenbild erfolgreich übertragen.
5

#### Neue Karte oder neuer Spielstand

Es ist keine manuelle Karteninstallation nötig. Sobald der LiveMap-Mod eine andere `livemap_overview.dds` oder eine neue Map-ID erzeugt, erkennt die Bridge den Wechsel und lädt das neue Kartenbild sowie die neuen Felddaten automatisch hoch.

## Prüfen & Hilfe

### Fertig, wenn alles grün ist

Live-Verbindung aktiv

Dashboard zeigt „Online“, der richtige Hof ist sichtbar und LiveMap-Spieler/Fahrzeuge aktualisieren sich.

VERBUNDEN

Problem | Lösung
--- | ---
telemetry.json fehlt | Beide Mods im richtigen Spielstand aktivieren. Spielstand vollständig laden. In `game.log` nach `FarmDashboardV2` suchen.
401 / API key required | Einrichtung erneut starten und den vollständigen API-Schlüssel ohne Leerzeichen eintragen.
404 / Seite nicht gefunden | Dashboard-URL bis zum Installationsordner prüfen; keine URL zu `index.php` oder `setup.html` verwenden.
SSL/TLS-Fehler | Eine gültige HTTPS-Adresse verwenden und Systemdatum von Windows prüfen. Für öffentliche Nutzung kein unsicheres HTTP einsetzen.
Karte fehlt | `FS25_LiveMap.zip` aktivieren und prüfen, ob `livemap_overview.dds` im lokalen `modSettings`-Ordner liegt.
Falscher Datenpfad | `1 - Einrichtung starten.cmd` erneut ausführen und den vollständigen Pfad zur `telemetry.json` manuell eintragen.

Alltag: Erst LS25-Spielstand starten, dann die Bridge öffnen. Beenden mit Strg+C. Die Datei `bridge.log` hilft bei Fehlern und enthält keinen API-Schlüssel.