Skip to main content

sendActorUpdate

Send an actor (player/NPC) state update for spatial replication to nearby chunks. Requires a bearer game token; opens a UDP proxy session automatically if none exists. Returns Boolean! that is true only when the datagram was ACCEPTED FOR SENDING to the game server — it does NOT confirm the world applied the update. There is NO separate per-request success response: the game server fans the update out to every client in the target chunk INCLUDING the sender, so you observe your own applied update as an ActorUpdateNotification carrying the same sequenceNumber (ActorUpdateResponse is legacy and is never emitted). Failures arrive ASYNCHRONOUSLY as a GenericErrorResponse; both are correlated by the request sequenceNumber (correlation only — not an idempotency key; the server does not dedupe replays). Subscribe to udpNotifications before sending so the self-notification/error is not missed.

sendActorUpdate(
  input: ActorUpdateRequestInput!
): Boolean!

Arguments​

sendActorUpdate.input ● ActorUpdateRequestInput! non-null input​

The actor update to send: target appId, chunk coordinates, 32-byte actor uuid, base64 state, and optional distance/decayRate/sequenceNumber. See ActorUpdateRequestInput.

Type​

Boolean scalar​

The Boolean scalar type represents true or false.