المساعدة والتوثيق
كل ما تحتاج معرفته لاستخدام CrystalFive Host
البداية السريعة
1 تحميل وتثبيت التطبيق
- • حمّل التطبيق من صفحة التحميل
- • شغّل ملف التثبيت واتبع الخطوات
- • افتح التطبيق وسجّل الدخول بحساب Discord أو Google
2 إنشاء سيرفر جديد
- • اضغط على "إضافة سيرفر جديد"
- • اختر اسماً لسيرفرك (مثال: "سيرفر الأصدقاء")
- • اختر نسخة FiveM Artifact (الموصى بها)
- • اضغط "إنشاء" - التطبيق يتولى كل الإعدادات
3 تشغيل السيرفر
- • اضغط على زر "تشغيل" بجانب سيرفرك
- • انتظر حتى يصبح الحالة "متصل"
- • انسخ رابط الاتصال وشاركه مع أصدقائك
- • اللاعبين يتصلون عبر الرابط مباشرة بدون أي برامج إضافية
قاعدة البيانات
إعداد قاعدة البيانات
التطبيق يثبت ويدير MariaDB تلقائياً. لا تحتاج أي إعداد يدوي. بيانات الاتصال تظهر في تبويب "قاعدة البيانات":
الاستخدام مع ESX/QBCore
في ملف server.cfg، أضف السطر التالي:
استبدل PASSWORD بكلمة المرور الظاهرة في التطبيق.
النسخ الاحتياطي
التطبيق ينشئ نسخ احتياطية تلقائية يومية. يمكنك أيضاً إنشاء نسخة يدوية من تبويب "قاعدة البيانات" ← "النسخ الاحتياطي".
بوت ديسكورد
CrystalFive Host يتضمن بوت ديسكورد مدمج يعمل مباشرة من التطبيق. كل البيانات تبقى على جهازك — التوكن مشفر ولا يغادر جهازك أبداً.
إعداد البوت
- 1. افتح Discord Developer Portal وأنشئ تطبيق جديد
- 2. في قسم Bot، اضغط "Reset Token" وانسخه
- 3. فعّل Server Members Intent و Message Content Intent
- 4. في التطبيق، اذهب لتبويب بوت ديسكورد وأدخل Application ID والتوكن و Guild ID
- 5. اضغط على رابط الدعوة لإضافة البوت لسيرفر ديسكورد
- 6. اضغط تشغيل البوت — الأوامر تتسجل تلقائياً
المميزات حسب الباقة
المميزات تنفتح حسب باقة اشتراكك:
/status ·
/players ·
/faq (3 إدخالات)
كل ميزات التجربة، بالإضافة إلى:
/kick ·
/ban ·
/warn ·
/whitelist ·
/announce ·
رسائل ترحيب · قناة سجلات · ربط الرولات بالوظائف
كل ميزات ستارتر، بالإضافة إلى:
/quiz (10 أسئلة) ·
/ticket ·
/template ·
FAQ (10 إدخالات)
كل ميزات بلس، بالإضافة إلى: أسئلة كويز مخصصة · كويز (25 سؤال) · FAQ بدون حد
الأوامر
/status تجربة+
يعرض حالة السيرفر مباشرة: متصل/غير متصل، عدد اللاعبين، ووقت التشغيل.
/players تجربة+
يعرض قائمة اللاعبين المتصلين حالياً مع شريط السعة. يجلب البيانات من txAdmin مباشرة.
/kick /ban /warn ستارتر+
إدارة اللاعبين من ديسكورد مباشرة. طرد، حظر (مدة: ساعة إلى دائم)، وتحذير. كل الإجراءات تُسجَّل في قناة السجلات.
/announce ستارتر+
إرسال إعلان لجميع اللاعبين داخل اللعبة ولقناة الإعلانات في ديسكورد. الأنواع: عام، تحذير، طوارئ، معلومات.
/whitelist ستارتر+
إدارة الوصول للسيرفر. الأوامر الفرعية: add، remove، approve، deny، check، list، request (طلب ذاتي من اللاعب).
/faq تجربة+
إدارة الأسئلة الشائعة بكلمات مفتاحية. البوت يرد تلقائياً لما اللاعبين يسألون في قناة الـ FAQ باستخدام مطابقة نصية ذكية تفهم العربي بلهجاته.
/quiz بلس+
نظام وايتلست بالكويز. اللاعبين يختبرون على قوانين سيرفرك، والناجح يُضاف للوايتلست تلقائياً ويحصل على رول ديسكورد. تقدر تتحكم بنسبة النجاح، عدد المحاولات، وقت الانتظار، ووقت كل سؤال. أسئلة جاهزة بالعربي متوفرة.
/ticket بلس+
نظام تذاكر الدعم. ينشئ زر "فتح تذكرة"؛ اللاعبين يحصلون على قنوات خاصة. الإدارة تقدر تقفل التذاكر مع سبب. تذكرة واحدة مفتوحة لكل مستخدم.
/template بلس+
قوالب سيرفر ديسكورد جاهزة لمجتمعات الرول بلاي. ينشئ رولات وأقسام وقنوات مع صلاحيات مناسبة. متوفر بالعربي والإنجليزي. القوالب: RP أساسي، RP متقدم، RP مختصر.
أوضاع الوايتلست
تحكم بطريقة دخول اللاعبين لسيرفرك (يتطلب ستارتر+):
/whitelist approve إعداد القنوات
حدد قنوات ديسكورد لكل ميزة من تبويب القنوات:
قناة الحالة
حالة السيرفر تتحدث تلقائياً
قناة الإعلانات
إعلانات وتنبيهات السيرفر
قناة الترحيب
رسائل ترحيب للأعضاء الجدد
قناة السجلات
سجلات إجراءات الإدارة
قناة الأسئلة الشائعة
ردود تلقائية على أسئلة اللاعبين
قناة الكويز
اختبارات الوايتلست
ربط الرولات بالوظائف
مزامنة تلقائية بين رولات ديسكورد ووظائف FiveM داخل اللعبة. النظام يكتشف الفريم ورك (ESX/QBCore) تلقائياً ويقرأ الوظائف المتاحة من سيرفرك.
طريقة العمل
- 1. اذهب لقسم ربط الرولات بالوظائف في تبويب بوت ديسكورد
- 2. اضغط إضافة ربط — الوظائف تتحمل من سيرفر FiveM تلقائياً
- 3. اختر وظيفة FiveM — إذا فيه رول ديسكورد مطابق ينتقي تلقائياً، وإذا ما فيه يعطيك خيار إنشاء رول جديد مباشرة
- 4. اختر الحد الأدنى لدرجة الوظيفة، واحفظ
مزامنة بالاتجاهين
بعد الربط، الرولات تتزامن تلقائياً بالاتجاهين:
- • اللعبة → ديسكورد: لما لاعب ياخذ وظيفة داخل اللعبة (مثلاً يتعين شرطي)، يحصل على رول ديسكورد المطابق تلقائياً
- • اللعبة → ديسكورد: لما لاعب يفقد وظيفته (مثلاً ينطرد أو يتغير شغله)، رول ديسكورد ينشال تلقائياً
اكتشاف تلقائي وإنشاء رولات
- • اكتشاف الفريم ورك: يكتشف ESX أو QBCore تلقائياً ويقرأ الوظائف من قاعدة البيانات
- • إنشاء رولات تلقائي: إذا ما فيه رول ديسكورد مطابق للوظيفة، تقدر تنشئ واحد مباشرة من نموذج الربط بدون ما تطلع من التطبيق
ربط txAdmin
اربط البوت بلوحة txAdmin لتفعيل /kick و /ban و /warn و /players و /announce. في تبويب txAdmin، أدخل:
البيانات مشفرة بـ AES-256-GCM ومخزنة محلياً. استخدم زر "اختبار الاتصال" للتحقق.
حل المشاكل
السيرفر لا يتصل
- 1. تأكد من اتصالك بالإنترنت
- 2. تأكد من عدم وجود firewall يحجب التطبيق
- 3. أعد تشغيل التطبيق
- 4. إذا استمرت المشكلة، انضم لسيرفر الديسكورد للمساعدة
اللاعبين لا يستطيعون الاتصال
- 1. تأكد من أن السيرفر في حالة "متصل"
- 2. تأكد من أنك شاركت الرابط الصحيح
- 3. تأكد من أن عدد اللاعبين لم يتجاوز الحد (10 للمجاني، 200 للبريميوم)
- 4. اللاعبين على الشبكة المحلية يتصلون مباشرة على localhost
قاعدة البيانات لا تعمل
- 1. اذهب إلى تبويب "قاعدة البيانات"
- 2. تأكد من أن MariaDB في حالة "يعمل"
- 3. إذا كان متوقفاً، اضغط "تشغيل"
- 4. تأكد من أن بيانات الاتصال في server.cfg صحيحة