BUPA Chat

BUPA Chat to w pełni gotowy do użycia, wysokiej jakości zamiennik domyślnego chatu w FiveM. Posiada w pełni modyfikowalny interfejs w React i zastępuje standardowy zasób chat, dzięki czemu każdy skrypt, który już komunikuje się z chatem gry, nadal działa – bez konieczności migracji.

Zamiast jednego pola wprowadzania, BUPA Chat daje graczon wejście z zakładkami i kategoriami chatu (Komendy, OOC, admin, kanały pracy/gangu, wiadomości prywatne), wyborem emoji, żywymi podpowiedziami komend, emotkami w stylu /me i /do wyświetlanymi nad głową gracza, opcjonalnymi identyfikatorami ID / imienia gracza, logowaniem na Discordzie oraz językiem dla każdego gracza, który można zmienić w trakcie gry.

Key features

• Kategorie / zakładki chatu — wbudowana zakładka command plus w pełni konfigurowalne kategorie: OOC globalny, OOC lokalny (proximity), admin, kanały policji/EMS, kanały gangów oraz dowolna niestandardowa kategoria, którą zdefiniujesz. Każda kategoria ma własne kolory, tagi, uprawnienia i reguły wiadomości.
• Wiadomości prywatne — /pm (oraz /dm) z osobnym stylem dla nadawcy i odbiorcy.
• Emotki — /me, /do, /dice i /rps od zaraz, wyświetlane jako tekst nad pedem i opcjonalnie powielane na chacie. Dodaj własne z animacjami, limitami odległości i niestandardowymi parametrami.
• Wybór emoji — konfigurowalny, podzielony na kategorie panel emoji (buźki, gesty, symbole, obiekty) z wyszukiwanymi shortcodami.
• Podpowiedzi komend — automatycznie uzupełniane na podstawie zarejestrowanych komend, do których gracz ma dostęp ACE, oraz wszystkiego, co przesyłasz przez standardowe API chat:addSuggestion(s).
• Odznaki tożsamości gracza — opcjonalna nazwa dla kategorii, ID serwera, praca (nazwa/stopień) i tagi ról Discord, z ukrywaniem imienia uwzględniającym maski i wyświetlaniem ID w pobliżu nad głowami.
• Integracja z Discordem — logowanie webhook wiadomości chatu/emote/PM oraz opcjonalny mostek kanału Discord → gra, który przekazuje wiadomości z Discorda na chat.
• Wielojęzyczność — tłumaczenia za pomocą lokali ox_lib, wybierane globalnie, per zasób lub na żywo na sesję.
• Interfejs React z możliwością zmiany motywu — tryby widoczności (pokaż gdy aktywny / zawsze pokaż / ukryj), dźwięki pisania, kliknięcie poza obszarem, aby zamknąć, oraz konfigurowalne klawisze otwierania/widoczności.

Framework

BUPA Chat jest stworzony dla QB-Core i jest wymieniony jako zależność qb-core. Wspólny mostek frameworka wykrywa również automatycznie podczas działania Qbox (qbx_core) i ESX (es_extended), a framework można wymusić lub wyłączyć za pomocą convara bupa-chat:framework.

Zasób dostarcza standardowy zasób chat (provide 'chat'), więc jest pełnym zamiennikiem domyślnego chatu FiveM, a nie dodatkiem.

Dependencies

Dependency	Purpose
ox_lib	Lokale, binde klawiszy, powiadomienia, callbacki i pomocnicy UI. Ładowane jako @ox_lib/init.lua oraz przez ox_lib 'locale'.
qb-core	Rdzeń frameworka (dane gracza, prace, gangi). Wymieniony jako twarda zależność.
assetpacks	Zadeklarowane z dependency '/assetpacks' — wymagane przez spakowane zasoby UI.