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

مرجع الدوال

كل دوال الكود مقسّمة حسب النوع.

كل الدوال

نفس المرجع موجود داخل محرر الكود، والضغط عليه هناك يضيف الدالة.

الرسائل

الدالة	وش تسوي
`respond رسالة`	يحدد رد الأمر، ويرسله بالطريقة الصحيحة تلقائيًا: Reply أو رد سلاش أو رد زر. الأسهل للـEmbed والأزرار.
`sendMessage قناة رسالة`	يرسل رسالة. القناة nil تعني نفس القناة.
`sendMessageNoEscape قناة رسالة`	مثل sendMessage لكن يسمح بكل المنشنات. لا تمرر فيه نص الأعضاء لأنهم يقدرون يسوون @everyone.
`sendMessageRetID قناة رسالة`	يرسل رسالة ويرجع رقمها.
`sendMessageNoEscapeRetID قناة رسالة`	مثل السابقة مع السماح بكل المنشنات.
`sendDM رسالة`	يرسل خاص للعضو اللي شغّل الأمر (مرة وحدة في التشغيل).
`sendTemplate قناة "اسم" بيانات`	يرسل مخرجات قالب define في قناة.
`sendTemplateDM "اسم" بيانات`	يرسل مخرجات قالب define في الخاص.
`editMessage قناة رقم رسالة`	يعدّل رسالة أرسلها البوت.
`editMessageNoEscape قناة رقم رسالة`	مثل editMessage مع السماح بكل المنشنات.
`getMessage قناة رقم`	يجيب بيانات رسالة، أو nil إذا ما لقاها.
`deleteMessage قناة رقم ثواني`	يحذف رسالة بعد ثواني (الافتراضي 10).
`deleteResponse ثواني`	يحذف رد الأمر بعد ثواني.
`deleteTrigger ثواني`	يحذف رسالة العضو اللي شغّلت الأمر.
`addReactions إيموجي...`	يضيف ريأكشن على رسالة العضو.
`addResponseReactions إيموجي...`	يضيف ريأكشن على رد الأمر.
`addMessageReactions قناة رقم إيموجي...`	يضيف ريأكشن على أي رسالة.
`deleteMessageReaction قناة رقم عضو إيموجي...`	يشيل ريأكشن عضو من رسالة.
`deleteAllMessageReactions قناة رقم`	يشيل كل الريأكشنات من رسالة.
`pinMessage قناة رقم`	يثبت رسالة.
`unpinMessage قناة رقم`	يلغي تثبيت رسالة.
`publishMessage قناة رقم`	ينشر رسالة في قناة الإعلانات.

بناء الرسائل

الدالة	وش تسوي
`cembed "title" "..." "description" "..."`	ينشئ Embed. الحقول: title, description, url, color, fields, author, footer, image, thumbnail, timestamp.
`complexMessage "content" "..." "embed" e "components" ...`	رسالة كاملة: نص و Embed وأزرار وقوائم و Container.
`complexMessageEdit "content" "..."`	مثل complexMessage لتعديل رسالة.
`ccontainer "color" 255 "text" "..." "image" رابط "buttons" ...`	صندوق Components V2، أبسط طريقة لكتابة Container.
`cbutton "label" "..." "custom_id" "..." "style" "green"`	زر. style: blue, grey, green, red. ولزر الرابط اكتب url.
`cmenu "custom_id" "..." "options" (cslice ...)`	قائمة منسدلة. type: text, user, role, channel, mentionable.
`cmodal "title" "..." "custom_id" "..." "fields" (cslice ...)`	نموذج يفتح للعضو ويعبّيه.
`ctextInput "label" "..." "custom_id" "..." "style" "long"`	حقل نص داخل نموذج.

التفاعلات

الدالة	وش تسوي
`sendResponse nil رسالة`	يرد على التفاعل، أو يرسل متابعة إذا سبق الرد.
`sendResponseNoEscape nil رسالة`	مثل السابقة مع السماح بكل المنشنات.
`sendResponseRetID nil رسالة`	يرد ويرجع رقم الرسالة.
`ephemeralResponse`	يخلي الرد يظهر للعضو فقط.
`sendModal نموذج`	يفتح نموذج cmodal. لازم يكون أول رد.
`updateMessage رسالة`	يعدّل الرسالة اللي فيها الزر أو القائمة.
`updateMessageNoEscape رسالة`	مثل السابقة مع السماح بكل المنشنات.
`editResponse nil رقم رسالة`	يعدّل رد التفاعل. الرقم nil يعني الرد الأصلي.
`deleteInteractionResponse nil رقم ثواني`	يحذف رد التفاعل.
`getResponse nil رقم`	يجيب بيانات رد التفاعل.

