CyberBot 🤖

A Modern Facebook Messenger Bot with Advanced Features

English | বাংলা

📚 Table of Contents

• Features
• Prerequisites
• Installation
• Configuration
• Command Creation
• Security
• Updates
• Support
• Contributing
• License

✨ Features

• 🚀 Modern Architecture: Built on Node.js 20.x
• 🌍 Multi-language Support: English and Bengali included
• 🔒 Enhanced Security: Built-in appstate encryption
• ⚡ Fast & Efficient: Optimized for performance
• 🎯 Easy to Extend: Simple command creation system
• 🛠 Customizable: Flexible configuration options
• 👥 Group Management: Advanced group features
• 🔍 Command Aliases: Multiple ways to trigger commands
• ⏱ Cooldown System: Prevent command spam
• 🔐 Permission Levels: User, Admin, and Bot Owner controls

📋 Prerequisites

• Node.js 20.x or higher
• NPM or Yarn
• Git
• Facebook Account

📝 Command Creation

CyberBot makes it easy to add new features! Use the template below to create your own commands:

module.exports.config = {
  name: "yourcommand",
  version: "1.0.0",
  hasPermission: 0, // 0: user, 1: group admin, 2: bot admin
  credits: "Your Name",
  description: "Describe what your command does",
  usePrefix: true,
  commandCategory: "category",
  usages: "[usage details]",
  cooldowns: 5,
  aliases: ["alias1", "alias2"]
};

module.exports.run = async function({ api, event, args, getText }) {
  // Your command logic here
  api.sendMessage("Hello from yourcommand!", event.threadID, event.messageID);
};

module.exports.languages = {
  en: {
    example: "This is an example message."
  }
};

How to use:

• Copy the template above into a new file in src/commands/
• Update the config and logic as needed
• Restart the bot to load your new command

Features supported:

• Aliases for commands
• Permission levels (user, group admin, bot admin)
• Cooldowns
• Multi-language support
• Custom categories

⚙️ Configuration

Language Settings

{
  "language": "en",  // "en" for English, "bn" for Bengali
  "PREFIX": "!",     // Command prefix
  "adminOnly": false // Set to true to restrict bot to admins only
}

Security Settings

{
  "encryptSt": true,  // Enable appstate encryption
  "ADMINBOT": ["YOUR_FACEBOOK_UID"]  // Admin UIDs
}

🔒 Security

• Enable encryptSt in config.json for enhanced security
• Keep your appstate.json private
• Regularly update your bot and dependencies
• Use environment variables for sensitive data

🔄 Latest Updates

• Upgraded to W3S-FCA for improved stability
• Enhanced security features
• Added command aliases support
• Improved error handling
• Bug fixes and performance improvements

💬 Support

• CYBER BOT COMMUNITY
• Join our Telegram
• Subscribe on YouTube
• Follow on Facebook

🤝 Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

Please read our Contributing Guidelines for details.

---

How To Use?

1. Clone this repo:

   git clone https://github.com/GrandpaAcademy/Cyber-Bot-v2.git
   
   cd Cyber-Bot-v2

2. Install dependencies:

   npm install --legacy-peer-deps

3. Run the bot:

   node index.js
   
   #or
   
   npm start

📄 License

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

---

Made with 💖 by Grandpa Academy

Copyright © 2025 Grandpa Academy | Cyber Bot