ox_target

Third-eye targeting for FiveM. Replaces qb-target and bt-target. Supports ox_core, esx and qbx_core.

Activation Contract

Load this skill when the user asks to make something interactable: "press E on this ped", "third eye", "target option", "add an interaction to this vehicle/door/prop", or when migrating from qb-target.

Hard Rules

• Call every function through exports.ox_target:<fn>(...). There is no global ox_target table.
• onSelect runs on the CLIENT. Never trust its arguments server-side: re-validate in the serverEvent handler.
• Always pass name on an option you intend to remove later. Removal is by name, not by index.
• distance defaults to the resource default; set it explicitly for anything above ~2.5m.
• Zone and entity functions are CLIENT-side only.
• Prefer addLocalEntity for entities you spawned yourself; use addEntity only for networked entities and expect the id to change on respawn.

Decision Gates

Execution Steps

1. Confirm ox_target is started AFTER ox_lib in server.cfg.
2. Pick the function from the Decision Gates table.
3. Build the options array. Read rules/options.md for every allowed field.
4. Gate visibility with groups, items or canInteract rather than checking inside onSelect.
5. Route the action: onSelect for client logic, serverEvent for anything that grants money, items or state.
6. Store the returned zone id if the zone must be removed later.

Output Contract

Return runnable Lua using exports.ox_target. Include the fxmanifest.lua dependency lines when the resource is new. Never emit qb-target syntax.

References

• rules/setup.md — install, fxmanifest, convars, framework support.
• rules/options.md — every field of the option table.
• rules/entities.md — entity, model and global targets.
• rules/zones.md — box, sphere and poly zones.
• rules/migration.md — qb-target to ox_target.

Upstream docs: https://overextended.dev/ox_target