ربات‌های Discord در اشکال و اندازه‌های مختلف هستند و می‌توانند برای طیف وسیعی از اهداف استفاده شوند، از تعدیل رفتار کاربر در سرور شما، اعمال مجازات‌هایی مانند قطع صدا یا ممنوع کردن گیمرهایی که از خط خارج می‌شوند تا بازی کردن. موسیقی برای لذت بردن همه.
دستورالعمل‌های زیر فرض می‌کنند که شما از قبل یک حساب و سرور Discord دارید. اگر نه، باید قبل از ادامه این را در discordapp.com تنظیم کنید.
در حالی که ربات‌های Discord به زبان جاوا اسکریپت نوشته می‌شوند، لازم نیست برای ایجاد آنها یک کدنویس با تجربه باشید. در واقع، این روند بسیار کمتر از آنچه تصور می کنید ترسناک است. به خواندن ادامه دهید تا یاد بگیرید که چگونه یک ربات Discord بسازید که خواسته شما را انجام دهد.
این آموزش برای کاربرانی که از سیستم عامل macOS یا ویندوز استفاده می کنند در نظر گرفته شده است.
دانلود و نصب Node.js
قبل از شروع به کار با ایجاد ربات Discord، ابتدا می خواهید Node.js را نصب کنید، یک محیط زمان اجرا جاوا اسکریپت که بر روی موتور V8 Google Chrome ساخته شده است.
-
مرورگر وب را باز کنید و به صفحه رسمی دانلود Node.js بروید.
Image -
بسته نصب مناسب برای پلتفرم خاص خود (macOS یا Windows) را انتخاب کنید و روی لینک دانلود آن کلیک کنید.
- فایل دانلود شده را باز کنید و برای نصب Node.js دستورات روی صفحه را دنبال کنید.
- پس از تکمیل، برنامه Command Prompt (ویندوز) یا Terminal (macOS) را اجرا کنید.
-
متن زیر را در اعلان تایپ کنید و Enter را روی صفحه کلید خود فشار دهید: node -v
Image - اگر شماره نسخه برگردانده شود، Node.js به درستی نصب شده است. اگر نه، مراحل بالا را مجدداً مشاهده کنید و مطمئن شوید که نصب کامل شده است.
ایجاد یک برنامه Discord
اکنون که پیش نیازها را از سر راه برداشته اید، زمان ایجاد یک برنامه جدید است که ربات شما بعداً می تواند به آن اضافه شود.
- مرورگری را باز کنید و به پورتال توسعه دهنده Discord برای سرور خود بروید و در صورت لزوم وارد شوید.
-
برنامه جدید را کلیک کنید.
Image -
نامی را برای برنامه جدید خود در قسمت ویرایش ارائه شده وارد کنید و پس از آماده شدن، Create را کلیک کنید.
Image -
صفحه اطلاعات عمومی برای برنامه جدید شما باید نمایش داده شود، همانطور که در تصویر همراه نشان داده شده است. Bot را که در منوی سمت چپ یافت می شود، انتخاب کنید.
Image -
Add Bot را کلیک کنید.
Image -
اکنون یک پیام ظاهر می شود که از شما می پرسد آیا مطمئن هستید که می خواهید یک ربات به برنامه خود اضافه کنید. روی بله، این کار را کلیک کنید!
Image -
ربات جدید شما اکنون باید ایجاد شود و اطلاعات و گزینه های آن در بخش BUILD-A-BOT نمایش داده شود. برای آشکار کردن رمز کلیک کنید را انتخاب کنید.
Image -
اکنون باید یک رشته طولانی از کاراکترها به جای پیوند فوق نمایش داده شود. برای ارسال این نشانه به کلیپ بورد، Copy را کلیک کنید.
Image -
این نشانه را فعلاً با استفاده از Notepad، TextEdit یا یک برنامه مشابه در یک فایل متنی جایگذاری کنید.
باید این فایل را حذف کنید و پس از تکمیل این آموزش، آن را از سطل بازیافت یا سطل زباله حذف کنید.
کدنویسی ربات خود
شما یک ربات ایجاد کرده اید و آن را به سرور خود اضافه کرده اید. بعد، بخش سرگرم کننده است، در واقع کدنویسی ربات خود برای انجام آنچه می خواهید.
- Command Prompt (Windows) یا Terminal (macOS) را راه اندازی کنید.
-
متن زیر را در فرمان تایپ کنید و Enter یا Return را روی صفحه کلید خود فشار دهید: mkdir discord-test -ربات
Image می توانید discord-test-bot را با نام دلخواه خود جایگزین کنید.
-
بعد، دستور زیر را تایپ کنید تا به دایرکتوری تازه ایجاد شده خود بروید: cd discord-test-bot
Image -
خط فرمان اکنون باید به روز شود و نام پوشه پروژه پوشه ربات شما را نمایش دهد. عبارت زیر را تایپ کنید و Enter یا Return را بزنید: npm init -y
Image -
همانطور که در تصویر بالا نشان داده شده است، اکنون باید یک فایل با نام package.json در پوشه پروژه شما ایجاد شود. عبارت زیر را در خط فرمان خود تایپ کنید و Enter یا Return را بزنید:
npm install --save discord.js
Image -
اکنون ممکن است فهرستی از پیام‌های WARN نمایش داده شود، که می‌توان آنها را نادیده گرفت تا زمانی که هیچ خطایی (ERR) نشان داده نشده باشد و پیامی که در پایین پنجره خط فرمان یا ترمینال شما می‌خواند «7 بسته اضافه شد» یا “8 بسته اضافه شد”.عبارت زیر را تایپ کنید و Enter یا Return را بزنید تا فایل auth.json ایجاد شود: touch auth.json
Image اگر هنگام تلاش برای استفاده از دستور touch پیام خطایی دریافت کردید، ممکن است ابتدا لازم باشد آن را با وارد کردن دستور زیر در خط فرمان خود نصب کنید: . npm نصب touch-cli -g
-
پیام تأییدی مبنی بر ایجاد این فایل وجود دارد، اما می‌توانید ls -al (macOS) یا dir را تایپ کنید (ویندوز) تا محتویات فهرست پروژه خود را ببینید و خودتان تأیید کنید که auth.json در واقع فهرست شده است.
Image - کد یا ویرایشگر متن دلخواه خود مانند Atom، Notepad یا TextEdit را راه اندازی کنید و به پوشه پروژه جدید خود بروید.
-
فایل auth.json را باز کنید و متن نشان داده شده در تصویر همراه را وارد کنید و AUTH-TOKEN را با رشته رمز احراز هویتی که قبلاً در آموزش ذخیره کرده بودید جایگزین کنید. پس از اتمام فایل را ذخیره کنید.
Image شما باید کل رشته احراز هویت را در گیومه های نشان داده شده کپی و جایگذاری کنید. اگر حتی یک کاراکتر را از دست داده اید، ربات شما آنطور که انتظار می رود کار نخواهد کرد.
- به ویرایشگر بازگردید و یک فایل جدید در پوشه پروژه خود با نام bot.js ایجاد کنید.
-
فایل bot.js حاوی کدی است که رفتار ربات شما را دیکته می کند که کاملاً به شما بستگی دارد. با این حال، برای اهداف این آموزش، توصیه می کنیم از کد زیر استفاده کنید و ربات خود را به صورت انتها به انتها آزمایش کنید تا مطمئن شوید که همه چیز همانطور که انتظار می رود کار می کند. سپس می توانید به عقب برگردید و محتویات bot.js را به دلخواه ویرایش کنید.
const Discord=require('discord.js');
const client=new Discord. Client();
const auth=require('./auth.json');
client.on('ready', ()=> {
console.log(`به عنوان ${client.user.tag} وارد شده‌اید!`);
});
client.on('message', msg=> {
if (msg.content==='سلام') {
msg.reply("سلام!");
}
});
client.login(auth.token);
این کد نمونه هنگام فراخوانی ربات پیامی به کنسول خط فرمان می نویسد که ورود موفقیت آمیز را تأیید می کند و حاوی برچسب کاربر شما است.
- فایل bot.js به روز شده خود را ذخیره کنید.
- به Command Prompt یا Terminal برگردید و موارد زیر را برای اجرای اسکریپت ربات خود تایپ کنید: node bot.js
- اگر همه کارها را تا این مرحله به درستی انجام داده اید، متن زیر باید در خط فرمان یا پنجره ترمینال ظاهر شود: به عنوان discord-test-bot وارد شده اید
کد ربات را با سرور خود ادغام کنید
تقریباً رسیدی…
- مرورگری را باز کنید و به پورتال توسعه دهنده Discord برای سرور خود بروید و در صورت لزوم وارد شوید.
-
برنامه‌ای را که قبلاً ایجاد کردیم، در صورت درخواست از صفحه برنامه‌های من انتخاب کنید.
Image -
OAuth2 را کلیک کنید، واقع در منوی سمت چپ.
Image -
به پایین صفحه بروید تا قسمت SCOPES را پیدا کنید. با یک بار کلیک کردن روی آن، در کنار گزینه bot علامت بزنید.
Image -
دوباره به سمت پایین به بخش اجازه های ربات بروید، علامت های تیک را در کنار هر نوع مجوزی که ربات فردی شما ممکن است به آن نیاز داشته باشد قرار دهید.برای اهداف این ربات نمونه، به مجوزهای زیر نیاز داریم: Send Messages, Read Message History
Image ربات خاص شما احتمالاً به مجموعه ای متفاوت از مجوزها نیاز دارد. مهم است که قبل از فعال کردن هر مجوز بدانیم که شامل چه چیزی است، به طوری که کاربران ربات نتوانند از آن برای اهداف پلید سوء استفاده کنند.
-
Copy را کلیک کنید، که در بین بخش‌های SCOPES و BOT PERMISSIONS قرار دارد و با یک URL طولانی همراه است.
Image - یک برگه مرورگر جدید باز کنید و این URL را در نوار آدرس جایگذاری کنید، Enter یا Return را فشار دهید تا صفحه بارگیری شود.
-
رابط CONNECT TO DISCORD اکنون باید نمایش داده شود، همانطور که در تصویر همراه نشان داده شده است. روی Select a server کلیک کنید و نام سرور خود را از لیست ارائه شده انتخاب کنید.
Image -
Authorize را کلیک کنید.
Image -
یک علامت تیک را در کنار من یک ربات نیستم با یک بار کلیک کردن روی کادر آن علامت بزنید.
Image -
اکنون باید یک پیام تأیید نمایش داده شود، با توجه به اینکه ربات شما مجاز است و به سرور شما اضافه شده است.
Image
چگونه ربات خود را روی سرور آزمایش کنید
می توانید ربات خود را با راه اندازی کلاینت Discord و ارسال دستورات یا پیام هایی که با کد خاص شما مطابقت دارند، آزمایش کنید. در این مثال، کلمه hello را به ربات خود ارسال کنید و باید با hi! پاسخ دهد.
