Skip to content

Home

Jump to bottom
Grandpa EJ edited this page Nov 15, 2025 · 1 revision

Cyber-Bot v2

A modern Facebook Messenger bot with advanced features Repository: GrandpaAcademy/Cyber-Bot-v2 ([GitHub]1) License: MIT ([GitHub]1)

Table of Contents

  1. Overview
  2. Features
  3. Prerequisites
  4. Installation
  5. Configuration
  6. Command Creation
  7. Security Considerations
  8. Updates & Changelog
  9. Support
  10. Contributing
  11. License

1. Overview

Cyber-Bot v2 is a simple yet modern Facebook Messenger bot (built with Node.js) inspired by “Mirai”-style functionality. ([GitHub]1) It aims to provide a flexible command system, multilingual support (English + Bengali), group management features, and a modular architecture for extendability.

2. Features

  • Built on Node.js (20.x or higher) for performance and modern JS features. ([GitHub]1)
  • Multi-language support: English & Bengali included. ([GitHub]1)
  • Customizable command prefix, aliases, categories, permission levels (user, group admin, bot owner). ([GitHub]1)
  • Cooldown system to prevent spam. ([GitHub]1)
  • Built for Facebook Messenger, enabling bots to respond in threads/groups. ([GitHub]1)
  • Easy to extend: add new commands quickly via template. ([GitHub]1)

3. Prerequisites

Before you begin, ensure you have:

  • Node.js version 20.x or above. ([GitHub]1)
  • NPM or Yarn package manager. ([GitHub]1)
  • Git. ([GitHub]1)
  • A Facebook account (for bot integration). ([GitHub]1)

4. Installation

  1. Clone the repository:

    git clone https://github.com/GrandpaAcademy/Cyber-Bot-v2.git  
cd Cyber-Bot-v2  
``` :contentReference[oaicite:14]{index=14}

  2. Install dependencies:

    npm install --legacy-peer-deps  
``` :contentReference[oaicite:15]{index=15}

  3. Run the bot:

    node index.js  
# or  
npm start  
``` :contentReference[oaicite:16]{index=16}

5. Configuration

Edit config.json (or whichever config file is used) to adjust settings:

Language Settings

{  
  "language": "en",  // "en" for English, "bn" for Bengali  
  "PREFIX": "!",     // Command prefix  
  "adminOnly": false // Set to true if only admins can use commands  
}  
``` :contentReference[oaicite:17]{index=17}

Security Settings

{  
  "encryptSt": true,            // Enable appstate encryption  
  "ADMINBOT": ["YOUR_FACEBOOK_UID"]  // Bot owner/admin UID(s)  
}  
``` :contentReference[oaicite:18]{index=18}

Make sure to keep your appstate.json (if used) and other sensitive information private.

6. Command Creation

To add a new command:

  1. Create a new file under src/commands/, e.g., yourcommand.js.
  2. Use the following template: 
    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." }  
};
``` :contentReference[oaicite:19]{index=19}
  3. After creating the file, restart the bot so it loads the new command.

Supported features for commands: aliases, multi-language responses, permission handling, categories, cooldowns. :contentReference[oaicite:20]{index=20}

7. Security Considerations

  • Enable "encryptSt": true in config to turn on appstate encryption. :contentReference[oaicite:21]{index=21}
  • Keep your appstate.json and any access tokens safe and not publicly accessible.
  • Use environment variables for highly sensitive configuration where possible.
  • Regularly update dependencies to reduce risk of known vulnerabilities.

8. Updates & Changelog

Recent improvements (examples):

  • Upgraded to W3S-FCA for improved stability. :contentReference[oaicite:22]{index=22}
  • Added command aliases support. :contentReference[oaicite:23]{index=23}
  • Improved error handling and performance. :contentReference[oaicite:24]{index=24}

You may maintain a CHANGELOG.md for full version history.

9. Support

For help and community discussion:

  • Telegram: [link] :contentReference[oaicite:25]{index=25}
  • YouTube: [link] :contentReference[oaicite:26]{index=26}
  • Facebook: [link] :contentReference[oaicite:27]{index=27}

(Be sure to update links in the README or wiki with correct URLs.)

10. Contributing

Contributions are welcome! If you want to help:

  1. Fork the repository.
  2. Create a feature branch.
  3. Commit your changes.
  4. Push your branch.
  5. Open a Pull Request.
    Also, please read the Contributing Guidelines (if provided). :contentReference[oaicite:28]{index=28}

11. License

This project is licensed under the MIT License. See the LICENSE file for details. :contentReference[oaicite:29]{index=29}

Feel free to modify headings, add screenshots, diagrams, or more detailed usage examples.  
Would you like me to prepare a **complete wiki file structure** (like separate markdown pages) ready to paste into your Wiki tab?
```::contentReference[oaicite:30]{index=30}

Clone this wiki locally