ox-target

ox_target

适用于 FiveM 的第三眼目标交互。替代 qb-target 和 bt-target。支持 ox_core、esx 和 qbx_core。

激活条件

当用户要求让某个对象可交互时加载此技能，例如：“按 E 与这个 ped 交互”“第三眼”“目标选项”“为这辆车／这扇门／这个道具添加交互”，或从 qb-target 迁移时。

硬性规则

• 每个函数都必须通过 exports.ox_target:<fn>(...) 调用。不存在全局 ox_target 表。
• onSelect 在客户端运行。绝不能在服务端信任其参数：请在 serverEvent 处理程序中重新验证。
• 对于之后需要移除的选项，务必传入 name。移除选项时依据名称，而不是索引。
• distance 默认为资源默认值；对于距离超过约 2.5m 的交互，请显式设置。
• 区域和实体函数只能在客户端使用。
• 对于由你自行生成的实体，优先使用 addLocalEntity；仅对网络实体使用 addEntity，并注意实体重生后 id 可能会改变。

决策条件

目标	函数
一个由你在本地生成的实体	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. 使用 groups、items 或 canInteract 控制可见性，而不是在 onSelect 中进行检查。
5. 路由操作：客户端逻辑使用 onSelect；凡涉及发放金钱、物品或状态的操作，使用 serverEvent。
6. 如果之后需要移除区域，请保存返回的区域 id。

输出要求

返回可运行的 Lua 代码，并使用 exports.ox_target。如果资源是新建的，请包含 fxmanifest.lua 依赖项行。绝不输出 qb-target 语法。

参考资料

• rules/setup.md — 安装、fxmanifest、convars、框架支持。
• rules/options.md — 选项表中的所有字段。
• rules/entities.md — 实体、模型和全局目标。
• rules/zones.md — box、sphere 和 poly 区域。
• rules/migration.md — 从 qb-target 迁移到 ox_target。

上游文档：https://overextended.dev/ox_target