clone

fifteen puzzle games for the terminal, with daily puzzles, weekly ladders and xp, built on bubble tea

main
puzzletea / games / hashiwokakero
README.md

Hashiwokakero

Connect islands with bridges to form a single connected group.

Hashiwokakero gameplay

How to Play

Islands are numbered circles on the grid. Each number indicates how many bridges must connect to that island. Bridges run horizontally or vertically between adjacent islands, may not cross, and can be single or double. The puzzle is solved when every island has exactly the required number of bridges and all islands are connected.

  1. Navigate to an island and press Enter or Space to select it.
  2. Press an arrow key toward an adjacent island to build a bridge.
  3. Press the same direction again to upgrade to a double bridge, or a third time to remove the bridge.
  4. Press Enter or Space again to deselect.

Controls

Key Action
Arrow keys / WASD / hjkl Jump to nearest island
Mouse left-click Focus a clicked island
Enter / Space Select island for bridging
Ctrl+R Reset puzzle
Ctrl+H Toggle full help
Escape Return to main menu

Bridge Mode (after selecting an island)

Key Action
Arrow keys / WASD / hjkl Build or cycle bridge in direction
Enter / Space Deselect island

Modes

Mode Grid Islands Description
Easy 7x7 7x7 8-10 Small grid, few islands
Medium 7x7 7x7 12-15 Moderate density
Hard 7x7 7x7 17-20 Dense island placement
Easy 9x9 9x9 12-16 Larger grid, spread out
Medium 9x9 9x9 20-24 Moderate density
Hard 9x9 9x9 28-32 Dense island placement
Easy 11x11 11x11 18-24 Large grid, spread out
Medium 11x11 11x11 30-36 Moderate density
Hard 11x11 11x11 42-48 Dense island placement
Easy 13x13 13x13 25-34 Largest grid, spread out
Medium 13x13 13x13 42-51 Moderate density
Hard 13x13 13x13 59-68 Dense island placement

Elo Difficulty

Named modes are compatibility presets. Use --difficulty <0..3000> to target a specific Elo difficulty for generated puzzles.

Quick Start

puzzletea new hashi easy-7x7
puzzletea new hashi medium-9x9
puzzletea new hashi hard-13x13