Mencipta bot Discord pertama anda adalah lebih mudah daripada yang anda fikirkan. Anda tidak memerlukan ijazah sains komputer atau pengalaman pengaturcaraan bertahun-tahun. Pada tahun 2026, membina dan menggunakan bot berfungsi mengambil masa hujung minggu jika anda fokus.
Panduan ini membimbing anda melalui keseluruhan proses: mendaftarkan bot anda, menulis arahan pertama anda, mengujinya secara tempatan, dan menggunakannya secara langsung. Menjelang akhir, anda akan mempunyai bot yang berjalan di pelayan anda.
Memahami Apa Itu Bot Discord
Bot Discord ialah program yang bersambung ke Discord melalui API dan bertindak balas kepada peristiwa: apabila seseorang menaip arahan, bertindak balas kepada mesej, menyertai pelayan, dsb.
Konsep utama:
- Aplikasi vs. Bot: "aplikasi" anda didaftarkan dalam Portal Pembangun Discord. "bot" ialah akaun pengguna yang dikaitkan dengan aplikasi itu. Satu aplikasi mempunyai satu bot.
- Token: Kunci rahsia yang mengesahkan bot anda. Jangan sekali-kali berkongsi ini. Ia seperti kata laluan ke bot anda.
- Niat: Kebenaran yang membolehkan bot anda melihat peristiwa tertentu (mesej, reaksi, perubahan status ahli, dsb.). Anda hanya mendayakan perkara yang anda perlukan.
- Arahan: Bot bertindak balas kepada arahan. Bot moden menggunakan arahan slash (
/arahan) dan bukannya arahan awalan (!arahan). Arahan slash disokong dan disyorkan secara rasmi. - Peristiwa: Bot anda mendengar peristiwa Discord (mesej dihantar, reaksi ditambah, ahli menyertai) dan bertindak balas kepadanya.
Langkah 1: Daftar Bot Anda di Portal Pembangun Discord
Di sinilah bot anda wujud secara rasmi dalam sistem Discord.
Proses:
- Pergi ke Portal Pembangun Discord
- Log masuk dengan akaun Discord anda
- Klik "Aplikasi Baharu"
- Namakannya (cth., "Bot Pertama Saya")
- Klik "Cipta"
- Anda kini berada dalam tetapan aplikasi anda
Sekarang cipta pengguna bot:
- Pergi ke bahagian "Bot" (bar sisi kiri)
- Klik "Tambah Bot"
- Di bawah nama pengguna bot, anda akan melihat butang "TOKEN"
- Salin token — ini ialah cara bot anda mengesahkan. Rahsiakan ini. Jangan sekali-kali berkongsinya secara terbuka atau melakukan ke GitHub tanpa penyulitan.
Konfigurasikan tetapan bot:
- Dayakan "Niat Kandungan Mesej" (membolehkan bot membaca teks mesej)
- Dayakan "Niat Ahli Pelayan" (membolehkan bot melihat siapa yang berada di pelayan)
- Tatal ke bawah ke bahagian "OAuth2"
Langkah 2: Hasilkan Pautan Jemputan Bot Anda
Anda memerlukan pautan jemputan khas untuk menambahkan bot ke pelayan.
Dalam Portal Pembangun:
- Pergi ke "OAuth2" → "Penjana URL"
- Di bawah "SKOP", semak:
bot - Di bawah "KEBENARAN", pilih perkara yang boleh dilakukan oleh bot anda:
Hantar Mesej(penting untuk mana-mana bot)Urus Mesej(jika anda menyederhanakan)Tambah Reaksi(jika bot bertindak balas kepada sesuatu)Sambung+Bercakap(jika ia bot muzik/suara)- Untuk pembelajaran, hanya pilih
Hantar Mesej+Baca Mesej(minimum berdaya maju)
- Salin URL yang dijana di bahagian bawah
- Kongsikan URL ini dengan pemilik pelayan (atau gunakannya sendiri untuk menambah ke pelayan ujian anda sendiri)
Jangan gunakan kebenaran Pentadbir kecuali benar-benar perlu. Kebenaran berlebihan adalah risiko keselamatan.
Langkah 3: Pilih Bahasa dan Rangka Kerja Anda
Dua pilihan utama untuk pemula:
JavaScript (discord.js)
Discord.js ialah rangka kerja bot Discord yang paling popular. Komuniti yang besar, banyak tutorial dan dokumentasi yang sangat baik.
Kebaikan:
- Komuniti terbesar dan kebanyakan tutorial dalam talian
- Dokumentasi discord.js sangat baik
- Node.js digunakan secara meluas dan mudah dipelajari
- Penggunaan mudah ke kebanyakan platform pengehosan
Keburukan:
- JavaScript mempunyai keanehan (lengkung pembelajaran async/await)
- Node.js menambah overhed memori berbanding Python
Mulakan:
- Pasang Node.js (v18+)
- Cipta folder projek
npm init -ynpm install discord.js
Python (discord.py)
Sintaks yang lebih mudah, bagus untuk pemula, sangat baik untuk mempelajari asas.
Kebaikan:
- Sintaks paling mudah untuk dipelajari
- Intuitif untuk pemula
- Dokumentasi discord.py adalah baik
- Python digunakan di mana-mana (sains data, web, automasi)
Keburukan:
- Komuniti yang lebih kecil daripada discord.js (tetapi masih besar)
- Lebih sedikit tutorial daripada JavaScript
- Penggunaan memori yang sedikit lebih tinggi
Mulakan:
- Pasang Python 3.10+
- Cipta folder projek
pip install discord.py
Cadangan untuk pemula: Jika anda tahu Python, gunakan discord.py. Jika anda tahu JavaScript, gunakan discord.js. Jika anda tidak tahu kedua-duanya, Python lebih mudah dipelajari, tetapi JavaScript mempunyai lebih banyak sumber dalam talian. Pilih satu dan komited.
Langkah 4: Tulis Bot Pertama Anda (Contoh Python)
Berikut ialah bot Discord berfungsi minimum dalam Python yang bertindak balas kepada arahan:
import discord
from discord.ext import commands
# Cipta bot dengan awalan arahan dan niat
intents = discord.Intents.default()
intents.message_content = True
bot = commands.Bot(command_prefix='!', intents=intents)
@bot.event
async def on_ready():
print(f'{bot.user} telah bersambung ke Discord!')
@bot.command(name='hello', help='Mengucapkan hello')
async def hello(ctx):
await ctx.send(f'Hello {ctx.author.name}!')
@bot.command(name='ping', help='Bertindak balas dengan pong')
async def ping(ctx):
await ctx.send('Pong!')
bot.run('TOKEN_ANDA_DI_SINI')
Apa yang dilakukan oleh ini:
- Bersambung ke Discord
- Mendengar arahan
!hellodan!ping - Bertindak balas dengan mesej apabila dicetuskan
Untuk menjalankannya:
- Gantikan
'TOKEN_ANDA_DI_SINI'dengan token sebenar anda dari Langkah 1 - Simpan sebagai
bot.py - Jalankan:
python bot.py - Dalam Discord, taip
!hellodalam mana-mana saluran - Bot bertindak balas: "Hello [NamaAnda]!"
Langkah 5: Uji Secara Tempatan
Sebelum menggunakan, uji bot anda secara tempatan (pada komputer anda).
Sediakan pelayan ujian:
- Cipta pelayan Discord peribadi untuk ujian
- Tambahkan bot anda padanya menggunakan pautan jemputan dari Langkah 2
- Jalankan kod bot anda secara tempatan
- Taip arahan dalam pelayan ujian
- Perhatikan ralat dalam terminal anda; betulkannya
Ralat biasa:
- "Token tidak sah" — Anda menyalin token dengan salah atau ia telah tamat tempoh. Jana semula dalam Portal Pembangun.
- "Kebenaran hilang" — Bot tidak mempunyai kebenaran untuk melakukan tindakan itu dalam saluran ini. Tambah kebenaran atau gunakan saluran di mana bot mempunyai lebih banyak hak.
- "Niat tidak didayakan" — Anda perlu mendayakan niat dalam Portal Pembangun (Niat Kandungan Mesej, Niat Ahli Pelayan, dsb.)
Uji dengan teliti. Bot dengan pepijat dalam pengeluaran adalah memalukan.
Langkah 6: Tambah Lebih Banyak Arahan
Sekarang anda memahami asasnya, kembangkan dengan lebih banyak ciri.
Contoh Python — arahan ekonomi mudah:
@bot.command(name='balance', help='Semak baki syiling anda')
async def balance(ctx):
# Dalam bot sebenar, ini akan menanyakan pangkalan data
# Buat masa ini, hanya kembalikan nilai olok-olok
await ctx.send(f'{ctx.author.name}, anda mempunyai 100 syiling!')
@bot.command(name='roll', help='Golek dadu (1-6)')
async def roll(ctx):
import random
result = random.randint(1, 6)
await ctx.send(f'{ctx.author.name} digolek: **{result}**')
Setiap arahan ialah fungsi mudah. Tambah seberapa banyak yang anda mahu.
Langkah 7: Gunakan Bot Anda
Pengehosan secara tempatan berfungsi untuk ujian, tetapi bot anda berhenti apabila anda menutup komputer riba anda. Gunakan ke pelayan supaya ia berjalan 24/7.
Pilihan Pengehosan Percuma
Replit (paling mudah untuk pemula):
- Pergi ke Replit.com
- Cipta Repl baharu → Python (atau Node.js)
- Tampal kod bot anda
- Klik "Jalankan"
- Replit mengehoskannya secara percuma (dengan batasan: mungkin tidur selepas tidak aktif)
Railway.app (moden, boleh dipercayai):
- Pergi ke Railway.app
- Sambungkan GitHub (atau muat naik fail secara terus)
- Cipta projek baharu → pilih bot anda
- Railway menggunakan secara automatik
- Peringkat percuma termasuk kredit bulanan $5
Glitch (serupa dengan Replit):
- Pergi ke Glitch.com
- Cipta projek baharu
- Tampal kod
- Glitch memastikan ia berjalan (dalam had peringkat percuma)
Penting: Jangan kodkan token anda dalam kod yang anda tolak ke GitHub. Gunakan pemboleh ubah persekitaran:
import os
from dotenv import load_dotenv
load_dotenv()
TOKEN = os.getenv('DISCORD_TOKEN')
bot.run(TOKEN)
Cipta fail .env secara tempatan (tambah pada .gitignore supaya ia tidak dilakukan):
DISCORD_TOKEN=token_sebenar_anda_di_sini
Pada Replit/Railway, tetapkan token sebagai pemboleh ubah persekitaran rahsia dalam tetapan platform (bukan dalam kod).
Kesilapan Pemula Biasa
Kesilapan 1: Mengekodkan token Jangan sekali-kali meletakkan token anda dalam kod yang anda tolak ke GitHub. Bot dengan token yang bocor dikompromi serta-merta. Gunakan pemboleh ubah persekitaran.
Kesilapan 2: Tidak mengendalikan ralat Bot anda ranap pada input yang tidak dijangka. Tambah pengendalian ralat:
@bot.command()
async def divide(ctx, a: int, b: int):
try:
result = a / b
await ctx.send(result)
except ZeroDivisionError:
await ctx.send('Tidak boleh dibahagi dengan sifar!')
except ValueError:
await ctx.send('Sila masukkan nombor yang sah!')
Kesilapan 3: Tidak menghormati had kadar Discord mengehadkan kelajuan anda boleh menghantar mesej. Jangan spam API. Tambah kelewatan antara tindakan pukal.
Kesilapan 4: Mengabaikan niat Banyak bot pemula gagal kerana mereka tidak mendayakan niat yang diperlukan dalam Portal Pembangun. Semak niat yang diperlukan oleh bot anda sebelum digunakan.
Kesilapan 5: Skop terlalu bercita-cita tinggi Jangan cuba membina sistem ekonomi, penyederhanaan, muzik dan 50 arahan dalam bot pertama anda. Mulakan dengan 3-5 arahan mudah. Kembangkan sebaik sahaja anda selesa.
Langkah Seterusnya
Sekarang anda mempunyai bot asas:
- Kembangkan kefungsian: Tambah lebih banyak arahan, gunakan pangkalan data untuk mengekalkan data, laksanakan logik yang kompleks
- Gunakan arahan slash: Sintaks
/arahanmoden dan bukannya arahan awalan - Tambah reaksi: Benarkan pengguna mengklik butang atau bertindak balas dengan emoji
- Sambungkan pangkalan data: Simpan data pengguna, syiling, keutamaan (SQLite untuk pemula, PostgreSQL untuk skala)
- Sertai komuniti: Komuniti pembangun bot Discord (reddit.com/r/discordbots, pelayan sokongan Discord.js) mempunyai jawapan kepada setiap soalan
Sumber
- dokumentasi discord.js: https://discord.js.org
- dokumentasi discord.py: https://discordpy.readthedocs.io
- Dokumen API Discord: https://discord.com/developers/docs/intro
- Tutorial YouTube: Cari "[discord.js/discord.py] tutorial" — sejumlah besar kandungan
Bot Discord pertama anda ialah projek hujung minggu. Bot Discord baik pertama anda ialah latihan selama sebulan. Bot pertama anda yang digunakan oleh 1,000 pelayan ialah berbulan-bulan lelaran, pembangunan ciri dan pembinaan komuniti. Mulakan sekarang, ulangi secara berterusan, dan jangan terlalu memikirkannya.