Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Effects

Effects are the small timed spell icons shown by the client. Players often recognize their remaining duration by the color of the bar rather than an exact number of seconds. daRPC exposes the same relative stages.

UseRoute or events
Read active effectsGET /clients/{client}/effects
Watch effect changesPersistent effect events

Reading effects

curl "http://127.0.0.1:2626/clients/ZiLo/effects"

Each active effect contains:

  • icon, which identifies the displayed effect
  • duration, which is a relative remaining-time band
Effects {
    observation: ObservationMetadata,
    effects: Effect[]?,
}

Effect {
    icon: u16,
    duration: EffectDuration,
}

From longest to shortest, the duration values are:

white, red, orange, yellow, green, blue

These values are not exact timers. The client retains the visible phase, so daRPC does not invent a remaining number of seconds.

The initial baseline reads the client’s ten effect slots. Later effect updates keep the retained resource current without another complete memory capture.

Effect events

The complete payload structures are in Persistent effect events.

EventMeaningData
effect.addedA new icon became active.icon, duration
effect.changedAn active icon moved to another duration band.icon, new duration
effect.removedThe icon expired or was cleared.icon

Effects are identified by icon. A removed event has no duration because the effect is no longer active.

Availability

effects: null means the effect slots were unavailable. An empty array means the slots were read successfully and no effects were active.