BUPA Chat
BUPA Chat
BUPA Chat هو نظام دردشة احترافي ومتطور مصمم ليحل محل دردشة FiveM الأساسية بسلاسة. يأتي بواجهة React قابلة للتخصيص بالكامل ويحل محل مورد chat القياسي، مما يضمن استمرار عمل كل سكربت يتفاعل مع دردشة اللعبة بالفعل دون الحاجة لأي عملية نقل أو تعديل.
بدلاً من مربع إدخال واحد، يمنح BUPA Chat اللاعبين صندوق إدخال مصنفاً مع فئات الدردشة (الأوامر، الدردشة خارج اللعبة OOC، الإدارة، قنوات الوظائف/العصائل، الرسائل الخاصة)، ومحدد إيوجي، واقتراحات الأوامر الفورية، وتعبيرات بنمط /me و/do تظهر فوق رأس اللاعب، بالإضافة إلى خيار شارات معرف/اسم اللاعب، وسجلات Discord، ولغة خاصة بكل لاعب يمكن تبديلها أثناء اللعب.
يدعم BUPA Chat خاصية provide 'chat'، مما يعني أنه يتولى اسم مورد chat القياسي. يجب عليك إزالة أو إيقاف مورد chat الافتراضي قبل تشغيل BUPA Chat — حيث سيؤدي تشغيلهما معاً إلى ظهور صندوقي دردشة. راجع صفحة التثبيت.
Key features
- فئات / تبويبات الدردشة — تبويب
commandمدمج بالإضافة إلى فئات قابلة للتخصيص بالكامل: دردشة عامة خارج اللعبة OOC، دردشة محلية (حسب القرب)، الإدارة، قنوات وظائف الشرطة/الإسعاف، قنوات العصابات، وأي فئة مخصصة تقوم بتعريفها. تحتوي كل فئة على ألوانها الخاصة، والعلامات، والأذونات، وقواعد الرسائل. - الرسائل الخاصة —
/pm(و/dm) مع تصميم مخصص لكل من المرسل والمستقبل. - التعبيرات (Emotes) —
/meو/doو/diceو/rpsجاهزة للاستخدام فوراً، وتظهر كنص فوق رأس الشخصية (Ped) ومععكسة اختيارياً في الدردشة. يمكنك إضافة تعبيراتك الخاصة مع الرسوم المتحركة، حدود المسافة، والمعلمات المخصصة. - محدد الإيموجي — لوحة إيموجي مخصصة ومصنفة (ابتسامات، إيماءات، رموز، كائنات) مع اختصارات قابلة للبحث.
- اقتراحات الأوامر — يتم تعبئتها تلقائياً من الأوامر المسجلة التي يمتلك اللاعب صلاحية الوصول إليها (ACE)، بالإضافة إلى أي شيء ترسله عبر واجهة برمجة التطبيقات القياسية
chat:addSuggestion(s). - شارات هوية اللاعب — أسماء اختيارية لكل فئة، ومعرف السيرفر، والوظيفة (العنوان/الدرجة) وعلامات رتبة Discord، مع إخفاء الأسماء المتوافقة مع الأقنعة وعرض معرف القرب فوق الرأس.
- تكامل Discord — تسجيل الويب هوك (Webhook) لرسائل الدردشة/التعبيرات/الرسائل الخاصة، وجسر اختياري بين Discord وقنوات داخل اللعبة ينقل رسائل Discord إلى الدردشة.
- متعدد اللغات — الترجمات عبر ملفات لغة ox_lib، قابلة للاختيار عالمياً، أو لكل مورد، أو مباشرة لكل جلسة.
- واجهة مستخدم React قابلة للتخصيص — أوضاع الرؤية (إظهار عند النشاط / إظهار دائماً / إخفاء)، أصوات الكتابة، النقر في الخارج للإغلاق، وأزرار الفتح/الرؤية القابلة للتخصيص.
Framework
تم تصميم BUPA Chat ليناسب QB-Core ومدرج كاعتمادية لـ qb-core. يقوم جسر الإطار المشترك أيضاً اكتشاف Qbox (qbx_core) وESX (es_extended) تلقائياً أثناء التشغيل، ويمكن فرض الإطار أو تعطيله من خلال متغير الأوامر bupa-chat:framework.
المورد يوفر مورد chat القياسي (provide 'chat')، مما يجعله بديلاً كاملاً لدردشة FiveM الافتراضية بدلاً من مجرد ملحق إضافي.
Dependencies
| Dependency | Purpose |
|---|---|
| ox_lib | اللغات، اختصارات الأبراج، الإشعارات، ردود النداء (Callbacks) ومساعدات واجهة المستخدم. يتم تحميله كـ @ox_lib/init.lua وعبر ox_lib 'locale'. |
| qb-core | نواة الإطار (بيانات اللاعب، الوظائف، العصابات). مدرج كاعتمادية أساسية صارمة. |
| assetpacks | مُعرّف بـ dependency '/assetpacks' — مطلوب بواسطة أصول واجهة المستخدم المجمعة. |