xodice

Yahtzee × Tic-Tac-Toe in your terminal.

Two players take turns rolling dice. The combinations they roll determine which squares they can claim on a shared grid. First to complete a winning line wins — but the dice decide what moves are available.

Install

npx xodice

Requires Node.js v20+.

How to Play

1. Enter player names and choose a board size (3×3 or 4×4).
2. Press R to roll all five dice.
3. Press 1–5 to hold individual dice, then R to reroll. Up to 3 rolls per turn.
4. Press D when done rolling. Move the cursor to a highlighted square and press Enter to claim it.
5. If no valid squares exist, your turn is forfeited.
6. First to complete a row, column, or diagonal wins. If both players forfeit on consecutive turns, the higher accumulated score wins.

Controls

| Key | Action | |-----|--------| | R | Roll / Reroll | | 1–5 | Toggle hold on die | | Space | Toggle hold on focused die | | ← → | Move focus between dice | | D | Done rolling | | Arrow keys | Move cursor on board | | Enter | Claim square / Continue / Play again | | W | Wild claim — any square, scores 0 (Wild mode only, once per player) | | Q | Quit |

Board Sizes

| Board | Combinations | Win condition | |-------|-------------|---------------| | 3×3 | Compound number categories (1&4, 2&5, 3&6) + all Yahtzee specials | 3-in-a-line | | 4×4 | All 13 standard Yahtzee categories + Pair, Two Pairs, High Dice | 4-in-a-line |

License

ISC