Skip to content

saeson4.md

Latest commit

 

History

History
140 lines (107 loc) · 4.94 KB

saeson4.md

File metadata and controls

140 lines (107 loc) · 4.94 KB

فصل ۴: شروع کار با discord.js

۴.۱ معرفی کتابخانه discord.js

discord.js یک کتابخانه قدرتمند و انعطاف پذیر برای ساخت ربات های دیسکورد با جاوا اسکریپت/Node.js است.

چرا discord.js؟

  • ساده و مبتدی پسند: نسبت به کتابخانه های دیگر (مثل Eris) یادگیری آسانتری دارد.
  • امن و به روز: بهطور مرتب آپدیت می شود و با آخرین تغییرات API دیسکورد سازگار است.
  • مستندات عالی: مستندات رسمی آن جامع و همراه با مثال است.

۴.۲ ساختار اصلی یک ربات

هر ربات دیسکورد با discord.js سه بخش اصلی دارد:

  1. Client: اتصال ربات به دیسکورد.
  2. Events: پردازش رویداد ها (مثل دریافت پیام).
  3. Commands: اجرای دستورات کاربران.

۴.۳ اتصال ربات به دیسکورد

مراحل راه اندازی اولیه

  1. ایجاد یک Client:

    const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({
  intents: [
    GatewayIntentBits.Guilds, // دسترسی به سرور ها
    GatewayIntentBits.GuildMessages, // دریافت پیام ها
    GatewayIntentBits.MessageContent // خواندن محتوای پیام ها
  ]
});

  2. اتصال با توکن:

    client.login('TOKEN_ربات_خود');

  3. رویداد ready:

    client.on('ready', () => {
  console.log(`✅ ${client.user.tag} آنلاین شد!`);
});

۴.۴ پاسخ به پیام های کاربران

از رویداد messageCreate برای دریافت پیام ها استفاده می شود:

client.on('messageCreate', (message) => {
  // اگر نویسنده پیام خود ربات باشد، پردازش نکند
  if (message.author.bot) return;

  // پاسخ به پیام "سلام"
  if (message.content === 'سلام') {
    message.reply('سلام! چطوری؟ 😊');
  }
});

۴.۵ ساخت اولین دستور (پینگ-پونگ)

client.on('messageCreate', (message) => {
  if (message.content === '!ping') {
    const start = Date.now();
    message.reply('در حال محاسبه پینگ...').then((sentMessage) => {
      const latency = Date.now() - start;
      sentMessage.edit(`🏓 پونگ! تاخیر: ${latency}ms`);
    });
  }
});

۴.۶ کار با اطلاعات پیام

هر شیء message شامل اطلاعات مفیدی است:

  • محتوا: message.content
  • نویسنده: message.author.tag
  • کانال: message.channel.name
  • سرور: message.guild.name

مثال:

client.on('messageCreate', (message) => {
  console.log(
    `پیام از ${message.author.tag} در کانال #${message.channel.name}: ${message.content}`
  );
});

تمرین عملی فصل ۴

۱. رباتی بسازید که به دستور !ساعت زمان فعلی را پاسخ دهد.
۲. دستوری ایجاد کنید که با !کاربر نام و تگ کاربر را برگرداند.
۳. دستور !پاککن را پیاده سازی کنید تا تعداد پیام های مشخصی را پاک کند (اختیاری).

مثال تمرین ۱:

if (message.content === '!ساعت') {
  const time = new Date().toLocaleTimeString('fa-IR');
  message.reply(`ساعت فعلی: ${time}`);
}

مشکلات رایج و راه حل ها

  • ربات آنلاین نمی شود:
    • توکن را بررسی کنید.
    • اینترنت وصل است؟
    • آیا Intentهای لازم در پنل توسعه دهندگان فعال شده اند؟ (راهنمای فعالسازی Intents)
  • ربات به پیام ها پاسخ نمی دهد:
    • Intent MessageContent را اضافه کنید.
    • مطمئن شوید ربات به سرور اضافه شده است.

نکات کلیدی

  • Gateway Intents را در پنل توسعه دهندگان دیسکورد فعال کنید.
  • هرگز توکن ربات را در کد عمومی قرار ندهید (از فایل .env استفاده کنید. فصل ۷ آموزش داده می شود).
  • برای دستورات پیشرفته تر، از Slash Commands استفاده کنید (فصل ۶).

در فصل بعدی، ساخت دستورات پیشرفته تر و کار با Embedها را یاد خواهید گرفت! 🚀