TF3 Log-Analyzer – Fehler in der stdout.txt einfacher verstehen

Willkommen in der Transport Fever Community

Wir begrüßen euch in der Fan-Community zu den Spielen Transport Fever und Train Fever, den Wirtschaftssimulatoren von Urban Games. Die Community steht euch kostenlos zur Verfügung damit ihr euch über das Spiel austauschen und informieren könnt. Wir pflegen hier einen freundlichen und sachlichen Umgang untereinander und unser Team steht euch in allen Fragen gerne beiseite.

 

Die Registrierung und Nutzung ist selbstverständlich kostenlos.

 

Wir wünschen euch viel Spaß und hoffen auf rege Beteiligung.

Das Team der Transport-Fever Community


  • Ich habe in den letzten Tagen an einem kleinen Tool gearbeitet, das die Fehlersuche in Transport Fever 3 etwas einfacher machen soll: dem TF3 Log Analyzer.

    Wer schon einmal einen Absturz oder Probleme mit Mods hatte, kennt vermutlich die stdout.txt. Dort steht zwar oft ziemlich genau drin, was passiert ist, aber die Datei ist schnell sehr unübersichtlich und gerade für weniger erfahrene Nutzer nicht immer leicht zu verstehen.


    Der Log Analyzer liest die Datei ein, sucht nach auffälligen Meldungen und versucht, diese verständlich einzuordnen. Wiederholte Warnungen werden zusammengefasst und besonders relevante Fehler hervorgehoben.


    Erkannt werden aktuell unter anderem:

    • Abstürze und Hänger
    • Speicher- und VRAM-Probleme
    • Lua- und Scriptfehler
    • fehlerhafte mod.json
    • doppelte Mod-IDs
    • fehlende Ressourcen und Materialien
    • verschiedene Mod- und Abhängigkeitsprobleme

    Mir war dabei wichtig, dass das Tool nicht einfach jede Warnung als Ursache darstellt. Meldungen wie ein Minidump oder eine allgemeine ErrorBox zeigen zwar, dass etwas schiefgelaufen ist, sagen aber noch nicht automatisch, was der eigentliche Auslöser war.


    Zusätzlich gibt es Filter, eine Suche, den direkten Sprung zur entsprechenden Stelle im Log und die Möglichkeit, eine Zusammenfassung für Supportanfragen zu exportieren.

    Die Auswertung läuft vollständig lokal auf dem eigenen Rechner.

    Das Ganze ist noch in Entwicklung und wird mit echten stdout.txt-Beispielen weiter verbessert. Wenn ihr also Logs habt, bei denen der Analyzer etwas falsch einordnet oder gar nicht erkennt, sind solche Beispiele sehr hilfreich.


    Ziel ist am Ende einfach ein kleines Werkzeug, das bei der ersten Fehlersuche unterstützt, ohne dass man sich direkt durch tausende Logzeilen kämpfen muss.


    Zum Download: TF3 Log-Analyzer

  • Stark, danke!
    Wenn ich mir die Analyse so ansehe, bleiben zwei Fragen:

    - Wieso fehlen in so vielen Mods Dateien oder Referenzen?

    "Referenziertes Material fehlt - Eine Mod verweist auf eine Ressource, die TF3 nicht finden kann."

    Sollte man das beim Erstellen und Finalisieren einer Mod nicht sauber machen, bzw. nur auf das Referenzieren, was standardmäßig mit dem Hauptspiel kommt?


    - Wie können so viele doppelte Mod-IDs vergeben werden?

    "Doppelte Mod-ID - TF3 hat mehrere Installationen mit derselben internen Mod-ID gefunden und wählt eine davon aus."


    Unbedarfte Anwender könnten jetzt ins Schwitzen geraten, mir ist's aber grade wurscht, wundert mich aber trotzdem.


    Sorry für's Off Topic jedenfalls! :D

    System: AMD Ryzen 7 7800X3D, 64 GB RAM, nVidia RTX 3060, Windows 11

  • Wieso fehlen in so vielen Mods Dateien oder Referenzen?

    Das ist eigentlich ganz einfach: Es gibt Modder, die ihre Mods vor dem Upload sehr sorgfältig prüfen, und solche, die das weniger gründlich tun. Wir sind aber alle auch nur Menschen, Fehler können passieren.


    Der im Spiel integrierte Assistent ist dabei hilfreich, übersieht aber leider auch einiges – zum Beispiel Fehler in Soundsets. Falls euch so etwas bei einem meiner Mods auffällt, wisst ihr ja, wie ihr mich erreicht.


    Ich finde diese Mod als zusätzliche Prüfung daher sehr sinnvoll, weil man damit eine weitere Instanz hat, um die eigenen Mods vor der Veröffentlichung zu kontrollieren.


    - Wie können so viele doppelte Mod-IDs vergeben werden?

    Doppelte Mod-IDs können aus mehreren Gründen entstehen:

    • Zum einen passiert das, wenn sich Modder nicht an die Vorgaben bzw. das etablierte Schema "moddername_modname" für die Mod-ID halten. Wenn dann beispielsweise 15 verschiedene Mods einfach alle `line_renamer` als Mod-ID verwenden, sind Konflikte vorprogrammiert.
    • Zum anderen gibt es auch Nutzer, die ihre Mods mehrfach „sichern“ oder parallel installieren. Dann liegt derselbe Mod zum Beispiel einmal über mod.io vor, zusätzlich noch unter `local/mods` und vielleicht auch noch einmal in der `staging_area`. In dem Fall findet das Spiel natürlich mehrere Installationen mit derselben internen Mod-ID.
  • Feedback zum Tool an sich

    Wenn da irgendwo stehen würde zu welchem Mod die mod.json gehört wäre das echt hilfreich. (ja ich weiss unten im Text steht das irgendwo im Code, kann sich also jeder selbst raussuchen ;-)


    Die Meldung ist sehr eindeutig: zu wenig Fakebogies im axles eintrag. für modder: kontrolieren der axles einträge, für user -->modder bescheid geben

  • Danke, MaikC für die Erläuterung!

    Ich finde das Tool extrem hilfreich und wenn dann jeder mitarbeitet (also auch die Nutzer) und Fehler oder Unzulänglichkeiten meldet, könnten wir vielleicht irgendwann mal in den Genuss einer sauberen, fast leeren stdout.txt kommen. :)

    System: AMD Ryzen 7 7800X3D, 64 GB RAM, nVidia RTX 3060, Windows 11

  • Neue Version online!
    v0.3.1

    - Auto-Updater auf das zentrale TransportFever.net TF3-Repository umgestellt

    - Separates Update-Manifest für den Log Analyzer entfernt

    - Automatische Erkennung des passenden TF3 Log Analyzer-Eintrags im Repository

    - Version, Download-Link und vorhandene Updateinformationen werden direkt aus dem Repository gelesen

    - Unterstützung für SHA-256-Prüfsummen aus dem Repository

    - Unterstützung für relative und absolute Download-URLs

    - Zusätzliche Prüfung eingebaut, damit nicht versehentlich Updateinformationen eines anderen Tools verwendet werden

    - Dokumentation und Update-Paketierung angepasst

    - Mehrsprachigkeit ergänzt

    - Deutsch und Englisch verfügbar

    - Sprachauswahl wird gespeichert

    - Oberfläche, Analysehinweise und Exportberichte mehrsprachig

    - Wahrscheinliche konkrete Absturzursachen werden farbig hervorgehoben

    - Minidump- und allgemeine ErrorBox-Meldungen werden nicht fälschlich als eigentliche Ursache markiert

    - Automatische Updateprüfung beim Programmstart ergänzt

    - Manuelle Funktion "Nach Updates suchen..." ergänzt

    - Update-Download mit Fortschrittsanzeige

    - Automatisches Installieren und Neustarten nach einem Update

    - Optionale SHA-256-Prüfung heruntergeladener Updates

    - Mod-Zuordnung verbessert

    - Anzeigename, interne Mod-ID, mod.io-ID und Quelle werden nach Möglichkeit miteinander verknüpft

    - Fehlerhafte mod.json können besser einer konkreten Mod zugeordnet werden

    - Zusätzlicher Versuch, lokale Modinformationen direkt aus der mod.json auszulesen

    - Neue Fehlererkennung für FakeBogies-/LOD-Probleme

    - Getrennte Hinweise für Nutzer und Modentwickler bei FakeBogies-Fehlern

    - Betroffene Modelle und Mods werden deutlicher angezeigt

    - Analyse der TF3-Logeinträge weiter verfeinert

    - Fehlzuordnungen und falsche Ursachenbewertungen reduziert

  • Ich liebe diesen Analyzer

  • Freut mich. Ich habe den Tool gestern noch ein Update verpasst. Konnte wieder einige exotische stdout-Auszüge einpflegen um die Fehlererkennung sowie Lösungsvorschläge zu verbessern.


    Changelog

    v0.3.3

    - Erkennung möglicher Windows-Berechtigungs- und UAC-Probleme

    - Geschützte Pfade wie Program Files werden bei frühen Startabstürzen berücksichtigt

    - Zugriffsmeldungen wie "Access denied" werden als mögliche Ursache erkannt

    - Hinweise zu Benutzerkonten, Ordnerrechten und Adminrechten ergänzt


    v0.3.2

    - Startabstürze während der Initialisierung werden erkannt

    - Hinweis, wenn keine konkrete Absturzursache in der stdout.txt gefunden wird

    - Externe Vulkan-Layer wie ReShade und Overlays werden als Troubleshooting-Hinweis erkannt

    - Gamepad-Warnungen werden stärker ausgeblendet und zusammengefasst