روبوتات ديسكورد تأتي في جميع الأشكال والأحجام ويمكن استخدامها لمجموعة واسعة من الأغراض التي تتراوح من تعديل سلوك المستخدم على الخادم الخاص بك ، وتوجيه العقوبات تلقائيًا مثل كتم الصوت أو حظر اللاعبين الذين يخرجون عن الخط ، إلى اللعب موسيقى ليستمتع بها الجميع.
تفترض الإرشادات أدناه أن لديك بالفعل حساب وخادم على Discord. إذا لم يكن كذلك ، يجب عليك إعداد هذا على discordapp.comقبل المتابعة.
بينما تتم كتابة روبوتات Discord بلغة JavaScript ، لا يتعين عليك أن تكون مبرمجًا متمرسًا لإنشائها. في الواقع ، هذه العملية أقل تخويفًا مما قد تتخيله. استمر في القراءة لتتعلم كيفية صنع Discord Bot الذي يقوم بتقديم عروضك.
هذا البرنامج التعليمي مخصص للمستخدمين الذين يستخدمون أنظمة تشغيل macOS أو Windows.
تنزيل وتثبيت Node.js
قبل البدء في إنشاء برنامج Discord bot ، ستحتاج أولاً إلى تثبيت Node.js ، وهي بيئة وقت تشغيل JavaScript مبنية على محرك V8 من Google Chrome.
-
افتح مستعرض ويب وانتقل إلى صفحة تنزيل Node.js الرسمية.
Image - حدد حزمة المثبت المناسبة لمنصتك الخاصة (macOS أو Windows) وانقر على رابط التنزيل الخاص بها.
-
افتح الملف الذي تم تنزيله واتبع التعليمات التي تظهر على الشاشة لتثبيت Node.js.
- بمجرد الانتهاء ، قم بتشغيل تطبيق Command Prompt(Windows) أو Terminal(macOS).
-
اكتب النص التالي في الموجه واضغط أدخل على لوحة المفاتيح: node -v
Image - إذا تم إرجاع رقم الإصدار ، فسيتم تثبيت Node.js بشكل صحيح. إذا لم يكن كذلك ، قم بإعادة النظر في الخطوات المذكورة أعلاه وتأكد من اكتمال التثبيت.
إنشاء تطبيق Discord
الآن بعد أن أعددت المتطلبات الأساسية بعيدًا ، حان الوقت لإنشاء تطبيق جديد يمكن إضافة الروبوت الخاص بك إليه لاحقًا.
- افتح متصفحًا وانتقل إلى Discord Developer Portal لخادمك ، وقم بتسجيل الدخول إذا لزم الأمر.
-
انقر تطبيق جديد.
Image -
أدخل اسمًا لتطبيقك الجديد في حقل التعديل المتوفر وانقر على Createعندما تكون جاهزًا.
Image -
يجب الآن عرض شاشة المعلومات العامة لتطبيقك الجديد ، كما هو موضح في لقطة الشاشة المصاحبة. حدد بوت، الموجود في جزء القائمة الأيسر.
Image -
انقر فوق إضافة بوت.
Image -
ستظهر الآن رسالة تسألك عما إذا كنت متأكدًا من رغبتك في إضافة روبوت إلى تطبيقك. انقر فوق نعم ، افعل ذلك!
Image -
يجب الآن إنشاء روبوتك الجديد ، مع عرض معلوماته وخياراته في قسم BUILD-A-BOT. حدد انقر للكشف عن الرمز.
Image -
يجب الآن عرض سلسلة طويلة من الأحرف بدلاً من الارتباط المذكور أعلاه. انقر فوق Copyلإرسال هذا الرمز المميز إلى الحافظة الخاصة بك.
Image -
الصق هذا الرمز المميز في ملف نصي الآن باستخدام Notepad أو TextEdit أو أي تطبيق مشابه.
يجب حذف هذا الملف وإزالته من سلة المحذوفات أو سلة المهملات بمجرد الانتهاء من هذا البرنامج التعليمي.
ترميز بوتك
لقد أنشأت روبوتًا وأضفته إلى خادمك. يأتي بعد ذلك الجزء الممتع ، فعليك ترميز الروبوت الخاص بك للقيام بما تريده.
- قم بتشغيل موجه الأوامر(Windows) أو Terminal(macOS) التطبيق.
-
اكتب النص التالي في الموجه واضغط أدخل أو 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 -
قد يتم الآن عرض قائمة بالرسائل التحذيرية ، والتي يمكن تجاهلها طالما لم تظهر أخطاء (ERR) والرسالة الموجودة أسفل موجه الأوامر أو نافذة Terminal تقرأ "تمت إضافة 7 حزم" أو "وأضاف 8 حزم".اكتب ما يلي واضغط على Enter أو Return لإنشاء ملف auth.json: touch auth.json
Image إذا تلقيت رسالة خطأ عند محاولة استخدام الأمر touch ، فقد تحتاج أولاً إلى تثبيته عن طريق إدخال بناء الجملة التالي في موجه الأوامر: npm تثبيت touch-cli -g
-
ستكون هناك رسالة تأكيد تشير إلى أن هذا الملف قد تم إنشاؤه ، ولكن يمكنك كتابة ls -al(macOS) أو dir(Windows) لمشاهدة محتويات دليل مشروعك والتأكد بنفسك من أن auth.json مدرج بالفعل.
Image - قم بتشغيل الكود أو محرر النصوص المفضل لديك مثل Atom أو Notepad أو TextEdit ، وانتقل إلى مجلد المشروع الجديد.
-
افتح ملف auth.jsonوأدخل النص الموضح في لقطة الشاشة المصاحبة ، واستبدل AUTH-TOKEN بسلسلة رمز المصادقة التي قمت بتخزينها مسبقًا في البرنامج التعليمي. احفظ الملف عند الانتهاء.
Image You mustنسخ ولصق سلسلة المصادقة بالكامل داخل علامات الاقتباس المعروضة. إذا فقدت حتى شخصية واحدة ، فلن يعمل برنامج الروبوت الخاص بك كما هو متوقع.
- ارجع إلى المحرر وأنشئ ملفًا جديدًا في مجلد المشروع باسم bot.js.
-
سيحتوي ملف bot.js على الكود الذي يملي سلوك الروبوت الخاص بك ، الأمر متروك لك تمامًا. ومع ذلك ، لأغراض هذا البرنامج التعليمي ، نوصي باستخدام الكود التالي واختبار الروبوت الخاص بك من طرف إلى طرف للتأكد من أن كل شيء يعمل كما هو متوقع. يمكنك بعد ذلك الرجوع وتحرير محتويات bot.js كما تراه مناسبًا.
const Discord=تتطلب ('discord.js') ؛
عميل const=جديد Discord. Client () ؛
const المصادقة=تتطلب ('./ auth.json') ؛
client.on ('جاهز'، ()=> {
console.log (`مسجل الدخول باسم $ {client.user.tag}!`)؛
}) ؛
client.on ('message'، msg=> {
if (msg.content==="مرحبًا") {
msg.reply ("hi!")؛
}
}) ؛
client.login (auth.token) ؛
سيكتب نموذج الكود هذا رسالة إلى وحدة تحكم سطر الأوامر عند استدعاء الروبوت ، مما يؤكد تسجيل دخول ناجح ويحتوي على علامة المستخدم الخاصة بك.
- احفظ الملف المحدث bot.js.
- ارجع إلى موجه الأوامر أو المحطة الطرفية واكتب ما يلي لتشغيل البرنامج النصي للروبوت: node bot.js
- إذا كنت قد فعلت كل شيء بشكل صحيح حتى هذه النقطة ، فيجب أن يظهر النص التالي في موجه الأوامر أو النافذة الطرفية: تم تسجيل الدخول كـ discord-test-bot
دمج كود البوت مع خادمك
أنت على وشك الانتهاء…
- افتح متصفحًا وانتقل إلى Discord Developer Portal لخادمك ، وقم بتسجيل الدخول إذا لزم الأمر.
-
حدد التطبيق الذي أنشأناه سابقًا من شاشة تطبيقاتي ، إذا طُلب منك ذلك.
Image -
انقر فوق OAuth2، الموجود في جزء القائمة الأيسر.
Image -
قم بالتمرير إلى أسفل الشاشة حتى تحدد قسم SCOPES. ضع علامة اختيار بجوار الخيار botبالنقر فوقه مرة واحدة.
Image -
قم بالتمرير لأسفل مرة أخرى إلى قسم BOT PERMISSIONS ، مع وضع علامات اختيار بجوار كل نوع إذن قد يحتاجه الروبوت الفردي الخاص بك للعمل كما هو متوقع.لأغراض هذا المثال البوت ، نحتاج إلى الأذونات التالية: إرسال الرسائل ، قراءة سجل الرسائل
Image من المحتمل أن يحتاج برنامج الروبوت الخاص بك إلى مجموعة مختلفة من الأذونات. من المهم فهم ما يستلزمه كل إذن قبل تمكينه ، حتى لا يتمكن مستخدمو الروبوت من استغلاله لأغراض شائنة.
-
انقر فوق Copy، الموجود بين أقسام SCOPES و BOT PERMISSIONS ويرافقه عنوان URL طويل.
Image - افتح علامة تبويب متصفح جديدة والصق عنوان URL هذا في شريط العنوان ، واضغط على Enter أو Returnلتحميل الصفحة.
-
يجب الآن عرض واجهة CONNECT TO DISCORD ، كما هو موضح في لقطة الشاشة المصاحبة. انقر فوق حدد خادمًاواختر اسم الخادم الخاص بك من القائمة المتوفرة.
Image -
انقر فوق تخويل.
Image -
ضع علامة اختيار بجوار أنا لست روبوتًابالنقر فوق مربع الاختيار الخاص به مرة واحدة.
Image -
يجب الآن عرض رسالة تأكيد ، مع الإشارة إلى أن الروبوت الخاص بك مرخص له وتمت إضافته إلى الخادم الخاص بك.
Image
كيفية اختبار الروبوت الخاص بك على الخادم
يمكنك اختبار الروبوت الخاص بك عن طريق تشغيل عميل Discord وإرسال الأوامر أو الرسائل التي تتوافق مع الرمز الخاص بك. في هذا المثال ، أرسل الكلمة hello إلى الروبوت الخاص بك ويجب أن ترد بـ hi!
