BUPA Chat

BUPA Chat — это премиальная замена стандартного чата FiveM по принципу "установи и работай". Она поставляется с полностью кастомизируемым интерфейсом на React и заменяет стандартный ресурс chat, поэтому каждый скрипт, который уже взаимодействует с игровым чатом, продолжит работать — миграция не требуется.

Вместо одного поля ввода BUPA Chat предлагает игрокам вкладки с категориями чата (Команды, OOC, административные каналы, каналы работы/банды, личные сообщения), выбор эмодзи, подсказки команд в реальном времени, отыгровки в стиле /me и /do, отображаемые над головой игрока, опциональные бейджи с ID / именем игрока, логирование в Discord и язык для каждого игрока, который можно переключать прямо во время игры.

Ключевые особенности

• Категории / вкладки чата — встроенная вкладка command плюс полностью настраиваемые категории: глобальный OOC, локальный OOC (по близости), админ-чат, каналы работы полиции/EMS, каналы банд и любые созданные вами пользовательские категории. Каждая категория имеет свои цвета, теги, права и правила сообщений.
• Личные сообщения — /pm (и /dm) с разным стилем отображения для отправителя и получателя.
• Отыгровки — /me, /do, /dice и /rps "из коробки", отображаемые в виде текста над головой педа и опционально дублирующиеся в чат. Добавляйте собственные отыгровки с анимациями, ограничениями по дальности и пользовательскими параметрами.
• Выбор эмодзи — настраиваемая панель эмодзи с категориями (смайлики, жесты, символы, объекты) и поиском по шорткодам.
• Подсказки команд — автоматически заполняются на основе зарегистрированных команд, к которым у игрока есть доступ по ACE, а также всего, что вы передаете через стандартный API chat:addSuggestion(s).
• Бейджи идентификации игрока — настраиваемые для каждой категории имя, ID на сервере, работа (название/ранг) и теги ролей Discord, со скрытием имени при надетой маске и отображением ID по близости над головой.
• Интеграция с Discord — логирование через вебхуки для сообщений чата, отыгровок и ЛС, а также опциональный мост Discord → внутриигровой канал, который транслирует сообщения из Discord в чат.
• Мультиязычность — переводы через локали ox_lib, выбираемые глобально, для каждого ресурса или динамически за сессию.
• Кастомизируемый React UI — режимы видимости (показывать при активности / всегда показывать / скрывать), звуки ввода текста, закрытие по клику вне интерфейса и настраиваемые клавиши открытия/видимости.

Фреймворк

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

Ресурс предоставляет стандартный ресурс chat (provide 'chat'), поэтому он является полноценной заменой дефолтного чата FiveM, а не дополнением.

Зависимости

Зависимость	Назначение
ox_lib	Локали, бинды клавиш, уведомления, колбэки и хелперы UI. Загружается как @ox_lib/init.lua и через ox_lib 'locale'.
qb-core	Ядро фреймворка (данные игрока, работы, банды). Указано как жесткая зависимость.
assetpacks	Объявлено с dependency '/assetpacks' — требуется для упакованных UI-ресурсов.