Core API Overview

The core API gives each registered mod an owner-scoped IModContext. It provides:

• IModLogger for structured logging;
• IModEvents for game-data lifecycle events;
• IItemService for read-only native item lookup and value registrations;
• ICustomItemService for custom definitions and activation;
• ICustomAbilityService for custom abilities;
• ILocalizationService for owner-scoped English text.

Runtime evidence covers initialization, versions, main-thread identity, diagnostics, registration, dependency metadata, ownership isolation, GameDataReady delivery, generation changes, and cleanup.

Core rules

1. Register one stable mod owner.
2. Use that owner's namespace for every custom ID.
3. Subscribe during Awake; events are not replayed.
4. Call runtime services on Unity's main thread.
5. Keep activation and subscription handles for deterministic cleanup.
6. Remove dependent items before the abilities they reference.

See Registration & Ownership, Lifecycle & Events, and Logging & Diagnostics.