🤖 P3Verse WhatsApp Bot

A powerful, feature-rich WhatsApp bot built with Baileys

Features • Installation • Commands • Configuration • Contributing

---

✨ Features

🎓 Class Group Tools

• Auto Group Division - Randomly divide members into balanced groups
• Links Manager - Store & categorize important links (Zoom, Drive, Forms, etc.)
• Quick Polls - Create instant polls for class decisions
• Assignment Tracker - Track deadlines with visual countdowns
• Schedule Manager - Manage class schedules with reminders

🛡️ Moderation & Security

• Anti-Toxic System - Auto-detect & warn toxic language (3-strike system)
• Anti-Link Protection - Auto-kick users posting WhatsApp group links
• Ban System - Ban/unban users with persistent storage
• Dynamic Word Filter - Add/remove toxic words on the fly
• Admin Management - Multi-level admin system with owner protection

🎮 Fun & Engagement

• Games - Tebak angka and more
• Quote Generator - Daily motivational quotes
• AI Chat - Conversational AI assistant

📥 Downloader Tools

• Instagram Downloader - Download IG photos & videos
• TikTok Downloader - Download TikTok videos without watermark
• YouTube Music - Search & download music

🌐 Utility Tools

• Wikipedia Search - Quick wiki lookups
• Translator - Multi-language translation
• Text-to-Speech - Convert text to voice messages
• GitHub Stats - View GitHub user statistics
• Lyrics Finder - Search song lyrics

👥 Group Management

• Kick/Promote/Demote - Member management
• Tag All - Mention all members
• Hidden Tag - Send messages with hidden mentions
• Open/Close Group - Control group settings
• Get Link - Retrieve group invitation link

🚀 Installation

Prerequisites

• Node.js v16 or higher
• npm or yarn
• Git (optional)

Quick Start

# Clone repository
git clone https://github.com/sntdashi/bot-p3verse-1.0.git
cd bot-p3verse-1.0

# Install dependencies
npm install

# Configure bot (edit len.js)
nano len.js

# Run bot
npm start

First Time Setup

1. Configure Owner & Admins

   Edit len.js:

   global.owner = '628YOURPHONE@s.whatsapp.net'
   global.admin = ['628YOURPHONE@s.whatsapp.net']

2. Run the Bot

   npm start

3. Scan QR Code

   • QR code will appear in terminal
   • Open WhatsApp → ⋮ → Linked Devices
   • Tap Link a Device
   • Scan the QR code
   • Done! ✅

📱 Commands

Note: All commands support both mobile-friendly comma (,) and desktop pipe (|) delimiters

👑 Admin & Owner Commands

Command	Description	Example
/addadmin	Add new admin (owner only)	/addadmin @user
/deladmin	Remove admin (owner only)	/deladmin @user
/listadmin	View all bot admins	/listadmin
/ban	Ban user from bot	/ban @user
/unban	Unban user	/unban @user
/listban	View banned users	/listban
/addtoxic	Add word to filter (owner)	/addtoxic word1 word2
/deltoxic	Remove filtered word (owner)	/deltoxic word1
/listtoxic	View filtered words	/listtoxic

🎓 Class Group Tools

Command	Description	Example
/bagikelompok jumlah <N>	Divide into N groups	/bagikelompok jumlah 5
/bagikelompok max <N>	Max N members per group	/bagikelompok max 4
/setlink	Save link	/setlink Zoom, https://zoom.us/xxx
/links	View all saved links	/links
/dellink <N>	Delete link #N	/dellink 1
/poll	Create poll	/poll Question, A, B, C
/jadwal [day]	View schedule	/jadwal or /jadwal senin
/setjadwal	Set schedule (admin)	/setjadwal senin 08:00 ...
/addpr	Add assignment	/addpr Math, Page 50, Tomorrow
/listpr	View assignments	/listpr
/delpr <N>	Delete assignment #N	/delpr 1

