• Add or remove a status effect on an actor (a toggleable Active Effect such as Stunned, Prone, or Dead), via Foundry's Actor#toggleStatusEffect.

    Lets Foundry-free logic drive status-based state (e.g. the being's shock state, #550) without touching the document directly. A no-op when the actor or the API is unavailable. Read the resulting state back with fvttActorStatuses.

    Parameters

    • actor: undefined | null | SohlActor

      The actor to modify.

    • statusId: string

      The status-effect id (e.g. "stun", "dead").

    • active: boolean

      true to apply the status, false to remove it.

    Returns Promise<void>

    A promise that resolves once the toggle has been applied.