Creating Your First Mod

The canonical first-mod tutorial will be generated from FTK2.ModAPI.ExampleMod once the current source tree is connected to the docs build. That is intentional: a tutorial that compiles is more valuable than a hand-written sample with guessed public signatures.

The consumer flow the current runtime tests establish is:

1. Load after the Community Toolkit runtime.
2. Register a mod owner/session.
3. Use the owner context for logging, events and content registration.
4. Give custom content namespaced IDs owned by that same mod.
5. Register definitions before attempting activation or dependent-content activation.
6. Dispose/release owner resources during the supported shutdown path.

A proven test namespace looks like community.example:ember_axe; cross-owner mutation is rejected in the runtime tests.

Important

Do not copy internal implementation names from logs into a consumer mod. Use the generated public SDK reference and the synchronized ExampleMod snippets once source generation is enabled.