Discord Sunucusunda Guild Tag ile Otomatik Rol Sistemi

Discord Sunucularında Tag ve Rol Sistemi

Discord sunucuları büyüdükçe üyeleri organize etmek zorlaşır. Özellikle belirli bir topluluk tagini taşıyan üyeleri ayırt etmek ve onlara özel ayrıcalıklar vermek, moderatörler için ciddi bir iş yükü oluşturabilir. Biz de tam burada devreye giriyoruz: Guild Tag ile Otomatik Rol Sistemi.

Bu sistem sayesinde, bir üye sunucunun belirlediği tagı aldığında ona otomatik olarak özel bir rol veriliyor, tagı kaybettiğinde ise rol geri alınıyor. Moderatörler sadece uzaktan gülümseyip "Harika, sistem çalışıyor" diyebilir. 😏

Sistem Nasıl Çalışıyor?

Sistemimizin çekirdeği, Discord'un Raw Event'idir. GUILD_MEMBER_UPDATE eventini dinleyerek, üyelerin tag durumunu sürekli kontrol ediyoruz. İşleyişi şöyle:

Üye tag aldıysa ve rolü yoksa: Rol otomatik eklenir, log kanalına yeşil bir embed ile bilgi gönderilir.
Üye tagı kaybettiyse ve rolü varsa: Rol otomatik kaldırılır, kırmızı bir embed ile loglanır.
Spam önleme: Aynı kullanıcıya kısa sürede tekrar işlem yapılmaması için debounceCache kullanılır.

Örnek Kod

Raw event dosyası

import { WosskiClient, Event } from '@repo/client'
import { bold, inlineCode, Colors, EmbedBuilder, TextChannel, GatewayDispatchPayload, Events } from 'discord.js'

const debounceCache = new Map<string, number>()

const config = {
  guildID: '852890250312286218',
  log: '1433226826691514378',
  role: '1415371533483901162'
}

export default class RawEvent extends Event {
  constructor(client: WosskiClient) {
    super(client, { name: Events.Raw })
  }

  async run(client: WosskiClient, packet: GatewayDispatchPayload) {
    if (packet.t !== 'GUILD_MEMBER_UPDATE') return
    const data = packet.d
    if (data.guild_id !== config.guildID) return

    const guild = client.guilds.cache.get(config.guildID)
    if (!guild) return
    const member = guild.members.cache.get(data.user.id)
    if (!member || member.user.bot) return

    const last = debounceCache.get(member.id)
    if (last && Date.now() - last < 3000) return
    debounceCache.set(member.id, Date.now())

    const logChannel = client.channels.cache.get(config.log) as TextChannel | undefined

    const hasTag = data.user.primary_guild?.identity_guild_id === config.guildID
    const hasRole = member.roles.cache.has(config.role)

    if (hasTag && !hasRole) {
      await member.roles.add(config.role).catch(() => {})
      logChannel?.send({
        embeds: [
          new EmbedBuilder()
            .setColor(Colors.Green)
            .setDescription(
              `${member} [${inlineCode(member.id)}] ${bold(`@${member.guild.roles.cache.get(config.role)?.name}`)} verildi`
            )
        ]
      })
    } else if (!hasTag && hasRole) {
      await member.roles.remove(config.role).catch(() => {})
      logChannel?.send({
        embeds: [
          new EmbedBuilder()
            .setColor(Colors.Red)
            .setDescription(
              `${member} [${inlineCode(member.id)}] ${bold(`@${member.guild.roles.cache.get(config.role)?.name}`)} alındı`
            )
        ]
      })
    }
  }
}

Kendi event handlerına göre düzenlemen gerekebilir.