🐐 ST-BOT - By Sheikh Tamim

A customized and powerful multi-purpose chatbot framework for Facebook Messenger

Enhanced version of GoatBot V2 - Modified and maintained by Sheikh Tamim

📖 Table of Contents

Features
Command Structure
Configuration Guide
Installation & Setup
Premium System
ST-FCA (Custom Facebook API)
Advanced Features
Dashboard
ST Handlers Store
AI Command (STAI)
Support & Community
License

🚀 Features

Modular Command System - Easy to add/remove commands
Premium System - Advanced premium user management
Fast and Scalable - Optimized bot core for high performance
Auto-restart and Watchdog - Self-healing capabilities
MongoDB/SQLite Support - Flexible database options
Dynamic Command Loader - Hot-reload commands without restart
Thread Approval System - Control bot access to groups
Anti-React System - Advanced message management
Real-time Dashboard - Live monitoring with WebSocket
Easy Deployment - One-click deployment on Replit & Render
Custom ST-FCA - Optimized Facebook Chat API
Bot Logging System - Comprehensive logging configuration
Prefix Management - Global and per-thread prefix control
Bio Update System - Automatic bio updates
Startup Notifications - Configurable startup messages

📝 Command Structure

Every command in ST-BOT follows a standardized structure for consistency and ease of development:

Command Configuration

module.exports = {
  config: {
    name: "commandname",           // Command name (lowercase)
    aliases: ["alias1", "alias2"], // Alternative names
    version: "1.0.0",              // Command version
    author: "Your Name",           // Author name
    countDown: 5,                  // Cooldown in seconds
    role: 0,                       // 0: Everyone, 1: Group Admin, 2: Bot Admin
    premium: false,                // true: Premium only, false: Everyone
    usePrefix: true,               // true: Requires prefix, false: No prefix needed
    description: "Command description",
    category: "category name",
    guide: "{pn} <usage guide>"    // Usage instructions
  },

  langs: {
    en: {
      success: "Command executed successfully!",
      error: "An error occurred!"
    }
  },

  onStart: async function({ message, args, event, api, getLang }) {
    // Main command logic
    message.reply(getLang("success"));
  },

  onReply: async function({ message, Reply, event, api }) {
    // Handle user replies to bot messages
  },

  onChat: async function({ message, event, args }) {
    // Listen to all messages (without prefix)
  },

  onReaction: async function({ message, Reaction, event, api }) {
    // Handle reactions to bot messages
  }
};

Available Functions

message.reply(text) - Reply to user messages
message.send(text, threadID) - Send message to specific thread
message.unsend(messageID) - Unsend a message
message.reaction(emoji, messageID) - React to a message
message.pr(processingMessage, processingEmoji, successEmoji, errorEmoji) - Advanced processing message handler
- processingMessage (optional): Message to display during processing (default: "⏳ Processing...")
- processingEmoji (optional): Emoji to react with during processing (default: "⏳")
- successEmoji (optional): Emoji to react with on success (default: "✅")
- errorEmoji (optional): Emoji to react with on error (default: "❌")
- Returns object with methods: edit(message), success(message), error(message)
api.sendMessage() - Direct API message sending
getLang(key, ...args) - Get localized text
usersData.get(userID) - Get user data
threadsData.get(threadID) - Get thread data

Example: Using message.pr() with custom emojis

// Default emojis
const pr = await message.pr("⏳ Processing your request...");
await pr.success("✅ Done!");

// Custom emojis
const pr = await message.pr("🔄 Working on it...", "🔄", "🎉", "💔");
await pr.success("🎉 All done!");
await pr.error("💔 Something went wrong!");

⚙️ Configuration Guide

Global Prefix System

Configure prefix usage in config.json:

{
  "prefix": "!",
  "usePrefix": {
    "enable": true,                    // Global prefix requirement
    "adminUsePrefix": {
      "enable": true,                  // Admin prefix requirement
      "specificUids": []               // Specific users who need prefix
    }
  }
}

Options:

usePrefix.enable: true - All users must use prefix
usePrefix.enable: false - No prefix required globally
adminUsePrefix.enable: true - Admins must use prefix
adminUsePrefix.enable: false - Admins don't need prefix
specificUids: ["uid1", "uid2"] - Specific users affected by admin rules

Bot Account Configuration

Login credentials are set in config.json:

