Terminal Water Sort

Terminal Water Sort is a command-line water sort puzzle game.

日本語版はこちら

Screenshot

Features

• Vertical bottle rendering with Unicode lines
• ANSI color display with fallback text symbols
• Simple move input in <from> <to> format (example: 1 2)
• Difficulty presets: easy, normal, hard
• Random rounds based on selected difficulty
• Continue playing after clear (n for next round, q to quit)

Requirements

• Node.js 20+

Quick Start

Run instantly (recommended)

npx terminal-water-sort

Install as a command

npm install -g terminal-water-sort
terminal-water-sort

How to play

• Goal: every bottle must be either empty or full with one color only
• At startup, choose a difficulty (easy, normal, hard, default: normal)
• Move input: 1 2 means pour from bottle 1 to bottle 2
• A move is valid when:
  • source bottle is not empty
  • destination bottle has free space
  • destination is empty, or top colors match
• Continuous top layers of the same color move together as much as possible
• After clear, the game stays open (n for next round, q to quit)

Difficulty profiles

• easy: 10 bottles (8 full + 2 empty)
• normal: 10 bottles (5 full + 4 partial(3 layers) + 1 empty)
• hard: 14 bottles (9 full + 4 partial(3 layers) + 1 empty)

Commands

• 1 2 pour from bottle 1 to bottle 2
• r restart current round
• n start a new random round
• d change difficulty and start a new round
• help show command list
• q quit game

License

MIT License. See LICENSE.