Status Core

Status Core is a developer library for registering and applying authoritative timed player statuses. It owns duration, refresh, expiration, server ticks, owner synchronization, and integration with Native Status UI. It does not add gameplay statuses by itself.

Developer API

Register a StatusDefinition once, then apply it from authoritative server code with StatusApi.Apply(...). Reapplying the same status to the same player refreshes its duration and replaces its source. Providers implement status-specific behavior through callbacks or by querying StatusApi.IsActive(...) from their game hooks.

StatusApi.Register(new StatusDefinition(
    id: "YourTeam.YourMod.Bleeding",
    displayName: "Bleeding",
    iconPng: iconBytes,
    color: new Color(0.5f, 0.08f, 0.18f),
    tickInterval: 1f,
    onTick: context => Damage(context.Target, context.Source)));

// Call from validated server-authoritative gameplay code.
StatusApi.Apply(victim, "YourTeam.YourMod.Bleeding", 6f, attacker);

StatusApi.Remove(...), IsActive(...), and TryGet(...) provide lifecycle and query access. Status Core synchronizes only presentation and timing to the affected player's client; gameplay callbacks execute on the server. Native Status UI remains the rendering layer.

In multiplayer, every participant using a dependent status provider must install Status Core, Native Status UI, and that provider. Status IDs and definitions must match across the lobby.

The initial API intentionally supports one active instance per player and status. Stack and charge policies are deferred until a real status requires them.

AI Disclosure

This mod was developed with assistance from generative AI for programming, documentation, and promotional artwork. The author reviewed, tested, and approved the final implementation and assets.