MyCatBot - Your Fun, Furry Assistant

Meet MyCatBot, the playful and quirky cat-themed Telegram bot that will make your chats more fun! Whether you want to hear a random meow, trigger a zoomie attack, or just get some cuddles, this bot is here to make your day better — one paw at a time!

Features

• Purr-fectly Random Responses: Get hilarious and unpredictable replies, just like a real cat.
• Interactive Cat Actions: Command the bot to meow, nap, pounce, and even have the zoomies!
• Powerful Moderation Tools: Behind the cute exterior is a powerful moderator with a full suite of commands to keep your chat safe.
• Advanced Security: Protect your group with a global ban system and a user blacklist.
• Multi-Level Permissions: Full control for the Owner, with trusted Sudo users to help manage the bot.

How to run

1. Clone the repository:

   git clone https://github.com/R0Xofficial/MyCatBot catbot

2. Install requirements:

   pip install -r requirements.txt

3. Set up your environment variables: Copy the template file:

   cp ~/catbot/envtemp.sh ~/catbot/env.sh

   Then, edit the file to add your tokens and IDs:

   nano ~/catbot/env.sh

4. Run the bot: Navigate to the bot's directory and run it using the script:

   cd ~/catbot && . ./env.sh && python catbot.py

   To run the test version of the bot, use:

   cd ~/catbot && . ./env.sh && python catbot_test.py

---

Command List

Bot Commands

• /start: Shows the welcome message. ✨
  
• /help: Shows this help message. ❓
  
• /github: Get the link to my source code! 💻
  
• /owner: Info about my designated human! ❤️
  
• /sudocmds: List sudo commands. 👷‍♂️
  

User Commands

• /info <ID/@user/reply>: Get info about a user. 👤
  
• /chatstat: Get basic stats about the current chat. 📈
  
• /kickme: Kick yourself from the chat. 👋
  
• /listadmins: Show the list of administrators in the current chat. 📃 (Alias: /admins)
  

Management Commands

• /ban <ID/@user/reply> [Time] [Reason]: Ban a user from the chat. ⛔️
• /unban <ID/@user/reply>: Unban a user from the chat. 🔓
• /mute <ID/@user/reply> [Time] [Reason]: Mute a user in the chat. 🚫
• /unmute <ID/@user/reply>: Unmute a user from the chat. 🎙
• /kick <ID/@user/reply> [Reason]: Kick a user from the chat. ⚠️
• /promote <ID/@user/reply> [Title]: Promote a user to administrator. 👷‍♂️
• /demote <ID/@user/reply>: Demote an administrator to a regular member. 🙍‍♂️
• /pin <loud|notify>: Pin the replied-to message. 📌
• /unpin: Unpin the replied-to message. 📍
• /purge : Deletes messages up to the replied-to message. 🗑
• /report <ID/@user/reply> [reason]: Report a user to the administrators. ⚠️

Security

• /enforcegban <yes/no>: Enable/disable Global Ban enforcement in this chat (Chat Creator only). 🛡️

4FUN Commands

• /gif: Get a random cat GIF! 🖼️
  
• /photo: Get a random cat photo! 📷
  
• /meow: Get a random cat sound or phrase. 🔊
  
• /nap: What's on a cat's mind during naptime? 😴
  
• /play: Random playful cat actions. 🧶
  
• /treat: Demand treats! 🎁
  
• /zoomies: Witness sudden bursts of cat energy! 💥
  
• /judge: Get judged by a superior feline. 🧐
  
• /fed: I just ate, thank you! 😋
  
• /attack <@user/reply>: Launch a playful attack! ⚔️
  
• /kill <@user/reply>: Metaphorically eliminate someone! 💀
  
• /punch <@user/reply>: Deliver a textual punch! 👊
  
• /slap <@user/reply>: Administer a swift slap! 👋
  
• /bite <@user/reply>: Take a playful bite! 😬
  
• /hug <@user/reply>: Offer a comforting hug! 🤗
  

Sudo Commands

• /status: Show bot status.
  
• /cinfo [Optional chat ID]: Get detailed info about the current or specified chat.
  
• /say [Optional chat ID] [Your text]: Send a message as the bot.
  
• /blist <ID/@user/reply> [Reason]: Add a user to the blacklist.
  
• /unblist <ID/@user/reply>: Remove a user from the blacklist.
  
• /gban <ID/@user/reply> [Reason]: Ban a user globally.
  
• /ungban <ID/@user/reply>: Unban a user globally.
  

Note: Sudo users can use management commands like /ban, /mute, etc., even if they are not chat administrators.

Owner Commands

• /leave [Optional chat ID]: Make the bot leave a chat.
  
• /speedtest: Perform an internet speed test.
  
• /listsudo: List all users with sudo privileges.
  
• /addsudo <ID/@user/reply>: Grant SUDO (bot admin) permissions to a user.
  
• /delsudo <ID/@user/reply>: Revoke SUDO (bot admin) permissions from a user.