[Free] ox_target - "Third-eye" interaction system

Linden · September 23, 2022, 8:45pm

The successor to qtarget, focused on improving functionality and performance at the cost of compatibility.

Dependencies

ox_lib

Why another third-eye resource?

The original author of qtarget left FiveM right after releasing it, with many features scrapped or untested. Since it was supposed to be mostly compatible with bt-target it kept many of its flaws, and the resource was mostly abandoned as I worked on other projects. Rather than hacking my way through the spaghetti that makes up qtarget, I started completely fresh with only a list of features.

Video

todo… I’m lazy.

Supported Frameworks

Support for ox_core, esx-legacy.

How can I check if a player has a job/gang?

Use the groups property to compare against a group, job or gang (framework-dependant).

example

exports.ox_target:addGlobalPlayer({
    {
        name = 'cuff',
        icon = 'fas fa-handcuffs',
        label = 'Handcuff',
        groups = 'police', -- or {'police', 'sheriff'}, {police = 0}
        distance = 1.5,
        onSelect = function(data)
            cuffPlayer(data.entity)
        end
    }
})

How can I check for other variables?

Use the canInteract function with your option.

example

exports.ox_target:addGlobalPlayer({
    {
        name = 'cuff',
        icon = 'fas fa-handcuffs',
        label = 'Handcuff',
        distance = 1.5,
        canInteract = function(entity, distance, coords, name)
            return InService and not IsPedCuffed(entity)
        end,
        onSelect = function(data)
            cuffPlayer(data.entity)
        end
    }
})

Compatibility

As mentioned previously, ox_target has been rewritten entirely purposefully drops compatibility with qtarget. There is partial compatibility included but it does not and will not ever cover 100% of cases.

Luke · September 23, 2022, 8:54pm

HAZE.EXE · September 23, 2022, 10:23pm

Love it but sadly most scripts are made with qTarget and are not compatible maybe add that Scripts that use qTarget rewritten by ox_Target so that it can be used with ox_Target or an feature that ox_Target understands script that uses qTarget and can use it as it was written to use ox_target instead of qTarget

But thank you guys from overextended for the hard work you put in your Scripts and OX-Framework <3

GryTrean · September 23, 2022, 11:07pm

Saw this on your github a while ago and was waiting for an official release - as always, great job.
One thing I’ve wanted but have lacked the ability to do so myself (I have absolutely no idea about how raycasts work, the minimal experience I have with them comes from Unity from at least 5-6 years ago…) is to have it work in a slightly different way - rather than having the eye in the middle and moving your camera around, have the screen freeze and move the eye/a circle around. Whenever you hover over something that has an action - give it an outline and change the color of the eye as to signalize that you can take some action here. I have seen it on some servers and it worked beautifully - if you do have the time, that’s a suggestion/request I’d make.

I’d also bump the previous comment - backwards compatibility with qTarget would be good to be provided. Most actually well-written scripts (which is… not many) will give players the option to configure that to your target system, but most scripts overall - won’t.

Linden · September 24, 2022, 12:55am

ox_Target understands script that uses qTarget and can use it

backwards compatibility with qTarget would be good to be provided

I can’t make it backwards compatible. Features don’t exist or are implemented in completely different ways. Some qtarget resources will constantly re-register options on a target, which works because options are stored by name; on ox_target that results in hundreds of options.

Partial compatibility is already there if you look, but it is not and will not ever be a drop-in replacement.

github.com

overextended/ox_target/blob/main/client/compat/qtarget.lua

local function exportHandler(exportName, func)
    AddEventHandler(('__cfx_export_qtarget_%s'):format(exportName), function(setCB)
        setCB(func)
    end)
end

---@param options table
---@return table
local function convert(options)
    local distance = options.distance
    options = options.options

    -- People may pass options as a hashmap (or mixed, even)
    for k, v in pairs(options) do
        if type(k) ~= 'number' then
            table.insert(options, v)
        end
    end

    for id, v in pairs(options) do

This file has been truncated. show original

JoeSzymkowicz · September 24, 2022, 1:04am

Great work! Looking forward to converting from qtarget and checking out some of the new features. Keep up the great work!

fyx.dev.co · September 24, 2022, 1:04am

how about qb-target?

Linden · September 24, 2022, 1:07am

Couldn’t care less about qbus and its ecosystem, if people want to PR they can; I’m not wasting my time.

qbtarget is a fork from qtarget and is already mostly compatible with it, but with extra bloat i.e. integrated ped spawning, which makes no sense and will never be accepted.

lulu3 · September 24, 2022, 1:52am

esx1.1 esx1.2 Can it be used？？

Sacreddz · September 24, 2022, 5:39am

finally. thank you

Tristan_Sanchez1 · September 24, 2022, 6:07am

Nobody supports 1.1 anymore

pjzprqa · September 25, 2022, 1:05am

Use ESX 0.1.1. It’s a lot better

dewen · September 25, 2022, 1:33am

Thank you for providing such an amazing tool.
Soon i will change qt_target and go for ox_target instead!

Thanks and keep going!

Linden · September 25, 2022, 2:18am

Probably works, there’s barely anything framework-dependant. I really don’t recommend using such outdated versions though.

github.com

overextended/ox_target/blob/main/client/framework/esx.lua

if GetResourceState('es_extended') == 'missing' then return end

local groups = { 'job', 'job2' }
local playerItems = {}
local playerGroups = {}

local function setPlayerData(playerData)
    if playerData.inventory then
        for _, v in pairs(playerData.inventory) do
            if v.count > 0 then
                playerItems[v.name] = v.count
            end
        end
    end

    for i = 1, #groups do
        local group = groups[i]
        local data = playerData[group]

        if data then

This file has been truncated. show original

Georginos · September 25, 2022, 7:17am

hi, im kinda new to ox_target/qtarget so i wanted to ask… if i can (and how) add police menu into this
Example :
identity card
body search
handcuff
hardcuff
uncuff
drag
put in vehicle / out the vehicle

Thanks for response

PocketFace · November 16, 2022, 4:10pm

I don’t understand why, but when I use ox_target all options are duplicated, in all scripts that use target, when I use qtarget this doesn’t happen, qtarget is “true” in my ox_inventory

Linden · November 16, 2022, 11:58pm

Because qtarget would graciously replace other options with the same name when you spammed target creation; as a result people would register them on events, or even better, inside a iterator or while loop.

docburn · November 17, 2022, 9:18pm

you are adding the model “printercc”… where is it defined ?

i know nothing about ox_target (i need to make the switch someday) but… you need to add ATM model somewhere… like…

local atm = { 506770882, -1364697528, -870868698, -1126237515 }
exports.ox_target:addModel(atm, {

Or i am completely wrong and loosing my time trying to help…

Open_Engine · July 26, 2023, 4:24pm

Can anyone help me i want a camp fire as target and then i want the option Cooking an then i want that the Cooking triggers a custom event

fivehead.eu · August 3, 2023, 1:47pm

So registering them on events is a bad idea?

AddEventHandler('nozzleOnGround', function(droppedNozzle)

    exports.ox_target:addEntity(droppedNozzle,
    {
        icon = 'fa-solid fa-shower',
        event =  'pickUpNozzle',
        label = _U('pickup_nozzle'),
        groups = Config.AllowedJobs,
    })

end)

I have an entity that should be able to be picked up when it drops on the ground. But I want to pass it’s ID (droppedNozzle) along when it triggers the pickUpNozzle event. Is this possible?