Kosten und Ereignisse

TruckSim LogBook ordnet finanzielle Gameplay-Ereignisse der aktiven Tour zu.

Kostenarten

Kostenart	Quelle
Maut	dokumentiertes SDK-Gameplay-Ereignis, Betrag
Fähre/Zug	dokumentierte Reise-Ereignisse, gemeinsamer Kostenzähler
Tanken	erkannte Zunahme des Tankinhalts, preislich geschätzt
Bußgelder/Unfälle	fine.amount, Rohdiagnose zusätzlich fine.offence; kein Unfallbetrag allein aus Schaden
Reparatur	teilweise Ereignisnamen-Heuristik, kein dokumentiertes direktes SDK-Kaufereignis
Abschleppen	teilweise Ereignisnamen-Heuristik, kein dokumentiertes direktes SDK-Kaufereignis
Auftragsabbruch	gemeldete Abbruchkosten, separat im Tourdetail

Stand 0.13.18: Eine getrennte Unfall-/Verstoßabrechnung sowie getrennte Fähr-/Zugzähler sind noch nicht implementiert. Reale Kostenabnahme offen. Firmen-/Ortsnamen werden nicht als Reparatur- oder Abschleppnachweis verwendet. Nicht endliche Zahlen werden abgewehrt; Kosten ohne aktive Tour verändern nicht die letzte abgeschlossene Fahrt.

Kumulative Zähler

Das Plugin führt Kosten als kumulative Zähler. Beim Start einer Tour speichert die App den Ausgangswert. Für die Tour wird die Differenz zum aktuellen Wert berechnet. So werden ältere Ereignisse nicht einer neuen Fahrt zugerechnet.

Tankkosten

Das SCS SDK liefert nicht in jeder Situation einen vollständigen Kassenbeleg. Die App erkennt eine reale Zunahme des Tankinhalts und multipliziert sie mit dem konfigurierten Schätzpreis. Kleine Schwankungen unterhalb des Erkennungsschwellwerts werden ignoriert.

Nullwerte

Ein Wert von 0 € bedeutet entweder:

• es gab kein entsprechendes Ereignis,
• das Ereignis lag außerhalb der aktiven Tour,
• oder die verwendete Spiel-/SDK-Version hat das Ereignis nicht geliefert.

Zur Analyse direkt nach der Fahrt das Runtime-Log sichern.

Neue Schadenserkennung in 0.13.18 ändert keine Kostenbeträge. Ein Schadenszusatz ist kein Reparatur-/Unfallkostenbeleg.

Optionales JSON-Rohlogging

Ab Plugin-Build 0.13.41 beginnen Dateinamen mit ets2- oder ats-. Jeder erkannte Auftrag erhält eine eigene ...-job-<nummer>.json; der Liefer-/Abbruchdatensatz steht am Ende. Daten außerhalb einer Tour bleiben in Sitzungsdateien. Eine geschlossene Datei ohne Abschlussdatensatz kann durch Beenden des Spiels unterbrochen worden sein und belegt keine Lieferung. Die Auftragsnummer gilt nur innerhalb der jeweiligen Plugin-Sitzung.

Seit 0.13.19 direkt unter Einstellungen/System ein-/ausschaltbar, mit sichtbarem Ordner und Ordneröffnung. Seit 0.13.20 über benutzerbezogene Registry- Übergabe auch unabhängig von Steam-Prozessvariablen, aber nicht live im laufenden Spiel. Neues Plugin erforderlich. Details: Einstellungen. Das folgende Skript bleibt als alternative Teststartmöglichkeit verfügbar.

Ab 0.13.4 kann eine gezielte Testfahrt mit JSON-Diagnosen protokolliert werden. Im normalen Spielbetrieb ist der Modus deaktiviert. Im installierten App-Ordner:

.\start-telemetry-diagnostics.ps1 `
  -GameExecutable "D:\SteamLibrary\steamapps\common\American Truck Simulator\bin\win_x64\amtrucks.exe" `
  -DiagnosticDirectory "C:\TruckSimLogBook\logs\telemetry-tests" `
  -TestCase "ats-cost-route-01"

Im Hauptrepository liegt das Skript unter scripts. Pfade anpassen; die Meldung JSON diagnostics enabled im Spiel-Log bestätigt die Aktivierung. Steam-Neustarts können die Prozessvariablen verlieren. Das Skript 0.13.20 veröffentlicht zusätzlich dieselbe Registry-Auswahl samt Testkennung. Diese bleibt bis zur nächsten App-/Skript-Auswahl bestehen; anschließend in der App ausschalten und Spiel neu starten. JSON-Metadaten nennen configuration_source (app_registry oder environment).

JSON enthält Versions-/Sitzungsmetadaten, Ereignisattribute, Filterergebnis, Zählerdifferenzen und höchstens einen Frame-Snapshot je Sekunde. Das ist keine Bestätigung einer Datenbankbuchung. Verworfene Datensätze, Schreibfehler oder erreichte Grenzen verhindern eine vollständige Testabnahme. Diagnose ist begrenzt auf 256 wartende Datensätze und acht Segmente von ungefähr 2 MiB. Rohdaten vor Weitergabe auf persönliche Informationen prüfen.

Fahrplan für die noch offenen Spieltests

Kontrollfahrt ohne Kosten, Maut, Teil-/Vollbetankung, Unfall mit Strafe, Rotlicht/Geschwindigkeitsverstoß, Fähre, Zug, Abschleppen, Reparatur und die Kombination Abschleppen/Reparatur getrennt durchführen. Anschließend Pause, Laden, Neustart, Auftragswechsel und Kosten ohne aktive Tour testen. ETS2, ATS-LKW und Road Trip getrennt prüfen, soweit die jeweilige Aktion möglich ist.

Je Schritt Spielbetrag und Uhrzeit notieren, Rohlog, Plugin-Zähler und DB-Delta vergleichen. Die vollständigen Fälle K01 bis K13 und das Berichtsformat stehen in telemetry-costs.md. Automatisierte Tests ersetzen diese echten Testfahrten nicht.