Metadata-Version: 2.4
Name: pylette-game
Version: 1.0.0
Summary: A terminal based Buckshot Roulette inspired game!
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Pylette

A terminal-based survival game inspired by **Buckshot Roulette**.

## About

Pylette is a complete revival and expansion of one of my very old projects from 2024.

The original project was a very basic recreation of Buckshot Roulette with simple mechanics, minimal UI, and limited gameplay. Yeah, I found it somedays ago apperantly and got it working <3

This version has been rebuilt from the ground up with:

- A full terminal user interface
- Colored HUD and menus
- ASCII-based visuals
- Multiple game modes
- Item mechanics
- Dealer AI
- Persistent statistics
- Cross-platform support
- PyPI installation support

The goal of Pylette is not just to recreate the original idea, but to turn it into a proper standalone terminal game.

## Installation

Pylette is available on PyPI.

Install using:

```bash
pip install pylette-game
```

Run the game:

```bash
pylette
```

## Features

### Gameplay

- Three-round survival mode
- Double or Nothing mode
- Dealer opponent
- Randomized chambers
- Live and blank shells
- Strategic decision making

### Items

Pylette includes multiple items that can change the outcome of a round:

- Beer
- Cigarettes
- Handcuffs
- Handsaw
- Magnifier
- Phone
- Inverter
- Medicine
- Adrenaline

## Game Modes

### Normal Mode

The main game mode.

Survive three rounds and defeat the dealer.

### Double or Nothing

A high-risk mode where you can increase your winnings after each victory.

Choose between:

- Cashing out
- Continuing for a larger reward

## Controls

Pylette runs completely inside the terminal.

Controls:

- Arrow keys - Navigate menus
- Enter - Select
- Ctrl + C - Exit safely

## Platform Support

Supported platforms:

- Windows
- Linux
- macOS

Pylette is designed to work with standard terminal environments and does not require any external software.

## Running From Source

Clone the repository:

```bash
git clone https://github.com/Aarav2709/Pylette.git
```

```bash
python main.py
```

## Credits

Inspired by:

- Buckshot Roulette by Mike Klubnika

Pylette is an independent fan-made project created for learning, experimentation, and fun.
