Ice Slide

Goal

Slide a character across a frozen grid to reach the exit, clearing 20 increasingly tricky levels for the highest total score. On every slide the character glides in the chosen direction and does not stop until it hits a wall, a rock, or the edge of the board — you cannot stop mid-slide. Some levels scatter gems that must all be collected (by sliding over them) before the exit unlocks. Land exactly on the exit, with every gem collected, to clear the level and advance.

Scoring

Higher is better (descending). Each level you clear adds a level score, accumulated into the total: levelScore = (100 + max(0, (par - slidesUsed) * 20) + (slidesUsed === par ? 50 : 0)) * (floor(level / 5) + 1). So fewer slides earn more, hitting par exactly earns a 50-point perfection bonus, and later levels carry a rising multiplier (×1 for levels 1-4, ×2 for 5-9, ×3 for 10-14, ×4 for 15-19, ×5 for level 20). There is no move limit and no lose state — you keep sliding until the level is solved.

Rules

The board is a square grid of cells: '#' wall, 'O' rock (both stop a slide), '.' ice (slide over it), '$' uncollected gem, 'E' exit, '@' you. Rows and columns are 0-indexed (0 = top/left). A {type:'slide',direction} action sends you gliding up/down/left/right until a wall, rock, or edge halts you — you travel the whole run in a single action and any gems on the path are collected automatically. A slide that is blocked immediately (you are already against a wall/rock/edge in that direction) is a no-op and returns a teaching error; getLegalActions lists only the directions that actually move you. Landing on the exit clears the level only when all required gems are collected (otherwise the exit is just ice you slide over). When a level is solved its phase becomes 'won' and the only legal action is {type:'next_level'}, which loads the next level (or, after the final level, ends the run). The game is fully deterministic — the 20 levels are fixed and curated (the seed is accepted but has no effect), and there is no hidden information: the entire grid, every gem, the exit, and your position are always visible.

Action grammar

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "slide"
        },
        "direction": {
          "enum": [
            "up",
            "down",
            "left",
            "right"
          ],
          "description": "Which way to glide. You slide until a wall, rock, or board edge stops you — consult legalActions for the directions that actually move you from your current cell."
        }
      },
      "required": [
        "type",
        "direction"
      ]
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "const": "next_level"
        }
      },
      "required": [
        "type"
      ],
      "description": "Advance to the next level after solving the current one (only legal when the level is 'won')."
    }
  ]
}

Start a game

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

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