User Manual

Every screen, and what it does

The game teaches its own rules — the in-app tutorial walks through all of them with stones moving on a demo board, and the companion book under Help goes as deep as anyone could want. This page is the reference for everything else: the buttons, the settings, and the study tools, with pictures. It reads top to bottom, but every section stands alone.

The game screen

The main game screen: two score cards above the carved wooden board, a row of round control buttons below
The whole game on one screen: score cards, board, controls.

Each player has a card showing their captures out of the five pairs that win, and a small badge marks whose turn it is. Tap any intersection to place a stone. The row of buttons under the board (beside it, on a bigger screen):

Choosing an opponent and rules

The Settings sheet: Opponent picker with Human, AI, and Online; the four difficulty tiers Novice, Apprentice, Journeyman, Artisan; the rules variants below
Opponent, tier, and rules — the Game tab of Settings.

Settings is four tabs — Game, Study, Board, and Sound — so nothing hides down a long scroll. The Game tab holds the opponent: pass-and-play with a Human beside you, the AI, or an Online match through Game Center. Against the AI you choose which color it plays and which rung of the workshop ladder you face — Novice, Apprentice, Journeyman, or Artisan, each described in a line under its name. The Opponents page tells you who they are.

Below that, the rules: Standard, Keryo-Lapilli (triplet captures count too, first to fifteen stones), and the Tournament variants that restrict the first player's second stone. Changing opponent or rules mid-game asks before it discards the board.

Hints that explain themselves

The game screen with a dashed golden ring on the suggested square and a caption reading: Nothing is forced here. This builds shape and keeps the initiative.
With Explain Hints on, the ring gets a reason.

The Hint button always rings a square. Turn on Explain Hints — on the Study tab of Settings — and each hint also says why, in one line of the language the companion book teaches: this wins outright, this blocks a loss, this answers an open three, this threatens a capture, or nothing is forced and this builds shape. It's off by default; the ring alone is there for players who just want a nudge.

The Study section of Settings: Your Games, Practice Board, The Mirror, and the Explain Hints toggle
The Study tab of Settings — the next three chapters live here.

Your Games — the walk-back

Every game you finish is recorded automatically, from the day you installed the game — and the archive travels between your devices through your own iCloud, so a game finished on the phone appears in Your Games on the Mac. The Study section's Your Games is where they live: every finished game, newest first, with its date, length, and how it ended.

The Your Games list: three finished games with dates, move counts, and outcomes
Every finished game, kept.
The walk-back: a mid-game position with a ring on the reviewed move, the reading 'The opponent could win on the very next move; this takes that away', the Artisan's suggestion, and a move slider
Move 20 of 37, with the position's reading and the Artisan's opinion.

Open one and walk through it with the slider or the arrows. Under the board, every move carries a one-line reading: what it did, what it answered — and, honestly, where a threat demanded an answer that never came. Ask the Artisan and the strongest opponent thinks about the position for a few seconds and tells you what it would have played. Nothing is computed until you ask. And any recorded game exports from here — the same Export button the live game has, sharing the same .lapilli file.

The Practice Board

The Practice Board in Play mode with a book problem loaded, a dashed ring on the winning square, and the caption: The Artisan would play J10. This wins the game outright.
A book problem on a real board, with the Artisan's explained answer.
The problems menu listing the book's Chapter 15 problems, the solved one marked with a checkmark
The book's fifteen problems. Solved ones wear a mark.

A free board with two bowls beside it, in the Study section. It has two modes, and the difference is the whole idea:

The eraser removes any single stone. The note field keeps whatever you learned, and the whole board — position, note, and all — is exactly where you left it next time. The book menu in the corner opens any of the companion book's fifteen problems on the board; find a problem's published answer in Play mode and it's remembered with a checkmark. And Ask the Artisan works here too — on the Practice Board, the explanation always shows, because practice is where the vocabulary is learned.

The Mirror

The Mirror: a line chart of mistake rates per hundred moves across games, a legend of three categories, and a list of flagged moves with explanations
Three kinds of mistake, charted oldest game to newest — this one is fading.

The Mirror reads back through every finished game against the AI on your device and charts the mistakes you repeat, as a rate per hundred of your own moves, oldest game to newest — so you can see whether they're fading as you improve. It counts exactly three things, and all of them are facts the record proves, never an engine's opinion:

A threat you ignored that the opponent never punished is deliberately not counted. And every flagged move opens in the walk-back at that exact position, ring on the move, so you can judge the claim on the board yourself. The analysis runs entirely on your device and is cached, so the Mirror opens instantly after the first look.

Zoom and pan on the phone

Nineteen lines each way is a lot of board for a hand's width of glass. On iPhone and iPad, pinch to zoom into the part of the board where the fight is happening — stones become comfortably tappable — then drag with one finger to follow the action. Placing stones works the same while zoomed, and the fit button in the corner returns the whole board in one tap. Most players zoom in early and stay there. The Practice Board zooms the same way.

Records, sound, appearance, online play

Where your games live

On your devices. Recorded games travel between your own machines through your own iCloud, the same way your win/loss tallies do; practice positions and the Mirror's analysis are files on the device that made them, read by that device. We run no servers and never see any of it. The full policy is one page: Privacy.

Something unclear, or missing from this page? Write to lapilli-stones@proton.me — the manual, like the game, improves by letter.