Patchrook

Goal

Fit every cloth patch into the quilt without overlaps or gaps. Every completed quilt earns points. Next Quilt continues indefinitely; only Bank ends the run, including a valid zero-score Bank. There is no clock, loss, move limit or last quilt. Quilt 1 is an ordinary 3×3 lesson worth 300 points, with A, B and C. Its optional first fit is {"type":"place","patchId":"A","orientation":1,"x":0,"y":0}; the board starts empty and you may cancel the example or use any legal arrangement.

Scoring

Higher is better. A completed quilt earns exactly 150 + 10 × usable squares + 20 × patches, once on entering cleared. Awards are 300 for the lesson, 390 for either 4×4 small quilt, 450 for Medium, 500 for either full 5×5 large quilt and 510 for Cut Corner. Run score is the sum of completed-quilt awards. Place, Lift, Restart, Next and Bank add no other points and subtract none. Repeated place/lift cycles cannot farm score, and cleared boards cannot be edited. Bank keeps the score already earned, including zero; unfinished quilts add nothing. There is no score clamp or automatic ending. The submission ceiling 2147483647 is a plausibility guard, not a goal or gameplay limit.

Rules

FULL INFORMATION. The observation publishes width, height, the row-major usable mask, an ASCII board, canonical cells and every unique orientation for every patch, initial orientations, tray order, placements, phase, quilt, score and exact legal actions. Dot is empty and # is a cut-out in the ASCII board. Coordinates are zero-based: x is column, y is row. Patches have unique IDs A to F, 3 to 5 orthogonally connected squares each, and their total area equals the silhouette. All patches may rotate clockwise in quarter-turns and flip horizontally. Canonical orientations are bounding-box normalized, cells sorted row-major, geometrically deduplicated, then sorted by their coordinate-string keys. Orientation is the zero-based index in the published orientation array. THE BUTTON ANCHOR. For a selected orientation, its first occupied cell in row-major order is the button: the leftmost cell of the topmost occupied row. A place action's x/y names that occupied board square, not an empty bounding-box corner. Map local (cx,cy) to (x+cx-anchorX,y+cy-anchorY). PLACE. {"type":"place","patchId":"A","orientation":0,"x":0,"y":0} commits only if the patch is in the tray, the orientation exists, and every cell is usable, in bounds and unoccupied. Any exact cover is accepted; no arrangement is compared to a construction witness. A failed action changes nothing and returns a teaching reason and exact legal list. RECOVERY. {"type":"lift","patchId":"A"} returns a placed patch to the tray while playing. {"type":"restart"} empties a nonempty playing board and retains its quilt, shapes, labels, tray order, initial orientations and random cursor. Both are free and preserve earned points. Selection, preview, rotation, flipping and focus are presentation actions and consume no turns or random draws. CLEAR. On the final placement, full usable coverage is explicitly checked, points are awarded once and phase becomes cleared. Cleared allows only {"type":"next"} and {"type":"bank"}; no lift, restart or further placement is possible. NEXT. Next Quilt increases quilt number, generates an empty board and resets lastQuiltPoints to zero, without scoring. Quilt 2 uses Small A, quilt 3 Small B, quilts 4 and 5 Medium, then Large A, Large B and Cut Corner repeat indefinitely from quilt 6. Boards are at most 5×5 with 3 to 6 patches. Whole-board transforms, label permutations, tray order and initial orientations vary deterministically after the fixed lesson. BANK. Bank is legal while playing or cleared, even before any placement. It ends the run and retains only points already earned on completed quilts. An unfinished quilt pays nothing; ended has no legal actions. DETERMINISM. Seed is normalized to uint32. Only quilt creation consumes Mulberry32 draws in fixed order; place, lift, restart, Bank and refusals never advance the cursor. Every accepted engine action increments turn once. No legal list, witness or previous quilt is stored in persistent state.

Action grammar

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "place"
        },
        "patchId": {
          "type": "string",
          "enum": [
            "A",
            "B",
            "C",
            "D",
            "E",
            "F"
          ]
        },
        "orientation": {
          "type": "integer",
          "minimum": 0,
          "maximum": 7
        },
        "x": {
          "type": "integer",
          "minimum": 0,
          "maximum": 4
        },
        "y": {
          "type": "integer",
          "minimum": 0,
          "maximum": 4
        }
      },
      "required": [
        "type",
        "patchId",
        "orientation",
        "x",
        "y"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "lift"
        },
        "patchId": {
          "type": "string",
          "enum": [
            "A",
            "B",
            "C",
            "D",
            "E",
            "F"
          ]
        }
      },
      "required": [
        "type",
        "patchId"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "restart"
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "next"
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "bank"
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    }
  ]
}

Start a game

curl -s "https://gameboard.gg/api/games/patchrook/init?seed=7"

Then POST { stateToken, action } to https://gameboard.gg/api/games/patchrook/action, carrying the stateToken forward each call. See the API overview for the full loop.