Metadata-Version: 2.4
Name: ledblast
Version: 1.0.0
Summary: LED BLASTER — terminal colour-shooter game
License: MIT
Project-URL: Homepage, https://github.com/tombribowei01/ledblast
Keywords: game,terminal,curses,cli,arcade
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment :: Arcade
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: windows-curses; sys_platform == "win32"
Dynamic: license-file

# LED BLASTER

A fast-paced terminal colour-shooter. Orbs fall down the strip — shoot the matching colour beam to destroy them before they reach the bottom.

```
pip install ledblast
ledblast
```

## Controls

| Key | Action |
|-----|--------|
| `R` | Fire RED beam |
| `G` | Fire GREEN beam |
| `B` | Fire BLUE beam |
| `Y` | Fire YELLOW beam *(unlocks at level 4)* |
| `M` | Fire MAGENTA beam *(unlocks at level 7)* |
| `C` | Fire CYAN beam *(unlocks at level 10)* |
| `P` | Pause / unpause |
| `Q` | Quit |

## How to play

- Orbs (`●`) fall **down** the strip in one of up to 6 colours
- Press the matching colour key to fire a beam (`▲`) upward
- Hit an orb with the **same colour** → destroy it, score points
- Hit an orb with the **wrong colour** → lose a life
- Miss an orb (it reaches the bottom) → lose a life
- You have **3 lives** — don't waste them
- Build combos by hitting orbs back-to-back for bonus points

## Difficulty

Select before starting with `1` / `2` / `3`:

- **Easy** — slower orbs, generous spawn rate
- **Normal** — default balance
- **Hard** — fast orbs, rapid spawns

## Progression

- Levels up every 6 points — orbs get faster and spawn quicker
- New colour lanes unlock at levels 4, 7, and 10
- Your best score is saved between sessions (`~/.ledblast_best`)

## Requirements

- Python 3.8+
- A terminal with colour and Unicode support
- On **Windows**: use [Windows Terminal](https://aka.ms/terminal) for best results (`windows-curses` is installed automatically)

## Install from source

```bash
git clone https://github.com/tombribowei01/ledblast
cd ledblast
pip install -e .
ledblast
```
