✦ nirwabot ✦

Useless WhatsApp Bot — Because Why Not?

---

📖 About

nirwabot adalah bot WhatsApp yang dirancang untuk menjadi teman digital serbaguna — mulai dari membuat stiker, menjawab pertanyaan dengan AI, hingga bermain game interaktif. Meskipun disebut "useless", bot ini hadir dengan segudang fitur yang (mungkin) berguna untuk keseharianmu.

🧠 Philosophy of Names

Bagian	Arti
Nir	Berasal dari bahasa Sanskerta yang berarti "tidak ada", "tanpa", atau "bebas"
Wa	Singkatan dari WhatsApp
Bot	Merujuk pada Robot atau program otomatis

Secara keseluruhan, nirwabot bermakna "Bot WhatsApp yang bebas (tanpa batasan)" — sebuah representasi dari semangat open-source yang memberi kebebasan kepada pengguna untuk mengeksplorasi dan mengembangkan sesuai kebutuhan.

---

Warning

⚠️ Important Warning

nirwabot tidak berafiliasi dengan WhatsApp, Meta, atau pihak terkait mana pun. Proyek ini adalah perangkat lunak sumber terbuka yang dibuat untuk tujuan edukasi dan pengembangan.

Bot ini menggunakan API WhatsApp tidak resmi, yang berarti akun WhatsApp Anda berpotensi diblokir oleh WhatsApp. Gunakan dengan bijak dan di bawah tanggung jawab Anda sendiri.

Kami tidak bertanggung jawab atas penyalahgunaan, kerusakan, atau pemblokiran akun yang mungkin terjadi.

---

🚀 Starting

📋 Requirements

• Node.js ≥ 20
• npm atau yarn atau pnpm
• Git

1️⃣ Clone

git clone https://github.com/itsreimau/nirwabot.git
cd nirwabot

2️⃣ Install & Setup

npm run setup

Atau manual:

npm install
cp config.example.json config.json

3️⃣ Configuration

Buka dan edit config.json sesuai kebutuhan:

• Bot Identity — Nama, nomor HP, thumbnail, dan link grup
• Owner Settings — Nama, nomor, dan co-owner
• System Settings — Mode bot, fitur keamanan, batasan, dan lainnya
• Message Settings — Pesan default untuk berbagai situasi
• Sticker Settings — Packname dan author untuk stiker

---

▶️ Running

Mode	Perintah	Deskripsi
🧪 Development	npm start	Jalankan di terminal untuk debugging
🚀 Production	npm run start:pm2	Jalankan sebagai background service

🔐 Authentication

Metode	Langkah
Pairing Code	Kode 8 digit muncul di terminal → Buka WhatsApp > Perangkat Tertaut → Masukkan kode
QR Code	QR Code muncul di terminal → Buka WhatsApp > Perangkat Tertaut → Pindai QR

---

🛠️ Creating a New Command

Untuk menambahkan perintah kustom, buat file JavaScript baru di folder commands/ dengan struktur berikut:

// commands/example/helloworld.js

module.exports = {
    name: "helloworld", // Nama perintah (wajib)
    aliases: ["hello", "hw"], // Alias (opsional)
    category: "example", // Kategori (opsional)
    permissions: { // Izin (opsional)
        admin: false, // Hanya admin grup?
        botAdmin: false, // Bot harus admin?
        coin: 0, // Biaya koin
        group: false, // Hanya di grup?
        owner: false, // Hanya owner?
        premium: false, // Hanya premium?
        private: false, // Hanya private chat?
        restrict: false // Mode restriktif?
    },
    code: async (ctx) => {
        await ctx.reply("Hello, World! 👋"); // Kirim pesan
        await ctx.replyReact("✨"); // Kirim reaksi
    }
};

---

🤝 Contribution

Contribution Guidelines

1. Fork repositori ini
2. Buat branch baru (git checkout -b fitur-keren)
3. Commit perubahan (git commit -m '✨ Menambahkan fitur keren')
4. Push ke branch (git push origin fitur-keren)
5. Buat Pull Request

Contribution Rules

• ✅ Ikuti gaya kode yang sudah ada
• ✅ Tambahkan dokumentasi untuk fitur baru
• ✅ Uji coba sebelum mengirim PR
• ✅ Gunakan pesan commit yang deskriptif
• ❌ Jangan menghapus credit/attribution

---

🙏 Thanks to Contributors

Terima kasih kepada semua pihak yang telah berkontribusi:

ItsReimau	Jastin Linggar Tama	Lia Wynn	Kyluxx	Sir Kafka	fjrhub
Rippanteq7	Fan	Luki Zainur	Anupam Mediratta

Dan semua kontributor lainnya yang tidak bisa disebutkan satu per satu 🌟

---

📄 License

Proyek ini dilisensikan di bawah MIT License.

---

_{Dibuat dengan ❤️ oleh ItsReimau dan para kontributor
✦ nirwabot — Useless WhatsApp Bot ✦}