Skip to content

Troubleshooting

Troubleshooting

Common issues and how to fix them.

Two chat boxes / duplicate chat

Cause: デフォルトの chat リソースが BUPA Chat と同時に起動しています。BUPA Chat は provide 'chat' を行っているため、両方がチャットとして登録されます。

Fix: デフォルトの chat リソースを停止または削除してください。設定ファイルのどこにも ensure chat を記述せず、ensure bupa-chat のみにしてください。

Resource won't start / UI is blank

Cause: 依存関係が不足しています。BUPA Chat は ox_lib、qb-core に依存しており、dependency '/assetpacks' を宣言しています。

Fix: 3つすべてが BUPA Chat の前に起動するようにしてください:

cfg
ensure ox_lib
ensure qb-core
ensure assetpacks
ensure bupa-chat

もし assetpacks がない場合、パッケージ化された UI アセットの読み込みに失敗し、チャットが表示されません。

No messages showing

  • 他のリソースが標準 API (chat:addMessage (イベント) または exports.chat:addMessage(...)) を使用してメッセージを送信していることを確認してください。Developer API を参照してください。
  • カテゴリメッセージについては、プレイヤーに実際にアクセス権があることを確認してください。カテゴリの permissions (ACE)、jobs、または gangs が一致している必要があります。権限のないプレイヤーには、そのタブが表示されず、使用することもできません。
  • カテゴリの maxLength を確認してください。長すぎるメッセージは破棄されるのではなく切り捨てられますが、カスタム連携での type の不一致は無視されます。

Suggestions not appearing

  • コマンドサジェストは、プレイヤーが使用を ACE 許可されている登録済みコマンド (command.<name>) から構築されます。プレイヤーにコマンドの ACE 権限がない場合、サジェストされません。
  • サジェストは、プレイヤーのロード時およびリソースの開始/停止時に更新されます。新しく登録されたコマンドが表示されない場合は、提供しているリソースを再起動するか、チャットを再度開いてください。
  • カスタムのヘルプテキスト/パラメータについては、chat:addSuggestion / chat:addSuggestions を使用して明示的にプッシュしてください。

Everything is in English (or the wrong language)

Cause: ロケール convar が設定されていないため、BUPA Chat は en にフォールバックします。

Fix: server.cfg で言語を設定してください:

cfg
setr ox:locale "tr"
# またはチャットのみを強制する場合:
setr bupa-chat:locale "tr"

bupa-chat:locale は ox:locale よりも優先されることに注意してください。ライブで変更するには、bupa:changeLanguage クライアントイベントを使用してください。Localization を参照してください。

Missing translations show the key name

アクティブな言語ファイルに翻訳が欠落している場合、t() はキー (例: CATEGORY_ADMIN_LABEL) を返します。該当する locales/<code>.json に不足しているキーを追加するか、en.json からコピーしてください。

qb-core / framework not detected

Cause: フレームワークコアの起動が遅い（または BUPA Chat の起動時に実行されていない）。

Fix: BUPA Chat の前に qb-core (または qbx_core / es_extended) が起動するようにしてください。フレームワークブリッジは Qbox、QB-Core、ESX を自動検出します。また、bupa-chat:framework convar を使用して固定または無効化することもできます (デフォルトは qb-core、フレームワークなしで実行するには false に設定します)。

Discord logging / bridge not working

  • Webhook logs not arriving: server/webhook.lua 内の URL がプレースホルダー値ではなく、実際の Discord Webhook URL であることを確認してください。
  • Discord → chat bridge silent: shared/config/discord.lua で active = true に設定し、channelId を入力し、ボットの トークン + ギルド ID (config.discord 内、または config.adminChatName.discord から流用) を提供してください。ボットが作成したメッセージは意図的に無視されます。
PreviousLocalizationNext BUPA Fuel