Skip to main content

updateChunkState

Upserts ONLY the opaque base64 chunk-level state blob for a chunk, preserving its voxels, per-voxel states and LODs; returns the updated chunk (or null if it could not be written). WRITES world state. Requires a valid bearer token AND the manage_apps permission on the org that owns input.appId (super admins bypass).

updateChunkState(
  input: UpdateChunkStateInput!
): Chunk

Arguments​

updateChunkState.input ● UpdateChunkStateInput! non-null input​

Type​

Chunk object​

A persisted 16x16x16-voxel chunk (4096 voxels) of an app's voxel world. Holds the packed voxel-type grid (voxels), sparse per-voxel state overrides (voxelStates), an optional opaque chunk-level state blob (chunkState), and level-of-detail meshes (lods). Returned by getChunk/getChunksByDistance and written by updateChunk/updateChunkState/updateChunkLods.