Dokümantasyon / Bot yazmayı öğren / JavaScript nasıl çalışır
- Değerler kutulara konur
const ile bir değere isim verirsin: const isim = "Aegis".
- Fonksiyonlar iş yapar
Bir fonksiyon girdi alır, bir şey yapar, sonuç döndürür.
- Bot olayları dinler
Biri komut yazınca Discord bir olay gönderir, senin fonksiyonun çalışır.
JavaScript, satır satır yukarıdan aşağı okunan bir dildir. Bir Discord botu aslında bilgisayarında ya da bir sunucuda sürekli açık duran bir JavaScript programıdır. Node.js bu programı tarayıcı dışında çalıştırır; discord.js ise Discord ile konuşmayı kolaylaştıran bir kütüphanedir. Bu derste kodu okuyabilecek kadar JavaScript öğreneceksin.
Değerler ve değişkenler
Programdaki her şey bir değerdir: metin, sayı, doğru/yanlış. Bir değere isim vermek için const kullanırsın. Sonradan değişecekse let kullanırsın.
const botAdi = "Aegis"; // metin (string)
const uyeSayisi = 425; // sayı (number)
const korumaAcik = true; // doğru/yanlış (boolean)
let uyari = 0; // let: değeri sonradan değişebilir
uyari = uyari + 1;
console.log(botAdi, uyeSayisi, korumaAcik, uyari);
// Ekrana yazar: Aegis 425 true 1console.log terminale yazı basar; kodunun ne yaptığını görmenin en kolay yoludur.
- // ile başlayan satırlar yorumdur, bilgisayar onları okumaz. Kendine not bırakmak için kullan.
Fonksiyonlar
Fonksiyon, bir işi paketleyip istediğin zaman çalıştırmanı sağlar. Parantez içindekiler girdidir, return sonucu geri verir.
function selamla(isim) {
return "Merhaba, " + isim + "!";
}
// Aynı şeyin kısa yazımı (ok fonksiyonu):
const selamla2 = (isim) => `Merhaba, ${isim}!`;
console.log(selamla("Deniz")); // Merhaba, Deniz!
console.log(selamla2("Mert")); // Merhaba, Mert!Ters tırnak (`) içinde ${...} yazarak metnin içine değer koyabilirsin.
Nesneler ve diziler
Nesne, ilgili değerleri bir arada tutar ve noktayla okunur. Dizi ise sıralı bir listedir. discord.js'teki her şey (üye, mesaj, kanal) birer nesnedir.
const uye = {
kullaniciAdi: "deniz_dev",
roller: ["Üye", "Yetkili"], // dizi
bot: false,
};
console.log(uye.kullaniciAdi); // deniz_dev
console.log(uye.roller[0]); // Üye (sayım 0'dan başlar)
console.log(uye.roller.length); // 2
console.log(uye.roller.includes("Yetkili")); // trueKoşullar
if ile "şu doğruysa bunu yap" dersin. === iki değerin aynı olup olmadığını kontrol eder; ! bir şeyi tersine çevirir.
const mesaj = "discord.gg/bedava-nitro";
if (mesaj.includes("discord.gg/")) {
console.log("Davet linki var, mesajı sil.");
} else if (mesaj.length > 2000) {
console.log("Mesaj çok uzun.");
} else {
console.log("Sorun yok.");
}Olaylar
Bot kendi başına bir şey yapmaz; bir şey olmasını bekler. client.on("olay", fonksiyon) yazdığında "bu olay olunca bu fonksiyonu çalıştır" demiş olursun. Bu fonksiyona geri çağırma (callback) denir.
const { Client, Events, GatewayIntentBits } = require("discord.js");
const client = new Client({ intents: [GatewayIntentBits.Guilds] });
// Bot Discord'a bağlanınca bir kez çalışır
client.once(Events.ClientReady, (c) => {
console.log(`${c.user.tag} çevrimiçi!`);
});
// Biri slash komutu kullandıkça çalışır
client.on(Events.InteractionCreate, (interaction) => {
console.log("Bir komut geldi:", interaction.commandName);
});once yalnızca ilk seferde, on ise her seferinde çalışır.
Beklemek: async ve await
Discord'a mesaj göndermek internet üzerinden olur ve biraz zaman alır. Böyle işler bir Promise (söz) döndürür. Sonucu beklemek için fonksiyonun başına async, beklenen işin başına await yazarsın.
client.on(Events.InteractionCreate, async (interaction) => {
// await: Discord cevabı alana kadar bekle, sonra devam et
await interaction.reply("Bir saniye...");
await interaction.editReply("Tamam, hazır!");
});await yalnızca async bir fonksiyonun içinde kullanılabilir.
- Bir şey ters giderse await hata fırlatır. try { ... } catch (hata) { ... } ile yakalayıp botun çökmesini önleyebilirsin.
Hepsi bir arada: örnek komut
Şimdi öğrendiklerini birleştirelim. Bu kod /zar komutu gelince 1 ile 6 arasında rastgele bir sayı atar. Her satırı artık okuyabiliyorsun.
client.on(Events.InteractionCreate, async (interaction) => {
// Slash komutu değilse (ör. düğme) hiçbir şey yapma
if (!interaction.isChatInputCommand()) return;
if (interaction.commandName === "zar") {
const sayi = Math.floor(Math.random() * 6) + 1; // 1-6
await interaction.reply(`Zar: **${sayi}**`);
}
});Math.random() 0 ile 1 arasında sayı verir; 6 ile çarpıp aşağı yuvarlayıp 1 eklersek 1-6 olur.