Skip to main content

SingleActorMessageInput

Input for sending an actor-to-actor message: a message delivered only to the single actor identified by targetUuid. It is spatially routed (the sender must know the destination actor’s chunk), but unlike normal spatial messages it is NOT broadcast to other nearby actors and has no distance/decay.

input SingleActorMessageInput {
  appId: BigInt!
  chunk: ChunkCoordinatesInput!
  targetUuid: String!
  payload: String!
  sequenceNumber: Int
}

Fields​

SingleActorMessageInput.appId ● BigInt! non-null scalar​

The ID of the app the destination actor belongs to.

SingleActorMessageInput.chunk ● ChunkCoordinatesInput! non-null input​

The chunk coordinates of the DESTINATION actor (where the target currently is). The sender must know this.

SingleActorMessageInput.targetUuid ● String! non-null scalar​

The DESTINATION actor’s UUID. The message is delivered only to the client that owns this actor. Must be exactly 32 bytes when encoded as UTF-8.

SingleActorMessageInput.payload ● String! non-null scalar​

The message payload, base64-encoded. Opaque to the server; the sender’s identity (if needed) must be embedded here by the application.

SingleActorMessageInput.sequenceNumber ● Int scalar​

Client-assigned correlation id for this datagram: a uint8 (0-255) that wraps at gameClientBootstrap.sequenceNumberModulo (256); defaults to 0 if omitted. For CORRELATION ONLY — it is NOT an idempotency key and the server does not dedupe replays. Echoed on any GenericErrorResponse for this send, delivered on the udpNotifications subscription.

Member Of​

sendSingleActorMessage mutation