Skip to main content

ActorLeftNotification

The game server has stopped considering an actor present (Buddy v0.25.0). Emitted ONCE, over the actor's last chunk with the replication rings its own updates used, at the moment its presence record is removed -- roughly five seconds after its last update. Not emitted when the actor merely moved to another server. Treat a later ActorUpdateNotification for the same uuid as a rejoin. Received via the udpNotifications subscription.

type ActorLeftNotification {
  appId: BigInt!
  chunkX: BigInt!
  chunkY: BigInt!
  chunkZ: BigInt!
  distance: Int!
  uuid: String!
  leftReason: Int!
  sequenceNumber: Int!
  epochMillis: BigInt!
}

Fields​

ActorLeftNotification.appId ● BigInt! non-null scalar​

The ID of the app the actor was in.

ActorLeftNotification.chunkX ● BigInt! non-null scalar​

The X coordinate of the actor's last chunk.

ActorLeftNotification.chunkY ● BigInt! non-null scalar​

The Y coordinate of the actor's last chunk.

ActorLeftNotification.chunkZ ● BigInt! non-null scalar​

The Z coordinate of the actor's last chunk.

ActorLeftNotification.distance ● Int! non-null scalar​

Chunk replication distance (0-8) the notification was fanned out over.

ActorLeftNotification.uuid ● String! non-null scalar​

The unique identifier of the actor that left.

ActorLeftNotification.leftReason ● Int! non-null scalar​

Why the server stopped considering the actor present: 0 = STALE (it stopped updating). 1 is reserved for an immediate server-side release; treat any other value as STALE.

ActorLeftNotification.sequenceNumber ● Int! non-null scalar​

Correlation byte from the datagram tail (always 0 today).

ActorLeftNotification.epochMillis ● BigInt! non-null scalar​

Server-generated epoch milliseconds timestamp.

Implemented By​

UdpNotification union