eisterman
0ca905eb71
Precompute board adjacency and square sets, look up opponents once per move, and cache walks that exclude only the start square. Every game is unchanged for the same seed, checked with agents/scripts/fingerprint_games.py. Plan: skip catch-up 6.9 (D44), stop running the random lineup (D45). Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2.4 KiB
Il Labirinto del Dojo
A small tabletop game (1–2 h, 3–8 players, best at 4), plus the tooling used to design and balance it.
| Document | What it is |
|---|---|
RULES.md |
The rulebook (English working draft). |
board/FORMAT.md |
How the board is written as text. |
agents/plans/ |
Active work plan: decisions, phases, open questions. |
Setup
Requires uv. It installs the pinned Python and all tools:
uv sync
Board
The board is authored as one 8x8 quadrant in board/quadrant.txt (tunnel links in
board/legend.toml) and rotated into the full 16x16 board.
uv run dojo board validate # check the board against the rules, print stats
uv run dojo board render # print the full 16x16 board
uv run dojo board render -o board/board.txt # regenerate the full board file (never edit it by hand)
uv run dojo board validate --quadrant other.txt --legend other.toml # check another draft
validate exits with 0 when the board is fine (warnings allowed), 1 on rule violations,
2 when the file is malformed or missing.
Simulation
Plays many seeded games with bots and prints metrics per scenario. Every combination of the
listed values is a scenario; game i of each scenario uses seed --seed + i, and the lineup
rotates one seat per game. Bots: random, casual, balanced, farmer, aggressive
(casual is balanced comparing only 6 random moves of those offered, like a person).
uv run dojo sim # 4 players, current rules, 200 games
uv run dojo sim --games 1000 --csv games.csv # more games; one CSV row per game
uv run dojo sim --lineup casual balanced --summary-csv s.csv # one CSV row per scenario
uv run dojo sim --exam c none a ac # Final Exam options in force (rules: c), combinable
uv run dojo sim --players 3 4 6 8 --start 0 3 # player counts x start position
uv run dojo sim --kiai 2 1 # Kiai +2 vs +1
uv run dojo sim --lineup farmer aggressive,farmer # several lineups (comma-separated seats)
uv run dojo sim --seed 42 --jobs 1 # other dice; single process
Minutes are estimated as 45 s per turn plus 30 s per Kumite.
Development
uv run pytest # tests
uv run ruff check . # lint
uv run ruff format . # format
uvx pyright src tests # type check