الأوامر المخصصة

متى يشتغل الأمر

كل أنواع التشغيل وطريقة استخدامها.

الرسائل

النوع	يشتغل لما	مثال
أي رسالة	أي رسالة في قنوات تختارها، حتى الصور بدون نص	قناة اقتراحات
أمر بالبادئة	البادئة أو منشن البوت ثم الكلمة	`!نقاطي`
يبدأ بـ	الرسالة تبدأ بالنص	`مرحبا`
يحتوي	النص في أي مكان	`خبر`
مطابق تمامًا	الرسالة هي النص فقط	`تم`
Regex	الرسالة تطابق النمط	`^(هلا\|مرحبا)`

رسائل البوتات ما تشغّل الأوامر. وخيار حساسية الأحرف ويشتغل عند تعديل الرسالة اختياريين.

أوامر Discord

أمر سلاش: كلمة وحدة بدون مسافات، والعربي مسموح. له خيارات تقرأها بـ.Options.الاسم، وما يصلح اسم أمر أساسي في البوت.
كلك يمين على عضو: تحت Apps، والعضو في .TargetUser و.TargetMember.
كلك يمين على رسالة: تحت Apps، والرسالة في .TargetMessage.

البوت لازم يكون مدعو بصلاحية applications.commands. وDiscord يحدد عدد إنشاء أوامر السلاش في اليوم.

الأزرار والنماذج

تكتب نمط Regex يطابق custom_id. مثال كامل: أمر يرسل زر، وأمر ثاني يشتغل عند الضغط.

{{/* الأمر الأول: أمر بالبادئة */}}
{{sendMessage nil (complexMessage "content" "اضغط الزر" "components" (cbutton "label" "اضغطني" "custom_id" "hello" "style" "green"))}}

{{/* الأمر الثاني: زر أو قائمة، والنمط ^hello$ */}}
{{ephemeralResponse}}هلا {{.User.Username}}

إجابات النموذج في .Options.custom_id و.Values.

أحداث السيرفر

النوع	خيارات	البيانات
ريأكشن	إضافة أو إزالة أو الاثنين، وإيموجي معيّن	`.Reaction` `.ReactionAdded` `.Message`
تغيّر الرتب	إضافة أو إزالة، ورتب معيّنة	`.Role` `.RoleAdded` `.TargetMember`
دخول عضو	قناة الرد	`.User` `.Member`
خروج عضو	قناة الرد	`.User`

تغيّر الرتب يشتغل مرة كل دقيقة لنفس العضو والرتبة، حتى ما تتكوّن حلقة لا تنتهي. والبوتات ما تشغّله.

الجدولة

كل فترة: أقل فترة 5 دقايق، وأول تشغيل بعد انتهاء الفترة.
وقت محدد: كل يوم أو أسبوع أو شهر، أو سطر Cron. وأقل فترة 10 دقايق.
يدوي: يشتغل من execCC أو زر التشغيل.

الأوامر المجدولة تحتاج قناة، وتقدر تستثني أيام وساعات. والمواعيد على المنطقة الزمنية في الإعدادات. وما فيها عضو، فـ.User فاضي.

دقيقة ساعة يوم شهر يوم-الأسبوع
30 8 * * 1-5   8:30 من الاثنين إلى الجمعة
0 12 * * *     12:00 كل يوم
0 0 1 * *      أول كل شهر