Files
ProLibertateGames/docs/RULES-meowdoku.md
Claude 7942adeaf7
CI / Build and check (pull_request) Successful in 10m1s
CI / Deploy to Cloudflare Pages (pull_request) Skipped
Meowdoku: rules, AI and screen refinements
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01S8evMuUxrft6TQj6NdAoqQ
2026-10-26 01:14:45 +00:00

99 lines
4.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Meowdoku
A board of colours, and a cat in every row, column and colour — no two sharing
even a corner.
## The puzzle
The board is **N by N** and coloured into **N regions**. Exactly one cat hides
in every row, every column and every region, and no two cats may touch — not
along a side and not at a corner, so a cat rules out all eight squares around
itself. Those four constraints together always leave exactly one arrangement.
Uniqueness is not decoration. The game is deduction, and a second answer means
a square the player cannot prove either way. Every board is therefore generated
and then searched: build the colours, count the ways a board can be answered,
and if it is more than one, throw the board away and deal another. The count is
a plain depth-first search over the rows with the obvious exclusions propagated,
and it sees only the colours and the rules — never the cats it was grown from.
## Playing it
Controls are the original's, and they carry the game's whole psychology:
- **One tap crosses a square over.** Free, instant, erasable — the note you
make while thinking.
- **A second tap on the same square within 350 ms is the cat attempt.** The
board judges it against the answer it was dealt: correct, the cross is
replaced by a cat; wrong, the cross stays and a heart goes. This is why a
guess feels like a decision: your own note has to survive one more tap
before it becomes a bet.
- **Drag to cross a line.** The stroke paints the same note every square it
enters: start on a blank square and it crosses the row or column you drag
along; start on a crossed square and the stroke erases them instead. Cats
are skipped — placed cats are permanent.
A square you pencilled over can still be tapped for a cat, and the cross is
forgiven: the attempt replaces it if it is right. The one thing no gesture
undoes is a cat once placed.
The original ships a fifth gesture — a **draft** scratchpad mode, a tool you
buy, where crosses and cats are laid down without judgement and applied all at
once — and it is left out here with the rest of the shop: a scratchpad whose
notes cost nothing is what tapping already is.
A **Hint** spends a token and shows the cat in the first row that still lacks
one, replacing any cross drawn over it. The original sells these as tools; here
they are simply counted, three per board by default, which keeps the hint a
decision rather than a reflex.
## The heart
Why a wrong tap costs anything at all: the puzzle is only hard if guessing is.
A board with no penalty is a board you can solve by tapping every square, and
the hearts are what make the deduction on a colour you have not reasoned about
yet feel like a choice. Three is the number the original deals, and it stays
three by default.
## Options
| | |
| --- | --- |
| **Board** | 4×4 up to 10×10; the number of cats equals the side |
| **Hearts** | 1 to 5, default 3 |
| **Hints** | 0 to 3, default 3 |
Boards are dealt from the table's seed, so a saved game resumes to the same
cats in the same colours, and **New puzzle** moves the seed to deal a different
board. Smaller sides are gentler: a 4×4 is the shortest way to learn what
no-touch does to a corner, and the ten-wide boards are for people who have
already made that mistake.
## How a board is dealt
The order matters, and it is the order the original game uses:
1. **Settle the cats first.** One per row, one per column, no two touching,
chosen by backtracking over shuffled column orders.
2. **Grow the colours around them.** Each region starts as its cat's square and
expands outwards one square at a time; some regions are grown as straight
bars along the cat's row or column, which is what stops the board reading as
texture, and the rest take whichever neighbour is smallest so nothing
sprawls while another dies young.
3. **Check the answer.** Count solutions up to two; keep the board only when
the count comes back exactly one.
The generator's rejection loop is why the same seed can take a few attempts:
most boards are unique on the first try, and the odd seed has to walk until it
finds one.
## Where this engine differs from the original
The app is a game collection, not a live-service puzzle, so what sits around
the original's gameplay is left behind: lives-as-monetisation (watching an ad
for a heart), daily streaks and leaderboards, an Elo-matched bank of
hand-authored levels, and the cosmetic layer (cat animations, combo feedback,
confetti). This engine **deals its boards from a seed** instead of shipping a
level bank, and the rules are the part worth keeping: the cats, the colours,
the no-touch, the hearts, the one answer.