TruckSim LogBook

Aktuelle Version: V0.12.0 (Experimental Beta)

TruckSim LogBook ist ein lokales Fahrtenbuch und Telemetrie-Dashboard für Euro Truck Simulator 2 und American Truck Simulator. Eine native SCS-Telemetrie-Erweiterung überträgt Fahr-, Auftrags- und Kosteninformationen an die Windows-App. Touren werden automatisch erfasst, dauerhaft in SQLite gespeichert und als CSV, JSON oder PDF exportiert.

Beta-Hinweis: Die Anwendung wird aktiv entwickelt. Vor einem Update empfiehlt sich eine Sicherung des Ordners db. Feldtests und aussagekräftige Runtime-Logs helfen dabei, die Erfassung verschiedener Spielereignisse weiter zu verbessern.

App-Tour

Die Tour zeigt Dashboard, Fahrer-Kurzansicht, Logbuch, Profil, Statistiken sowie die Bereiche System, Integrationen mit Discord, Launcher, Über, Changelog und Lizenz. Die einzelnen Originalaufnahmen liegen unter docs/media/app-tour/frames.

Funktionsumfang

Dashboard

• aktuelle aktive Route mit Abhol- und Zielort
• Fracht, Gewicht, Zugmaschine und Trailer
• geplante und tatsächlich gefahrene Strecke
• Restzeit und erwartete Einnahmen
• Live-Telemetrie für Geschwindigkeit, Drehzahl, Gang und Tempomat
• Treibstoff, AdBlue, Reichweite und Verbrauch
• Schäden an Zugmaschine, Trailer und Fracht
• integrierter Start von ETS2, ATS und unterstützten Zusatzprogrammen

Touren und Logbuch

• automatische Erkennung und Speicherung von Aufträgen
• Suche und Filter nach Spiel, Status, Ort, Land und Fracht
• ausführliche Fahrt-, Zeit-, Fahrzeug- und Finanzdaten
• Bearbeiten von Status und Notizen
• gezieltes Löschen von Einträgen
• Export als CSV, JSON und PDF

Statistiken

• Aufträge nach Status
• Einnahmen, Kosten und Gewinn
• Maut, Fähre/Zug, Tanken, Bußgelder/Unfälle, Reparatur und Abschleppen
• tatsächliche Strecke, Transportgewicht und Fahrzeit
• Gesamtwerte und Durchschnittswerte pro Auftrag
• Gewinnmarge, durchschnittlicher Schaden und Lieferzeit

Profil

• eigener Hauptbereich für Fahrerkarte, Stammdaten und Spedition
• Fahrerprofil mit Rolle, Fahrer-ID, Geburtsdatum, Eintritt und Avatar
• ETS2-/ATS-Heimatstandort, Eintrittsdatum, Geburtsdatum und Mitgliedsdauer
• Speditionsprofil mit Name, Kürzel, Logo, Gründungsdatum, Farbe und Beschreibung
• getrennte ETS2-/ATS-Speditionsdaten für Hauptsitz und Garage
• bevorzugte LKW-Marke und bevorzugtes LKW-Modell getrennt für ETS2 und ATS
• Fahrer-Kurzansicht mit Touren, Strecke, Einnahmen und Mitgliedsdaten

Einstellungen

• Datenbank-, Export- und Telemetrieeinstellungen
• Standard- und Holo-Theme
• automatische und manuelle Launcher-Pfaderkennung
• lokaler Changelog mit versionierter Änderungshistorie
• Informationen, Kontaktangaben und Projektlizenz

Unterstützte Systeme

• Windows 10 ab Build 19041 oder Windows 11
• x64-System
• Euro Truck Simulator 2 und/oder American Truck Simulator
• Spielausführung über bin\win_x64

Die veröffentlichte App ist eine eigenständige, unpackaged WinUI-3-Anwendung. Das Setup installiert das native Plugin in die ausgewählten Spielordner.

Installation

1. Das aktuelle Setup als Administrator starten.
2. Einen Installationsordner wählen.
3. Die vorhandenen ETS2- und ATS-Spielordner auswählen.
4. Installation abschließen und TruckSim LogBook starten.
5. Unter Profil die Fahrer-, Speditions- und Fahrzeugdaten eintragen.
6. Spiel starten und prüfen, ob im Dashboard Live-Werte erscheinen.

Typische Steam-Spielordner:

<SteamLibrary>\steamapps\common\Euro Truck Simulator 2
<SteamLibrary>\steamapps\common\American Truck Simulator

Das Setup kann als Update über eine vorhandene Installation ausgeführt werden. Benutzereinstellungen, Datenbank und Logs bleiben dabei erhalten.

Installationsstruktur

