Logging, Events & Diagnostics
IModLogger emits owner-tagged messages through ModAPI and BepInEx:
mod.Log.Info("Content", "Registering Ember Axe.");
mod.Log.Warning("Compatibility", "Optional dependency was not found.");
mod.Log.Error("Content", error);
FTK2API.Diagnostics.DumpState returns a text-only main-thread snapshot containing versions, lifecycle state, game-data generation, registered owners, subscribers, active content, patch state, and recent diagnostics.
- Confirm
API_INITIALIZEDand versions. - Confirm the consumer's
MOD_REGISTEREDentry. - Confirm
GAME_DATA_READYbefore native-template work. - Read the first owner/content error before secondary failures.
- Attach the startup block and relevant context to a bug report.
ExampleMod's numbered PASS/FAIL reporter is a maintainer tool. Consumer mods can use public logging and diagnostics without adopting that internal harness.