Cantlewing

Goal

Guide the mass-2 courier from coordinate -2 to +2 on a five-foothold balance beam by walking and moving two separate seed counterweights. Reach +2 within the move allowance, choose Next Crossing, and repeat the eight-board circuit indefinitely. Only Stop and Bank or spending the third reserve ends a run. There is no clock, final introductory victory, score target or automatic advancement. All five winds, masses, positions and resulting force previews are observable.

Scoring

Award exactly once on entry to cleared: 100 + 10*remainingMoves + (movesUsed===par ? 50 : 0), where remainingMoves = allowance - movesUsed. An optimal crossing 1 or 2 earns 190; every later optimal crossing earns 180. A last-move finish earns 100. The first optimal eight-crossing lap totals 1460, two laps total 2900 and 80 optimal clears total 14420. Failed attempts, restarts, retry, next and bank add no points; an unfinished crossing awards nothing. Previously earned score is retained. There is no speed bonus, score deduction, score clamp, finite victory or stop at the platform's 1000000 submission plausibility guard.

Rules

TRACKS AND FORCE. Coordinates are integers -2,-1,0,1,2. Courier mass is 2, seed A mass 1 and seed B mass 2. Courier footholds and weight sockets are separate tracks: the courier may share a coordinate with either seed; A and B must occupy distinct sockets. Signed force = 2*courier + A + 2*B + wind[courier+2]. A destination is stable when its absolute force is at most 2, inclusive; positive is right-heavy and negative left-heavy. MOVES. {"type":"walk","direction":-1|1} moves the courier exactly one foothold, using destination wind. {"type":"move-weight","weight":"A"|"B","to":-2|-1|0|1|2} transfers one seed to any different unoccupied socket in one move, using current courier wind. Transfers resolve atomically at their destination; no intermediate collision or force sampling occurs and weights may pass each other. Each accepted walk or weight move uses one move. Invalid, unstable, off-board, no-op, occupied, malformed, unknown, extra-field, noninteger or wrong-phase actions change nothing, including reserves, score and counters. PHASES. Playing permits legal walk/weight, restart and bank. Cleared permits next and bank. Retry permits retry and bank. Ended permits nothing. CLEAR AND FAILURE. Reaching +2 awards once and enters cleared; check this before exhaustion, so a last-move finish succeeds. Otherwise using the last move spends one reserve. With reserves left, enter retry; the third spent reserve ends the run with endReason reserves, retaining earned score. {"type":"retry"} restores the same crossing start and full allowance for free, without a second reserve cost. {"type":"restart"} is playing-only, spends one reserve immediately, and restores the same crossing start and full allowance if a reserve remains; the third reset ends the run. BANK. {"type":"bank"} from any live phase ends the run with endReason banked, including at zero score, without partial points or a penalty. NEXT. {"type":"next"} is cleared-only and explicitly starts crossing+1; preserve score, completed count and reserves, reset courier, weights, winds, moves and crossing failures. Fixtures cycle ((crossing-1)%8)+1 forever. Crossing 1 and 2 have allowance par+4, every later crossing par+3. FIXTURES. In coordinate order -2,-1,0,1,2: 1 First Bough starts A=-1,B=2, wind=[0,0,0,0,0], par=6; 2 Needle Breeze A=-2,B=2, wind=[0,1,-1,1,0], par=7; 3 High Canopy A=-1,B=2, wind=[2,0,-2,0,2], par=7; 4 Cedar Bend A=0,B=2, wind=[1,0,1,0,-1], par=7; 5 Lantern Branch A=0,B=2, wind=[-1,0,-1,-1,1], par=8; 6 Crosswind Crown A=1,B=2, wind=[-1,0,-1,0,1], par=8; 7 Fern Passage A=-1,B=2, wind=[-1,0,0,-1,1], par=8; 8 Evening Roost A=1,B=2, wind=[-1,0,0,0,1], par=8. Tolerance is always 2. The seed is accepted for compatibility but never varies this fixed circuit. Replay creates crossing 1, score 0 and three reserves. No undo, skip, tick, random wind, timer, automatic retry, automatic next or terminal win exists.

Action grammar

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "walk"
        },
        "direction": {
          "type": "integer",
          "enum": [
            -1,
            1
          ]
        }
      },
      "required": [
        "type",
        "direction"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "move-weight"
        },
        "weight": {
          "enum": [
            "A",
            "B"
          ]
        },
        "to": {
          "type": "integer",
          "enum": [
            -2,
            -1,
            0,
            1,
            2
          ]
        }
      },
      "required": [
        "type",
        "weight",
        "to"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "next"
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "retry"
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "restart"
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "bank"
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": false
    }
  ]
}

Start a game

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

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