- commit
- 9af24693b428564ef11ba8d7b25c81c18c9f70cf
- parent
- 0c32ee22b85aedcb67ceeff288ae7031c198dd26
- author
- Dami <dami.etoile@gmail.com>
| M | README.md | 21 | ++++++++++-- |
| M | takuzuplus/ | 53 | ++++++++++++++++++++++++++++-- |
@@ -2,7 +2,7 @@
22 33 A terminal-based puzzle game collection built with [Bubble Tea](https://github.com/charmbracelet/bubbletea).44 5-Twelve puzzle types, multiple difficulty modes, daily challenges, XP progression, 365 color themes, and an explicit game catalog for adding new games.5+Twelve puzzle types, multiple difficulty modes, daily and weekly deterministic challenges, XP progression, 365 color themes, and an explicit game catalog for adding new games.66 77 88 @@ -10,8 +10,9 @@ Twelve puzzle types, multiple difficulty modes, daily challenges, XP progression
1010 1111 - **12 puzzle games** -- Fillomino, Nonogram, Nurikabe, Ripple Effect, Sudoku, Shikaku, Word Search, Hashiwokakero, Hitori, Lights Out, Takuzu, Takuzu+1212 - **Daily puzzles** -- A unique puzzle generated each day using deterministic seeding. Same date, same puzzle for everyone. Streak tracking rewards consecutive daily completions.13-- **XP and leveling** -- Per-category levels based on victories. Harder modes yield more XP. Daily puzzles grant 2x XP.14-- **Stats dashboard** -- Profile level, daily streak, victory counts, and XP progress bars per category.13+- **Weekly gauntlet** -- Each ISO calendar week has a shared 99-puzzle ladder. The current week unlocks sequentially from `#01` to `#99`; past weeks can be reviewed from completed saves only.14+- **XP and leveling** -- Per-category levels based on victories. Harder modes yield more XP. Daily puzzles grant 2x XP, and weekly puzzles add slot-based bonus XP.15+- **Stats dashboard** -- Profile level, daily streak status, weekly completion progress, victory counts, and XP progress bars per category.1516 - **365 color themes** -- Live-preview theme picker with WCAG-compliant contrast enforcement. Dark and light themes included.1617 - **Mouse support** -- Click and drag in Nonogram, Nurikabe, Shikaku, and Word Search. Lights Out supports click-to-toggle.1718 - **Seeded puzzles** -- Share a seed string to generate identical puzzles across sessions and machines.@@ -82,6 +83,18 @@ Launch the interactive menu:
8283 puzzletea8384 ```8485 86+The Play menu includes:87+88+- `Create` for a new puzzle by category and mode89+- `Continue` for saved games90+- `Daily` for the shared deterministic daily puzzle91+- `Weekly` for the current or historical weekly gauntlet92+- `Seeded` for a custom deterministic seed93+94+Weekly gauntlets use the ISO week-year format shown in the menu, for example95+`Week 10-2026 # 7`. The `#` value is the currently active weekly challenge for96+that week. Current-week puzzles unlock one at a time; older weeks are review-only.97+8598 Start a new game directly:8699 87100 ```bash@@ -185,6 +198,8 @@ Nonogram, Nurikabe, Shikaku, and Word Search support click and drag. Lights Out
185198 186199 Games are automatically saved to `~/.puzzletea/history.db` (SQLite). Navigating away saves progress; quitting with `Ctrl+C` marks the game as abandoned. Completed games are preserved and can be revisited.187200 201+Daily and current-week weekly puzzles keep a single deterministic save per seed/week slot. Completed weekly puzzles from prior weeks reopen in review mode and are not modified when viewed again.202+188203 ## Previews189204 190205 ### Fillomino@@ -1,9 +1,54 @@
11 # Takuzu+22 3-Takuzu+ keeps the classic Takuzu rules and adds fixed relation clues between adjacent cells.3+Fill the grid with two symbols while obeying the normal Takuzu rules plus fixed relation clues.44 5-- `=` means the two cells must be equal.6-- `x` means the two cells must be opposite.5+76 8-The controls match classic Takuzu.7+## How to Play98 9+Fill every empty cell with either a filled circle (●) or an open circle (○)10+so that the grid satisfies the standard Takuzu constraints and the relation11+clues placed between neighboring cells.12+13+1. **No triples**: No three consecutive identical symbols in any row or column.14+2. **Equal count**: Each row and column must contain exactly half ● and half ○.15+3. **Unique lines**: No two rows may be identical; no two columns may be identical.16+4. **Relation clues**: `=` means the two cells must match. `x` means they must differ.17+18+Pre-filled cells and relation clues are fixed. The puzzle is solved when every19+cell is filled and all four rules are satisfied.20+21+## Controls22+23+| Key | Action |24+|-----|--------|25+| Arrow keys / WASD / hjkl | Move cursor |26+| Mouse left-click | Move to a cell, or cycle the current editable cell |27+| `z` / `0` | Place ● |28+| `x` / `1` | Place ○ |29+| `Backspace` | Clear cell |30+| `Ctrl+R` | Reset puzzle |31+| `Ctrl+H` | Toggle full help |32+| `Ctrl+E` | Toggle debug overlay |33+| `Escape` | Return to main menu |34+35+## Modes36+37+| Mode | Grid | Clues | Notes |38+|------|------|-------|-------|39+| Beginner | 6x6 | ~50% | Relation clues heavily support early deduction |40+| Easy | 6x6 | ~40% | Balanced Takuzu and relation clue logic |41+| Medium | 8x8 | ~40% | Mixed deductions across rows, columns, and clues |42+| Tricky | 10x10 | ~38% | Uniqueness and clue interactions matter |43+| Hard | 10x10 | ~32% | Longer deduction chains |44+| Very Hard | 12x12 | ~30% | Sparse givens with tighter clue reading |45+| Extreme | 14x14 | ~28% | Largest board and deepest logic |46+47+## Quick Start48+49+```bash50+puzzletea new takuzu-plus beginner51+puzzletea new takuzu-plus medium52+puzzletea new takuzu-plus extreme53+puzzletea new binario+ hard # alias54+```