المنشن

الدالة	وش تسوي
`mentionEveryone`	يمنشن @everyone فعليًا.
`mentionHere`	يمنشن @here فعليًا.
`mentionRoleID رقم`	يمنشن رتبة برقمها.
`mentionRoleName "اسم"`	يمنشن رتبة باسمها.

الرتب

الدالة	وش تسوي
`hasRole رتبة`	هل العضو عنده الرتبة (رقم أو اسم)؟
`hasRoleID رقم`	هل العضو عنده الرتبة؟
`hasRoleName "اسم"`	هل العضو عنده الرتبة؟
`addRole رتبة ثواني`	يعطي العضو رتبة، والثواني اختيارية.
`addRoleID رقم ثواني`	يعطي العضو رتبة برقمها.
`addRoleName "اسم" ثواني`	يعطي العضو رتبة باسمها.
`removeRole رتبة ثواني`	يشيل من العضو رتبة.
`removeRoleID رقم ثواني`	يشيل من العضو رتبة برقمها.
`removeRoleName "اسم" ثواني`	يشيل من العضو رتبة باسمها.
`giveRoleID عضو رقم ثواني`	يعطي أي عضو رتبة.
`giveRoleName عضو "اسم" ثواني`	يعطي أي عضو رتبة باسمها.
`takeRoleID عضو رقم ثواني`	يشيل من أي عضو رتبة.
`takeRoleName عضو "اسم" ثواني`	يشيل من أي عضو رتبة باسمها.
`targetHasRole عضو رتبة`	هل هذا العضو عنده الرتبة؟
`targetHasRoleID عضو رقم`	هل هذا العضو عنده الرتبة؟
`targetHasRoleName عضو "اسم"`	هل هذا العضو عنده الرتبة؟
`setRoles عضو قائمة`	يبدّل كل رتب العضو بالقائمة.
`getRole رتبة`	يجيب بيانات رتبة برقمها أو اسمها.
`getRoleID رقم`	يجيب بيانات رتبة برقمها.
`getRoleName "اسم"`	يجيب بيانات رتبة باسمها.
`roleAbove رتبة رتبة`	هل الأولى أعلى من الثانية؟

الأعضاء

الدالة	وش تسوي
`getMember عضو`	يجيب بيانات عضو، أو nil إذا مو في السيرفر.
`userArg عضو`	يجيب بيانات مستخدم من رقمه أو منشنه.
`editNickname "اسم" عضو`	يغيّر لقب العضو.
`hasPermissions .Permissions.BanMembers`	هل العضو اللي شغّل الأمر عنده الصلاحية؟
`targetHasPermissions عضو .Permissions.BanMembers`	هل هذا العضو عنده الصلاحية؟
`onlineCount`	عدد المتصلين.
`memberAbove عضو عضو`	هل الأول أعلى من الثاني في الرتب؟
`timeoutMember عضو مدة "سبب"`	يسكّت عضو (Timeout). حد 5 عمليات إدارية في التشغيل.
`removeTimeout عضو`	يلغي إسكات العضو.
`kickMember عضو "سبب"`	يطرد عضو. قيّد الأمر برتبة الإدارة.
`banMember عضو "سبب" أيام`	يحظر عضو. قيّد الأمر برتبة الإدارة.
`unbanMember رقم "سبب"`	يلغي حظر عضو.

القنوات

الدالة	وش تسوي
`getChannel قناة`	يجيب بيانات قناة.
`getChannelOrThread قناة`	يجيب بيانات قناة أو ثريد.
`editChannelName قناة "اسم"`	يغيّر اسم القناة. Discord يسمح بمرتين كل 10 دقائق.
`editChannelTopic قناة "وصف"`	يغيّر وصف القناة.
`createThread قناة رقم "اسم" خاص`	ينشئ ثريد على رسالة، أو بدون رسالة إذا الرقم nil.
`closeThread ثريد قفل`	يغلق ثريد.
`deleteThread ثريد`	يحذف ثريد.
`getPinCount قناة`	عدد الرسائل المثبتة.

قاعدة البيانات

