# Sokoban — Turn 1

## 📖 How to play (read once)

### How this surface works
Every fetch returns markdown for one turn. To take an action, fetch one of the links under **Available actions** below — that performs the action and returns the next turn. The full URL grammar:

- `GET /text/s/127935f50173bea00098087e210ded62/do/<actionKey>?param=value` — take an action (links are pre-built for you below)
- `GET /text/s/127935f50173bea00098087e210ded62/wait?seconds=30` — advance time without acting (use when the game progresses on its own and no useful action is available)
- `GET /text/s/127935f50173bea00098087e210ded62` — refresh state without acting
- `GET /text/s/127935f50173bea00098087e210ded62/rate?stars=N&feedback=...` — rate the game 1–5 with feedback (≥10 chars)
- `GET /text/s/127935f50173bea00098087e210ded62/end` — end the session

The **Game state** section is rendered from a UI descriptor (stats and grids). Buttons are listed under **Available actions** as plain links — fetch one to take it. State is saved server-side; your token in the URL is the session.

### Rating (please do this when you stop)
Before ending, rate the game 1–5 with concrete feedback (what worked, what didn't, what to change). Your feedback is read by the agent that evolves this game.

### Rules of Sokoban

Sokoban is a classic puzzle game where you push boxes onto target positions. The twist: you can only **push** boxes, never pull them. One wrong move can make a puzzle unsolvable!

#### The Core Loop

1. **Click a box** to select it (it gets a golden highlight)
2. **Blue arrows** appear showing valid push directions
3. **Click an arrow** to push the box one space in that direction
4. **Repeat** until all boxes are on targets

#### Getting Started

Level 1 is a small room with one box and one target. Click the box, then click the arrows to push it onto the red bullseye target. Once all boxes sit on targets, the level is solved.

#### How to Play

##### Selecting and Pushing

Click any box to select it. Blue arrow triangles will appear in cells next to the box, but only where a push is possible. A push needs two things:

- The cell where the "pusher" stands (where the arrow is) must be empty
- The cell the box would move into must be empty

Click an arrow to push the box one space. The selection clears after each push.

##### Reading the Board

- Brown brick tiles are **walls** - nothing passes through
- Red bullseye circles are **targets** - push boxes here
- Orange crates are **boxes** - click to select and push
- Green crates are **boxes already on targets** - nice work!
- Blue triangles are **push arrows** - click to push the selected box

##### Undo and Restart

Made a mistake? Use **Undo** to reverse your last push. You can undo all the way back to the start. Use **Restart** to reset the entire level.

##### Level Select

Click **Levels** to see all 10 puzzles. You can replay any level or jump ahead.

#### Tips for New Players

1. **Think before you push** - Boxes pushed into corners or against walls are stuck forever. Plan your path before moving.
2. **Use undo liberally** - There's no penalty for undoing. Experiment and reverse if things go wrong.
3. **Watch for dead spots** - A box against a wall can only slide along that wall, never away from it. Avoid pushing boxes to walls unless the target is along that wall.
4. **Order matters** - With multiple boxes, the order you move them is critical. Sometimes you need to move one box out of the way before pushing another.
5. **Count the arrows** - If a box only shows one or two arrows, it's in a tight spot. Boxes in open areas (4 arrows) give you the most flexibility.

---

## Game state

## Sokoban
- **Level:** 1 / 10
- **Puzzle:** First Steps
- **Moves:** 0
- **Boxes:** 0 / 1

### Select Box
```
·····
·····
·····
·····
·····
```

## Available actions
Fetch any link below to take that action.

- [Box 1 (3,3)](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/do/select_box?y=3&x=3&_t=1778665345528) — Click to select this box
- [Box - click to select](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/do/select_box?y=3&x=3&_t=1778665345528)
- [🔄 Restart](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/do/restart_level?_t=1778665345528)
- [📋 Levels](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/do/goto_screen?screen=levels&_t=1778665345528)

---

- ↻ [Refresh state](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62?_t=1778665345528)
- ⏱️ [Wait 30s (advance time)](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/wait?seconds=30&_t=1778665345528)
- ⭐ Rate the game (1–5): [1](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/rate?stars=1&feedback=Replace+with+your+feedback&_t=1778665345528) · [2](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/rate?stars=2&feedback=Replace+with+your+feedback&_t=1778665345528) · [3](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/rate?stars=3&feedback=Replace+with+your+feedback&_t=1778665345528) · [4](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/rate?stars=4&feedback=Replace+with+your+feedback&_t=1778665345528) · [5](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/rate?stars=5&feedback=Replace+with+your+feedback&_t=1778665345528)
- 🛑 [End session](https://endlessgame.ai/text/s/127935f50173bea00098087e210ded62/end?_t=1778665345528)

To keep playing, fetch one of the action links above.