99 online 3 members  + Join RP Base  +
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
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 `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
Preview
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
Installation
  1. Download the latest release.
  2. Extract it into your resources directory as fa_target.
  3. Add the resource to your server.cfg after ox_lib:

ensure ox_lib
ensure fa_target
  1. Remove your previous target resource.
  2. Restart the server.

IMPORTANT
Do not run FA Target alongside another resource providing ox_target, qb-target, or qtarget.

Theme Creator
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 allow

Server themes:

  • Persist between restarts using resource KVP
  • Update connected players live
  • Define which fields players may override locally
Configuration
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 label
badge, string, Small badge displayed alongside the option
key, string, Key used to trigger the option
hold, number, Required hold duration in milliseconds
mode, string, Overrides the interaction mode for the option
category, string, Identifier matching a color in Theme.categoryColors
unavailable, 'show' / 'hide', Overrides how unavailable actions are displayed
disabled, boolean, Explicitly marks an action unavailable
getState, function, Returns status, optional reason and remainingMs
Unavailable 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

…