---

🎮 What is the Telegram Games Bot?

The Telegram Games Bot is an advanced bot created by XPTOOLS, allowing users to play multiple fun games like Tic Tac Toe, Rock Paper Scissors, and Number Guessing — all within Telegram!

Built using Pyrogram and MongoDB, the bot is modular, efficient, and tracks leaderboard stats, user wins, and much more.

---

🚀 Features

💡 Feature	🔎 Description
🎮 Multiple Games	Includes Tic Tac Toe, Rock Paper Scissors, and Number Guessing.
🧠 Smart Game Logic	Turn-based game rendering, win tracking, and inline interactions.
📊 Leaderboard Support	Tracks global wins and displays Top 10 players.
👤 Profile Dashboard	Shows user's ID, username, current date/time, and win stats.
📢 Broadcast Tool	Admins can message all registered users.
📈 User Stats	Total number of users registered.
♻️ Reset Wins	Admin command to reset all game wins.
⚙️ Admin Panel	Central place to view and access all admin commands.
🔗 Social Buttons	Displayed on /start with links to Telegram, YouTube, and more.
🔐 Force Join Check	Users must join the channel to use the bot.

---

☁️ Quick Deploy

Deploy this bot quickly using popular cloud hosting platforms.

Platform	Link
🌍 Heroku Deploy
⚡ Render Deploy
☁️ Koyeb Deploy
💻 Replit Deploy

---

💻 Manual Deployment

📥 VPS Installation Steps

# Step 1 - Install dependencies
sudo apt update && sudo apt install git python3-pip -y

# Step 2 - Clone the repo
git clone https://github.com/XPTOOLS/GameHub
cd GameHub

# Step 3 - Install Python requirements
pip3 install -r requirements.txt

# Step 4 - Configure your info.py or .env with:
# BOT_TOKEN, DATABASE_URI, DATABASE_NAME, ADMINS, etc.

# Step 5 - Run the bot
python3 main.py

---

🔐 Commands Overview

Command	Who Can Use	Description
/start	All users	Shows welcome message and buttons.
/tictactoe	All users	Play Tic Tac Toe vs the bot.
/rps	All users	Rock Paper Scissors game.
/guess	All users	Number guessing game.
/games	All users	Shows all available games.
/profile	All users	View your game profile and wins.
/leaderboard	All users	Top 10 winners of all games.
/contactus	All users	Display admin and support info.
/broadcast	Admin only	Send message to all users.
/stats	Admin only	Show total user count.
/resetwins	Admin only	Reset all wins.
/adminpanel	Admin only	Display all admin commands.

---

👥 Contributors, Stars & Forks

---

💬 Community & Support

---

Made with ❤️ by XPTOOLS