at.turtleme.game.sweepReef

turtleme.at

Documentation

Sweep one patch of the reef, or the handful a chord opens, in the order given. What comes back is the patches that opened and what each one counts, which is everything a board needs to be drawn and nothing more. Sweeping a patch with a turtle under it wakes the shoal and ends the board, and only a board swept clean pays anything. Requires an atproto service auth token addressed to did:web:turtleme.at#turtle_game and naming this method, so a token issued for one call cannot be spent on another.

main procedure

Sweep one patch of the reef, or the handful a chord opens, in the order given. What comes back is the patches that opened and what each one counts, which is everything a board needs to be drawn and nothing more. Sweeping a patch with a turtle under it wakes the shoal and ends the board, and only a board swept clean pays anything. Requires an atproto service auth token addressed to did:web:turtleme.at#turtle_game and naming this method, so a token issued for one call cannot be spent on another.

Input

Encodingapplication/json
netted array Optional

Where the player's nets are. They are the player's own marks and are not kept here; they are sent because a net stops a sweep spreading, the way a flag does. Leaving them out only opens more of the caller's own board.

maxLength: 256 items
patches array Required

Which patches to sweep, in order. Sweeping stops at the first one that wakes the shoal.

maxLength: 9 itemsminLength: 1 items

Output

Encodingapplication/json
Schemaat.turtleme.game.defs#state
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "patches"
      ],
      "properties": {
        "netted": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 0
          },
          "maxLength": 256,
          "description": "Where the player's nets are. They are the player's own marks and are not kept here; they are sent because a net stops a sweep spreading, the way a flag does. Leaving them out only opens more of the caller's own board."
        },
        "patches": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 0
          },
          "maxLength": 9,
          "minLength": 1,
          "description": "Which patches to sweep, in order. Sweeping stops at the first one that wakes the shoal."
        }
      }
    },
    "encoding": "application/json"
  },
  "output": {
    "schema": {
      "ref": "at.turtleme.game.defs#state",
      "type": "ref"
    },
    "encoding": "application/json"
  },
  "description": "Sweep one patch of the reef, or the handful a chord opens, in the order given. What comes back is the patches that opened and what each one counts, which is everything a board needs to be drawn and nothing more. Sweeping a patch with a turtle under it wakes the shoal and ends the board, and only a board swept clean pays anything. Requires an atproto service auth token addressed to did:web:turtleme.at#turtle_game and naming this method, so a token issued for one call cannot be spent on another."
}

Lexicon Garden

@