Depanare

Probleme comune și modul de remediere a acestora.

Două ferestre de chat / chat duplicat

Cauză: resursa chat implicită încă rulează alături de BUPA Chat. Deoarece BUPA Chat are provide 'chat', ambele se înregistrează ca și chat.

Soluție: opriți sau eliminați resursa chat stock. Nu folosiți niciodată ensure chat nicăieri în configurarea voastră — doar ensure bupa-chat.

Resursa nu pornește / Interfața este goală

Cauză: lipsește o dependință. BUPA Chat depinde de ox_lib, qb-core și declară dependency '/assetpacks'.

Soluție: asigurați-vă că toate cele trei pornesc înainte de BUPA Chat:

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

Dacă assetpacks lipsește, fișierele UI împachetate nu se vor încărca, iar chatul nu va apărea niciodată.

Nu se afișează mesaje

• Asigurați-vă că alte resurse trimit mesaje prin API-ul standard — chat:addMessage (eveniment) sau exports.chat:addMessage(...). Consultați Developer API.
• Pentru mesajele pe categorii, confirmați că jucătorul are efectiv acces: permissions (ACE), jobs sau gangs de pe categorie trebuie să corespundă. Un jucător fără acces nu va vedea și nu va folosi niciodată acea filă.
• Verificați maxLength pe categorie — mesajele excesiv de lungi sunt trunchiate, nu eliminate, dar un type nepotrivit într-o integrare personalizată va fi ignorat.

Sugestiile nu apar

• Sugestiile de comenzi sunt construite din comenzile înregistrate pe care jucătorul are permisiunea ACE să le folosească (command.<name>). Dacă o comandă nu are permisiune ACE pentru acel jucător, aceasta nu va fi sugerată.
• Sugestiile se actualizează la încărcarea jucătorului și atunci când resursele pornesc/se opresc. Dacă o comandă nou înregistrată nu apare, reporniți resursa care o furnizează sau redeschideți chatul.
• Pentru text de ajutor/parametri personalizați, trimiteți-i în mod explicit cu chat:addSuggestion / chat:addSuggestions.

Totul este în engleză (sau în limba greșită)

Cauză: convar-ul pentru localizare nu este setat, așa că BUPA Chat revine automat la en.

Soluție: setați limba în server.cfg:

setr ox:locale "tr"
# sau alegeți doar pentru chat:
setr bupa-chat:locale "tr"

Nu uitați că bupa-chat:locale suprascrie ox:locale. Pentru o schimbare în timp real, folosiți evenimentul de client bupa:changeLanguage. Consultați Localization.

Traducerile lipsă afișează numele cheii

t() returnează cheia (de ex. CATEGORY_ADMIN_LABEL) atunci când o traducere lipsește din fișierul de limbă activ. Adăugați cheia lipsă în acel locales/<code>.json sau copiați-o din en.json.

qb-core / framework-ul nu a fost detectat

Cauză: nucleul framework-ului a pornit după (sau nu rulează când) BUPA Chat pornește.

Soluție: asigurați-vă că qb-core (sau qbx_core / es_extended) pornește înainte de BUPA Chat. Bridge-ul framework-ului detectează automat Qbox, QB-Core și ESX; de asemenea, îl puteți fixa sau dezactiva cu convar-ul bupa-chat:framework (implicit qb-core; setați pe false pentru a rula fără framework).

Logging-ul Discord / bridge-ul nu funcționează

• Logurile webhook nu sosesc: confirmați că URL-urile din server/webhook.lua sunt URL-uri webhook Discord reale și nu valorile placeholder.
• Bridge-ul Discord → chat este silențios: în shared/config/discord.lua, setați active = true, completați channelId și furnizați un token de bot + ID de server (guild ID) (în config.discord sau preluat din config.adminChatName.discord). Mesajele scrise de boți sunt ignorate intenționat.