ed

resources/[carscripts]/community_bridge/modules/target/qb-target/client.lua

@@ -0,0 +1,208 @@
+---@diagnostic disable: duplicate-set-field
+local resourceName = "qb-target"
+if GetResourceState(resourceName) == 'missing' then return end
+if GetResourceState("ox_target") == 'started' then return end
+
+local targetDebug = false
+local function detectDebugEnabled()
+    if BridgeSharedConfig.DebugLevel == 2 then
+        targetDebug = true
+    end
+end
+
+detectDebugEnabled()
+
+local targetZones = {}
+
+Target = Target or {}
+local qb_target = exports['qb-target']
+
+
+---This is an internal function that is used to fix the options passed to fit alternative target systems, for example qb-ox or ox-qb etc.
+---@param options table
+---@return table
+Target.FixOptions = function(options)
+    for k, v in pairs(options) do
+        local action = v.onSelect or v.action
+        local select = function(entityOrData)
+            if type(entityOrData) == 'table' then
+                return action(entityOrData.entity)
+            end
+            return action(entityOrData)
+        end
+        options[k].action = select
+        options[k].job = v.job or v.groups
+    end
+    return options
+end
+
+---This will toggle the targeting system on or off. This is useful for when you want to disable the targeting system for a specific player entirely.
+---@param bool boolean
+Target.DisableTargeting = function(bool)
+    qb_target:AllowTargeting(not bool)
+end
+
+---This will add target options to players.
+---@param options table
+Target.AddGlobalPlayer = function(options)
+    options = Target.FixOptions(options)
+    qb_target:AddGlobalPlayer({
+        options = options,
+        distance = options.distance or 1.5
+    })
+end
+
+---This will remove target options from all players.
+Target.RemoveGlobalPlayer = function()
+    qb_target:RemoveGlobalPlayer()
+end
+
+---This will add target options to all specified models. This is useful for when you want to add target options to all models of a specific type.
+---@param options table
+Target.AddGlobalPed = function(options)
+    options = Target.FixOptions(options)
+    qb_target:AddGlobalPed({
+        options = options,
+        distance = options.distance or 1.5
+    })
+end
+
+---This will remove target options from all peds. This is useful for when you want to remove target options from all peds.
+---@param options any
+Target.RemoveGlobalPed = function(options)
+    qb_target:RemoveGlobalPed(options)
+end
+
+---This will add taget options to all vehicles.
+---@param options table
+Target.AddGlobalVehicle = function(options)
+    options = Target.FixOptions(options)
+    qb_target:AddGlobalVehicle({
+        options = options,
+        distance = options.distance or 1.5
+    })
+end
+
+---This will add a networked entity to the target system.
+---@param netids table | number
+---@param options table
+Target.AddNetworkedEntity = function(netids, options)
+    options = Target.FixOptions(options)
+    qb_target:AddTargetEntity(netids, options)
+end
+
+---This will remove a networked entity from the target system.
+---@param netids table | number
+---@param optionNames string
+Target.RemoveNetworkedEntity = function(netids, optionNames)
+    qb_target:RemoveTargetEntity(netids, optionNames)
+end
+
+---This will remove target options from all vehicles.
+---@param options table
+Target.RemoveGlobalVehicle = function(options)
+    local assembledLables = {}
+    for k, v in pairs(options) do
+        table.insert(assembledLables, v.label)
+    end
+    qb_target:RemoveGlobalVehicle(assembledLables)
+end
+
+---This will generate targets on non networked entites with the passed options.
+---@param entities number | table
+---@param options table
+Target.AddLocalEntity = function(entities, options)
+    options = Target.FixOptions(options)
+    qb_target:AddTargetEntity(entities, {
+        options = options,
+        distance = options.distance or 1.5
+    })
+end
+
+---This will remove the target options from a local entity. This is useful for when you want to remove target options from a specific entity.
+---@param entity number | table
+---@param labels string | table | nil
+Target.RemoveLocalEntity = function(entity, labels)
+    qb_target:RemoveTargetEntity(entity, labels)
+end
+
+---This will add target options to all specified models. This is useful for when you want to add target options to all models of a specific type.
+---@param models number | table
+---@param options table
+Target.AddModel = function(models, options)
+    options = Target.FixOptions(options)
+    qb_target:AddTargetModel(models, {
+        options = options,
+        distance = options.distance or 1.5,
+    })
+end
+
+---This will remove target options from all specified models.
+---@param model number
+Target.RemoveModel = function(model)
+    qb_target:RemoveTargetModel(model)
+end
+
+---This will add a box zone to the target system. This is useful for when you want to add target options to a specific area.
+---@param name string
+---@param coords table
+---@param size table
+---@param heading number
+---@param options table
+Target.AddBoxZone = function(name, coords, size, heading, options, debug)
+    options = Target.FixOptions(options)
+    if not next(options) then return end
+    qb_target:AddBoxZone(name, coords, size.x, size.y, {
+        name = name,
+        debugPoly = debug or targetDebug,
+        heading = heading,
+        minZ = coords.z - (size.z * 0.5),
+        maxZ = coords.z + (size.z * 0.5),
+    }, {
+        options = options,
+        distance = options.distance or 1.5,
+    })
+    table.insert(targetZones, { name = name, creator = GetInvokingResource() })
+end
+
+---This will add a circle zone to the target system. This is useful for when you want to add target options to a specific area.
+---@param name string
+---@param coords table
+---@param radius number
+---@param options table
+Target.AddSphereZone = function(name, coords, radius, options)
+    options = Target.FixOptions(options)
+    qb_target:AddCircleZone(name, coords, radius, {
+        name = name,
+        debugPoly = targetDebug,
+    }, {
+        options = options,
+        distance = options.distance or 1.5,
+    })
+    table.insert(targetZones, { name = name, creator = GetInvokingResource() })
+end
+
+---This will remove target options from a specific zone.
+---@param name string
+Target.RemoveZone = function(name)
+    if not name then return end
+    for _, data in pairs(targetZones) do
+        if data.name == name then
+            qb_target:RemoveZone(name)
+            table.remove(targetZones, _)
+            break
+        end
+    end
+end
+
+AddEventHandler('onResourceStop', function(resource)
+    if resource ~= GetCurrentResourceName() then return end
+    for _, target in pairs(targetZones) do
+        if target.creator == resource then
+            qb_target:RemoveZone(target.name)
+        end
+    end
+    targetZones = {}
+end)
+
+return Target