Troubleshooting

الممشکلات الشائعة وكيفية إصلاحها.

Two chat boxes / duplicate chat

السبب: مورد chat الافتراضي لا يزال قيد التشغيل إلى جانب BUPA Chat. وبما أن BUPA Chat يستخدم provide 'chat', فإن كلاهما يتم تسجيله كمربع محادثة.

الحل: قم بإيقاف أو إزالة مورد chat الأساسي. لا تقم أبداً بـ ensure chat في أي مكان داخل ملفات التكوين الخاصة بك — فقط استخدم ensure bupa-chat.

Resource won't start / UI is blank

السبب: وجود تبعية مفقودة. يعتمد BUPA Chat على ox_lib, qb-core ويصرح بـ dependency '/assetpacks'.

الحل: تأكد من بدء تشغيل الثلاثة جميعاً قبل BUPA Chat:

ensure ox_lib
ensure qb-core
ensure assetpacks
ensure bupa-chat

إذا كان assetpacks مفقوداً، ستفشل واجهة المستخدم المجمعة في التحميل ولن تظهر الدردشة أبداً.

No messages showing

• تأكد من أن الموارد الأخرى ترسل الرسائل عبر واجهة البرمجة القياسية — chat:addMessage (حدث) أو exports.chat:addMessage(...). راجع Developer API.
• بالنسبة لرسائل الفئات (categories), تأكد من أن اللاعب يمتلك الصلاحية بالفعل: يجب أن تتطابق الصلاحيات permissions (ACE), أو الوظائف jobs, أو العِصابات gangs الموجودة على الفئة. اللاعب الذي ليس لديه صلاحية لن يرى أو يستخدم تلك التبويب أبداً.
• تحقق من maxLength على الفئة — الرسائل الطويلة جداً يتم اقتطاعها وليست إزالتها، ولكن سيتم تجاهل type غير المتطابق في التكامل المخصص.

Suggestions not appearing

• اقتراحات الأوامر يتم إنشاؤها من الأوامر المسجلة التي يُسمح للاعب باستخدامها عبر ACE (command.<name>). إذا لم يكن الأمر مصرحاً به عبر ACE لهذا اللاعب، فللن يتم اقتراحه.
• يتم تحديث الاقتراحات عند تحميل اللاعب وعند بدء/إيقاف الموارد. إذا كان الأمر المسجل حديثاً لا يظهر، قم بإعادة تشغيل المورد المسؤول عنه أو أعد فتح الدردشة.
• بالنسبة لنصوص المساعدة / المعلمات المخصصة، قم بدفعها صراحةً باستخدام chat:addSuggestion / chat:addSuggestions.

Everything is in English (or the wrong language)

السبب: متغير اللغة (convar) غير معرّف، لذا يعود BUPA Chat تلقائياً إلى اللغة الإنجليزية en.

الحل: قم بتعيين اللغة في server.cfg:

setr ox:locale "tr"
# or force only chat:
setr bupa-chat:locale "tr"

تذكر أن bupa-chat:locale يتجاوز ox:locale. للتغيير المباشر، استخدم حدث العميل bupa:changeLanguage. راجع Localization.

Missing translations show the key name

تُرجع الدالة t() المفتاح (مثل CATEGORY_ADMIN_LABEL) عندما تكون الترجمة مفقودة من ملف اللغة النشط. أضف المفتاح المفقود إلى ملف locales/<code>.json هذا، أو قم نسخه من en.json.

qb-core / framework not detected

السبب: بدأ تشغيل نواة الإطار بعد (أو لم تكن قيد التشغيل عندما) تم إقلاع BUPA Chat.

الحل: تأكد من أن qb-core (أو qbx_core / es_extended) يبدأ قبل BUPA Chat. يقوم جسر الإطار باكتشاف Qbox و QB-Core و ESX تلقائياً؛ يمكنك أيضاً تثبيته أو تعطيله باستخدام متغير bupa-chat:framework (الافتراضي هو qb-core; اضبطه على false للتشغيل بدون إطار عمل).

Discord logging / bridge not working

• Webhook logs not arriving: تأكد من أن الروابط الموجودة في server/webhook.lua هي روابط Discord webhook حقيقية وليست القيم المؤقتة.
• Discord → chat bridge silent: في shared/config/discord.lua, اضبط active = true, وامئ حقل channelId, وقم بتوفير توكن البوت + معرف السيرفر guild ID (في config.discord أو معاد استخدامه من config.adminChatName.discord). يتم تجاهل الرسائل المرسلة بواسطة البوتات عمداً.