İlk botunu yaz

Sıfırdan, çevrimiçi olan bir Discord botu: Node.js kurulumu, Discord'da uygulama açma, token, davet linki ve ilk kod.

Dokümantasyon / Bot yazmayı öğren / İlk botunu yaz

  1. Uygulamayı aç

    Discord Developer Portal'da yeni uygulama oluştur, Bot sekmesinden token al.

  2. Projeyi kur

    Bir klasörde npm init -y ve npm install discord.js dotenv çalıştır.

    npm install discord.js dotenv
  3. Ç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.

Terminalbash
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:

Terminalbash
mkdir benim-botum
cd benim-botum
npm init -y
npm install discord.js dotenv

npm 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.

.envbash
TOKEN=buraya-botunun-tokeni
CLIENT_ID=uygulama-id
GUILD_ID=test-sunucunun-id
Token yanlışlıkla bir yere yapışırsa Developer Portal'dan hemen Reset Token yap. Token'ı bilen biri botunu tamamen kontrol edebilir.

6. İ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.

index.jsjavascript
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.