Metadata-Version: 2.4
Name: fungames
Version: 0.1.1
Summary: A collection of pygame mini-games
Requires-Dist: pygame
Description-Content-Type: text/markdown

<p align="center">
  <img src="logo.svg" width="500"/>
</p>

<p align="center">
  <img src="https://img.shields.io/pypi/v/fungames?color=6c63ff&label=PyPI&style=for-the-badge"/>
  <img src="https://img.shields.io/pypi/pyversions/fungames?color=ff4d6d&style=for-the-badge"/>
  <img src="https://img.shields.io/pypi/dm/fungames?color=00d4aa&label=Downloads&style=for-the-badge"/>
  <img src="https://img.shields.io/pypi/l/fungames?color=f5a623&style=for-the-badge"/>
</p>

<p align="center">
  <b>A collection of fun pygame mini-games — install once, play forever!</b>
</p>

---

## 🕹️ Games Included

| Game | Description | Controls |
|------|-------------|----------|
| 🟥 **Tic Tac Toe** | Classic X and O with animated gradient background | Click to place |
| 🟨 **2048** | Slide and merge tiles to reach 2048 | Arrow keys / Swipe |
| 🚀 **Space Shooter** | Shoot UFOs before they invade | Arrow keys + Space |
| 🐦 **Flappy Bird** | Dodge pipes and survive | Space to flap |

---

## ⚙️ Installation

```bash
pip install fungames
```

> Requires Python 3.7+ · pygame installs automatically

---

## 🚀 Quick Start

```python
from fungames import tictactoe
tictactoe.play()
```

---

## 🎮 Play Any Game

```python
# Tic Tac Toe
from fungames import tictactoe
tictactoe.play()

# 2048
from fungames import game2048
game2048.play()

# Space Shooter
from fungames import spaceshooter
spaceshooter.play()

# Flappy Bird
from fungames import flappybird
flappybird.play()
```

---

## 🎯 Controls

### 🟥 Tic Tac Toe
- **Click** on any cell to place X or O
- **R** to restart the game
- Supports **touch** input

### 🟨 2048
- **Arrow Keys** — slide tiles in any direction
- **Swipe** — touch/mouse swipe supported
- **R** — restart the game

### 🚀 Space Shooter
- **Left / Right Arrow** — move the rocket
- **Space** — fire bullet
- Shoot all UFOs before they reach you!

### 🐦 Flappy Bird
- **Space** — flap wings to go up
- Release — bird falls with gravity
- Dodge the pipes and survive!

---

## 📦 Requirements

- Python 3.7+
- pygame (auto-installed)

---

## 📈 Changelog

### v0.1.0
- Initial release
- 4 games included: Tic Tac Toe, 2048, Space Shooter, Flappy Bird

---

## 👨‍💻 Author

Made with ❤️ by **Soumyajyoti Ghosh**

> PyPI · [fungames](https://pypi.org/project/fungames/)

---

## 📄 License

MIT License — free to use, modify and share!