TruckSimLogBook\
|-- app\                         Programmdateien
|-- config\
|   |-- appsettings.json         Standardkonfiguration
|   `-- appsettings.user.json    persönliche Einstellungen
|-- db\
|   `-- database.db              lokales Logbuch
|-- logs\                        Runtime- und Crash-Logs
|-- CHANGELOG.txt
|-- LICENSE
|-- NOTICE
`-- THIRD-PARTY-NOTICES.md

Discord-Integration

TruckSim LogBook kann den aktuellen Spiel- und Auftragsstatus optional als Discord Rich Presence anzeigen. Aktive Aufträge können zusätzlich über einen konfigurierten Discord-Webhook als Embed an einen ausgewählten Server-Channel gesendet werden. Die Nachricht wird während der Fahrt aktualisiert und nach Abschluss oder Abbruch finalisiert.

Die Integration ist vollständig optional. Webhook-Zugangsdaten werden lokal mit Windows-DPAPI verschlüsselt gespeichert und nicht im Klartext protokolliert.

Ausführliche Einrichtung: Discord-Integration

Launcher

Die Anwendung kann folgende Programme erkennen, manuell konfigurieren und starten:

• Euro Truck Simulator 2
• American Truck Simulator
• TruckersMP
• Trucky
• FPH Sped-V
• TrucksBook

Projektstruktur

src/TruckSimLogBook.App/            WinUI-3-Oberfläche und ViewModels
src/TruckSimLogBook.Core/           Modelle, SQLite, Telemetrie und Exporte
src/TruckSimLogBook.Plugin/         natives SCS-Telemetrie-Plugin
src/TruckSimLogBook.Tests/          automatisierte Tests
third_party/scs_sdk_1_14/           SCS SDK 1.14
scripts/                            Build-, Release- und Prüfscripte
installer/                          Inno-Setup-Definition und Installationsassets
docs/                               technische Projektdokumentation
docs/reference/                     Referenzlisten für Stammdaten und Mappings

Die Kommunikation zwischen Plugin und App erfolgt über den Shared-Memory-Kanal TruckSimLogBook.SharedMemory. Alle Fahrtenbuchdaten bleiben lokal.

Entwicklung

Voraussetzungen:

• Visual Studio 2022 oder Build Tools mit .NET-Desktop- und C++-Werkzeugen
• .NET SDK 10 aus global.json
• CMake
• SCS SDK 1.14
• Inno Setup 6 für Setup-Builds

App bauen:

$env:DOTNET_CLI_HOME = Join-Path (Get-Location) '.dotnet'
dotnet build src\TruckSimLogBook.App\TruckSimLogBook.App.csproj `
  -c Debug -p:Platform=x64

Tests ausführen:

dotnet test src\TruckSimLogBook.Tests\TruckSimLogBook.Tests.csproj `
  -c Release -p:Platform=x64

Plugin bauen:

cmake -S src\TruckSimLogBook.Plugin `
  -B src\TruckSimLogBook.Plugin\build -A x64
cmake --build src\TruckSimLogBook.Plugin\build --config Release

Vollständiges Release erstellen:

.\scripts\build.ps1 -Configuration Release
.\scripts\verify-release.ps1

Alle Release-Artefakte werden einheitlich unter build\trucksim_logbook\<Version>\ abgelegt.

Nur dieser versionierte Ordner ist zur Veröffentlichung bestimmt. installer\out\ ist ein temporäres Staging-Verzeichnis interner Build-Schritte und kein Release- oder Downloadordner.

Hilfe und Dokumentation

• Projekt-Wiki
• Programmierhandbuch
• Plugin-Integration
• Build und Deployment
• Projektleitfaden

Bei Telemetrieproblemen zuerst die Dateien in logs prüfen. Das Wiki enthält eine vollständige Checkliste für Installation, Plugin-Prüfung und Fehlerdiagnose.

Datenschutz

TruckSim LogBook benötigt keinen Cloud-Dienst. Fahrten, Profilinformationen, Einstellungen und Logs werden lokal im gewählten Installationsordner gespeichert. Exportdateien entstehen nur nach einer Benutzeraktion.

Markenhinweise

TruckSim LogBook, das TruckSim-LogBook-Logo und Bastelhof-Bezeichnungen sind Projekt- beziehungsweise Markenkennzeichen von Bastelhof. Die Projektlizenz gewährt keine Markenrechte. Euro Truck Simulator 2, American Truck Simulator, SCS Software sowie weitere genannte Produktnamen und Marken gehören den jeweiligen Rechteinhabern.

Kontakt

• Autor: Batista82
• Website: bastelhof.srv64.de
• Discord: TruckSim LogBook Community

Lizenz

TruckSim LogBook ist Source Available / quelloffene nichtkommerzielle Software. Der Quellcode ist öffentlich einsehbar und darf für nichtkommerzielle Zwecke verwendet, verändert, gebaut, geforkt und kostenlos weitergegeben werden.

Die Projektlizenz ist die PolyForm Noncommercial License 1.0.0 mit dem SPDX-Identifier PolyForm-Noncommercial-1.0.0.

Kommerzielle Nutzung, kommerzielle Weitergabe oder der Einsatz in einem kommerziellen Angebot benötigt vorherige schriftliche Zustimmung von Bastelhof.

Weitere Hinweise zu Drittanbieter-Komponenten stehen in THIRD-PARTY-NOTICES.md.