BUPA Chat
BUPA Chat
BUPA Chat це преміальна, повністю готова заміна для стандартного чату FiveM. Він постачається з повністю кастомізованим інтерфейсом на React і замінює стандартний ресурс chat, тож кожен скрипт, який уже взаємодіє з ігровим чатом, продовжує працювати — міграція не потрібна.
Замість єдиного поля введення, BUPA Chat надає гравцям вкладки введення з категоріями чату (Команди, OOC, адміністрація, канали робіт/банд, особисті повідомлення), вибором емодзі, живими підказками команд, емоціями у стилі /me та /do, які відображаються над головою гравця, опціональними бейджами ID / імені гравця, логіруванням у Discord та мовою для кожного гравця, яку можна перемикати під час гри.
BUPA Chat містить provide 'chat', що означає перехоплення стандартної назви ресурсу chat. Ви повинні видалити або зупинити стандартний ресурс chat перед запуском BUPA Chat — одночасний запуск обох призведе до появи двох вікон чату. Перегляньте сторінку Встановлення.
Ключові особливості
- Категорії / вкладки чату — вбудована вкладка
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 | Локалі, бінди клавіш, сповіщення, колбеки та помічники інтерфейсу. Завантажується як @ox_lib/init.lua та через ox_lib 'locale'. |
| qb-core | Ядро фреймворку (дані гравця, роботи, банди). Вказано як жорстка залежність. |
| assetpacks | Оголошено з dependency '/assetpacks' — вимагається пакованими ресурсами інтерфейсу. |