stdout.txt - Erklärung & typische Fehlermeldungen

Vielleicht noch ein passendes Zitat von VacuumTube zur Einleitung:

Zitat von @VacuumTube

Die stdout ist eine ungeordnete Sammlung von Logmeldungen (ohne Zeitstempel), die sowohl vom Spiel als auch von einzelnen Mods kommen.

Es gibt nicht den einen Weg, eine stdout richtig zu lesen. Je nach Problem, muss man sich das genau anschauen. Erst wenn man sich schon länger damit beschäftigt hat, versteht man den prinzipiellen Aufbau und die Bedeutung der Meldungen.

Danto Danke für das Erstellen. Ich hab den Artikel mal erweitert und unten die Liste angefangen, wie ich mir das etwa vorgestellt habe. Ob das in Zukunft hilfreich ist, wird sich zeigen.

1 Einleitung

Dieser Lexikon-Eintrag soll den Umgang mit Fehlern/Crashes vereinfachen. Bei der Fehlersuche geht es meist darum, die verantwortliche Mod zu finden. Dieser Artikel soll helfen, die Fehlerart und die Ursache anhand der stdout festzustellen, welche für weniger erfahrene Spieler offenbar nur schwer zu durchschauen ist. Außerdem sollen in einer Liste (siehe unten) bekannte Fehlermeldungen mit Erläuterung festgehalten werden, diese ist auch für Modder interessant.

Dies soll aber keine Schritt-für-Schritt Anleitung sein, denn in vielen Fällen muss man einfach genauer hinschauen oder ist auf die Erfahrung der Modder hier im Forum angewiesen. Daher gilt, wenn euch die Informationen hier und die Fehlerliste nicht weiterhelfen: Schreibt euer Problem ins Forum. Achtet dabei darauf, genau zu beschreiben, wann/wie der Fehler auftritt und welche Mods ihr benutzt. Das wichtigste: immer die stdout anhängen, denn manchmal stehen auch über der eigentlich Fehlermeldung entscheidende Informationen.

2 Allgemeines

• Grundlagen/Speicherorte: Speicherorte der Spieldateien, stdout.txt, Speicherstände, Mods
• Die Datei wird mit jedem neuen Spielstart überschrieben
• Lest die stdout.txt am besten immer von unten nach oben - tendenziell steht unten das, was euer Spiel zum Absturz gebracht hat
• Die Zeilen kurz vor der Fehlermeldung können relevant sein, müssen aber nicht (siehe gewöhnliche Meldungen)
• Im selben Ordner befinden sich auch die Minidumps (.dmp) - diese können aber nur die Entwickler lesen

3 Arten von Crashes

Ich unterscheide mal 3 grundlegende Möglichkeiten, wie das Spiel crashen kann. (Es gibt sicherlich noch mehr, was aber aus unserer Sicht nicht relevant ist, siehe das Crash-Feld im Debug-Fenster.)

Ihr solltet nach einem Crash mit der Fehlermeldung schnell merken, um was es sich handelt, somit lässt sich das Problem eingrenzen.

• Lua Fehler: Tritt auf, wenn im Lua-Code eine nicht-geschützte Exception auftritt, z.B. ein Null-Pointer-Fehler wegen fehlender Überprüfung. Die Ursache ist meistens ein Mod. Diese Fehler sind leicht zu analysieren, weil direkt die Fehlerzeilen in den Lua Dateien angegeben sind. z.B.: stack traceback: error: .../local/mods/modxy_1/mod.lua:36: attempt to index global 'var1' (a nil value)
• Assertion: Diese "Tests" sind von den Entwicklern in den Quellcode eingebaut, um fehlerhaftes Verhalten oder ungültige Zustände zu erkennen. Die eigentliche Ursache kann jedoch sehr viel früher entstehen. Grundsätzlich ist es ein Fehler im Spiel, aber auch Mods können verantwortlich sein.
  Das Spiel bricht sofort ab, um Folgefehler oder korrupte Savegames zu vermeiden (Ausnahme: Exceptions innerhalb einer Konstruktion werden jetzt "gefangen" und eine rote Meldung angezeigt, man kann die Konstruktion dann nicht bauen, aber immerhin weiterspielen.)
  Im Log wird zusätzlich zur fehlgeschlagenen Assertion die Quelldatei und Zeile sowie die Funktion, in der der Fehler auftrat, angegeben. Wir können das nicht nachsehen, da der C++ Quellcode nicht öffentlich ist, aber man kann oft spekulieren, was das Problem sein könnte. Außerdem findet ihr in alten Threads oder in der Liste (siehe unten) mehr Informationen, falls der Fehler bekannt ist.
