Dokümantasyon / Temeller / Discord botları nasıl çalışır
- Davet ile girer
Bot, izinleri yazan bir davet bağlantısıyla sunucuya eklenir.
- Olayları dinler
Discord, sunucuda olan biteni bota anlık olay olarak gönderir.
- İstekle iş yapar
Bot bir şey yapmak istediğinde Discord'a istek gönderir: mesaj sil, rol al, embed yaz.
Bir Discord botu, bir insan yerine bir programın kullandığı özel bir hesaptır. Discord Developer Portal'da bir uygulama olarak oluşturulur, sunucuya davet bağlantısıyla eklenir ve kendi sunucusunda kesintisiz çalışan bir program tarafından yönetilir. Aegis, discord.js v14 kütüphanesiyle yazılmış böyle bir programdır.
Bot bir uygulamadır
Botun adı, avatarı ve gizli bir token'ı vardır. Program bu token ile Discord'a bağlanır; token'ı bilen herkes botu yönetebileceği için yalnızca botun sunucusunda saklanır. Discord'da bot hesaplarının yanında APP etiketi görünür.
Davet ve izinler
Bir botu sunucuna eklemek için Discord'un davet ekranı kullanılır. Bağlantı, botun kim olduğunu ve hangi izinleri istediğini taşır. Sunucuyu seçip onayladığında bot, o izinlerle sunucuya katılır.
https://discord.com/oauth2/authorize?client_id=1527276218007687168&permissions=8&integration_type=0&scope=bot+applications.commands| Parametre | Tür | Açıklama | Örnek |
|---|---|---|---|
| client_id * | kimlik | Hangi botun ekleneceği. | 1527276218007687168 |
| permissions * | sayı | İstenen izinlerin toplamı. 8, Yönetici iznidir. | 8 |
| scope * | liste | bot: sunucuya üye olarak katılır. applications.commands: slash komutlarını kaydeder. | bot+applications.commands |
| integration_type | sayı | 0, botun bir sunucuya eklendiğini belirtir. | 0 |
Olaylar: botun kulağı
Bot çalıştığı sürece Discord Gateway'e açık bir bağlantı tutar. Sunucuda bir şey olduğunda Discord bunu bota olay olarak iletir. Bot yalnızca istediği olay gruplarını (intent) alır; üye listesi ve mesaj içeriği gibi hassas gruplar için Discord ayrıca onay ister.
- MESSAGE_CREATE
- Yeni mesaj. AutoMod küfür ve davet linkini burada yakalar.
- GUILD_MEMBER_ADD
- Yeni üye. Karşılama, otorol, güven skoru ve Anti-Raid sayacı çalışır.
- CHANNEL_DELETE
- Kanal silindi. Anti-Nuke silmeleri sayar.
- GUILD_ROLE_UPDATE
- Rol değişti. Rol logu yazılır, izin değişiklikleri izlenir.
- INTERACTION_CREATE
- Biri slash komutu yazdı ya da bir düğmeye bastı.
- Aegis; sunucu, mesaj, mesaj içeriği, üye, tepki, durum, moderasyon, davet, ses ve webhook olay gruplarını dinler.
İstekler: botun eli
Bot bir şey yapmak istediğinde Discord'un API'sine istek gönderir: mesajı sil, üyeye rol ver, kanalı aç, embed gönder. Discord her isteği botun izinlerine ve rol sırasına göre kontrol eder; izni olmayan isteği reddeder. Çok hızlı istek gönderen botları da geçici olarak yavaşlatır.
Slash komutları
Sohbete / yazdığında Discord, sunucudaki botların kaydettiği komutları listeler. Komutu gönderdiğinde Discord bunu bota bir etkileşim olarak iletir. Bot 3 saniye içinde yanıt vermek ya da "düşünüyor" durumuna geçmek zorundadır; /setup gibi uzun süren komutlar önce düşünme durumuna geçer, iş bitince yanıtı yazar.
{
"type": "APPLICATION_COMMAND",
"data": { "name": "kurulum" },
"guild_id": "…",
"member": { "user": { "username": "sen" } }
}Aegis bunları nasıl birleştirir
Bir yetkilinin hesabı ele geçirildiğinde olan zincir şöyledir:
- 1. Olay
- Kısa sürede art arda CHANNEL_DELETE olayları gelir.
- 2. Sayım
- Aegis aynı kişinin 10 saniyedeki silmelerini sayar ve eşikle karşılaştırır (varsayılan 3).
- 3. İstekler
- Eşik aşılınca o kişinin rolleri geri alınır, sunucu izinleri dondurulur.
- 4. Kayıt
- guvenlik-log kanalına ne olduğunu anlatan bir embed yazılır, kurucuya DM gider.