Skip to content

Installation

安装

BUPA Chat 替换了 FiveM 的默认聊天框。安装的核心在于确保旧的 chat 资源已被移除，并且依赖项在 BUPA Chat 之前启动。

1. 依赖项优先

确保在 BUPA Chat 之前安装并启动了以下项：

  • ox_lib
  • qb-core
  • assetpacks — BUPA Chat 声明了 dependency '/assetpacks'；没有它，UI 将无法加载其资源。

2. 移除默认聊天框

BUPA Chat 声明了 provide 'chat'，因此它会把自己注册为 chat 资源。如果自带的 substitution/chat 资源仍在运行，你将会看到两个聊天框。

⚠

请不要在服务器配置的任何地方 ensure chat（默认资源）。请删除或重命名默认的 [system]/chat 资源，或者确保它永远不会被启动。

3. 放入资源

将 bupa-chat 文件夹放入你的资源目录中（例如放在 [qbx]/[BUPA] 内部），并确保在启动它的依赖项后再启动它。

server.cfg
ensure ox_lib
ensure qb-core
ensure assetpacks

# 确保没有 ensure 默认的 chat
ensure bupa-chat

4. 设置语言

BUPA Chat 从标准的 ox_lib 本地化 convar 读取其语言，同时也支持可选的单个资源覆盖。

server.cfg
# 全局 ox_lib 语言区域 — 由 BUPA Chat 以及所有其他 ox_lib 资源使用
setr ox:locale "tr"

# 可选：仅为 BUPA Chat 覆盖语言（留空则遵循 ox:locale）
setr bupa-chat:locale "en"

如果两个 convar 都未设置，BUPA Chat 将回退到英文（en）。有关内置语言的完整列表，请参阅 Localization。

ℹ

加密版本（escrow build）保持了配置文件的开放编辑权限。位于 shared/config/*.lua、所有 locales/*.json、client/editable.lua、server/editable.lua、server/playerIdDisplay.lua、server/webhook.lua 以及 shared/type.lua 的文件均已列在 escrow_ignore 中，因此你可以在购买后直接进行编辑。

5. 验证

启动服务器并按下 T 键（默认打开键）。你应该能看到带有命令（Commands）标签页的 BUPA Chat 输入框。如果你同时也看到了旧的聊天框，说明默认的 chat 资源仍在运行 — 请返回第 2 步。

PreviousBUPA ChatNext Chat Categories