Memulai

Laman ini memberikan sedikit introduksi untuk modul ini. Kami akan mengasumsikan kalau anda sudah menginstall modul, jika belum mohon kunjungi bagian Memasang.

Bot minimalis

Mari kita buat bot yang akan merespon pesan spesifik.

Kurang lebih akan terlihat seperti ini:

import discord

client = discord.Client()

@client.event
async def on_ready():
    print(f'We have logged in as {client.user}')

@client.event
async def on_message(message):
    if message.author == client.user:
        return

    if message.content.startswith('$hello'):
        await message.channel.send('Hello!')

client.run('your token here')

Mari kita namakan filenya menjadi example_bot.py. Pastikan namanya bukan ndiscord.py karena akan konflik dengan nama modul ini.

Melihat sekilas, banyak sekali hal yang kita akan jelaskan satu-per-satu.

1. Baris pertama yaitu import modul, jika terjadi error ModuleNotFoundError atau ImportError disarankan anda mengunjungi bagian Memasang untuk melakukan instalasi dengan benar.

2. Lalu, kita buat instansi Client. Klien ini akan menjadi jembatan koneksi kita ke Discord.

3. Lalu kita menggunakan dekorator Client.event() untuk mendaftarkan event. Modul ini memiliki banyak sekali event. Dikarenakan modul ini bersifat asynchronous, maka kita melakukan berbagai hal dengan sistem "callback".

   Callback simpelnya adalah fungsi yang dipanggil jika sesuatu terjadi. Dicontoh ini, event on_ready() dipanggil jika bot selesai masuk dan terhubung ke Discord dan event on_message() dipanggil jika bot mendapatkan pesan.

4. Dikarenakan on_message() dipanggil tiap bot menerima pesan, maka kita harus mengabaikan pesan yang dikirim oleh bot kita sendiri. Kita dapat melakukannya dengan memeriksa apakah Message.author sama dengan Client.user.

5. Lalu, kita bisa memeriksa apabila Message.content mulai dengan $hello. Jika iya, kita akan mengirim ke kanal di mana perintah itu digunakan dengan Hello!. Ini adalah cara simpel memproses perintah, yang kita dapat buat lebih mudah dengan kerangka discord.ext.commands -- Kerangka perintah Bot.

6. Akhirnya, kita dapat menjalankan bot dengan token kita. Jika kalian butuh bantuan mendapatkan token atau membuat akun bot, mohon lihat Membuat akun Bot baru.

Sekarang kita sudah beres membuat basis botnya, kita harus jalankan botnya. Untungnya, karena ini hanyalah skrip Python biasanya, kita bisa langsung jalankan.

Windows:

$ py -3 example_bot.py

Sistem lain:

$ python3 example_bot.py

Sekarang anda dapat mengutak-atik bot simpel anda.