Dokümantasyon / Bot yazmayı öğren / İlk botunu yaz
- Uygulamayı aç
Discord Developer Portal'da yeni uygulama oluştur, Bot sekmesinden token al.
- Projeyi kur
Bir klasörde npm init -y ve npm install discord.js dotenv çalıştır.
npm install discord.js dotenv - Çalıştır
index.js dosyasını yaz ve node index.js ile başlat.
node index.js
Bu dersin sonunda kendi sunucunda çevrimiçi görünen bir botun olacak. Her adımı sırayla yap; bir adımı atlarsan sonraki çalışmaz.
1. Node.js kur
nodejs.org adresinden LTS sürümünü indirip kur. Kurulumdan sonra terminali (Windows'ta PowerShell) açıp sürümü kontrol et. discord.js v14 için Node.js 18 veya daha yenisi gerekir.
node -v
# v22.x.x gibi bir şey yazmalı2. Discord'da uygulama aç
discord.com/developers/applications adresine git ve New Application ile bir uygulama oluştur. Sonra:
- Bot sekmesi
- Reset Token'a basıp token'ı kopyala. Token botunun şifresidir, kimseyle paylaşma.
- Privileged Gateway Intents
- Mesaj içeriğini okumak istiyorsan Message Content Intent'i, üye katılımlarını izleyeceksen Server Members Intent'i aç.
- Application ID
- General Information sekmesindeki bu sayı komutları kaydederken lazım olacak.
3. Botu sunucuna davet et
OAuth2 sekmesindeki URL Generator'da scopes kısmından bot ve applications.commands'ı seç, izinlerden ihtiyacın olanları işaretle. Oluşan linki tarayıcıda açıp test sunucunu seç.
- Öğrenirken kendine boş bir test sunucusu aç; botun hatalarından gerçek sunucun etkilenmesin.
4. Projeyi kur
Bilgisayarında yeni bir klasör aç ve terminali o klasörde çalıştır:
mkdir benim-botum
cd benim-botum
npm init -y
npm install discord.js dotenvnpm init projeyi başlatır (package.json oluşur); npm install kütüphaneleri indirir (node_modules klasörü).
5. Token'ı güvenle sakla
Token'ı koda yazma. Klasörde .env adlı bir dosya aç ve token'ı oraya koy. dotenv bu dosyayı okuyup process.env'e yükler. Kodu GitHub'a koyacaksan .gitignore dosyasına .env yazmayı unutma.
TOKEN=buraya-botunun-tokeni
CLIENT_ID=uygulama-id
GUILD_ID=test-sunucunun-id6. İlk kod: index.js
Klasörde index.js dosyası aç, aşağıdakini yaz ve terminalde node index.js çalıştır. Terminalde "çevrimiçi" yazısını görürsen botun Discord'da yeşil ışık yakar.
require("dotenv").config();
const { Client, Events, GatewayIntentBits } = require("discord.js");
// Intent: botun hangi olayları alacağı. Şimdilik yalnızca sunucu bilgileri.
const client = new Client({ intents: [GatewayIntentBits.Guilds] });
client.once(Events.ClientReady, (c) => {
console.log(`${c.user.tag} olarak çevrimiçi!`);
});
client.login(process.env.TOKEN);Botu durdurmak için terminalde Ctrl + C'ye bas.
- "Used disallowed intents" hatası alırsan Developer Portal'da ilgili intent'i açmamışsındır.