ox-target

ox_target

FiveM 向けのサードアイターゲティングです。qb-target と bt-target を置き換えます。ox_core、esx、qbx_core に対応しています。

アクティベーション条件

ユーザーが何かをインタラクト可能にするよう依頼した場合に、このスキルを読み込みます。「この ped に E キーでアクセス」「サードアイ」「ターゲットオプション」「この車両／ドア／小道具にインタラクションを追加」、または qb-target からの移行が該当します。

厳守事項

• すべての関数は exports.ox_target:<fn>(...) 経由で呼び出します。グローバルな ox_target テーブルはありません。
• onSelect はクライアントで実行されます。引数をサーバー側で決して信用せず、serverEvent ハンドラーで再検証してください。
• 後で削除する予定のオプションには、必ず name を指定してください。削除はインデックスではなく名前で行います。
• distance の既定値はリソースの既定値です。約 2.5m を超えるものには、明示的に設定してください。
• ゾーン関数とエンティティ関数はクライアント側でのみ使用できます。
• 自分でスポーンしたエンティティには addLocalEntity を優先して使用してください。addEntity はネットワーク化されたエンティティにのみ使用し、リスポーン時に ID が変わることを想定してください。

選択基準

対象	関数
ローカルでスポーンした 1 つのエンティティ	addLocalEntity(entities, options)
ネットワーク化されたエンティティ（ネットワーク ID）	addEntity(entities, options)
モデルのすべてのインスタンス	addModel(models, options)
すべての ped／車両／オブジェクト／プレイヤー	addGlobalPed / addGlobalVehicle / addGlobalObject / addGlobalPlayer
フィルターなしですべて	addGlobalOption(options)
エンティティではなく場所	addBoxZone / addSphereZone / addPolyZone

実行手順

1. server.cfg で ox_target が ox_lib の後に起動することを確認します。
2. 選択基準の表から関数を選びます。
3. オプション配列を作成します。使用可能なすべてのフィールドについて、rules/options.md を確認してください。
4. onSelect 内でチェックするのではなく、groups、items、または canInteract で表示条件を設定します。
5. 処理を振り分けます。クライアント側のロジックには onSelect、お金、アイテム、または状態を付与する処理には serverEvent を使用します。
6. 後でゾーンを削除する必要がある場合は、返されたゾーン ID を保存します。

出力要件

exports.ox_target を使った、実行可能な Lua を返します。リソースが新規の場合は、fxmanifest.lua の依存関係の行を含めてください。qb-target の構文は決して出力しないでください。

参考資料

• rules/setup.md — インストール、fxmanifest、コンバール、フレームワークのサポート。
• rules/options.md — オプションテーブルのすべてのフィールド。
• rules/entities.md — エンティティ、モデル、グローバルターゲット。
• rules/zones.md — ボックス、球体、ポリゴンのゾーン。
• rules/migration.md — qb-target から ox_target への移行。

上流ドキュメント：https://overextended.dev/ox_target