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

> أنشئ أوامر دردشة خاصة بك على Kick مثل !discord أو !socials مع KickBot، واختر من يستطيع استخدام كل أمر، وأضف فترات انتظار، واستخدم المتغيرات لبيانات مباشرة.

Source: https://kickbot.com/ar/docs/chat-bot/custom-commands

الأمر المخصص أمر دردشة تصنعه بنفسك. عندما يكتبه مشاهد في دردشتك على Kick، مثلًا `!discord`، ينشر KickBot الرد الذي حفظته. تنشئ أوامر دردشة Kick (kick commands) وتعدّلها في صفحة [الأوامر المخصصة](https://kickbot.com/dashboard/commands) في لوحة تحكم KickBot، تحت **Chat Bot**.

تحتاج إلى حساب KickBot مربوط بقناتك على Kick، ويجب أن يكون KickBot [مشرفًا في قناتك](https://kickbot.com/ar/docs/getting-started/add-kickbot-as-moderator).

![صفحة الأوامر المخصصة مع أمرين من أوامرك والأوامر المدمجة الستة](https://kickbot.com/docs/images/chat-bot/custom-commands/01-commands-page.webp "أوامرك في الأعلى. الأوامر المدمجة في قائمة خاصة بها في الأسفل.")

في الصفحة قائمتان:

- **أوامرك**: الأوامر التي أنشأتها. تختار الاسم والرد وكل إعداد.
- **الأوامر المدمجة**: ستة أوامر جاهزة، مثل `!followage` و `!lurk`. لا تُحسب ضمن حد الخطة المجانية. راجع [الأوامر المدمجة](https://kickbot.com/ar/docs/chat-bot/built-in-commands).

## إضافة أمر

1. افتح [kickbot.com/dashboard/commands](https://kickbot.com/dashboard/commands).
2. اضغط على **إضافة أمر**. تُفتح لوحة على اليمين.
3. في **الأمر**، اكتب الاسم بدون `!`. يضيفها KickBot لك. مثلًا، `discord` ينشئ الأمر `!discord`.
4. في **الرد**، اكتب الرسالة التي ينشرها KickBot. يمكنك إضافة [متغيرات](https://kickbot.com/ar/docs/chat-bot/command-variables) عبر **إدراج متغير**.
5. اختر **من يمكنه الاستخدام** واضبط **فترة الانتظار** إذا احتجت إليها.
6. اضغط على **حفظ**.

يعرض مربع **في دردشة Kick** في الأعلى شكل الأمر في الدردشة أثناء الكتابة. تعرض المتغيرات هناك قيمًا نموذجية. أنت فقط ترى هذه المعاينة.

![لوحة أمر جديد مع الأمر discord ورد فيه متغير والمعاينة في دردشة Kick](https://kickbot.com/docs/images/chat-bot/custom-commands/02-new-command.webp "تعرض المعاينة في الأعلى الرد بقيم نموذجية.")

## الإعدادات

| الإعداد | ماذا يفعل | الحدود والافتراضي |
| --- | --- | --- |
| **الأمر** | الكلمة التي يكتبها المشاهدون بعد `!`. | من 1 إلى 20 حرفًا، بدون مسافات. حالة الأحرف لا تهم: `!Discord` و `!discord` ينفّذان الأمر نفسه. |
| **الرد** | الرسالة التي ينشرها KickBot. | حتى 500 حرف. يمكن أن يحتوي على [متغيرات](https://kickbot.com/ar/docs/chat-bot/command-variables). |
| **من يمكنه الاستخدام** | **الجميع**، أو **المشتركون**، أو **كبار الشخصيات** (VIPs)، أو **المشرفون**، أو مزيج منها. | الافتراضي **الجميع**. |
| **ينتظر كل مشاهد** | فترة انتظار المستخدم: المدة التي ينتظرها المشاهد قبل استخدام الأمر مرة أخرى. | من 0 إلى 300 ثانية، بخطوات من 5. الافتراضي 0. |
| **ينتظر الجميع** | فترة الانتظار العامة: المدة التي تنتظرها الدردشة كلها بعد أن يستخدم أي شخص الأمر. | من 0 إلى 300 ثانية، بخطوات من 5. الافتراضي 0. |
| **الأمر مفعّل** | يفعّل الأمر أو يوقفه دون حذفه. | مفعّل للأوامر الجديدة. |

## من يستطيع استخدام الأمر

**الجميع** يسمح لكل المشاهدين باستخدام الأمر. عندما يكون **الجميع** مفعّلًا، لا تهم المجموعات الأخرى.

أوقف **الجميع** واختر مجموعة أو أكثر لتقييد الأمر. مثلًا، **المشتركون** و**المشرفون** معًا يسمحان للمشتركين والمشرفين فقط باستخدامه. لا يحصل المشاهدون الآخرون على رد.

أنت (المذيع) تستطيع دائمًا استخدام كل الأوامر. إذا أوقفت كل المجموعات، فلا يستطيع أحد غيرك استخدام الأمر، وتعرض اللوحة تحذيرًا.

![أزرار من يمكنه الاستخدام مع تفعيل المشتركون والمشرفون، وحقلا فترة الانتظار](https://kickbot.com/docs/images/chat-bot/custom-commands/03-who-cooldown.webp "اختيار المشتركون والمشرفون. فترات الانتظار في الأسفل.")

> **أوامر للمشرفين فقط:** حصر أمر مخصص في مجموعة **المشرفون** طريقة جيدة لإبعاد أدوات، مثل أمر الترويج لقناة أخرى (shout-out)، عن المشاهدين العاديين. لهذا السبب يكون الأمر المدمج `!so` مضبوطًا على **المشرفون**. لأوامر الإشراف الخاصة بـ Kick مثل `/ban` و `/timeout`، راجع [الإشراف](https://kickbot.com/ar/docs/chat-bot/moderation#kicks-own-moderator-tools).

## فترات الانتظار

تمنع فترة الانتظار الإزعاج عندما يكتب مشاهدون كثيرون الأمر نفسه.

- **ينتظر كل مشاهد** ينطبق على مشاهد واحد. مع 30 ثانية، يستطيع المشاهد استخدام `!discord` مرة كل 30 ثانية. ويستطيع المشاهدون الآخرون استخدامه في هذه المدة.
- **ينتظر الجميع** ينطبق على الدردشة كلها. مع 10 ثوانٍ، يرد KickBot على `!discord` مرة واحدة كل 10 ثوانٍ على الأكثر، أيًّا كان من يكتبه.

لا تنطبق فترات الانتظار عليك ولا على مشرفيك.

## تعديل أمر أو إيقافه أو حذفه

- استخدم مفتاح التبديل في الصف لتفعيل الأمر أو إيقافه. يُحفظ التغيير فورًا.
- اضغط على صف لفتحه. غيّر أي حقل واضغط على **حفظ**.
- لحذف أمر، افتحه واضغط على **حذف**، ثم على **حذف الأمر**. لا يمكنك التراجع عن هذا.

لا يمكن حذف الأوامر المدمجة. يمكنك إيقافها أو تغيير ردها.

## حد الخطة المجانية

> **Note:** في الخطة المجانية، يمكن تفعيل حتى 5 أوامر مخصصة في الوقت نفسه. يمكنك إنشاء المزيد، لكن الأوامر الزائدة تبقى متوقفة. لا تُحسب الأوامر المدمجة ضمن هذا الحد. لا يوجد حد في Premium.

## أمثلة على أوامر مفيدة

انسخ هذه الأوامر وعدّلها لقناتك. النص مثل `discord.gg/your-server-code` مثال فقط، فاستبدله بما يخص قناتك.

| الأمر | الرد |
| --- | --- |
| `!discord` | `انضم إلى Discord: discord.gg/your-server-code` |
| `!socials` | `تابع @{{streamer.username}} على X: x.com/yourhandle` |
| `!schedule` | `بث مباشر الثلاثاء والخميس والسبت الساعة 7 مساءً (ET).` |
| `!tip` | `ادعم البث: kickbot.com/tips/yourchannel` |
| `!title` | `اليوم: {{stream.title}}` |
| `!dice` | `@{{sender.username}} رمى النرد وحصل على {{randomRange(1,6)}}` |
| `!8ball` | `{{randomItem("نعم","لا","اسأل لاحقًا")}}` |
| `!hug` | `{{sender.username}} يعانق {{taggedUser.username}}` (يكتب المشاهدون `!hug @name`) |

للقائمة الكاملة بالمتغيرات وما ينشره كل منها، راجع [متغيرات الأوامر](https://kickbot.com/ar/docs/chat-bot/command-variables). ولمزيد من الأفكار لقناتك، راجع دليل [أوامر الدردشة التي تحتاجها كل قناة على Kick](https://kickbot.com/ar/guides/grow/kick-chat-commands).

## حل المشكلات

إذا لم يُنشر أمر في الدردشة:

- **KickBot ليس مشرفًا.** هذا هو السبب الأكثر شيوعًا. راجع [أضف KickBot كمشرف](https://kickbot.com/ar/docs/getting-started/add-kickbot-as-moderator).
- **الأمر متوقف.** تحقق من مفتاح التبديل في صفه. في الخطة المجانية، يبدأ الأمر الجديد متوقفًا عندما تكون 5 أوامر مفعّلة بالفعل.
- **المشاهد ليس في مجموعة تستطيع استخدامه.** مثلًا، الأمر المحصور في مجموعة **المشتركون** لا يرد على المشاهدين العاديين.
- **فترة انتظار ما زالت جارية.** انتظر انتهاءها، أو جرّب بحساب المذيع.
- **الاسم مستخدم في ميزة أخرى.** عندما يكون [أمر Clip](https://kickbot.com/ar/docs/chat-bot/clip-command) مفعّلًا، يصنع `!clip` مقطعًا دائمًا، فلا يُنفَّذ أمر `!clip` المخصص.

## الأسئلة الشائعة

**كيف أضيف أوامر على Kick؟**

استخدم بوت دردشة. مع KickBot، افتح [kickbot.com/dashboard/commands](https://kickbot.com/dashboard/commands)، واضغط على **إضافة أمر**، واكتب اسمًا وردًا، ثم اضغط على **حفظ**. بعدها يستطيع المشاهدون كتابة الأمر في دردشتك.

**هل يستطيع مشرفيّ إنشاء أوامر KickBot؟**

نعم. أضفهم إلى فريقك في KickBot مع صلاحية **الأوامر المخصصة**. بعدها يستطيعون تسجيل الدخول وتغيير أوامر قناتك. راجع [الفريق](https://kickbot.com/ar/docs/account/team).

**كم أمرًا يمكنني إنشاؤه؟**

لا يوجد حد لعدد الأوامر التي تنشئها. في الخطة المجانية، يمكن تفعيل 5 أوامر مخصصة في الوقت نفسه. لا يوجد حد في Premium. لا تُحسب الأوامر المدمجة.

**هل يستطيع أمر عرض اسم المشاهد أو مدة متابعته؟**

نعم. ضع متغيرات مثل `{{sender.username}}` أو `{{sender.followage}}` في الرد. يضع KickBot القيمة الحالية عند تنفيذ الأمر. راجع [متغيرات الأوامر](https://kickbot.com/ar/docs/chat-bot/command-variables).