{
  "botAccount": {
    "email": "your_email@example.com",
    "password": "your_password",
    "userAgent": "Mozilla/5.0...",
    "autoUseWhenEmpty": true
  }
}

Note: If account.txt is empty, the bot will automatically use credentials from config.json to fetch cookies.

🔧 Installation & Setup

🖥 Method 1: Local Setup

Clone the repository:

git clone https://github.com/sheikhtamimlover/ST-BOT.git && cp -r ST-BOT/. . && rm -rf ST-BOT

Install dependencies:

npm install

Configure the bot:
- Set your Admin UID in config.json → adminBot array
- Add your Facebook email/password in config.json → botAccount
- Or add cookies directly in account.txt (JSON format)
Start the bot:

npm start

🌐 Method 2: Deploy on Render (Recommended)

Click the "Deploy on Render" button above
Configure your bot in config.json
Click the Run button - Render handles everything automatically!

💎 Premium System

The bot includes a comprehensive premium user management system.

How Premium Works

For Users:

Request premium access: .premium request <message>
Premium users get exclusive command access

For Admins:

Add premium: .premium add <uid/@mention>
Remove premium: .premium remove <uid/@mention>
View premium users: .premium list
Check pending requests: .premium pending

Creating Premium Commands

module.exports = {
  config: {
    name: "premiumcommand",
    premium: true,  // Makes this command premium-only
    role: 0,
    // ... other config
  },

  onStart: async function({ message }) {
    message.reply("🌟 This is a premium feature!");
  }
};

🔌 ST-FCA (Custom Facebook API)

ST-BOT uses ST-FCA - an optimized, custom-built Facebook Chat API for better performance and reliability.

Installation

npm install stfca

GitHub Repository

🔗 https://github.com/sheikhtamimlover/ST-FCA.git

Features

✅ Better stability and performance
✅ Optimized for ST-BOT
✅ Regular updates and bug fixes
✅ Enhanced error handling
✅ Improved cookie management

🎯 Advanced Features

Thread Approval System

Control which groups can use your bot:

{
  "threadApproval": {
    "enable": true,
    "adminNotificationThreads": ["thread_id"],
    "autoApproveExisting": true,
    "sendNotifications": true,
    "sendThreadMessage": true,
    "autoApprovedThreads": []
  }
}

Commands:

!threadapprove list - View all threads
!threadapprove approve <tid> - Approve a thread
!threadapprove unapprove <tid> - Unapprove a thread
!threadapprove pending - View pending threads

Bot Logging System

Configure comprehensive logging:

{
  "botLogging": {
    "enable": true,
    "sendToThreads": true,
    "logThreadIds": ["thread_id"],
    "sendToAdmins": false,
    "silentOnDisabledThreads": true,
    "logBotAdded": false,
    "logBotKicked": true
  }
}

Anti-React System

Admin-only message management through reactions:

{
  "antiReact": {
    "enable": true,
    "reactByUnsend": {
      "enable": true,
      "emojis": ["👍"]
    },
    "reactByRemove": {
      "enable": true,
      "emoji": "⚠"
    },
    "onlyAdminBot": true
  }
}

Bio Update System

Automatically update bot bio:

{
  "bioUpdate": {
    "enable": true,
    "bioText": "ST Bot - Your custom bio here",
    "updateOnce": true
  }
}

Startup Notifications

Send notifications when bot starts:

{
  "botStartupNotification": {
    "enable": true,
    "sendToThreads": {
      "enable": true,
      "threadIds": ["thread_id"]
    },
    "sendToAdmin": {
      "enable": false,
      "adminId": ""
    },
    "message": "🤖 Bot is now online!"
  }
}

📊 Dashboard

Access the powerful web dashboard with enhanced security:

{
  "dashBoard": {
    "enable": true,
    "port": 3021,
    "passwordProtection": {
      "enable": true,
      "password": "your_secure_password"
    }
  }
}

Features:

📊 Real-time statistics
👥 User management
💎 Premium user control
📝 Thread management
📈 Command analytics
🔧 System monitoring

🛍️ ST Handlers Store

Browse, install, and share commands, events, and APIs!

Usage

!sthandlers                    # Open main menu
!sthandlers <filename>         # Install from store
!sthandlers <name> <code>      # Upload command
!sthandlers -e <name> <code>   # Upload event
!sthandlers -p <filename>      # Upload from file path

