Skip to main content

Actor

No description

type Actor {
  uuid: ID!
  appId: BigInt!
  userId: BigInt!
  avatarId: BigInt
  chunk: ChunkCoordinates!
  privateState: String
  publicState: String
  createdAt: DateTime!
  updatedAt: DateTime!
}

Fields​

Actor.uuid ● ID! non-null scalar​

Actor id and primary key: a 32-character ASCII identifier (exactly 32 ASCII characters / 32 raw octets on the UDP wire). This is NOT a hyphenated RFC-4122 UUID. This is the value accepted by all actor uuid arguments.

Actor.appId ● BigInt! non-null scalar​

App (game) this actor belongs to. BigInt serialized as a decimal string.

Actor.userId ● BigInt! non-null scalar​

Owner user id. BigInt serialized as a decimal string. Ownership gates writes and access to privateState.

Actor.avatarId ● BigInt scalar​

Avatar this actor is using, or null. BigInt serialized as a decimal string.

Actor.chunk ● ChunkCoordinates! non-null object​

Chunk-grid coordinates (x, y, z as int64 BigInt decimal strings) locating the actor in the world.

Actor.privateState ● String scalar​

Owner-only private state blob, base64-encoded binary. Stripped (returned null) for non-owners and in public/batch reads such as batchLookupActors.

Actor.publicState ● String scalar​

Public state blob, base64-encoded binary; visible to all viewers.

Actor.createdAt ● DateTime! non-null scalar​

Server timestamp (ISO-8601) when the actor row was created. Used as the primary ordering key for host election (oldest fresh actor wins).

Actor.updatedAt ● DateTime! non-null scalar​

Liveness timestamp (ISO-8601), refreshed by the actorHeartbeat mutation. Host election treats actors with a recent updatedAt as fresh; stale rows age out of eligibility.

Returned By​

actor query ● actors query ● batchLookupActors query ● createActor mutation ● deleteActor mutation ● updateActor mutation ● updateActorState mutation

Member Of​

ActorEdge object