Troubleshooting

Общие проблемы и способы их решения.

Два чата / дублирование чата

Причина: стандартный ресурс chat всё еще запущен параллельно с BUPA Chat. Поскольку BUPA Chat содержит provide 'chat', оба ресурса регистрируются как чат.

Решение: остановите или удалите стандартный ресурс chat. Ни в коем случае не используйте ensure chat в вашей конфигурации — только ensure bupa-chat.

Ре ресурс не запускается / интерфейс пустой

Причина: отсутствует необходимая зависимость. BUPA Chat зависит от ox_lib, qb-core и объявляет dependency '/assetpacks'.

Решение: убедитесь, что все три ресурса запускаются перед BUPA Chat:

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

Если assetpacks отсутствует, упакованные ресурсы интерфейса не смогут загрузиться, и чат так и не появится.

Сообщения не отображаются

• Убедитесь, что другие ресурсы отправляют сообщения через стандартный API — событие chat:addMessage или exports.chat:addMessage(...). См. Developer API.
• Для сообщений в категориях убедитесь, что у игрока действительно есть доступ: настройки permissions (ACE), jobs или gangs для этой категории должны совпадать. Игрок без доступа никогда не увидит эту вкладку и не сможет ею воспользоваться.
• Проверьте параметр maxLength для категории — слишком длинные сообщения обрезаются, а не отбрасываются, но несоответствие type в кастомной интеграции будет проигнорировано.

Подсказки не появляются

• Подсказки команд формируются на основе зарегистрированных команд, к которым у игрока есть ACE-доступ (command.<name>). Если у игрока нет ACE-разрешения на команду, она не будет предложена.
• Подсказки обновляются при загрузке игрока, а также при запуске и остановке ресурсов. Если только что зарегистрированная команда не появляется, перезапустите предоставляющий ее ресурс или откройте чат заново.
• Для кастомного текста помощи или параметров передайте их явно с помощью chat:addSuggestion / chat:addSuggestions.

Всё отображается на английском (или не на том языке)

Причина: ковар локали не задан, поэтому BUPA Chat переключается на язык по умолчанию (en).

Решение: задайте язык в файле server.cfg:

setr ox:locale "tr"
# или принудительно только для чата:
setr bupa-chat:locale "tr"

Помните, что bupa-chat:locale имеет приоритет над ox:locale. Для изменения в реальном времени используйте клиентское событие bupa:changeLanguage. См. Localization.

Отсутствующие переводы выводят имя ключа

Функция t() возвращает ключ (например, CATEGORY_ADMIN_LABEL), если перевод отсутствует в файле активного языка. Добавьте недостающий ключ в файл locales/<code>.json или скопируйте его из en.json.

qb-core / фреймворк не обнаружен

Причина: ядро фреймворка запустилось после запуска BUPA Chat (или не заведено в момент его загрузки).

Решение: убедитесь, что qb-core (или qbx_core / es_extended) запускается до BUPA Chat. Мост фреймворка автоматически определяет Qbox, QB-Core и ESX; вы также можете зафиксировать его или отключить с помощью ковара bupa-chat:framework (по умолчанию qb-core; установите значение false для работы без фреймворка).

Логирование в Discord / мост не работает

• Логи вебхука не приходят: убедитесь, что URL-адреса в server/webhook.lua являются реальными URL-адресами вебхуков Discord, а не значениями-заглушками.
• Мост Discord → чат не активен: в файле shared/config/discord.lua установите active = true, укажите channelId и предоставьте токен бота + ID гильдии (в config.discord или повторно используя config.adminChatName.discord). Сообщения от имени ботов намеренно игнорируются.