Metadata-Version: 2.4
Name: falliant
Version: 2.0.0
Summary: A terminal block stacking game with Classic (NES) and Modern (guideline) modes
Author-email: Henry Sowell <henry@homelab.engineering>
License-Expression: MIT
Project-URL: Homepage, https://github.com/veteranbv/falliant
Project-URL: Changelog, https://github.com/veteranbv/falliant/blob/main/CHANGELOG.md
Project-URL: Bug Tracker, https://github.com/veteranbv/falliant/issues
Keywords: tetris,game,terminal,curses,tui,arcade,puzzle,retro
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Games/Entertainment :: Puzzle Games
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: windows-curses; platform_system == "Windows"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Dynamic: license-file

# Falliant

A terminal block stacking game with a genuine arcade soul. Two complete rule sets, pure Python standard library, zero dependencies.

![Falliant Demo](https://raw.githubusercontent.com/veteranbv/falliant/main/docs/demo.gif)

## Quick Start

```bash
pip install falliant
falliant
```

## Two Modes

- **Classic (1989)**: faithful NES rules. Re-roll randomizer, no wall kicks, instant lock, NES scoring and speed curve, kill screen at level 29.
- **Modern (2006+)**: guideline rules. 7-bag randomizer, SRS wall kicks, hold, ghost piece, hard drop, lock delay, T-spins, combos, back-to-back, perfect clears.

Clear four lines and the game says its own name: **FALLIANT!**

## Controls

- **← → / A D**: move, **↓ / S**: soft drop
- **↑ / W / X**: rotate clockwise, **Z**: counter-clockwise
- **Space**: hard drop, **C**: hold (Modern mode)
- **P**: pause, **Q**: quit to menu

## Features

- Separate top-10 leaderboards per mode with arcade-style initials entry
- Line clear flash animations and score callouts (T-SPIN! B2B! PERFECT CLEAR!)
- Flicker-free rendering and input handling built for fast play
- High scores stored per user, shared across every directory you play from

Requires Python 3.9+ and a color terminal at least 60x24.

Source, issues, and contributions: [github.com/veteranbv/falliant](https://github.com/veteranbv/falliant)