الدالة	وش تسوي
`dbSet عضو "مفتاح" قيمة`	يحفظ قيمة. استخدم 0 بدل العضو للقيم العامة.
`dbSetExpire عضو "مفتاح" قيمة ثواني`	يحفظ قيمة تنتهي بعد ثواني.
`dbGet عضو "مفتاح"`	يجيب العنصر، والقيمة في .Value.
`dbIncr عضو "مفتاح" مقدار`	يزيد رقم ويرجع قيمته الجديدة.
`dbDel عضو "مفتاح"`	يحذف عنصر.
`dbDelByID عضو رقم`	يحذف عنصر برقمه.
`dbDelMultiple (sdict "pattern" "%") عدد تخطي`	يحذف حتى 100 عنصر مطابق.
`dbGetPattern عضو "نمط" عدد تخطي`	يجيب عناصر عضو بنمط: % أي نص و _ حرف واحد.
`dbGetPatternReverse عضو "نمط" عدد تخطي`	مثل السابقة بترتيب عكسي.
`dbTopEntries "نمط" عدد تخطي`	أعلى القيم الرقمية. ممتازة للمتصدرين.
`dbBottomEntries "نمط" عدد تخطي`	أقل القيم الرقمية.
`dbCount عضو أو sdict`	عدد العناصر.
`dbRank عضو "مفتاح" "نمط"`	ترتيب عنصر بين العناصر.

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

الدالة	وش تسوي
`execCC رقم قناة تأخير بيانات`	يشغّل أمر ثاني الآن أو بعد ثواني. البيانات تصل في .ExecData.
`scheduleUniqueCC رقم قناة تأخير "مفتاح" بيانات`	يجدول أمر بمفتاح؛ نفس المفتاح يستبدل الجدولة القديمة.
`cancelScheduledUniqueCC رقم "مفتاح"`	يلغي جدولة.
`parseArgs مطلوب "استخدام" (carg ...)`	يقرأ مدخلات الأمر ويتحقق منها، ويرد برسالة استخدام عند الخطأ.
`carg "نوع" "اسم" حد حد`	يعرّف مدخل لـparseArgs. الأنواع: string, int, float, duration, user, userid, member, channel, role.
`execTemplate "اسم" بيانات`	يشغّل قالب define ويرجع قيمة return.
`sleep ثواني`	ينتظر. المجموع 30 ثانية في التشغيل.

النصوص

الدالة	وش تسوي
`print قيم...`	يدمج القيم في نص.
`println قيم...`	مثل print مع سطر جديد.
`printf "%s" قيم...`	نص منسق: %s نص، %d رقم، %.2f كسر.
`joinStr "فاصل" قيم...`	يدمج قيم بفاصل.
`lower نص`	أحرف صغيرة.
`upper نص`	أحرف كبيرة.
`title نص`	أول حرف كبير في كل كلمة.
`trimSpace نص`	يشيل المسافات من الأطراف.
`split نص "فاصل"`	يقسّم النص إلى قائمة.
`replace نص "قديم" "جديد"`	يستبدل كل تكرار.
`hasPrefix نص "بداية"`	هل يبدأ النص بكذا؟
`hasSuffix نص "نهاية"`	هل ينتهي النص بكذا؟
`sanitizeText نص`	يشيل التشكيل والزخرفة من النص.
`urlescape نص`	يجهز النص لرابط.
`urlunescape نص`	يرجع نص الرابط لأصله.
`urlquery نص`	يجهز النص لاستعلام رابط.
`encodeBase64 نص`	تشفير Base64.
`decodeBase64 نص`	فك Base64.
`hash نص`	بصمة SHA-256.
`json قيمة indent`	يحوّل قيمة إلى JSON.
`jsonToSdict نص`	يحوّل JSON إلى sdict.
`toRune نص`	أرقام حروف النص.
`toByte نص`	بايتات النص.

المقارنة

الدالة	وش تسوي
`eq أ ب ...`	يساوي؟ أو يساوي أي قيمة بعده.
`ne أ ب`	لا يساوي؟
`lt أ ب`	أصغر؟
`le أ ب`	أصغر أو يساوي؟
`gt أ ب`	أكبر؟
`ge أ ب`	أكبر أو يساوي؟
`and أ ب ...`	كلها صحيحة؟
`or أ ب ...`	وحدة منها صحيحة؟
`not قيمة`	عكس القيمة.

الأرقام

