Metadata-Version: 2.4
Name: zenith-11
Version: 0.1.1
Summary: A high-complexity 11-way elemental battle system.
Author: TheLostIdea1
Author-email: afifashamsad.vivo@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Games/Entertainment
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: license
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# Zenith-11

Zenith-11 is a high-complexity, 11-way elemental battle system designed for strategic gameplay. It extends the classic Rock-Paper-Scissors logic into a balanced 11-element matrix with persistent storage and professional-grade data handling.

## Features

- **11-Element Matrix**: A perfectly balanced combat system including Rock, Paper, Scissors, Lizard, Spock, Water, Fire, Human, Towel, Sponge, and TNT.
- **Tutor Xenon AI**: An adaptive AI with 8 levels of difficulty, ranging from "Easy" to "Impossible."
- **Internal Storage**: Persists lifetime wins, lesson visits, and user preferences using a local JSON engine.
- **Secure Matchmaking**: Features hidden input for local multiplayer sessions.
- **Scoreboard Export**: Generates `.sbrd` match reports in XML format with CDATA protection.

## Installation

Within your environment root, run:

```bash
pip install .
```

## Usage

### Terminal Command
After installation, you can launch the game directly from your shell:

```bash
zenith11
```

### As a Library
You can integrate the Zenith-11 engine into your own Python projects:

```python
import zenith_11
zenith_11.zenith_11.startrps()
```

### As a One-Liner
You can run this directly in your terminal:

```bash
python3 -c "import zenith_11; zenith_11.zenith_11.startrps()"
```

## Elemental Hierarchy

The Zenith-11 matrix is mathematically balanced. In this 11-element system, every element defeats exactly **5** other elements and is defeated by the remaining **5** (excluding ties), creating a "Wide Offense" tactical environment.



## Commands & Controls

While the engine is running, you can use the following specialized inputs:

| Input | Action |
| :--- | :--- |
| `l3ss0n` | Opens the Xenon Training module to study element counters. |
| `B` | Exports current session results to an XML `.sbrd` file. |
| `help` | Displays the difficulty guide and lifetime win statistics. |
| `reset` | Wipes all local persistent data and starts fresh. |

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Author

**TheLostIdea1**, Email: afifashamsad.vivo@gmail.com