• Andere: Leider passiert es auch manchmal, dass das Spiel ohne irgendeine Art von Fehlermeldung abstürzt. Entweder beendet das Spiel durch einen unerwarteten Fehler ("An error just occurred"). Oder aber das Programm wird von außen gekillt (ist zB der Fall, wenn es nicht reagiert und man es zum Abbruch zwingt). In der stdout ist dann die letzte Zeile "normal" und jede Art von Fehlermeldung oder Goodbye fehlt, außerdem gibt es kein Minidump. Die Ursache ist nur schwer rauszufinden. Auch Hardwareprobleme sind möglich.

4 Typische stdout-Meldungen ohne Absturz

Hier können wir "gewöhnliche" Meldungen sammeln, die zwar anzeigen, dass etwas nicht in Ordnung ist, aber in der Regel nicht der Grund für einen Crash sind.

• texture load error: Eine Textur kann nicht geladen werden. Im Spiel macht sich das durch eine lila Fläche bemerkbar, führt aber normalerweise nicht zum Absturz
• error loading dds file: Eine dds Datei kann nicht geladen werden
• vehicle/x.mdl is missing boundingInfo: Im Modell ist keine boundingInfo angegeben
• * x.mdl was removed because the following resources were missing: Fehlende Modelle werden durch Dummys ersetzt
• [RESOURCE ERROR] Referenced model not found: 'x.mdl' in 'x.lua' (has been replaced with fallback): Fehlende Spieldaten
• WARNING: alutCreateBufferFromFile failed for "x.wav": Zuviele Soundquellen, Sound wird nicht abgespielt
• [ModUtil|UserSettings] Previous settings for id "x" are overwritten: Doppelte id beim Modutil -> Mod doppelt geladen?
• <ModId> key: x No params -> default value: 0: Fehlender Defaultwert bei ParamBuilder (aufgrund von Bug in Mod Params)

5 Fehlermeldungen Liste

Hier sollen alle bekannten Assertion-Fehlermeldungen inklusive vermutlicher Ursache gesammelt werden.

Der Aufbau ist immer gleich. Die Datei, in der der Fehler auftritt, beginnt mit c:\build\tpf2_steam oder c:\build\tpf2_gog, deshalb wird das weggelassen.

Dies ermöglicht außerdem einen gewissen Einblick in den Aufbau und die Programmierung des Spiels.

Beachtet aber, dass die Ursachen unterschiedlich sein können. Auch sind viele Assertions unbekannt oder nicht aussagekräftig.

Die Liste darf/soll gerne von jedem, der neue Erkenntnisse hat, erweitert werden. Bei Unsicherheiten Kommentar schreiben.

Ich habe im wiki (wenn auch etwas versteckt) eine ähnliche Fehlerliste gefunden.

Dort sind weitere Fehlermeldungen vorhanden, allerdings ist die Liste teilweise unvollständig.

Quelldatei/zeile	Error message / Assertion ... failed	vermutliche Ursache/Problemlösung	Funktion
	Error message: cannot open .../mod.lua: No such file or directory	Kann auftreten, wenn Dateien einer Workshop Mod nicht gefunden werden. Ggf neu abbonieren
