BUPA Chat

BUPA Chat は、デフォルトの FiveM チャットに代わるプレミアムなドロップイン代替スクリプトです。高度にテーマ設定可能な React インターフェースを搭載し、標準の chat リソースを置き換えるため、ゲーム内チャットと連携する既存のスクリプトはすべて移行作業なしでそのまま機能します。

BUPA Chat は、単一の入力ボックスの代わりに、チャットカテゴリ（コマンド、OOC、管理者、ジョブ/ギャングチャンネル、プライベートメッセージ）を備えたタブ付き入力、絵文字ピッカー、ライブコマンドサジェスト、プレイヤーの頭上に描画される /me および /do スタイルのエモート、オプションのプレイヤーID / 名前バッジ、Discordログ記録、および実行時に切り替え可能なプレイヤーごとの言語をプレイヤーに提供します。

主な機能

• チャットカテゴリ / タブ — 組み込みの command タブに加え、完全に設定可能なカテゴリ（OOCグローバル、OOCローカル（近接）、管理者、警察/EMSジョブチャンネル、ギャングチャンネル、および定義した任意のカスタムカテゴリ）を利用できます。各カテゴリには、独自のカラー、タグ、権限、メッセージルールがあります。
• プライベートメッセージ — 送信者と受信者で別々のスタイリングが適用される /pm（および /dm）。
• エモート — 標準で /me、/do、/dice、/rps が利用でき、ペッドの頭上のテキストとして表示されるほか、オプションでチャットにもミラーリングされます。アニメーション、距離制限、カスタムパラメータを指定して独自のエモートを追加できます。
• 絵文字ピッカー — 検索可能なショートコードを備えた、カスタマイズ可能でカテゴリ分けされた絵文字パネル（笑顔、ジェスチャー、シンボル、オブジェクト）。
• コマンドサジェスト — プレイヤーが ACE 権限を持っている登録済みコマンドや、標準の chat:addSuggestion(s) API を通じてプッシュした内容から自動入力されます。
• プレイヤーアイデンティティバッジ — カテゴリごとの名前、サーバーID、ジョブ（ラベル/グレード）、Discord ロールタグの表示（オプション）。マスクを考慮した名前の非表示機能や、頭上の近接ID表示機能もあります。
• Discord 連携 — チャット/エモート/PMメッセージのウェブフックログ記録、および 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 アセットに必要です。