TruckSim LogBook

Aktuelle Version: V0.13.42 (Experimental Beta, Frachtkatalog aktualisiert)

Build vom 20.10.2026 enthält auftragsbezogene JSON-Telemetriediagnose. Automatische Tests wurden für die externe Mehrpersonenabnahme ausgelassen; Testergebnisse und ETS2-/ATS-Liveabnahme stehen noch aus. Display-Firmware 0.7.1 liegt unverändert separat bei. Live Map bleibt ein Platzhalter; bekannte Display-Bildstörungen sind weiterhin offen. Lokale SCS-Grafiken sind kein öffentlich freigegebenes Asset-Paket.

Der vorherige Display-Entwicklungsstand 0.13.39 umfasste Firmware 0.7.1, lokalen TCP-Datenweg und 791 lokale Frachtbildzuordnungen für App/SD mit UART- Paketupdate. BGRA-Farben wurden anhand der Spieldaten korrigiert. Die sechs Sekunden lange Startanimation wurde am Gerät geprüft. Die Live-Map-Tabs sind Platzhalter, ihre Anbindung ist geplant: Plan, Startbildschirm, Farbabnahme und WLAN-Dauerstabilität bleiben offen. Bildpaket und Grenzen, WLAN-Einrichtung.

Neue Schäden während einer Tour werden getrennt von Vorschäden erkannt und als Zusatz zum Abschluss geführt. Grenzen und Prüfplan: Tourbezogene Schäden.

SDK 1.15 und ATS 1.61 Roadtrip-Aufträge werden unterstützt. Schnell- und Dispositionsaufträge werden separat als Roadtrip gespeichert, einschließlich Kundenprioritäten und Abschlussdaten. Details und SDK-Grenzen: SDK 1.15 und Roadtrip.

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 von data und config. Feldtests und aussagekräftige Runtime-Logs helfen dabei, die Erfassung verschiedener Spielereignisse weiter zu verbessern.

Aktueller Funktionsstand

Der vollständige Abgleich für App/Plugin 0.13.20 steht unter Entwicklungsstand und Nachweise. Alle technischen Themen sind im Dokumentationsindex verlinkt.

• Getrennte LKW- und Road-Trip-Touren; fünf Statistik-Tabs mit Euro-Gesamtstatistik.
• Schmale Tourenliste, erweiterte Auftragsdetails ohne Verlauf und 38-Pixel-Suchfeld.
• Aufgelöste Trailer-Namen aus ETS2-/ATS-Spieldaten, Originalkennungen bleiben erhalten.
• Installationslokale Datenhaltung und optionaler JSON-Diagnosemodus für Kostentests.
• Automatischer Schadenszusatz nur für neue Tour-Schäden, mit manuellem Override; Checkpoint für aktive Touren und App-Neustart.
• Fünf kompakte Statistik-Kennzahlen einschließlich Echtzeitfahrzeit, ohne doppelte Streckenbox oder manuellen Statistik-Refresh.

Auftragsmarkt-Namen und lokale/WoT-Herkunft sind in Details, Dashboard, Suche und CSV/JSON integriert. Der zusätzliche Markt-/WoT-Filter kombiniert Spiel/Fahrmodus und Suche; Logbuchsummen und alle Exporte folgen der Auswahl. Reale Markt-/Lebenszyklustests, Coaches-Telemetrie und geschützte Katalogpakete sind noch offen. Der Entwicklungsstand steht in Todo.md; Online-VTC ist separat in Todo-VTC.md vorgemerkt und nicht implementiert.

Archivierte App-Tour

Diese ältere Tour zeigt nicht den UI-Stand von 0.13.18. Sie 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
• Spiel-/Status- und Marktfilter sowie Suche in einer Zeile; Tour-ID-Suche bereits beim Tippen
• Gesamtzustand und neu beobachtete Schäden getrennt, historische Messungen nicht geraten
• Trailer-Namen anhand spielgetrennter Namenskataloge, auch in Suche und Exporten

Statistiken

• Ursprüngliches Statistik-Layout mit fünf Tabs: Gesamt, ATS, ETS-2, Road Trip, Coaches
• Eigene Zeiträume unabhängig von Logbuchfiltern
• Roadtrip-Frachteinheiten getrennt von LKW-Tonnen
• Gesamtwerte in Euro mit SCS-Faktor 0,8667; Einzelstatistiken bleiben nativ
• Aktive Einnahmen noch nicht als Umsatz gebucht
• Coaches zunächst als leerer Bereich für die spätere Bus-Anbindung
• Aufträge nach Status
• Beschädigte Lieferungen als Teilmenge der Abschlüsse, ohne doppelte Einnahmen oder Auftragszählung
• Einnahmen, Kosten und Gewinn
• Maut, Fähre/Zug, Tanken, Bußgelder/Unfälle, Reparatur und Abschleppen
• tatsächliche Strecke, modusspezifische Transportmenge und Echtzeitfahrzeit
• 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
• System-, Hell-, Dunkel- und Holo-Transparent-Darstellung
• automatische und manuelle Launcher-Pfaderkennung
• lokaler Changelog mit versionierter Änderungshistorie
• Informationen, Kontaktangaben und Projektlizenz
• Telemetrie-Diagnose ein/aus mit Ausgabeordner und Ordneröffnung; neues Plugin übernimmt die benutzerbezogene Auswahl unabhängig von Steam-Prozessvariablen beim nächsten Spielstart, nicht live

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

Seit 0.13.1 liegen Programm und Laufzeitdaten vollständig im Installationsordner (Standard: C:\TruckSimLogBook). Es gibt keine HomeDir-Auswahl und keinen HomeDir-Startparameter mehr.

TruckSimLogBook\
|-- TruckSimLogBook.exe
|-- Defaults\                   mitgelieferte SCS-Kataloge
|-- config\settings.json         persönliche Einstellungen
|-- config\*-city-countries.json aktive Städte-/Regionskataloge
|-- config\*-trailer-names.json  aktive Trailer-Namenskataloge
|-- data\trucksimlogbook.db       Logbuchdatenbank
|-- logs\
|-- backups\
|-- cache\
|-- temp\
|-- CHANGELOG.txt
|-- LICENSE
|-- NOTICE
`-- THIRD-PARTY-NOTICES.md

Beim ersten Start werden frühere externe Profildaten einmalig übernommen, ohne lokale Daten zu überschreiben. Externe Originaldateien bleiben erhalten. Das Setup erhält Einstellungen und Datenbank; mitgelieferte SCS-Kataloge werden aktualisiert. Eigene Mod-Zuordnungen gehören in eine separate config/ets2-city-overrides.json bzw. config/ats-city-overrides.json.

Siehe Stadt- und Länderzuordnung und Speicherumstellung 0.13.1.

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/            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
src/TruckSimLogBook.Maintenance/    reproduzierbare SCS-Katalogextraktion
localization/                       projektweite Sprachressourcen
third_party/scs_sdk_1_15/           SCS SDK 1.15
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.15
• Inno Setup 6 für Setup-Builds

App bauen:

$env:DOTNET_CLI_HOME = Join-Path (Get-Location) '.dotnet'
dotnet build src\TruckSimLogBook\TruckSimLogBook.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
• Trailer-Namenskataloge
• Auftragsmärkte: Analyse und offene Umsetzung
• Telemetrie-Kostentest und Diagnosemodus
• Plugin-Entwicklung und Übergabeprotokoll
• 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.