FreeScriptQBoxQBCoreESX
fa_target
by FA-Scripts · version 1.1 · updated 3 days ago
No reviews yet
- Downloads
- 0
- Reviews
- 0
- Size
- 3.7 MB
- Code check
- Clean
- Licence
- MIT
- Released
- Nov 2026
Modern, free & open-source interaction system for FiveM with Focus, Classic & DUI modes, Theme Creator and ox_target compatibility.
FA Target
Modern interaction system for FiveM with Focus, Cursor and World modes.
Documentation •
Download •
Discord •
Showcase [SOON]
**FA Target is a modern, free and open-source interaction system for FiveM, built on the proven `
Maintain compatibility with existing resources while adding modern interaction modes, world-anchored UI, per-option keybinds, hold interactions, action feedback, and a fully customizable Theme Creator.
Designed as a drop-in replacement for `
Features
Focus • Classic • DUI
Compatibility
Feature, ox_target, qb-target, qtarget
Zones, ✅, ✅, ✅
Entities, ✅, ✅, ✅
Models, ✅, ✅, ✅
Bones, ✅, ✅, ✅
Global options, ✅, ✅, ✅
Jobs, ✅, ✅, ✅
Gangs, —, ✅, ✅
Items, ✅, ✅, ✅
Client events, ✅, ✅, ✅
Server events, ✅, ✅, ✅
Callbacks / actions, ✅, ✅, ✅
Existing resources using
Requirements
FA Target includes an in-game Theme Creator for customizing the interaction UI without manually editing CSS.
Player preferences
Use
Server theme editor
Administrators with the following ACE permission can use
Server themes:
Explicit bridge values take precedence over auto-detection.
DUI mode uses the regular NUI renderer anchored to the raycast world coordinate, avoiding a separate browser instance for every target.
Local fonts
Montserrat Variable is bundled locally for runtime interactions. The Theme Creator uses its own local Inter font, independent of the selected target font. To add a custom target font, copy its
Only local
APIox_target compatibility
FA Target extensions
FA extensions are accepted on every option:
Property, Type, Description
Unavailable actions
Unavailable actions are hidden by default. Set
…
Modern interaction system for FiveM with Focus, Cursor and World modes.
Documentation •
Download •
Discord •
Showcase [SOON]
**FA Target is a modern, free and open-source interaction system for FiveM, built on the proven `
ox_target` engine.**Maintain compatibility with existing resources while adding modern interaction modes, world-anchored UI, per-option keybinds, hold interactions, action feedback, and a fully customizable Theme Creator.
Designed as a drop-in replacement for `
ox_target, with compatibility adapters for qb-target and qtarget`.Features
- 3 interaction modes - Focus, Cursor and World (configuration IDs:
focus,classic,dui) - Theme Creator - customize the interaction UI directly in-game
- Option keybinds - trigger interactions using configurable keys
- Hold interactions - require an option to be held for a configured duration
- Descriptions & badges - provide additional context without cluttering labels
- Action feedback - pending, success and error states for asynchronous interactions
- World-anchored UI - DUI mode follows the target position in the world
- Drop-in ox_target compatibility - existing
exports.ox_target:*calls continue to work - qb-target & qtarget adapters - supports common legacy registration formats
- Controller support
- Zones, entities, models, bones and global targets
- Runtime theme updates - server themes update connected players without a restart
- ACE-controlled theme administration
Focus • Classic • DUI
Compatibility
Feature, ox_target, qb-target, qtarget
Zones, ✅, ✅, ✅
Entities, ✅, ✅, ✅
Models, ✅, ✅, ✅
Bones, ✅, ✅, ✅
Global options, ✅, ✅, ✅
Jobs, ✅, ✅, ✅
Gangs, —, ✅, ✅
Items, ✅, ✅, ✅
Client events, ✅, ✅, ✅
Server events, ✅, ✅, ✅
Callbacks / actions, ✅, ✅, ✅
Existing resources using
exports.ox_target:* do not need to be rewritten.Requirements
ox_lib>= 3.30.0- OneSync recommended
- Download the latest release.
- Extract it into your
resourcesdirectory asfa_target. - Add the resource to your
server.cfgafterox_lib:
ensure ox_lib
ensure fa_target
- Remove your previous target resource.
- Restart the server.
IMPORTANTTheme Creator
Do not run FA Target alongside another resource providingox_target,qb-target, orqtarget.
FA Target includes an in-game Theme Creator for customizing the interaction UI without manually editing CSS.
Player preferences
Use
/fatheme to open personal appearance settings when enabled by the server.Server theme editor
Administrators with the following ACE permission can use
/fathemeadmin:
add_ace group.admin fa_target.theme allowServer themes:
- Persist between restarts using resource KVP
- Update connected players live
- Define which fields players may override locally
config.lua controls framework and inventory detection, interaction modes, keybinds, blocking states, visual indicators, and player theme permissions.Explicit bridge values take precedence over auto-detection.
DUI mode uses the regular NUI renderer anchored to the raycast world coordinate, avoiding a separate browser instance for every target.
Local fonts
Montserrat Variable is bundled locally for runtime interactions. The Theme Creator uses its own local Inter font, independent of the selected target font. To add a custom target font, copy its
.woff2 file to web/public/fonts, add one entry to Config.Theme.fonts, and rebuild the UI:
{
id = 'customer_font', label = 'Customer Font', family = 'Customer Font',
file = 'CustomerFont.woff2', weight = '100 900'
}Only local
.woff2 filenames are accepted.APIox_target compatibility
fa_target registers ox_target's exports. Together with provide 'ox_target', this keeps exports.ox_target:* calls.
exports.ox_target:addBoxZone({
coords = vec3(441.2, -981.9, 30.7), size = vec3(2, 2, 2),
options = {{ name = 'armoury', label = 'Open armoury', event = 'police:armoury' }}
})FA Target extensions
FA extensions are accepted on every option:
exports.fa_target:addLocalEntity(ped, {{
name = 'dealer_talk', label = 'Talk to dealer',
description = 'Browse available vehicles', icon = 'fa-solid fa-car',
badge = 'NEW', key = 'E', hold = 1200, mode = 'focus',
onSelect = function(data)
return { status = 'success', message = 'Opening catalogue' }
end
}})Property, Type, Description
description, string, Secondary text displayed below the option labelbadge, string, Small badge displayed alongside the optionkey, string, Key used to trigger the optionhold, number, Required hold duration in millisecondsmode, string, Overrides the interaction mode for the optioncategory, string, Identifier matching a color in Theme.categoryColorsunavailable, 'show' / 'hide', Overrides how unavailable actions are displayeddisabled, boolean, Explicitly marks an action unavailablegetState, function, Returns status, optional reason and remainingMsUnavailable actions
Unavailable actions are hidden by default. Set
Config.Interaction.unavailable = 'show' to display them with a reason, or use unavailable = 'show' on an individual option. Distance, object/bone/menu matching and vehicle filters still hide irrelevant options. A falsy canInteract result always hides the option, even when unavailable actions are shown, and is checked before group, item and disabled states. Failed canInteract/getState callbacks also hide their option and produce a throttled diagnostic.getState(entity, distance, coords, name, bone) must be a fast, synchronous client callback. Return one of available, disabled, cooldown, missingItem, noPermission. Cooldowns belong to the integrating resource; FA Target only displays their state. Group/item checks…