Metadata-Version: 2.4
Name: cannon-shooter
Version: 1.1.2
Summary: A keyboard-controlled ASCII arcade cannon shooter CLI game for your terminal.
Author: Priyansh
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Games/Entertainment :: Arcade
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: windows-curses; platform_system == "Windows"

# 🚀 Cannon Shooter

A fast-paced, keyboard-controlled ASCII arcade cannon shooter CLI game built for your terminal!

Defend your territory against falling ASCII blocks `[#]` by operating a ground cannon. As your score increases, the blocks fall faster and spawn more frequently.

---

## ⚡ Quick Start

```bash
pip install cannon-shooter
cannon-shoot
```

That's it — no cloning, no setup. (Windows users: `windows-curses` installs automatically as a dependency.)

---

## 🎮 Controls

| Key | Action |
| --- | --- |
| `A` / `Left Arrow` | Move Cannon Left |
| `D` / `Right Arrow` | Move Cannon Right |
| `Space` / `Enter` | Fire Bullet (`|`) |
| `Q` | Quit Game |

---

## ⚠️ Known Limitations

On some systems, firing (`Space`) may not register while a movement key is held simultaneously, due to a terminal input limitation. If this happens, use **Enter** as an alternate fire key, or tap A/D and Space separately rather than holding both at once.

---

## 🖥️ Recommended Terminals

For optimal rendering, smooth frame rates, and raw keyboard event handling, please run `cannon-shoot` in a dedicated terminal emulator:

- **Windows:** Windows Terminal (`wt.exe`), PowerShell, CMD
- **macOS:** Terminal.app, iTerm2
- **Linux:** GNOME Terminal, Alacritty, Kitty

*(Avoid running inside non-interactive IDE run-consoles or output panes as they may obscure raw keypresses.)*

---

## 🎯 Gameplay & Scoring

- **Scoring:** Destroying a falling box yields **+10 points**.
- **Lives:** You start with **3 lives**. A life is lost whenever a box reaches the bottom border of the screen.
- **Difficulty Scaling:** Every **75 points**, the difficulty increases:
  - Boxes fall faster (reduced frame interval down to minimum floor).
  - Boxes spawn more frequently.
- **Game Over:** When your lives reach 0, the game displays your final score and waits for a keypress before returning to your command prompt.
