الخلاف هي واحدة من أكثر المنصات شعبية للاتصال والتنسيق في المجتمعات عبر الإنترنت. ومع ذلك ، فهي أيضا أداة قوية لإنشاء وتكوين الخوادم الخاصة بك. واحدة من أكثر الميزات المفيدة للخلاف هي القدرة على استخدام الروبوتات. يمكن للروبوتات أداء مهام مختلفة ، بما في ذلك تعيين الأدوار تلقائيا للمستخدمين.
في هذا الدليل التفصيلي ، سننظر في كيفية إنشاء روبوت الخلاف الذي يصدر الأدوار تلقائيا. سنعرض خطوات إنشاء روبوت ، والتصريح به على الخادم وبرمجة وظيفة تعيين الدور التلقائي. سوف تتعلم كيفية استخدام أبي ديسكورد والمكتبة Discord.py لإنشاء الروبوت الخاص بك.
هذا الدليل مخصص لأولئك الذين لديهم بعض الخبرة في برمجة بايثون ولديهم فهم أساسي لواجهة برمجة تطبيقات ديسكورد. لكن لا تقلق إذا لم تكن لديك مثل هذه التجربة — سنحاول شرح كل خطوة بأكبر قدر ممكن من التفاصيل والوضوح.
ملاحظة: إنشاء واستخدام الروبوتات للخلاف يعني الامتثال لقواعد النظام الأساسي. يرجى قراءة قواعد الخلاف والتأكد من أن الروبوت الخاص بك لا ينتهك أي قواعد ولا ينتهك خصوصية المستخدم.
- الشروع في العمل مع بوت
- تثبيت وتكوين البرامج اللازمة
- إنشاء حساب على منصة الخلاف
- تطوير وظائف الروبوت لإصدار الأدوار
- اختبار وإطلاق الروبوت على خادم الخلاف
الشروع في العمل مع بوت
لبدء العمل مع روبوت الخلاف ، والذي سيعين الأدوار تلقائيا ، ستحتاج إلى:
1. إنشاء حساب بوت
الخطوة الأولى هي إنشاء حساب بوت على منصة الخلاف. للقيام بذلك ، انتقل إلى الموقع https://discordapp.com/developers/applications وتسجيل الدخول باستخدام حساب الخلاف الخاص بك. بعد تسجيل الدخول ، ستتمكن من إنشاء تطبيق جديد والحصول على رمز بوت.
2. إنشاء خادم
لكي يعمل الروبوت ، تحتاج إلى إنشاء خادم يعمل عليه. إذا كان لديك خادم بالفعل ، فيمكنك تخطي هذه الخطوة. إذا لم يكن لديك خادم ، فانتقل إلى لوحة تحكم الخلاف وانقر على "إنشاء خادم". قم بتعيين اسم للخادم وحدد منطقته. بعد إنشاء الخادم ، انسخ معرفه.
3. دعوة بوت إلى الخادم
احصل على رابط لدعوة الروبوت إلى الخادم باستخدام الرمز المميز الخاص به. للقيام بذلك ، انقر على الرابط في النموذج:
https://discordapp.com/oauth2/authorize?client_id=ВАШ_ИДЕНТИФИКАТОР_БОТА&scope=bot&permissions=ВАШИ_ПРАВА
بدلا من" الروبوت الخاص بك "، حدد معرف الروبوت الخاص بك ، وبدلا من" صلاحك " ، حدد الحقوق التي تريد منحها للبوت. بعد إعداد الرابط ، افتحه في المتصفح وحدد الخادم الخاص بك لدعوة الروبوت.
4. تثبيت وتكوين البرنامج
لبدء برمجة الروبوت الخاص بك وإضافة تعيين الدور التلقائي ، ستحتاج إلى تثبيت البرنامج وتكوينه. سوف تحتاج:
- تثبيت بايثون (https://www.python.org/downloads /)
- تثبيت المكتبة discord.py : افتح موجه الأوامر وقم بتشغيل الأمر " تثبيت النقطة discord.py "
5. اكتب رمز الروبوت
بعد تثبيت البرنامج وتكوينه ، يمكنك البدء في كتابة التعليمات البرمجية للبوت الخاص بك. استخدم المكتبة discord.py لإنشاء وتكوين بوت. لإضافة تخصيص دور تلقائي ، ستحتاج إلى استخدام وظائف إدارة الدور.
أنت الآن جاهز لإنشاء روبوت للخلاف ، والذي سيعين الأدوار تلقائيا. اتبع الخطوات المذكورة أعلاه وسيكون الروبوت الخاص بك جاهزا للاستخدام!
تثبيت وتكوين البرامج اللازمة
1. تثبيت العقدة.شبيبة .
عقدة.شبيبة هي بيئة وقت تشغيل جافا سكريبت تسمح لك بتشغيل البرامج النصية على الخادم. يمكنك تنزيله وتثبيته من الموقع الرسمي https://nodejs.org . يوصى بتحديد أحدث إصدار ثابت أثناء التثبيت.
2. إنشاء مجلد جديد للمشروع.
انتقل إلى الدليل الذي تريده ، وافتح موجه الأوامر وقم بتشغيل الأمر التالي:
مكدير ماي ديسكورد بوتسي دي ماي ديسكورد بوت
قم بتشغيل الأمر
الآلية الوقائية الوطنية الحرف الأول
قم بتشغيل الأمر
| الآلية الوقائية الوطنية تثبيت الخلاف.شبيبة | في سطر الأوامر المشروع. الخلاف.شبيبة هي مكتبة لإنشاء روبوتات الخلاف باستخدام العقدة.شبيبة . يحتوي على جميع الأدوات والوظائف اللازمة للتفاعل مع واجهة برمجة تطبيقات الخلاف. |
|---|---|
| الفريق | الوصف |
من الآلية الوقائية الوطنية تثبيت الخلاف.شبيبة
تثبيت الخلاف.شبيبة
5. إنشاء ملف فهرس.شبيبة.
في مجلد المشروع ، قم بإنشاء ملف جديد باسم الفهرس.شبيبة. سيحتوي هذا الملف على الرمز الرئيسي للروبوت الخاص بك. افتح الملف في محرر نصوص واستمر في تكوين الروبوت.
إنشاء حساب على منصة الخلاف
1. انتقل إلى موقع الخلاف الرسمي على discord.com .
2. انقر فوق الزر" فتح الخلاف " في الزاوية اليمنى العليا من الصفحة.
3. في النافذة التي تفتح ، حدد" تسجيل " واتبع التعليمات.
4. أدخل عنوان بريدك الإلكتروني ، وأنشئ كلمة مرور وانقر على "متابعة".
5. أدخل اسم المستخدم الخاص بك ، والذي سيتم عرضه في غرف الدردشة وعلى خوادم الخلاف.
6. أضف صورة لملفك الشخصي. يمكنك تحميل صورة من جهاز الكمبيوتر الخاص بك أو الاختيار من بين الخيارات المقترحة.
7. انقر فوق الزر" متابعة " وانتقل إلى عملية التأكيد إذا لزم الأمر.
مبارك! لقد نجحت في إنشاء حساب على منصة الخلاف. يمكنك الآن البدء في استخدام الخلاف للتواصل مع المستخدمين الآخرين وإنشاء الخوادم والانضمام إليها وإعداد برامج الروبوت.
تطوير وظائف الروبوت لإصدار الأدوار
لإنشاء وظيفة روبوت تقوم تلقائيا بتعيين الأدوار على الخادم في الخلاف ، سنحتاج إلى استخدام الخلاف.جس ، مكتبة مصممة خصيصا للعمل مع أبي ديسكورد.الخطوة الأولى هي تثبيت الخلاف.شبيبة . قم بتشغيل الأمر التالي في سطر الأوامر:
الآلية الوقائية الوطنية تثبيت الخلاف.شبيبةبعد التثبيت ، يمكننا البدء في تطوير وظائف الروبوت. إنشاء ملف جديد واستيراد الخلاف.شبيبة:
كونست الفتنة = تتطلب ('الفتنة.شبيبة);الآن إنشاء كائن عميل الخلاف الجديد:
كونست العميل = الخلاف الجديد.العميل();بعد ذلك ، نخبر الروبوت بما يجب فعله بعد الاتصال بالخادم بنجاح:
العميل.على ('جاهز' ، () = > {وحدة التحكم.سجل ('تسجيل الدخول باسم {{العميل.المستخدم.الوسم}`);
});يمكننا الآن إضافة وظائف من شأنها تتبع الأعضاء الجدد على الخادم وتعيين أدوار معينة لهم تلقائيا. للقيام بذلك ، إنشاء معالج للحدث " غيلدميمبيراد:
العميل.على ('النقابة إضافة' ، عضو = > {
// كود إصدار الدور التلقائي});
داخل المعالج ، يمكننا تحديد منطق تعيين الأدوار. على سبيل المثال ، يمكننا تعيين مشارك جديد دورا معينا ، بشرط أن يكون في محادثة صوتية معينة. للقيام بذلك ، ونحن نستخدم أساليب الكائن عضو وكائن النقابة:
قناة كونست = عضو.نقابة.القنوات.مخبأ.بحث (قناة = > channel.name = = = 'الدردشة الصوتية');إذا (قناة) {
دور كونست = عضو.نقابة.الأدوار.مخبأ.البحث عن (دور => role.name = = = 'عضو جديد');
إذا (دور) {
عضو.الأدوار.إضافة (دور);
}
}
سيبحث هذا الرمز عن محادثة صوتية باسم "الدردشة الصوتية" ، ثم يعين دور" مشارك جديد " لمشارك جديد.
أخيرا ، بعد أن نحدد وظيفة الروبوت،نحتاج إلى توصيله بالخادم باستخدام رمز ترخيص. قم بإنشاء متغير جديد يقوم بتخزين الرمز المميز:
كونست توكن = 'ديسكورد _ بوت توكين';
يمكنك الحصول على رمز مميز عن طريق إنشاء روبوت جديد واستلام الرمز المميز الخاص به على موقع الخلاف الرسمي.
أخيرا ، أضف الكود التالي لتشغيل عميل الخلاف:
العميل.تسجيل الدخول (رمز);بعد تشغيل الروبوت الخاص بك ، سيتتبع تلقائيا الأعضاء الجدد على الخادم ويعين لهم أدوارا معينة وفقا لمنطقك.
الآن لديك الوظيفة الأساسية للبوت لإصدار الأدوار في الخلاف. يمكنك تطويره بشكل أكبر عن طريق إضافة ميزات وإعدادات إضافية. لا ننسى لتثبيت كافة التبعيات اللازمة باستخدام الآلية الوقائية الوطنية كذلك.اختبار وإطلاق الروبوت على خادم الخلاف
1. تسجيل روبوت وتلقي رمز مميزقبل البدء في اختبار الروبوت على خادم الخلاف ، تحتاج إلى تسجيله والحصول على رمز مميز. للقيام بذلك ، انتقل إلى الموقع https://discord .كوم / المطورين / التطبيقات وإنشاء تطبيق جديد.
بعد إنشاء التطبيق ، انتقل إلى علامة التبويب" بوت "وانقر على زر" إضافة بوت". ثم قم بتنشيط خياري" نية التواجد "و" نية أعضاء الخادم".انسخ الرمز المميز المستلم ، والذي سيتم استخدامه لتفويض الروبوت على خادم الخلاف.
2. ربط المكتبة وكتابة التعليمات البرمجية
لكتابة روبوت ، استخدم لغة برمجة بايثون والمكتبة discord.py . قم بتثبيت المكتبة باستخدام الأمر:تثبيت النقطة discord.py
بعد تثبيت المكتبة ، قم بإنشاء ملف مع extension.py واستيراد الوحدات اللازمة:
استيراد الخلاف