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

• Переконайтеся, що інші ресурси надсилають повідомлення через стандартний API — chat:addMessage (подія) або exports.chat:addMessage(...). Дивіться Developer API.
• Для повідомлень у категоріях переконайтеся, що гравець дійсно має доступ: 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"
# або примусово тільки для чату:
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; ви також можете зафіксувати його або вимкнути за допомогою convar-змінної bupa-chat:framework (за замовчуванням qb-core; встановіть у false для роботи без фреймворку).

Discord logging / bridge not working

• Webhook logs not arriving: переконайтеся, що URL-адреси в server/webhook.lua є реальними URL-адресами вебхуків Discord, а не заповнювачами.
• Discord → chat bridge silent: у shared/config/discord.lua встановіть active = true, заповніть channelId і вкажіть токен бота + ID гільдії (у config.discord або повторно використайте з config.adminChatName.discord). Повідомлення від ботів навмисно ігноруються.