SuperAPI AI 工具集

ox-target

通用与其它

查看项目

更新于 10-16 08:47

技能介绍

用途:为 FiveM 中实体、模型、玩家或位置添加可交互目标,实现“按 E 交互”“第三人称目标选项”等效果,并支持从 qb-target 迁移。

主要能力:可按对象类型选择不同函数:本地生成的实体用 addLocalEntity;网络实体(net id)用 addEntity;某模型的所有实例用 addModel;所有 ped/车辆/对象/玩家用 addGlobalPed/addGlobalVehicle/addGlobalObject/addGlobalPlayer;无过滤用 addGlobalOption;位置而非实体用 addBoxZone/addSphereZone/addPolyZone。所有函数均通过 exports.ox_target:<fn>(...) 调用,不存在全局 ox_target 表。

使用方式:确保 ox_target 在 server.cfg 中于 ox_lib 之后启动。选择对应函数构建 options 数组;用 groups、items 或 canInteract 控制可见性,而非在 onSelect 内检查;客户端逻辑走 onSelect,涉及金钱、物品或状态的走 serverEvent。若需移除选项,必须为其设置 name,移除按名称而非索引;区域需保存返回的 id 以便后续移除。权限方面,onSelect 在客户端运行,其参数在服务端不可信,需在 serverEvent 处理器中重新校验;distance 默认使用资源默认值,超过约 2.5 米时应显式设置;区域与实体函数仅在客户端使用;自己生成的实体优先用 addLocalEntity,网络实体用 addEntity 且 id 在重生后可能改变。

限制:资料未提供收费、价格、平台或效果信息;新资源需附带 fxmanifest.lua 依赖行,禁止输出 qb-target 语法。上游文档见 https://overextended.dev/ox_target。