⚡ ARX BOT ⚡

A Rock-Paper-Scissors game with Telegram integration & stat tracking

---

 █████╗ ██████╗ ██╗  ██╗    ██████╗  ██████╗ ████████╗
██╔══██╗██╔══██╗╚██╗██╔╝    ██╔══██╗██╔═══██╗╚══██╔══╝
███████║██████╔╝ ╚███╔╝     ██████╔╝██║   ██║   ██║   
██╔══██║██╔══██╗ ██╔██╗     ██╔══██╗██║   ██║   ██║   
██║  ██║██║  ██║██╔╝ ██╗    ██████╔╝╚██████╔╝   ██║   
╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝    ╚═════╝  ╚═════╝    ╚═╝   

---

🎮 What is ARX Bot?

ARX Bot is a terminal-based Rock-Paper-Scissors game featuring:

• 🔐 User Authentication - Login system with username/password stored in CSV
• 🎲 Classic RPS Gameplay - Play against the computer with randomized choices
• 📊 Stat Tracking - Your wins and losses are saved and persist between sessions
• 📈 Data Visualization - Matplotlib generates graphs of your performance
• 📲 Telegram Integration - Get your stats sent directly to your Telegram chat

---

🚀 How It Works

graph LR
    A[🔐 Login] --> B[🎮 Play Game]
    B --> C{Win/Lose/Draw?}
    C -->|Win| D[📈 Update Stats]
    C -->|Lose| D
    C -->|Draw| B
    D --> B
    B -->|Quit| E[📊 Generate Graph]
    E --> F[📲 Send to Telegram]

Loading

Game Flow:

1. Login - Enter your credentials (stored in stats.csv)
2. Play - Choose Rock, Paper, or Scissors
3. Track - Your wins/losses are automatically saved
4. Exit - Type quit to end the game
5. Report - Stats are visualized and sent to Telegram

---

📦 Installation

Clone the Repository

git clone https://github.com/Arvinvx/Arx_Bot.git
cd Arx_Bot

Install Dependencies

pip install pandas matplotlib python-telegram-bot numpy

Configure Telegram Bot

1. Create a bot with @BotFather on Telegram
2. Get your bot token
3. Open main.py and replace:

BOT_TOKEN = "YOUR_BOT_TOKEN"  # <-- Add your token here
CHAT_ID = YOUR_CHAT_ID        # <-- Add your chat ID

---

▶️ Running the Game

Option 1: Python

python main.py

Option 2: Windows Launcher

Double-click setup.bat for a styled launch experience!

---

🛠️ Tech Stack

Technology	Purpose
Python 3.14	Core programming language
Pandas	CSV data manipulation & stat tracking
NumPy	Random choice generation
Matplotlib	Win/Loss graph visualization
python-telegram-bot	Telegram Bot API integration
asyncio	Async Telegram message sending

---

📁 Project Structure

Arx_Bot/
├── main.py          # Main game logic
├── stats.csv        # User credentials & statistics
├── setup.bat        # Windows launcher
├── stats.png        # Generated stats graph
└── README.md        # You are here!

---

📊 Sample Output

Username: arvin
Password: ****
Login successful

game loading...
game started
for exit write 4

Enter Rock, Paper, Scissors (or 'quit' to exit) : rock
you win
scissors

Enter Rock, Paper, Scissors (or 'quit' to exit) : quit

---

👤 Author

Arvin - @Arvinvx

---

Made with ❤️ and Python