Back to all projects Project

Tetris TUI

A pure- Tetris with NES-style and modern rule sets, a curses terminal , an optional pygame , a heuristic bot, deterministic replays, and local and network versus play.

2026 Game developer
  • Python
  • curses
  • pygame
  • TCP
  • Game
Tetris TUI project cover

What it is

Tetris TUI is a terminal Tetris with two rule sets. The default is NES-style: a 10×20 well, NES gravity and scoring, and no wall kicks. An opt-in modern adds 7-bag randomization, SRS rotations and kicks, hold, ghost piece, and hard drop. There is a bot demo mode, deterministic replays, local two-player versus with garbage attacks, network versus over TCP, and an optional pygame window.

Design

The central rule is that the rules engine stays deterministic and easy to test. Impure concerns are quarantined by module: curses for the terminal , pygame for the optional GUI, and sockets and threading for networking. That separation keeps the core covered by a plain stdlib test suite while the frontends can change freely.

Why it exists

Like its Snake sibling, this game is also a plugin evaluation project. Most implementation tasks were written as local issue files and delegated through model profiles, with orchestration and review handled by a stronger . The game is the deliverable; the issue tracker and orchestration notes in the repository document how the delegation experiment was run.

Current state

Active and public, tested against Python 3.14.