🎯Targets
UNIQUE FEATURES
Core Focus primaraly uses exactly the same export structure as in qb-target. There are a couple new variables that can be used when registering targets using core_focus, ox_target, qtarget exports. Usually put after options table besides distance variable.
Variable
Type
Description
forceColor
string (hex code)
Forces the "dot" and radial menu use this defined color.
forceSeperate
bool (true or false)
Forces the given options to form another "dot" and not merge with existing options
EXPORTS
AddCircleZone
Adds a circular zone that players can interact with
Usage :
exports.core_focus:AddCircleZone("police_armory", vector3(452.6, -980.0, 30.6), 1.5, {
name = "police_armory",
debugPoly = false,
useZ = true -- optional
}, {
options = {
{
num = 1, -- optional
type = "client",
event = "police:openArmory",
icon = "fas fa-archive",
label = "Open Armory",
targeticon = "fas fa-gun", -- optional
item = "police_badge", -- optional
action = function(entity) -- optional
if IsPedAPlayer(entity) then return false end
TriggerEvent("police:openArmoryMenu", entity)
end,
canInteract = function(entity, distance, data) -- optional
return not IsPedAPlayer(entity)
end,
job = { ["police"] = 0, ["sheriff"] = 1 }, -- optional
gang = { ["thelostmc"] = 2 }, -- optional
citizenid = { ["JFD98238"] = true, ["HJS29340"] = true }, -- optional
drawDistance = 10.0, -- optional
drawColor = {255, 255, 255, 255}, -- optional
successDrawColor = {0, 255, 0, 255} -- optional
}
},
distance = 2.5,
forceColor = '#3d24ab', -- optional
forceSeperate = true -- optional
})AddBoxZone
Adds a rectangular zone that players can interact with
Usage :
exports.core_focus:AddBoxZone("mechanic_workbench", vector3(-1150.7, -2005.1, 13.2), 1.5, 3.0, {
name = "mechanic_workbench",
heading = 90.0,
debugPoly = false, -- optional
minZ = 12.5,
maxZ = 14.0
}, {
options = {
{
num = 1, -- optional
type = "client",
event = "mechanic:client:RepairVehicle",
icon = "fas fa-wrench",
label = "Repair Vehicle",
targeticon = "fas fa-car-crash", -- optional
canInteract = function(entity, distance, data)
return IsEntityAVehicle(entity)
end,
job = { ["mechanic"] = 0 } -- optional
},
{
num = 2, -- optional
type = "client",
action = function(entity)
if IsEntityAVehicle(entity) then
TriggerServerEvent("mechanic:server:OpenUpgradeMenu")
end
end, -- optional
icon = "fas fa-arrow-up",
label = "Upgrade Vehicle",
item = "advanced_toolkit", -- optional
gang = { ["lostmc"] = 0, ["ballas"] = 0 }, -- optional
citizenid = { ["KAI00001"] = true }, -- optional
drawDistance = 2.0, -- optional
drawColor = {255, 165, 0, 200}, -- optional
successDrawColor = {0, 255, 127, 255} -- optional
}
},
distance = 2.5,
forceColor = "#c75ae0", -- optional
forceSeperate = true -- optional
})AddPolyZone
Adds a custom-shaped polygon zone that players can interact with
Usage :
-- Define the points for the polygon shape on the ground
local points = {
vector2(-75.5, -820.0),
vector2(-78.0, -822.5),
vector2(-81.5, -821.0),
vector2(-80.0, -817.5),
vector2(-77.0, -817.0)
}
exports.core_focus:AddPolyZone("rooftop_helipad", points, {
name = "rooftop_helipad",
debugPoly = false, -- optional
minZ = 320.0,
maxZ = 322.0
}, {
options = {
{
num = 1, -- optional
type = "server",
event = "heli:server:requestHeli",
icon = "fas fa-helicopter",
label = "Request Helicopter",
item = "gold_membership_card", -- optional
job = { ["pilot"] = 0 } -- optional
},
{
num = 2, -- optional
type = "client",
action = function() -- optional
-- Assume this triggers a cleaning minigame or animation
TriggerEvent("maintenance:client:cleanArea")
end,
icon = "fas fa-broom",
label = "Clean Helipad",
canInteract = function(entity, distance, data) -- optional
local playerPed = PlayerPedId()
-- Only allow interaction if the player is not in a vehicle
return not IsPedInAnyVehicle(playerPed, false)
end,
job = { ["maintenance"] = 0 }, -- optional
drawDistance = 5.0, -- optional
drawColor = {255, 255, 0, 150}, -- optional
successDrawColor = {255, 192, 203, 255} -- optional
}
},
distance = 3.0,
forceColor = "#ffab40", -- optional
forceSeperate = true -- optional
})AddComboZone
Adds a composite zone made up of two or more PolyZones (CircleZone, BoxZone, or PolyZone), treated as a single interactive area
Usage :
-- Create the first console zone for the generator
local powerConsoleA = BoxZone:Create(vector3(895.0, -180.0, 78.0), 1.0, 1.5, {
name = "powerConsoleA",
heading = 90.0,
debugPoly = false,
minZ = 77.5,
maxZ = 79.0
})
-- Create the second console zone
local powerConsoleB = BoxZone:Create(vector3(900.0, -180.0, 78.0), 1.0, 1.5, {
name = "powerConsoleB",
heading = 90.0,
debugPoly = false,
minZ = 77.5,
maxZ = 79.0
})
-- Combine the two zones into a single target that requires players in both
exports.core_focus:AddComboZone({ powerConsoleA, powerConsoleB }, {
name = "generator_controls",
debugPoly = false -- optional
}, {
options = {
{
num = 1, -- optional
type = "server",
event = "powerplant:server:activateGenerator",
icon = "fas fa-bolt",
label = "Activate Main Power",
targeticon = "fas fa-power-off", -- optional
item = "access_card", -- optional
canInteract = function(entity, distance, data) -- optional
-- Example check to see if the generator is already on
return not IsGeneratorActive
end,
job = { ["engineer"] = 0 }, -- optional
drawDistance = 10.0, -- optional
drawColor = {255, 200, 0, 200}, -- optional
successDrawColor = {124, 252, 0, 255} -- optional
}
},
distance = 1.5,
forceColor = "#ffc107", -- optional
forceSeperate = true -- optional
})AddTargetBone
Adds targetable interaction options to specific bones of entities
Usage :
-- A list of all wheel bones on a standard vehicle
local bones = { "wheel_lf", "wheel_rf", "wheel_lr", "wheel_rr" }
exports.core_focus:AddTargetBone(bones, {
options = {
{
num = 1, -- optional
type = "client",
action = function(entity, data) -- optional
-- data.bone contains the name of the specific bone that was targeted
print("Changing tire on bone: " .. data.bone)
TriggerEvent("vehicle:client:changeTire", entity, data.bone)
end,
icon = "fas fa-tire-flat",
label = "Change Tire",
item = "tire_iron", -- optional
canInteract = function(entity, distance, data) -- optional
if not IsEntityAVehicle(entity) then return false end
-- Check if the specific tire targeted is actually damaged
return GetVehicleTyreHealth(entity, data.boneIndex) < 950.0
end,
job = { ["tow"] = 0 }, -- optional
}
},
distance = 1.5,
forceColor = "#adb5bd", -- optional
forceSeperate = true -- optional
})RemoveTargetBone
Removes targeting options from one or more bones on all applicable entities registered via AddTargetBone
Usage :
exports.core_focus:RemoveTargetBone({ "wheel_lf", "wheel_rf", "wheel_lr", "wheel_rr" })AddTargetEntity
Adds interaction options to a specific entity (such as a ped, vehicle, or object)
Usage :
CreateThread(function()
local model = `prop_hotdogstand_01`
RequestModel(model)
while not HasModelLoaded(model) do Wait(0) end
-- Create a prop entity instead of a ped
local hotdogStand = CreateObject(model, 15.5, -1345.8, 29.5, true, true, false)
PlaceObjectOnGroundProperly(hotdogStand)
FreezeEntityPosition(hotdogStand, true)
exports.core_focus:AddTargetEntity(hotdogStand, {
options = {
{
num = 1, -- optional
type = "server",
event = "food:server:buyHotdog",
icon = "fas fa-hotdog",
label = "Buy Hotdog ($5)",
action = function(entity) -- optional
-- This can be used for client-side effects before a server event
print("Trying to buy a hotdog!")
end,
canInteract = function(entity, distance, data) -- optional
local playerPed = PlayerPedId()
return not IsPedInAnyVehicle(playerPed, false)
end
}
},
distance = 1.5,
forceColor = "#dc3545", -- optional
forceSeperate = true -- optional
})
end)RemoveTargetEntity
Removes specific target options from an entity by label(s).
Usage :
exports.core_focus:RemoveTargetEntity(hotdogStand, "Buy Hotdog ($5)")AddEntityZone
Adds a target zone that is dynamically attached to a specific entity. Useful for treating an entity like a movable zone (e.g. attaching interaction to a ped or vehicle)
Usage :
CreateThread(function()
local model = `taxi`
RequestModel(model)
while not HasModelLoaded(model) do Wait(0) end
-- Spawn a taxi at a taxi stand location
local taxiVehicle = CreateVehicle(model, 895.5, -175.0, 78.5, 180.0, true, false)
SetVehicleDoorsLocked(taxiVehicle, 2) -- Lock all doors
SetVehicleEngineOn(taxiVehicle, false, true, true)
exports.core_focus:AddEntityZone("taxi_fast_travel", taxiVehicle, {
name = "taxi_fast_travel",
debugPoly = false -- optional
}, {
options = {
{
num = 1, -- optional
type = "client",
action = function(entity) -- optional
TriggerEvent("fasttravel:client:start", "downtown")
end,
icon = "fas fa-city",
label = "Travel to Downtown",
canInteract = function(entity, distance, data) -- optional
return GetVehicleClass(entity) == 9 -- 9 is the Taxi vehicle class
end,
},
{
num = 2, -- optional
type = "client",
action = function(entity) -- optional
TriggerEvent("fasttravel:client:start", "beach")
end,
icon = "fas fa-umbrella-beach",
label = "Travel to Vespucci Beach",
job = { ["taxi"] = 0 } -- optional
}
},
distance = 3.0,
forceColor = "#ffc107", -- optional
forceSeperate = true -- optional
})
end)RemoveEntityZone
Removes a previously registered entity-based zone
Usage :
exports.core_focus:RemoveEntityZone("taxi_fast_travel")AddTargetModel
Adds interaction options to one or more models, allowing players to interact with all entities of those models (e.g. specific ped, vehicle, or prop types)
Usage :
-- A list of common vending machine models
local models = {
"prop_vend_soda_01",
"prop_vend_soda_02",
"prop_vend_water_01"
}
exports.core_focus:AddTargetModel(models, {
options = {
{
num = 1, -- optional
type = "server",
event = "vending:server:buyDrink",
icon = "fas fa-glass-whiskey",
label = "Buy Drink",
action = function(entity) -- optional
-- This action can run on the client before the server event
-- to determine which machine was used.
local model = GetEntityModel(entity)
if model == GetHashKey("prop_vend_water_01") then
print("Buying some water!")
else
print("Buying some soda!")
end
end,
canInteract = function(entity, distance, data) -- optional
-- Example: Check if the vending machine has power
return IsVendingMachinePowered(entity)
end
}
},
distance = 1.2,
forceColor = "#28a745", -- optional
forceSeperate = true -- optional
})RemoveTargetModel
Removes interaction options from one or more models.
Usage :
exports.core_focus:RemoveTargetModel(models, "Buy Drink")AddGlobalPed
Adds interaction options that apply to all peds in the world. Useful for universal interactions like restraining or identifying NPCs
Usage :
exports.core_focus:AddGlobalPed({
options = {
{
num = 1, -- optional
type = "client",
action = function(entity) -- optional
TriggerEvent("ems:client:checkVitals", entity)
end,
icon = "fas fa-heartbeat",
label = "Check Vitals",
canInteract = function(entity, distance, data) -- optional
-- Only allow interaction on NPC peds that are not dead
return not IsPedAPlayer(entity) and not IsPedDeadOrDying(entity, true)
end,
job = { ["ems"] = 0 }, -- optional
}
},
distance = 2.0,
forceColor = "#007bff", -- optional
forceSeperate = true -- optional
})RemoveGlobalPed
Removes global interaction options from all peds.
Usage :
exports.core_focus:RemoveGlobalPed("Check Vitals")AddGlobalVehicle
Adds interaction options to all vehicles globally.
Usage :
exports.core_focus:AddGlobalVehicle({
options = {
{
num = 1, -- optional
type = "server",
event = "police:server:checkVehiclePlate",
icon = "fas fa-id-card",
label = "Check License Plate",
targeticon = "fas fa-car", -- optional
canInteract = function(entity, distance, data) -- optional
local playerPed = PlayerPedId()
-- Only allow interaction if the player is not in a vehicle
return not IsPedInAnyVehicle(playerPed, false)
end,
job = { ["police"] = 0 }, -- optional
}
},
distance = 3.0,
forceColor = "#0d6efd", -- optional
forceSeperate = true -- optional
})RemoveGlobalVehicle
Removes global options from all vehicles.
Usage :
exports.core_focus:RemoveGlobalVehicle("Check License Plate")AddGlobalObject
Adds interaction options to all static world objects globally.
Usage :
exports.core_focus:AddGlobalObject({
options = {
{
num = 1, -- optional
type = "client",
action = function(entity) -- optional
-- A real script might play an effect before deleting the object
DeleteObject(entity)
end,
icon = "fas fa-fire-extinguisher",
label = "Extinguish Fire",
item = "fire_extinguisher", -- optional
canInteract = function(entity, distance, data) -- optional
if not DoesEntityExist(entity) then return false end
-- A simple check to see if the object is likely a fire prop.
-- A more robust script would check against a table of specific model hashes.
local modelName = GetEntityModelName(entity)
return modelName and string.find(modelName, "fire")
end,
job = { ["fire"] = 0 }, -- optional
}
},
distance = 4.0,
forceColor = "#fd7e14", -- optional
forceSeperate = true -- optional
})RemoveGlobalObject
Removes global options from all world objects.
Usage :
exports.core_focus:RemoveGlobalObject("Extinguish Fire")AddGlobalPlayer
Adds interaction options to all player entities globally
Usage :
exports.core_focus:AddGlobalPlayer({
options = {
{
num = 1, -- optional
type = "server",
event = "police:server:cuffPlayer",
icon = "fas fa-hands",
label = "Place in Cuffs",
item = "handcuffs", -- optional
canInteract = function(entity, distance, data) -- optional
-- Prevents cuffing yourself, players who are already cuffed, or dead players
return entity ~= PlayerPedId() and not IsPedCuffed(entity) and not IsPedDeadOrDying(entity, true)
end,
job = { ["police"] = 0 }, -- optional
}
},
distance = 1.5,
forceColor = "#0d6efd", -- optional
forceSeperate = true -- optional
})RemoveGlobalPlayer
Removes global options that apply to all player entities.
Usage :
exports.core_focus:RemoveGlobalPlayer("Place in Cuffs")Last updated