BUPA Chat

BUPA Chat 是一款高级的默认 FiveM 聊天框替代品，开箱即用。它搭载了完全支持主题定制的 React 界面，并可直接替换标准的 chat 资源，这意味着所有原本与游戏聊天交互的脚本都能继续正常工作——无需任何迁移。

BUPA Chat 没有采用单一的输入框，而是为玩家提供了带标签页的输入方式，包含聊天分类（命令、OOC、管理员、职业/帮派频道、私聊）、表情选择器、实时的命令补全建议、渲染在玩家头顶上方的 /me 和 /do 风格动作/状态提示、可选的玩家 ID / 姓名徽章、Discord 日志记录以及可在运行时切换的每玩家独立语言。

核心特性

• 聊天分类 / 标签页——内置一个 command 标签页以及完全可配置的分类：全局 OOC、本地 OOC（范围）、管理员、警察/EMS 职业频道、帮派频道，以及你定义的任何自定义分类。每个分类都有其专属的颜色、标签、权限和消息规则。
• 私聊——/pm（以及 /dm），发件人和收件人拥有独立的样式。
• 动作/状态提示——开箱即用的 /me、/do、/dice 和 /rps，以头顶文字的形式显示在人物（ped）上方，并可选择性地同步到聊天框中。你可以添加自定义的动画、距离限制和自定义参数。
• 表情选择器——一个可自定义、按类别划分的表情面板（笑脸、手势、符号、物品），支持带搜索功能的短代码。
• 命令补全建议——根据玩家拥有 ACE 权限的已注册命令自动填充，同时支持你通过标准的 chat:addSuggestion(s) API 推送的任何内容。
• 玩家身份徽章——按分类可选的姓名、服务器 ID、职业（标签/等级）和 Discord 角色标签，支持面具感知的姓名隐藏以及头顶范围 ID 显示。
• Discord 集成——聊天/动作/私聊消息的 Webhook 日志记录，以及可选的 Discord → 游戏内频道桥接功能，可将 Discord 消息转发至聊天框。
• 多语言——通过 ox_lib 本地化实现翻译，可全局、按资源或在会话运行时进行选择。
• 主题化 React UI——可见性模式（激活时显示/总是显示/隐藏）、打字音效、点击外部关闭以及可配置的打开/可见性按键。

框架支持

BUPA Chat 专为 QB-Core 构建，并被列为 qb-core 的依赖项。共享的框架桥接器还会在运行时自动检测 Qbox (qbx_core) 和 ESX (es_extended)，并且可以通过 bupa-chat:framework convar 强制指定或禁用框架。

该资源提供了标准的 chat 资源（provide 'chat'），因此它是 FiveM 默认聊天的完整替代品，而不仅仅是一个附加组件。

依赖项

依赖项	用途
ox_lib	本地化、按键绑定、通知、回调和 UI 辅助工具。通过 @ox_lib/init.lua 和 ox_lib 'locale' 加载。
qb-core	框架核心（玩家数据、职业、帮派）。被列为硬依赖项。
assetpacks	声明为 dependency '/assetpacks'——打包的 UI 资产所必需。