Yuka

Bot Discord serbaguna yang dirancang untuk menjadi asisten andalan di server Anda, dengan fitur moderasi, utilitas, dan kustomisasi yang canggih.

---

Daftar Isi

• Tentang Bot
• Fitur Utama
• Cara Memulai
• Untuk Self-Hosting (Developer)
• Cara Berkontribusi
• Lisensi

---

Tentang Bot

[yuka] adalah sebuah proyek yang lahir dari keinginan untuk menciptakan bot yang tidak hanya fungsional, tetapi juga stabil, cepat, dan mudah digunakan. Dengan arsitektur berbasis fitur yang modern, bot ini dirancang untuk skalabilitas dan pemeliharaan jangka panjang. Baik Anda seorang admin server yang membutuhkan alat moderasi yang kuat, atau komunitas yang menginginkan kustomisasi mendalam, [Nama Bot Anda] siap membantu.

Fitur Utama

✨ Sistem Peran Reaksi (Reaction Roles): Izinkan anggota untuk mendapatkan peran secara mandiri hanya dengan mengklik reaksi emoji. 🛡️ Moderasi Lengkap: Perintah /ban, /kick, /mute, dan /warn dengan sistem logging yang rapi untuk mencatat setiap tindakan moderator. 👋 Selamat Datang & Perpisahan: Sapa anggota baru dengan pesan dan banner gambar yang bisa dikustomisasi penuh. 🛠️ Utilitas Serbaguna: Perintah praktis seperti /serverinfo, /userinfo, dan /avatar untuk mendapatkan informasi dengan cepat. ⚙️ Sangat Dapat Dikonfigurasi: Hampir semua fitur dapat diaktifkan, dinonaktifkan, dan diatur sesuai kebutuhan server Anda. 🚀 Modern & Cepat: Dibangun dengan discord.py terbaru dan menggunakan Slash Commands untuk pengalaman pengguna yang mulus.

Cara Memulai

Cara termudah untuk menggunakan bot ini adalah dengan mengundangnya ke server Anda.

➡️ KLIK DI SINI UNTUK MENGUNDANG BOT KE SERVER ANDA ⬅️

Setelah bot bergabung, Anda bisa mulai menggunakan perintah dengan mengetik / di channel mana pun. Untuk melihat daftar lengkap perintah, gunakan perintah /help atau lihat Dokumentasi Perintah kami.

Butuh bantuan? Bergabunglah dengan Server Dukungan Discord kami!

---

Untuk Self-Hosting (Developer)

Jika Anda ingin menjalankan instance bot ini sendiri, Anda bisa mengikuti langkah-langkah di bawah ini.

Prasyarat

- Python 3.10+
- Poetry (untuk manajemen dependensi)
- Git
- FFmpeg (untuk fitur suara, jika ada)

Instalasi & Konfigurasi

1. Clone repositori ini:

   git clone [https://github.com/USERNAME/REPO.git](https://github.com/USERNAME/REPO.git)
   cd REPO

2. Instal dependensi menggunakan Poetry:

   poetry install

3. Siapkan file konfigurasi Anda: Salin file contoh .env.example menjadi .env.

   # Untuk Windows
   copy .env.example .env
   
   # Untuk Linux/macOS
   cp .env.example .env

4. Isi kredensial Anda: Buka file .env yang baru dibuat dan masukkan Token Bot Discord Anda.

   DISCORD_BOT_TOKEN="TOKEN_ANDA_DI_SINI"

5. Jalankan bot:

   poetry run python -m src.bot

Cara Berkontribusi

Kami sangat terbuka untuk kontribusi dari komunitas! Jika Anda ingin membantu, silakan ikuti alur kerja berikut:

1.  **Fork** repositori ini.
2.  Buat **branch** baru untuk fitur atau perbaikan Anda (`git checkout -b fitur/NamaFiturBaru`).
3.  Lakukan perubahan Anda dan **commit** (`git commit -m "feat: Menambahkan NamaFiturBaru"`).
4.  **Push** ke branch Anda (`git push origin fitur/NamaFiturBaru`).
5.  Buat **Pull Request** ke branch `develop` dari repositori ini.

Pastikan semua tes dan linter (CI) berhasil lolos sebelum meminta review. Untuk detail teknis tentang cara kerja bot, silakan baca [Dokumen Arsitektur](docs/architecture.md).

Lisensi

Proyek ini dilisensikan di bawah **Lisensi MIT**. Lihat file `LICENSE` untuk detail lebih lanjut.