Rune Recall

Goal

Clear 5 levels of a rune-matching memory game (Concentration). Each level is a grid of face-down tiles laid out in matching pairs; flip two tiles per turn to find a pair. A matched pair stays face-up; a mismatched pair is shown briefly then turned back face-down — remember what you saw. Match every pair on a level to clear it, then advance. The goal is the highest total score across all 5 levels.

Scoring

Higher is better (descending). Each match scores base points × a combo multiplier (1x for the first match in a streak, ramping to 3x for 5+ consecutive matches; a mismatch resets the combo). Clearing a level with no mismatches banks a perfect bonus, and (because the agent path is untimed — the per-level clock never runs) every cleared level also banks the FULL time bonus. Base points, time bonus, and perfect bonus all grow with the level. A flawless run (every level cleared, zero mismatches) is the maximum, ≤ 30000.

Rules

Levels are 3x2, 4x3, 4x4, 5x4 then 6x4 grids (3,6,8,10,12 pairs). Each tile has an integer id and a hidden rune index; matching tiles share a rune index. A {type:'flip_pair',tileIdA,tileIdB} action reveals two distinct face-down, unmatched tiles and resolves the turn in one step: if their runes match, both stay face-up permanently; if not, the returned observation shows them face-up for THIS turn and they are then turned back face-down. (The agent path is untimed and the start-of-level preview is auto-skipped, so play is fully deterministic per seed.) When every pair on a level is matched, the only legal action is {type:'next_level'}, which banks the time + perfect bonuses and loads the next level — or, after level 5, ends the game. Hidden information: the rune index of every face-down tile is hidden ('?' in the board) until you flip it; the game seed and the set of runes used so far are NOT revealed. Illegal actions (flipping a matched/face-up/nonexistent tile, passing two equal ids, advancing before a level is cleared, or any action after the game is over) are rejected with a teaching error.

Action grammar

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "flip_pair"
        },
        "tileIdA": {
          "type": "integer",
          "description": "id of the first face-down tile to flip."
        },
        "tileIdB": {
          "type": "integer",
          "description": "id of the second face-down tile to flip (must differ from tileIdA)."
        }
      },
      "required": [
        "type",
        "tileIdA",
        "tileIdB"
      ]
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "next_level"
        }
      },
      "required": [
        "type"
      ],
      "description": "Advance to the next level after clearing the current one (only legal when every pair is matched)."
    }
  ]
}

Start a game

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

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