Troubleshooting

Sık karşılaşılan sorunlar ve çözüm yolları.

İki sohbet kutusu / yinelenen sohbet

Cause: varsayılan chat resource'u, BUPA Chat ile birlikte çalışmaya devam ediyor. BUPA Chat provide 'chat' kullandığından, her ikisi de sohbet olarak kaydedilir.

Fix: stok chat resource'unu durdurun veya kaldırın. Yapılandırmanızın hiçbir yerinde ensure chat kullanmayın — yalnızca ensure bupa-chat kullanın.

Resource başlamıyor / Arayüz (UI) boş görünüyor

Cause: eksik bir dependency. BUPA Chat, ox_lib ve qb-core dependency'lerine dayanır ve dependency '/assetpacks' bildirir.

Fix: üçünün de BUPA Chat'ten önce başladığından emin olun:

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

Eğer assetpacks eksikse, paketlenmiş arayüz varlıkları yüklenemez ve sohbet asla görünmez.

Mesajlar görünmüyor

• Diğer resource'ların standart API üzerinden mesaj gönderdiğinden emin olun — chat:addMessage (event) veya exports.chat:addMessage(...). Bkz. Developer API.
• category mesajları için, oyuncunun gerçekten erişimi olduğunu doğrulayın: Kategori üzerindeki permissions (ACE), jobs veya gangs eşleşmelidir. Erişimi olmayan bir oyuncu bu sekmeyi asla görmez veya kullanamaz.
• Kategorideki maxLength değerini kontrol edin — çok uzun mesajlar silinmez, kısaltılır, ancak özel bir entegrasyonda eşleşmeyen bir type yoksayılır.

Öneriler görünmüyor

• Komut önerileri, oyuncunun kullanma ACE iznine sahip olduğu (command.<name>) kayıtlı komutlardan oluşturulur. Bir komut için oyuncunun ACE izni yoksa, önerilmeyecektir.
• Öneriler, oyuncu yüklenirken ve resource'lar başlayıp durduğunda yenilenir. Yeni kaydedilen bir komut görünmüyorsa, sağlayan resource'u yeniden başlatın veya sohbeti tekrar açın.
• Özel yardım metni/parametreleri için, bunları açıkça chat:addSuggestion / chat:addSuggestions ile gönderin.

Her şey İngilizce (veya yanlış bir dilde)

Cause: dil convar'ı ayarlanmamış, bu yüzden BUPA Chat varsayılan olarak en diline döner.

Fix: dili server.cfg içinde ayarlayın:

setr ox:locale "tr"
# veya yalnızca sohbeti zorlayın:
setr bupa-chat:locale "tr"

bupa-chat:locale ayarının ox:locale değerini geçersiz kıldığını unutmayın. Canlı (anlık) bir değişiklik için bupa:changeLanguage client event'ini kullanın. Bkz. Localization.

Eksik çeviriler anahtar adını (key) gösteriyor

Aktif dil dosyasında bir çeviri eksik olduğunda t() fonksiyonu anahtarı döndürür (örn. CATEGORY_ADMIN_LABEL). Eksik anahtarı ilgili locales/<code>.json dosyasına ekleyin veya en.json dosyasından kopyalayın.

qb-core / framework algılanmıyor

Cause: framework çekirdeği, BUPA Chat başladıktan sonra başladı (veya BUPA Chat açıldığında çalışmıyor).

Fix: qb-core (veya qbx_core / es_extended) öğesinin BUPA Chat'ten önce başladığından emin olun. Framework köprüsü (bridge) Qbox, QB-Core ve ESX'i otomatik olarak algılar; ayrıca bupa-chat:framework convar'ı ile bunu sabitleyebilir veya devre dışı bırakabilirsiniz (varsayılan qb-core; framework'süz çalıştırmak için false olarak ayarlayın).

Discord loglama / köprüsü çalışmıyor

• Webhook logları gelmiyor: server/webhook.lua içindeki URL'lerin yer tutucu değerler değil, gerçek Discord webhook URL'leri olduğunu doğrulayın.
• Discord → sohbet köprüsü sessiz: shared/config/discord.lua içinde active = true yapın, channelId değerini doldurun ve bir bot token + sunucu (guild) ID sağlayın (config.discord içinde veya config.adminChatName.discord içinden yeniden kullanın). Botlar tarafından gönderilen mesajlar kasıtlı olarak yoksayılır.