Skip to content

Bot kuis interaktif Discord dengan soal Excel, leaderboard, dan sistem role admin.

Notifications You must be signed in to change notification settings

ajoikafeb/QuizzBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

4 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿค– Bot Kuis Interaktif Discord

Bot ini adalah bot kuis pilihan ganda berbasis Discord yang dirancang untuk komunitas, edukasi, dan hiburan. Dilengkapi dengan sistem poin berbasis kecepatan, leaderboard, soal bergambar, dan integrasi file Excel.


๐Ÿš€ Fitur Utama

  • โœ… Command !quizz untuk membuka sesi kuis dan tombol join
  • โœ… Command !start untuk memulai kuis otomatis (15 detik/soal)
  • โœ… Command !result untuk menampilkan skor akhir (dengan tag & emoji juara)
  • ๐Ÿ–ผ๏ธ Soal mendukung gambar (via URL)
  • ๐Ÿ“ฅ Impor soal dari file Excel (soal_kuis.xlsx)
  • โฑ๏ธ Leaderboard otomatis setelah setiap soal
  • ๐Ÿ” Hanya admin (role QuizMaster) yang bisa memulai & mengakhiri kuis
  • ๐Ÿง  Anti-spam: user hanya bisa menjawab satu kali per soal

๐Ÿ“ Struktur File Excel (soal_kuis.xlsx)

Pertanyaan A B C D Jawaban Gambar (Opsional)
Siapakah presiden pertama RI? Soekarno Soeharto Habibie Jokowi A
Ibukota Jepang? Kyoto Osaka Tokyo Nagoya C
Bendera merah putih ini milik? Indonesia Polandia Jepang Singapura A https://upload.wikimedia.org/.../Flag_of_...

๐Ÿ”ง Cara Menjalankan Bot

  1. Install dependensi:

    pip install discord.py openpyxl
  2. Atur token:

    • Ganti bot.run("ISI_TOKEN_DISINI") dengan token bot Discord kamu.
  3. Letakkan file soal Excel (soal_kuis.xlsx) di direktori yang sama dengan bot.py.

  4. Jalankan bot:

    python bot.py

๐ŸŽฎ Perintah Bot

Perintah Fungsi
!quizz Membuka tombol join kuis
!start Memulai kuis otomatis per soal (admin only)
!result Menampilkan leaderboard akhir (admin only)

๐Ÿ›ก๏ธ Role Admin

Untuk menggunakan perintah !start dan !result, user harus memiliki role Discord bernama:

QuizMaster/role lain

๐Ÿ“œ Lisensi

MIT License ยฉ 2024 โ€“ KuisBot Project

About

Bot kuis interaktif Discord dengan soal Excel, leaderboard, dan sistem role admin.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages