🌿 GreenLeaf Bot

Siêu Bot Messenger Bất Tử — Tích hợp Sòng Bạc & Máy Chém

---

"Không chỉ là Bot, đây là Lễ Tân kiêm luôn Nhà Cái uy tín nhất hệ mặt trời!" 🐧☝️

📖 Giới Thiệu

GreenLeaf Bot là một dự án bot Messenger mã nguồn mở, được tối ưu hóa cực hạn để bảo vệ tài khoản (Anti-Block) và quản lý nhóm chat một cách tự động.

Với kiến trúc Modular — tách biệt hoàn toàn Core và Vỏ bọc — bot sở hữu hệ thống kinh tế (Economy) mạnh mẽ, máy chém Auto-Ban động, và khả năng hoạt động bền bỉ 24/7 trên VPS.

✨ Tính Năng Nổi Bật

Tính Năng	Mô Tả	Trạng Thái
🛡️ Hệ Thống Bất Tử	Tách biệt Core và Vỏ, kết hợp Adapter delay random chống block	✅
⚔️ Máy Chém Động	Auto-ban khi spam, tự động ân xá. Tùy chỉnh độ gắt qua lệnh	✅
💰 Sòng Bạc Macau	Hệ thống Tài Xỉu theo phiên 20s, ghép kèo nhiều người, All-in khô máu	✅
👑 God Mode (Admin)	Thao túng tiền tệ (?eco), bế quan tỏa cảng (?noreply), out box từ xa	✅
🧠 Smart Utils	Tự động dọn dẹp và fix lỗi Database JSON, chống corrupt data	✅
🚀 Hot Reload	Lệnh ?restart nạp lại Core và Commands ngay lập tức	✅

Note

Hệ thống Casino/Economy trong bot chỉ mang tính chất giải trí với tiền ảo trong game. Chúng tôi nghiêm cấm và không hỗ trợ bất kỳ hành vi quy đổi tiền thật nào. Hãy chơi game có trách nhiệm!

🛠️ Cài Đặt & Sử Dụng

Yêu cầu hệ thống

• Node.js phiên bản 18 trở lên
• Git
• Một tài khoản Facebook (khuyến nghị dùng acc clone/2022 sạch)

Cài đặt

# Clone source code về máy
git clone https://github.com/MiniSharkCraft/GreenLeaf-Bot.git

# Di chuyển vào thư mục bot
cd GreenLeafBot

# Cài đặt các thư viện cần thiết
npm install

Cấu hình

Important

Chỉnh sửa file config.json trước khi chạy bot.

{
  "prefix": "?",
  "adminIDs": ["100012345678901"],
  "adminOnly": false,
  "rateLimitCount": 3,
  "rateLimitTime": 2500,
  "appStatePath": "./appstate_letan.json"
}

Trường	Mô tả
prefix	Ký tự đặt trước mỗi lệnh (mặc định ?)
adminIDs	Mảng chứa Facebook UID của (các) admin bot — xem hướng dẫn bên dưới
adminOnly	true = chỉ admin dùng được bot, false = ai cũng dùng được
rateLimitCount	Số lệnh tối đa trong khoảng rateLimitTime (chống spam)
rateLimitTime	Thời gian rate-limit tính bằng mili-giây (2500 = 2.5 giây)
appStatePath	Đường dẫn tới file cookie/appstate của acc bot

🔑 Cách lấy Facebook UID

Facebook UID là dãy số định danh tài khoản (ví dụ: 100012345678901). Có nhiều cách lấy:

• Cách 1: Vào [Look Up ID] → dán link profile Facebook → copy UID
• Cách 2: Mở profile Facebook → nhấn chuột phải → View Page Source → tìm "userID":" → dãy số phía sau chính là UID
• Cách 3: Dùng extension trình duyệt như JEFI FB ID Finder

👥 Thêm nhiều Admin

Muốn thêm nhiều admin, chỉ cần thêm UID vào mảng adminIDs, mỗi UID cách nhau bằng dấu phẩy:

{
  "adminIDs": [
    "100012345678901",
    "100098765432101",
    "100011223344556"
  ]
}

Tip

Mỗi UID phải nằm trong dấu ngoặc kép "..." và cách nhau bằng dấu phẩy ,. UID cuối cùng không có dấu phẩy phía sau.

Lấy AppState (Cookie)

Bot cần file appstate.json chứa cookie Facebook để đăng nhập. Có thể lấy bằng extension c3c-fbstate hoặc tương tự:

1. Đăng nhập Facebook trên trình duyệt bằng acc clone/phụ
2. Dùng extension export ra file appstate.json
3. Đặt file vào thư mục bot và đảm bảo appStatePath trong config.json trỏ đúng đường dẫn

Warning

Tuyệt đối không dùng tài khoản Facebook chính. Dùng acc clone/2022 sạch để tránh bị khóa.

Vận hành

🖥️ Development (Local)

Chạy trực tiếp để test và debug:

node index.js

Bot sẽ log ra console, nhấn Ctrl + C để dừng.

☁️ Production (VPS 24/7)

Dùng PM2 để bot chạy nền, tự restart khi crash:

# Cài PM2 toàn cục (chỉ cần 1 lần)
npm install pm2 -g

# Khởi chạy bot
pm2 start index.js --name "GreenLeafBot"

Một số lệnh PM2 hữu ích:

pm2 logs GreenLeafBot     # Xem log real-time
pm2 restart GreenLeafBot   # Restart bot
pm2 stop GreenLeafBot      # Dừng bot
pm2 delete GreenLeafBot    # Xóa bot khỏi PM2
pm2 monit                  # Dashboard monitor CPU/RAM

Để bot tự khởi động lại khi VPS reboot:

pm2 startup
pm2 save

🐳 Docker (Tùy chọn)

# Build image
docker build -t greenleaf-bot .

# Chạy container
docker run -d --name greenleaf --restart unless-stopped greenleaf-bot

📂 Cấu Trúc Thư Mục

GreenLeafBot/
├── index.js          # 🛡️ Vỏ Bọc — khởi tạo kết nối & anti-crash
├── core.js           # 🧠 Bộ Não — xử lý lệnh & routing
├── config.json       # ⚙️ Cấu hình bot
├── utils/
│   └── adapter.js    # 🛡️ Lớp giáp chống block (delay random)
├── commands/         # 📦 Các module lệnh
└── database/         # 💾 Dữ liệu JSON (economy, users, ...)

🤝 Đóng Góp

Mọi đóng góp đều được chào đón! Hãy tạo Issue hoặc gửi Pull Request.

📄 License

Dự án được phân phối dưới giấy phép MIT.

---

Code by CongMC team 🐧☝️ | Version: 2.5 (Stable)