Features

✅ Browse commands by category
✅ Install commands instantly
✅ Share your own creations
✅ Version control
✅ Auto-load installed commands
✅ Community-driven content

🤖 AI Command (STAI)

The most advanced AI command with code generation and bug fixing capabilities!

Features

🧠 Generate commands and events
🐛 Fix bugs in existing code
💡 Code suggestions and improvements
🔧 Auto-formatting and optimization
📝 Documentation generation

Usage

!stai generate command <description>
!stai generate event <description>
!stai fix <command_name>
!stai improve <code>

📞 Support & Community

Need Help?

📱 Messenger Group: Join Support Group
📸 Instagram: @sheikh.tamim_lover
💬 Facebook: m.me/tormairedusi
🐛 Report Issues: Use !streport <your issue> command

Regular Updates

✅ Active development and maintenance
✅ Regular feature additions
✅ Bug fixes and improvements
✅ Community-driven enhancements

Report Issues

Use the built-in report command:

!streport <describe your issue or feature request>

Your report will be sent directly to the developer!

📋 Essential Commands

Command	Description	Access
`!help`	View all commands	All Users
`!prefix`	View/change prefix	Group Admin
`!premium request`	Request premium	All Users
`!premium add`	Add premium user	Bot Admin
`!threadapprove`	Manage thread approval	Bot Admin
`!botlog`	Configure bot logging	Bot Admin
`!sthandlers`	Access command store	All Users
`!stai`	AI assistant	All Users
`!streport`	Report issues	All Users
`!update`	Update bot	Bot Admin

🔄 Regular Updates & Maintenance

This project receives regular updates with:

🆕 New Features
🐛 Bug Fixes
🔒 Security Patches
⚡ Performance Optimizations
💎 Premium Features

Stay updated by:

⭐ Starring this repository
👀 Watching for releases
📱 Following on Instagram
💬 Joining the support group

📄 License

This project is licensed under the MIT License. You are free to use, modify, and distribute this software, but please maintain the original credits.

Original GoatBot V2 by NTKhang
Enhanced & Maintained by Sheikh Tamim

❤️ Support the Project

If you find this project helpful:

⭐ Star this repository
🍴 Fork and contribute
📢 Share with others
💬 Join our community
🔗 Follow on Instagram: @sheikh.tamim_lover

Happy Botting! 🤖✨

Made with ❤️ by Sheikh Tamim

GitHub: sheikhtamimlover/ST-BOT
ST-FCA: sheikhtamimlover/ST-FCA

Name		Name	Last commit message	Last commit date
Latest commit History 66 Commits
bot		bot
dashboard		dashboard
database		database
func		func
languages		languages
logger		logger
scripts		scripts
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.replit		.replit
Copyright.txt		Copyright.txt
Goat.js		Goat.js
LICENSE		LICENSE
README.md		README.md
account.txt		account.txt
account.txt2		account.txt2
config.json		config.json
configCommands.json		configCommands.json
index.js		index.js
package-lock.json		package-lock.json
package.json		package.json
replit.nix		replit.nix
restoreBackup.js		restoreBackup.js
update.js		update.js
updater.js		updater.js
utils.js		utils.js
versions.json		versions.json

License

sheikhtamimlover/ST-BOT

Folders and files

Latest commit

History

Repository files navigation

🐐 ST-BOT - By Sheikh Tamim

📖 Table of Contents

🚀 Features

📝 Command Structure

Command Configuration

Available Functions

Example: Using message.pr() with custom emojis

⚙️ Configuration Guide

Global Prefix System

Bot Account Configuration

🔧 Installation & Setup

🖥 Method 1: Local Setup

🌐 Method 2: Deploy on Render (Recommended)

💎 Premium System

How Premium Works

Creating Premium Commands

🔌 ST-FCA (Custom Facebook API)

Installation

GitHub Repository

Features

🎯 Advanced Features

Thread Approval System

Bot Logging System

Anti-React System

Bio Update System

Startup Notifications

📊 Dashboard

🛍️ ST Handlers Store

Usage

Features

🤖 AI Command (STAI)

Features

Usage

📞 Support & Community

Need Help?

Regular Updates

Report Issues

📋 Essential Commands

🔄 Regular Updates & Maintenance

📄 License

❤️ Support the Project

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Uh oh!

Languages

Packages