الدالة	وش تسوي
`add أ ب ...`	جمع.
`sub أ ب ...`	طرح.
`mult أ ب ...`	ضرب.
`div أ ب`	قسمة، وللأرقام الصحيحة يرجع رقم صحيح.
`fdiv أ ب`	قسمة بكسور.
`mod أ ب`	باقي القسمة.
`abs رقم`	القيمة المطلقة.
`pow أ ب`	أس.
`sqrt رقم`	جذر تربيعي.
`cbrt رقم`	جذر تكعيبي.
`log رقم أساس`	لوغاريتم.
`max قيم...`	الأكبر.
`min قيم...`	الأصغر.
`round رقم`	تقريب.
`roundCeil رقم`	تقريب لفوق.
`roundFloor رقم`	تقريب لتحت.
`roundEven رقم`	تقريب للزوجي.
`randInt حد حد`	رقم عشوائي: randInt 1 7 يعطي من 1 إلى 6.
`randNorm`	رقم عشوائي بتوزيع طبيعي.
`mathConst "pi"`	ثابت: pi, e, phi, sqrt2, ln2, ln10, maxint.
`bitwiseAnd أ ب`	AND.
`bitwiseOr أ ب`	OR.
`bitwiseXor أ ب`	XOR.
`bitwiseNot أ`	NOT.
`bitwiseAndNot أ ب`	AND NOT.
`bitwiseLeftShift أ ب`	إزاحة يسار.
`bitwiseRightShift أ ب`	إزاحة يمين.

القوائم والتحويل

الدالة	وش تسوي
`cslice قيم...`	ينشئ قائمة. والإضافة: $l = $l.Append قيمة
`sdict "مفتاح" قيمة ...`	ينشئ قاموس. الدوال: .Get .Set .Del .HasKey
`dict "مفتاح" قيمة ...`	مثل sdict.
`seq من إلى`	قائمة أرقام (حد 10000).
`len قيمة`	الطول.
`index قائمة موضع`	عنصر من قائمة أو قاموس.
`slice قيمة من إلى`	جزء من نص أو قائمة.
`in قائمة قيمة`	هل القيمة موجودة؟
`inFold قائمة قيمة`	مثل in بدون حساسية الأحرف.
`shuffle قائمة`	ترتيب عشوائي.
`sort قائمة (sdict "Key" "..." "Reverse" true)`	ترتيب.
`reverse قائمة`	عكس القائمة.
`toInt قيمة`	إلى رقم صحيح.
`toInt64 قيمة`	إلى رقم صحيح، ويحافظ على المعرفات الطويلة.
`toFloat قيمة`	إلى رقم بكسور.
`toString قيمة`	إلى نص.
`str قيمة`	إلى نص.
`toDuration "1h30m"`	إلى مدة.
`kindOf قيمة`	نوع القيمة.
`structToSdict قيمة`	يحوّل بيانات إلى قاموس.

الوقت

الدالة	وش تسوي
`currentTime`	الوقت الحالي. جرّب .Unix و .Hour و (.In "Asia/Riyadh").
`formatTime وقت "2006-01-02 15:04"`	تنسيق الوقت بنفس صيغة Go.
`parseTime "2024-01-31 12:00"`	يقرأ وقت من نص (UTC)، و nil إذا ما قدر.
`newDate سنة شهر يوم س د ث "منطقة"`	ينشئ وقت.
`loadLocation "Asia/Riyadh"`	يتحقق من منطقة زمنية.
`snowflakeToTime معرف`	وقت إنشاء أي معرف Discord.
`timestampToTime ثواني`	من Unix إلى وقت.
`weekNumber وقت`	رقم الأسبوع.
`humanizeDurationHours مدة`	مدة مقروءة بالساعات.
`humanizeDurationMinutes مدة`	مدة مقروءة بالدقائق.
`humanizeDurationSeconds مدة`	مدة مقروءة بالثواني.
`humanizeTimeSinceDays وقت`	الوقت المنقضي بالأيام.
`humanizeThousands رقم`	فواصل الآلاف.

Regex

الدالة	وش تسوي
`reFind "نمط" نص`	أول تطابق.
`reFindAll "نمط" نص عدد`	كل التطابقات.
`reFindAllSubmatches "نمط" نص عدد`	كل التطابقات مع المجموعات.
`reReplace "نمط" نص "جديد"`	يستبدل التطابقات.
`reSplit "نمط" نص`	يقسّم النص.
`reQuoteMeta نص`	يهرّب رموز Regex.