Skip to main content

ActorUpdateNotification

Notification received when an actor (player or NPC) state is updated by another client or the server. Received via the udpNotifications subscription.

type ActorUpdateNotification {
  appId: BigInt!
  chunkX: BigInt!
  chunkY: BigInt!
  chunkZ: BigInt!
  distance: Int!
  decayRate: Int!
  uuid: String!
  state: String!
  sequenceNumber: Int!
  epochMillis: BigInt!
}

Fields​

ActorUpdateNotification.appId ● BigInt! non-null scalar​

The ID of the app where the actor is located.

ActorUpdateNotification.chunkX ● BigInt! non-null scalar​

The X coordinate of the chunk where the actor is located.

ActorUpdateNotification.chunkY ● BigInt! non-null scalar​

The Y coordinate of the chunk where the actor is located.

ActorUpdateNotification.chunkZ ● BigInt! non-null scalar​

The Z coordinate of the chunk where the actor is located.

ActorUpdateNotification.distance ● Int! non-null scalar​

Chunk replication distance (0-8) from the original message.

ActorUpdateNotification.decayRate ● Int! non-null scalar​

Decay algorithm (0-5) from the original message.

ActorUpdateNotification.uuid ● String! non-null scalar​

The unique identifier of the actor that was updated.

ActorUpdateNotification.state ● String! non-null scalar​

The actor state data, base64-encoded. Decode this to get the full ActorState containing position, rotation, velocity, animation flags, etc.

ActorUpdateNotification.sequenceNumber ● Int! non-null scalar​

The sender's sequence number for this message (0-255).

ActorUpdateNotification.epochMillis ● BigInt! non-null scalar​

Server-generated epoch milliseconds timestamp.

Implemented By​

UdpNotification union