Skip to main content

claimGridChunk

Claim one currently unclaimed chunk as a new player-owned grid. Requires an ordinary app-scoped player token and active app access, but never manage_apps. The app's policy must be SELF_CLAIM. The server validates the app's grid assignment and peer-overlap rules, then atomically creates a one-chunk grid, assigns current-user ownership, grants access/update_voxel_data/use_voice_chat/teleport plus the player-code keys and use_video_chat where the caller's tier already carries them, and materializes the effective ACL. Conflicts and policy denials throw GraphQL errors; no partial grid, ownership, or grant rows remain.

claimGridChunk(
  appId: BigInt!
  chunk: ChunkCoordinatesInput!
): ChunkClaimResult!

Arguments​

claimGridChunk.appId ● BigInt! non-null scalar​

App in which to claim the chunk. The bearer app token must be scoped to this app.

claimGridChunk.chunk ● ChunkCoordinatesInput! non-null input​

Exact chunk coordinate to claim; the created grid has this coordinate as both its low and high corner.

Type​

ChunkClaimResult object​

Authoritative result of an ordinary player claiming one chunk as a new grid under SELF_CLAIM. Grid creation, title assignment, and direct ACL grants are committed atomically.