⚡ STEAM BOT V3

WhatsApp Bot • Modular • Secure • Plugin-Ready

Built for WhatsApp. Designed to evolve.

Features · Architecture · Commands · Security · Plugins · Quick Start

---

🔥 Features

	Feature	Details
🧩	Modular Core	Every command is an isolated ES module, loaded by a dynamic registry
🔐	Smart Identity	PN ⇄ LID mapping in both directions, persisted and auto-learned from group messages
🛡️	Role-Based Security	Five permission levels checked on every command
🔌	Live Plugins	Add, reload and remove plugins at runtime, with load errors reported back
🗄️	Safe Database	Async debounced saves, per-key serialized writes
📬	Bounded Queue	Message backlog capped at 128 to stay stable under load
🎬	Media Guard	Size, duration and URL safety checks on every download
📦	Clean Exports	Project packs skip plugins, credentials and secret-like files
🧪	Built-in Tests	Smoke, identity and group-phase tests

---

🧩 Architecture

STEAM BOT V3
├── commands/    → 40+ command modules
├── services/    → YouTube · Dorar · Archive · Group · Guards
├── security/    → Roles · Permissions · Owner & LID resolution
├── heart/       → Runtime · Registry · Bus · Queue
├── whatsapp/    → Connection & Message Engine
├── database/    → Persistent Store
├── console/     → Logger · Live Console
├── plugins/     → Drop-in Extensions
├── tests/       → Smoke & Identity Tests
├── assets/      → Static Media
└── index.js     → Entry Point

Flow: WhatsApp → Message Engine → Queue → Registry → Security Check → Command → Service / Database

---

🎮 Commands

Category	Commands
🕹️ Games	xo · شطرنج · اركيد · بنج · سنيك
🎬 Media	بوست · فيديو · بحث يوتيوب · سبوتي · فيس فيديو · ازالة خلفية · عرض · فيورا
👥 Groups	طرد · ادخل · رفع ادمن · ازل ادمن · تغيير · غير صوره · ق شات · ف شات
💾 Backup	نسخ · لصق · حذف نسخة
📖 Islamic	درر حديث · درر تفسير
🗂️ Archive	ارشيف · اضافة
⚙️ System	اوامر · سيستم · نخبة · ضيف · بدل · رستر · تست · خروج زرف فنش

Type .اوامر inside WhatsApp for the full live list.

---

🛡️ Security Roles

Level	Role	Access
👑	Developer	Everything, including system and plugin control
🔱	Main Owner	Owner powers plus elite management
⭐	Owner	Advanced group and media commands
💎	Elite	Special commands granted by the developer
👤	User	Public commands

Developer and owner numbers are set through .env, never hard-coded in source.

---

🔌 Plugins

Drop a file in plugins/ or use .ضيف to install one live. The registry reloads without a restart, reports any load error, and avoids command-name collisions.

---

📊 Limits

Limit	Value
Pending messages	128
Max media size	64 MB
Max audio length	15 min
Max video length	30 min

---

⚙️ Powered By

Node.js × Baileys × ES Modules

Sharp · Pino · Axios · JSZip · yt-search

Dynamic Registry · Security Layer · Async Database · Plugin Loader

---

🚀 Quick Start

# 1. Install
npm install

# 2. Create a .env file
DEVELOPERS=201000000000
MAIN_OWNERS=201000000000
OWNERS=
PHONE_NUMBER=201000000000

# 3. Run
npm start

# 4. Test
npm test

⚠️ Never commit .env or the session/ folder.

---

📡 STEAM NETWORK

---

⚡ STEAM BOT V3

Faster. Safer. Modular. Ready to evolve.