\src\lib\model\io\converter_model.h:179	invalid material type: REFLECTIVE_NRML_MAP_OP	Ungültiger Materialtyp. TPF1 Mod?	enum MaterialType __cdecl Converter<enum MaterialType,void>::operator ()(const class std::variant<struct lua::Nil,bool,double,class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> >,struct lua::Table> &)
\src\lib\util\idrep.h:83	false		int __cdecl IdRep<class Model *>::GetId(const class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > &) const
\src\game\terrain\renderdatamanager.cpp:806	m_subscriptions.empty()	Tritt manchmal als Folge eines anderen Fehlers auf. Shader Enhancement ?	__cdecl terrain::RenderDataManager::~RenderDataManager(void)
\src\game\application.cpp:637	false / Out of memory	Zu wenig RAM vorhanden oder anderer Fehler. Tritt auf, wenn die Karte zu groß ist und/oder die Auslagerungsdatei zu klein.	void __cdecl Main(int,char *[])
\src\lib\renderer\tex_load.cpp:343	img.width % 2 == 0 && img.height % 2 == 0	Eine Textur hat eine ungültige Größe	struct Rgbe::CImage __cdecl `anonymous-namespace'::ScaleDown(const struct Rgbe::CImage &)
\src\lib\renderer\tex_load.cpp:528	numBits == 8 numBits == 16 numBits == 24 numBits == 32 numBits == 64	Eine Textur hat eine ungültige Größe	int __cdecl `anonymous-namespace'::CompInternalSize(unsigned int,int,int,int,int)
\src\lib\renderer\tex_load.cpp:821	redGreen == (format.Internal == gli::gl::INTERNAL_RG_ATI2N_UNORM)	Eine Textur hat ein ungültiges Format	int __cdecl `anonymous-namespace'::UploadTexture(const class gli::texture &,unsigned int,bool)
\src\lib\renderer\texturemanager.cpp:105	it != m_textures.end()		void __cdecl TextureManager::RemoveRef(const struct engine::TextureDesc &)
\src\lib\renderer\model\staticbuffer.cpp:507	vbo > 0	Fehler mit Materialien? Signale?	auto __cdecl StaticBuffer::Render::<lambda_....>::operator ()(const struct VertexAttr &) const
\src\lib\model\edge_geometry_util.cpp:123	result.length > .0f	Straßen/Schienen-Bau nicht möglich. (zB wenn maxSlope 0 ist)	struct transport::EdgeGeometry __cdecl transport::MakeSplineEdge(const struct CVec3f &,const struct CVec3f &,const struct CVec3f &,const struct CVec3f &,float)
\src\lib\model\edge_geometry_util.h:215	len > .0f	Ungültige Straßenlänge	void __cdecl transport::VisitEdge<class transport::`anonymous-namespace'::CalcMaxCurvatureStep::<lambda_....>>(const struct transport::EdgeGeometry &,bool,float,float,float,float,int,class transport::`anonymous-namespace'::CalcMaxCurvatureStep::<lambda_...>)
\src\lib\model\edge_geometry_util.cpp:216	false		CVec3f transport::CalcPosition(const transport::EdgeGeometry&, float, CVec3f*, CVec3f*)
\src\lib\ui\combobox.cpp:174	index < (int)m_createItemFns.size()	Möglicher Fehler, wenn 2 Comboboxen denselben Parameter key haben	void __cdecl UI::ComboBox::SetSelected(int,bool)
\src\lib\ui\core.cpp:1446	pr.second && "Duplicate id found."	ID eines Gui Elements doppelt vorhanden. In der vorigen Zeile sollte die ID stehen. Mod doppelt geladen?	void __cdecl UI::CCore::AddId(class UI::ILayoutItem *)
\src\game\construction\make_proposal.cpp:692	(int)construction.stocks.size() == (int)r.size()	Fehler bei der Angabe der cargo rule	void __cdecl construction_builder_util::MakeProposalAdd(...const struct Construction &,const struct CMat4f &,const class std::unordered_map<int,struct std::pair<class ecs::Entity,float>,struct std::hash<int>,struct std::equal_to<int>,class std::allocator<struct std::pair<int const ,struct std::pair<class ecs::Entity,float> > > > ....
\src\game\procedural\buildingtyperep.cpp:66	false	Es sind keine Stadtgebäude für die Stadterweiterung verfügbar	class std::vector<class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> >,class std::allocator<class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > > > __cdecl `anonymous-namespace'::GetCandidates(const class BuildingTypeRep &,const class ConstructionRep &,enum LandUseType,int,int)
\src\game\procedural\buildingtyperep.cpp:373	it != m_buildingTypes.end()	Kann beim Klick auf das Landnutzungslayer auftreten, wenn unerwartete Gebäude vorhanden sind	const struct BuildingType &__cdecl BuildingTypeRep::GetType(const class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > &) const
\src\game\terrain\groundtexturerep.cpp:131	false	Nicht vorhandene ground_texture	const struct GroundTexture &__cdecl GroundTextureRep::Get(const class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > &) const
\src\game\transport\street\streetshapefactory.cpp:931	Valid(result.laneConfigs)	transportModesStreet einer Straße ungültig	c:\build\tpf2_steam\src\game\transport\street\streetshapefactory.cpp:931: struct StreetGeometry::StreetContext __cdecl CreateStreetContext(const struct StreetType &,int,bool,bool,bool,bool)
\src\game\transport\street\streettyperep.cpp:226	false	Nicht vorhandener Straßentyp	int __cdecl StreetTypeRep::GetIndexExact(const class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > &) const
\src\game\transport\cargotyperep.cpp:117	int(index) >= 0	Ungültiger Gütertyp	struct CargoTypeId __cdecl transport::CargoTypeRep::GetIndex(const class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > &) const
\src\game\transport\vehicle_cargo_util.cpp:160	it != format2model.end()	Problem mit Cargo-Mod/CargoType	class std::_List_const_iterator<class std::_List_val ...
\src\game\transport\path_util.cpp:174	dist < .0f	Problem bei Pfadfindung (zB wenn Flugzeug zu hoch ist)	struct transport::PathPos __cdecl transport::Move<struct std::pair<struct transport::EdgeGeometry,bool>>(const class ecs::Engine *,int,const class transport::TpNetData &,const class std::vector<struct std::pair<struct transport::EdgeGeometry,bool>,class std::allocator<struct std::pair<struct transport::EdgeGeometry,bool> > > &,struct transport::PathPos,float)
\src\game\urbansim\pathfinder_util.cpp:365	itCache != m_station2stationsAndDistances.end()	Problem bei Pfadfindung (evtl Abstand zwischen Stationen zu groß)	void __cdecl simulation_util::path_finder::`anonymous-namespace'::LinesExpander::VisitLinesAll(const class ecs::Entity &,class transport::PathFinder<struct transport::LineSectionOptimized,class transport::ZeroHeuristic> &,int,float) const
\src\game\urbansim\parcel_util.cpp:1153	face[0] != face[1]	Beschädigtes Gebäude. In der vorigen Zeile sollten Koordinaten stehen.	class ecs::Entity __cdecl parcel_util::CreateBuilding(const struct parcel_util::BuildingDesc &,class ecs::Engine &,const struct street_util::StreetToolkit &,const struct parcel_util::ParcelContext &,class boost::random::mersenne_twister_engine<unsigned int,....> &,class std::vector<class ecs::Entity,class std::allocator<class ecs::Entity> >,bool)
\src\game\ui\components\addmodulecomp.cpp:299	it.second	Ein Problem mit modularer Station	__cdecl UI::AddModuleComp::AddModuleComp(class CommandList &,const class GameRes &,class UI::IGameStateProvider &,class UI::GameTimeUI &,class UI::ModuleBuilder *,class std::shared_ptr<class UI::RendererFactory>,class UI::MenuCategorySettings,class UI::CRendererComponent &,class UI::Window *)
\src\game\ui\util\consumersupplierdataprovider.cpp:112	it != result.end()	Passiert beim Klicken auf Abnehmer einer Industrie, wenn keine echten Industrien (type=Industry) die Abnehmer sind	class std::unordered_map<class ecs::Entity,struct `anonymous namespace'::CargoFlowData,struct std::hash<class ecs::Entity>,.... __cdecl `anonymous-namespace'::GetConsumerData(const class ecs::Engine &,const class ecs::TownBuildingSystem &,const class ecs::SimBuildingSystem &,....
\src\lib\ecs\engine.h:275	it != components.end()	Im Savegame ist etwas nicht richtig abgespeichert. Die Ursache kann alles mögliche sein, Fehlerbehebung schwierig.	int __cdecl ecs::Engine::GetComponentDataIndex(const class ecs::Entity &,int) const
\src\game\ecs\trainmovesystem.cpp:666	mp.speed >= .0f		auto __cdecl ecs::TrainMoveSystem::Update2::<lambda_...>::operator ()(int,int) const
	it->second.second == 1' failed	in den edgeLists (Straße oder Schiene) ist einer der snapNodes nicht korrekt (z.B. nicht am Endstück der Straße)

Die Funktion ist jetzt rechts (4. Spalte) und hat die kleinste Schriftgröße mit Tahoma, um nicht so viel Platz wegzunehmen. Spoiler wäre perfekt, aber innerhalb einer Tabelle leider nicht möglich.