Skip to main content

claimGridChunk

Claim one wilderness chunk (a chunk no grid but the app's world grid covers) 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. A chunk inside another grid (a plot, a zone or another claim) is refused FORBIDDEN (GRID_NOT_CLAIMABLE): the claim would be the most specific grid there and take the chunk from whoever that grid grants. 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.