Integrations

Goal: connect ox_target to your existing scripts. Files: config.lua (Config.*Script selectors), then if needed config_client.lua and config_server.lua (hooks).

How the bridge decides

For every function (Bridge.Notify, Bridge.PlayEmote, Bridge.RevivePlayer…), the bridge applies this order:

1. Hook: if Config.ClientHooks.<Name> (or Config.ServerHooks.<Name> server side) is a function, it is called and fully replaces the preset.
2. Preset: otherwise, the selector value decides.

Possible values fall into four modes:

• Detection ('auto'): the bridge takes the first resource of its list that is started (started or starting) at call time; failing that, a fixed fallback (often native, command or no integration).
• Named resource ('esx_ambulancejob', 'av_weather'…): the matching preset is used. Depending on the preset, the resource state is checked or not: see each table.
• 'command' and 'native': commands from Config.Commands, or GTA natives without an external script.
• 'custom': no preset; only your hooks act. Some selectors also accept false to disable the integration.

Framework

Hooks that replace this preset: Config.ClientHooks.GetPlayerJob Config.ClientHooks.HasItem Config.ServerHooks.GetPlayerJob Config.ServerHooks.HasGroup Config.ServerHooks.HasItem Config.ServerHooks.RemoveItem

Config.Framework only affects the bridge. The native groups filter uses a separate module (client/framework) that detects ox_core, es_extended, qb-core, qbx_core then ND_Core when the resource starts.

The bridge uses the framework to read the job (GetPlayerJob), the staff groups (HasGroup) and the framework inventory. With ox, nd or standalone, the bridge reads no job: define GetPlayerJob client and server side if you use jobs filters.

Emotes

Hooks that replace this preset: Config.ClientHooks.PlayEmote Config.ClientHooks.PlaySharedEmote Config.ClientHooks.GetCurrentEmote Config.ClientHooks.CancelEmote Config.ClientHooks.Me

/me (Bridge.Me) and emote cancel always use Config.Commands.me and cancelEmote whatever the preset, unless a Me or CancelEmote hook exists.

Emote copy asks the targeted player for the current emote through Bridge.GetCurrentEmote; only a name (non-empty string) is usable. Depending on the rpemotes version, the IsPlayerInAnim export may return a boolean: the copy then answers with copy_emote_none. Define the GetCurrentEmote hook if your script exposes the name differently.

Medical

Hooks that replace this preset: Config.ClientHooks.ReviveSelf Config.ClientHooks.HealSelf Config.ServerHooks.RevivePlayer Config.ServerHooks.HealPlayer

With Config.Medical.nativeHealFallback = true, a native heal runs after every heal, including when a hook is defined.

Config.Medical.selfMode decides where self revive/heal runs: 'client' calls Bridge.ReviveSelf / HealSelf after server validation; 'server' calls Bridge.RevivePlayer(source, source) / HealPlayer. The success message (self_revived, self_healed) is sent by the server in both cases, without waiting for the medical script’s result.

Inventory

Hooks that replace this preset: Config.ClientHooks.HasItem Config.ServerHooks.HasItem Config.ServerHooks.RemoveItem

Client side, the item check only shows or hides an option; the server checks again before the action. The native items filter of options uses another mechanism (original ox_target module) that reads ox_inventory when present, otherwise the detected framework inventory.

Notifications

Hooks that replace this preset: Config.ClientHooks.Notify Config.ServerHooks.Notify

Server side, Bridge.Notify sends an event to the client, which then applies this choice.

Internal types are info, success, error, warning and primary. ox_lib receives inform for info and primary; QBCore receives primary, success or error (warning becomes error). Config.DNotifColors maps a dNotif colour to each type.

Inputs and confirmations

Hooks that replace this preset: Config.ClientHooks.TextInput Config.ClientHooks.InputDialog Config.ClientHooks.Confirm Config.ClientHooks.ProgressBar Config.ClientHooks.ShowTextUI Config.ClientHooks.HideTextUI

With dNotif, the confirmation only shows the text: the title is not passed.

Bridge.ProgressBar, ShowTextUI and HideTextUI always use ox_lib unless hooked.

Weather

Hooks that replace this preset: Config.ClientHooks.SetLocalRain Config.ClientHooks.SetLocalFreeze Config.ServerHooks.SetWeather Config.ServerHooks.SetTime Config.ServerHooks.FreezeTime Config.ServerHooks.SetBlackout Config.ServerHooks.GetBlackout Config.ServerHooks.GenerateWeathers Config.ServerHooks.GetTime Config.ServerHooks.GetZoneInfo

The weather menu is only visible client side when av_weather is resolved and started, or when a SetLocalRain or SetLocalFreeze client hook exists. Server hooks alone do not make it appear.

With av_weather, the zones and values sent are those of Config.Weather. Check that they exist in your av_weather configuration (santos, sandy, paleto, cayo and the CLEAR, RAIN… types by default).

Vehicle keys

Hooks that replace this preset: Config.ClientHooks.GiveVehicleKeys

Billing

Hooks that replace this preset: Config.ClientHooks.SendBill

Invoicing is not an engine server action: its validation relies on the receiving billing script.

The option is hidden for jobs in Config.Billing.excludedJobs and for a player without a job. The amount is rounded down to an integer.

Repair

Hooks that replace this preset: Config.ClientHooks.RepairVehicle

Appearance

Hooks that replace this preset: Config.ClientHooks.RestoreAppearance

“Take appearance” (dev_clone_ped) does not use this selector: it applies the ped model directly with SetPlayerModel.

Example: moving an integration to a hook

Your keys script is not qs-vehiclekeys. Set Config.KeysScript = 'custom', then in config_client.lua:

Config.ClientHooks.GiveVehicleKeys = function(vehicle, plate, model)
    TriggerEvent('my_keys:give', plate)
end

my_keys:give is an example name. The hook also makes the “give keys” option available: without it, with 'custom', the option stays hidden.

Common mistakes

• NotifyScript = 'custom' without a Notify hook: no notification at all.
• WeatherScript = 'custom' with server hooks only: the weather menu stays invisible client side. Also add SetLocalRain or SetLocalFreeze in config_client.lua (behaviour observed in bridge/client.lua).
• MedicalScript = 'auto' without a medical script: fallback to native; revive works but without your script’s logic (hospital bills, states…).
• RepairScript = 'jg-mechanic' without the resource: the event goes nowhere and the player still sees repair_done.