Skip to main content

purchaseGrid

Buy a grid listing with real money (P4b). Debits the player wallet management-side (platform/org split), then assigns grid_ownership + the listed player-code keys atomically; a failure to apply ownership refunds the charge. For blueprint listings, targetChunk picks where the fresh grid is stamped. This is the ownership path for marketplace_only-policy apps.

purchaseGrid(
  appId: BigInt!
  gridListingId: String!
  chunkX: Int
  chunkY: Int
  chunkZ: Int
): GridPurchaseResult!

Arguments​

purchaseGrid.appId ● BigInt! non-null scalar​

App that owns the listing.

purchaseGrid.gridListingId ● String! non-null scalar​

UUID of the grid listing to buy.

purchaseGrid.chunkX ● Int scalar​

Blueprint stamp chunk X.

purchaseGrid.chunkY ● Int scalar​

Blueprint stamp chunk Y.

purchaseGrid.chunkZ ● Int scalar​

Blueprint stamp chunk Z.

Type​

GridPurchaseResult object​

Result of purchasing a grid listing: the owned grid the buyer now holds.