Instalasi • Cara Pakai • Buat Command • Struktur

---

✨ Fitur Utama

• 🧩 Command modular: cukup buat 1 file .js, otomatis termuat
• 🏷️ Alias: satu command banyak nama (ping / p)
• 🛡️ Permission bawaan: ownerOnly, adminOnly, premium
• 🔘 Tombol interaktif: menu native quick reply
• 💾 SQLite bawaan: memakai node:sqlite, tanpa dependency tambahan
• 👤 Manajemen user otomatis
• 🔄 Auto reconnect: scan QR cukup sekali, session tersimpan
• 📝 Logger terpusat

---

📋 Persyaratan

Note

Membutuhkan Node.js v22.5+ karena memakai modul bawaan node:sqlite. Bisa dijalankan di PC, VPS, maupun Termux (Android).

---

🚀 Instalasi

git clone https://github.com/superrrkyy/axybot.git
cd axybot
npm install
cp .env.example .env

Lalu isi file .env:

# Nomor owner (format internasional, tanpa + atau spasi)

<details>
<summary>🇬🇧 English summary</summary>

**axybot Core V5** — a modular WhatsApp bot framework built on Baileys.

- Commands are auto-loaded from `src/commands/<category>/`
- Permission layers: owner, group admin, premium, user
- SQLite storage, message normalizer (text/image/video captions), custom logger
- Ships with an `.env.example` and a plain `npm start`

Read the docs in `README.md` (Indonesian) or open an issue with questions.

</details>

OWNER_NUMBER=628123456789

# (Opsional) LID owner
OWNER_LID=

📱 Instalasi di Termux (ketuk untuk membuka)

pkg update && pkg upgrade -y
pkg install nodejs-lts git -y
node -v   # pastikan v22.5 atau lebih baru
git clone https://github.com/superrrkyy/axybot.git
cd axybot && npm install
cp .env.example .env && nano .env

---

▶️ Menjalankan Bot

npm start      # mode normal
npm run dev    # mode development (auto-restart)

1. QR code muncul di terminal
2. Buka WhatsApp → Perangkat Tertaut → Tautkan Perangkat
3. Scan QR. Jika berhasil, muncul 🟢 WhatsApp Connected

Tip

Session tersimpan di folder sessions/. Untuk login ulang, hapus folder itu lalu jalankan lagi.

---

💬 Cara Pakai

Ketik nama command langsung di chat, tanpa prefix:

Command	Alias	Fungsi
menu	help	Menu interaktif
ping	p	Cek status bot
profile	–	Profil user

---

🧩 Membuat Command Baru

Buat file di src/commands/<kategori>/, contoh src/commands/general/halo.js:

export default {
  name: "halo",
  aliases: ["hai", "hi"],
  description: "Menyapa pengguna",
  category: "general",
  usage: "halo",

  premium: false,   // hanya user premium
  ownerOnly: false, // hanya owner
  adminOnly: false, // hanya admin grup

  async execute({ sock, jid, args }) {
    await sock.sendMessage(jid, {
      text: "👋 Halo! " + (args?.join(" ") || "")
    });
  }
};

Restart bot, dan command halo langsung aktif ✅

---

📁 Struktur Folder

Lihat struktur lengkap

axybot/
├── index.js              # Entry point
├── src/
│   ├── commands/         # Command per kategori
│   │   ├── general/      #   menu, ping, profile
│   │   ├── admin/        #   khusus admin grup
│   │   └── owner/        #   khusus owner
│   ├── core/
│   │   ├── connection.js # Koneksi, QR, reconnect
│   │   ├── loader.js     # Auto-load command
│   │   ├── command.js    # Registry & eksekusi
│   │   ├── message.js    # Handler pesan
│   │   ├── interactive.js# Handler tombol
│   │   ├── normalize.js  # Normalisasi pesan
│   │   ├── permissions.js# Owner/admin/premium
│   │   ├── identity.js   # Identitas owner
│   │   └── logger.js
│   ├── middleware/       # Middleware permission
│   ├── database/         # SQLite
│   └── users/            # Manajemen user
├── sessions/             # Session WA (diabaikan git)
└── .env                  # Konfigurasi (diabaikan git)

---

⚠️ Disclaimer

Warning

axybot memakai Baileys, library WhatsApp tidak resmi, sehingga ada risiko nomor diblokir. Gunakan nomor cadangan, jangan untuk spam, dan patuhi Ketentuan Layanan WhatsApp.

---

🤝 Kontribusi

1. Fork repo ini
2. git checkout -b fitur-baru
3. git commit -m "feat: tambah fitur X"
4. Push lalu buka Pull Request

---

Dibuat dengan 💜 oleh AXRYZURE • Lisensi MIT

_{⭐ Beri bintang jika repo ini membantumu!}