Felsökning

Vanliga problem och hur du löser dem.

Två chattrutor / dubbel chatt

Orsak: standardresursen chat körs fortfarande tillsammans med BUPA Chat. Eftersom BUPA Chat provide 'chat' registrerar sig båda som chatt.

Lösning: stäng av eller ta bort standardresursen chat. Kör inte ensure chat någonstans i din konfiguration – enbart ensure bupa-chat.

Resursen startar inte / gränssnittet är tomt

Orsak: ett saknat beroende. BUPA Chat är beroende av ox_lib, qb-core och deklarerar dependency '/assetpacks'.

Lösning: se till att alla tre startar innan BUPA Chat:

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

Om assetpacks saknas misslyckas laddningen av de paketerade gränssnittsresurserna och chatten visas aldrig.

Inga meddelanden visas

• Se till att andra resurser skickar meddelanden via standard-API:et – chat:addMessage (event) eller exports.chat:addMessage(...). Se Developer API.
• För kategorimeddelanden, bekräfta att spelaren faktiskt har behörighet: permissions (ACE), jobs eller gangs för kategorin måste matcha. En spelare utan behörighet ser eller använder aldrig den fliken.
• Kontrollera maxLength för kategorin – alltför långa meddelanden trunkeras, de kastas inte bort, men en felaktig type i en anpassad integration kommer att ignoreras.

Förslag visas inte

• Kommandoanvisningar byggs upp från registrerade kommandon som spelaren har ACE-behörighet att använda (command.<name>). Om ett kommando inte är ACE-tillåtet för den spelaren kommer det inte att föreslås.
• Förslag uppdateras när spelaren laddar in och när resurser startas/stängs av. Om ett nyligen registrerat kommando inte visas, starta om resursen som tillhandahåller det eller öppna chatten igen.
• För anpassad hjälptext/parametrar, skicka dem explicit med chat:addSuggestion / chat:addSuggestions.

Allt är på engelska (eller fel språk)

Orsak: lokaliserings-convaren är inte satt, så BUPA Chat faller tillbaka till en.

Lösning: ställ in språket i server.cfg:

setr ox:locale "tr"
# eller tvinga enbart chat:
setr bupa-chat:locale "tr"

Kom ihåg att bupa-chat:locale åsidosätter ox:locale. För att ändra live, använd klient-eventet bupa:changeLanguage. Se Localization.

Saknade översättningar visar nyckelnamnet

t() returnerar nyckeln (t.ex. CATEGORY_ADMIN_LABEL) när en översättning saknas i den aktiva språkfilen. Lägg till den saknade nyckeln i den locales/<code>.json-filen, eller kopiera den från en.json.

qb-core / framework detekteras inte

Orsak: framework-core startade efter (eller körs inte när) BUPA Chat startar.

Fix: se till att qb-core (eller qbx_core / es_extended) startar före BUPA Chat. Framework-bryggan känner automatiskt av Qbox, QB-Core och ESX; du kan också tvinga eller inaktivera detta med convaren bupa-chat:framework (standard är qb-core; sätt till false för att köra utan framework).

Discord-loggning / brygga fungerar inte

• Webhook-loggar kommer inte fram: bekräfta att URL:erna i server/webhook.lua är riktiga Discord-webhook-URL:er och inte platshållarvärden.
• Discord → chatt-bryggan är tyst: i shared/config/discord.lua, sätt active = true, fyll i channelId, och ange en bot-token + guild ID (i config.discord eller återanvänt från config.adminChatName.discord). Meddelanden som skickas av bottar ignoreras avsiktligt.