Skip to content

BUPA Chat

BUPA Chat

BUPA Chat is a premium, drop-in replacement for the default FiveM chat. It ships a fully themeable React interface and replaces the standard chat resource, so every script that already talks to the game chat keeps working — no migration required.

Instead of a single input box, BUPA Chat gives players a tabbed input with chat categories (Commands, OOC, admin, job/gang channels, private messages), an emoji picker, live command suggestions, /me and /do style emotes rendered above the player's head, optional player ID / name badges, Discord logging, and a per-player language that can be switched at runtime.

BUPA Chat provide 'chat', which means it takes over the standard chat resource name. You must remove or stop the default chat resource before starting BUPA Chat — running both at once results in two chat boxes. See the Installation page.

Key features

  • Chat categories / tabs — a built-in command tab plus fully configurable categories: OOC global, OOC local (proximity), admin, police/EMS job channels, gang channels, and any custom category you define. Each category has its own colors, tags, permissions and message rules.
  • Private messages/pm (and /dm) with separate styling for the sender and receiver.
  • Emotes/me, /do, /dice and /rps out of the box, shown as head text above the ped and optionally mirrored into chat. Add your own with animations, distance limits and custom parameters.
  • Emoji picker — a customizable, categorized emoji panel (smileys, gestures, symbols, objects) with searchable shortcodes.
  • Command suggestions — auto-populated from registered commands the player has ACE access to, plus anything you push through the standard chat:addSuggestion(s) API.
  • Player identity badges — optional per-category name, server ID, job (label/grade) and Discord role tags, with mask-aware name hiding and a proximity ID display above heads.
  • Discord integration — webhook logging of chat/emote/PM messages, and an optional Discord → in-game channel bridge that relays Discord messages into chat.
  • Multi-language — translations via ox_lib locales, selectable globally, per-resource, or live per session.
  • Themeable React UI — visibility modes (show-when-active / always-show / hide), typing sounds, click-outside-to-close and configurable open/visibility keys.

Framework

BUPA Chat is built for QB-Core and is listed as a qb-core dependency. The shared framework bridge also detects Qbox (qbx_core) and ESX (es_extended) automatically at runtime, and the framework can be forced or disabled through the bupa-chat:framework convar.

The resource provides the standard chat resource (provide 'chat'), so it is a full replacement for FiveM's default chat rather than an add-on.

Dependencies

Dependency Purpose
ox_lib Locales, keybinds, notifications, callbacks and UI helpers. Loaded as @ox_lib/init.lua and via ox_lib 'locale'.
qb-core Framework core (player data, jobs, gangs). Listed as a hard dependency.
assetpacks Declared with dependency '/assetpacks' — required by the packaged UI assets.