🎮 Fun & Games

Command	Description	Example
/tebakangka	Start number guessing game	/tebakangka
/tebak <N>	Guess the number	/tebak 50
/quote	Get random quote	/quote

🤖 AI & Tools

Command	Description	Example
/ai	Ask AI anything	/ai What is JavaScript?
/wiki	Wikipedia search	/wiki Python programming
/translate	Translate text	/translate en Hello World
/tts	Text to speech	/tts Hello everyone

📥 Downloaders

Command	Description	Example
/igdl	Download Instagram	/igdl https://instagram.com/p/xxx
/ttdl	Download TikTok	/ttdl https://tiktok.com/@xxx
/play	Download music	/play Imagine - John Lennon
/lirik	Get song lyrics	/lirik Imagine

👥 Group Management (Admin)

Command	Description	Example
/kick	Kick member	/kick @user
/promote	Make admin	/promote @user
/demote	Remove admin	/demote @user
/tagall	Tag all members	/tagall Important!
/hidetag	Hidden tag	/hidetag Message
/open	Open group	/open
/close	Close group	/close
/linkgroup	Get group link	/linkgroup

⚙️ Configuration

Basic Settings (len.js)

// Bot Owner (Full Control)
global.owner = '628XXXXXXXXXX@s.whatsapp.net'

// Bot Admins (Can use admin commands)
global.admin = [
    '628XXXXXXXXXX@s.whatsapp.net',  // Owner
    '628YYYYYYYYYY@s.whatsapp.net'   // Additional admin
]

// Command Prefix
global.prefix = '/'

// Bot Image
global.image = './database/image/KucingLucu.jpeg'

Pairing Methods

QR Code (Default - Recommended)

1. Run npm start
2. QR code appears in terminal
3. Scan with WhatsApp

Pairing Code (Alternative)

1. Edit index.js: const usePairingCode = true
2. Run npm start
3. Enter phone number
4. Use pairing code in WhatsApp

🛠️ Troubleshooting

Error: "Bad MAC"

Cause: Corrupted session

Solution:

# Delete session folder
rm -rf LenwySesi

# Or on Windows
rmdir /s LenwySesi

# Restart bot
npm start

Bot Not Responding

1. Check if bot is online in WhatsApp
2. Verify command prefix matches (/ by default)
3. Check if user is banned
4. Ensure bot is admin (for group features)

Session Expired

• Bot will auto-reconnect
• If fails repeatedly, delete LenwySesi and re-pair

📂 Project Structure

bot-p3verse-1.0/
├── index.js              # Main entry point
├── lenwy.js              # Command handler
├── len.js                # Configuration
├── package.json          # Dependencies
├── utils/                # Utility functions
│   └── helpers.js        # Helper functions
├── database/             # Data storage
│   ├── users.json        # User database
│   ├── banned.json       # Banned users
│   ├── links.json        # Saved links
│   ├── toxic_words.json  # Filtered words
│   ├── jadwal.json       # Schedules
│   └── pr.json           # Assignments
├── scrape/               # Web scrapers
│   ├── Ai4Chat.js        # AI scraper
│   └── Tiktok.js         # TikTok scraper
└── LenwySesi/            # WhatsApp session (auto-generated)

🔒 Security & Privacy

• ✅ Session files in .gitignore
• ✅ No data sent to external servers (except API calls)
• ✅ Local database storage
• ✅ Owner-only sensitive commands
• ✅ Per-group data isolation

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Coding Standards

• Use ES Module syntax
• Follow existing code style
• Add comments for complex logic
• Test before submitting

📝 License

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

👨‍💻 Author

Lenwy

• Instagram: @rawrznf

🙏 Acknowledgments

• Baileys - WhatsApp Web API
• qrcode-terminal - QR code display
• All contributors and users!

⭐ Star History

If this project helped you, please give it a ⭐!

---

Made with ❤️ by Lenwy

Report Bug • Request Feature