Troubleshooting

आम समस्याएं और उन्हें कैसे ठीक करें।

Two chat boxes / duplicate chat

कारण: डिफ़ॉल्ट chat रिसोर्स अभी भी BUPA Chat के साथ चल रहा है। चूकि BUPA Chat provide 'chat' करता है, दोनों चैट के रूप में रजिस्टर हो जाते हैं।

सुधार: स्टॉक chat रिसोर्स को बंद या हटा दें। अपनी किसी भी config में 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 गायब है, तो पैक्ड UI एसेट्स लोड होने में विफल हो जाते हैं और चैट कभी दिखाई नहीं देती।

No messages showing

• सुनिश्चित करें कि अन्य रिसोर्सेज स्टैंडर्ड API के माध्यम से संदेश भेजते हैं — chat:addMessage (event) या exports.chat:addMessage(...)। Developer API देखें।
• category संदेशों के लिए, पुष्टि करें कि खिलाड़ी के पास वास्तव में एक्सेस है: श्रेणी पर permissions (ACE), jobs या gangs मेल खाने चाहिए। एक्सेस के बिना कोई भी खिलाड़ी उस टैब को कभी नहीं देखता या उपयोग नहीं करता है।
• श्रेणी पर maxLength जांचें — अत्यधिक लंबे संदेशों को छोटा किया जाता है, हटाया नहीं जाता, लेकिन किसी कस्टम इंटीग्रेशन में एक बेमेल type को अनदेखा कर दिया जाएगा।

Suggestions not appearing

• कमांड सुझाव उन रजिस्टर्ड कमांड्स से बनाए जाते हैं जिनका उपयोग करने के लिए खिलाड़ी को ACE-allowed है (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"
# या केवल चैट को फोर्स करें:
setr bupa-chat:locale "tr"

याद रखें कि bupa-chat:locale ox:locale को ओवरराइड करता है। लाइव बदलाव के लिए bupa:changeLanguage क्लाइंट इवेंट का उपयोग करें। Localization देखें।

Missing translations show the key name

जब सक्रिय भाषा फ़ाइल से कोई अनुवाद गायब होता है, तो t() key (उदा. CATEGORY_ADMIN_LABEL) लौटाता है। उस locales/<code>.json में गायब की जोड़ें, या इसे en.json से कॉपी करें।

qb-core / framework not detected

कारण: फ्रेमवर्क कोर BUPA Chat बूट होने के बाद शुरू हुआ (या जब BUPA Chat बूट होता है तब नहीं चल रहा है)।

सुधार: सुनिश्चित करें कि qb-core (या qbx_core / es_extended) BUPA Chat से पहले शुरू हो। फ्रेमवर्क ब्रिज अपने आप Qbox, QB-Core और ESX का पता लगा लेता है; आप bupa-chat:framework convar के साथ इसे पिन या अक्षम भी कर सकते हैं (डिफ़ॉल्ट qb-core है; फ्रेमवर्कलेस चलाने के लिए false पर सेट करें)।

Discord logging / bridge not working

• Webhook logs not arriving: पुष्टि करें कि server/webhook.lua में URLs वास्तविक Discord webhook URLs हैं, न कि प्लेसहोल्डर वैल्यू।
• Discord → chat bridge silent: shared/config/discord.lua में, active = true सेट करें, channelId भरें, और एक बॉट token + guild ID प्रदान करें (config.discord में या config.adminChatName.discord से पुन: उपयोग करें)। बॉट द्वारा लिखे गए संदेशों को जानबूझकर अनदेखा किया जाता है।