Custom Premium Target HUD

A clean, next-generation, high-performance branching-line eye targeting system designed for FiveM roleplay servers.

This resource replaces standard target list menus with a futuristic, light-purple glassmorphic HUD that dynamically arranges options in a holographic circular arc around the center targeting eye.

---

Features

• Cyberpunk Aesthetics: Sleek semi-transparent dark purple buttons with glowing neon borders and smooth scale/slide hover transitions.
• Futuristic Orbital Arc: Connector lines and option tabs dynamically fan out in a symmetrical circular orbit around the target reticle, keeping the lower screen and HUD area completely clear.
• Highly Optimized: Fast camera-raycast calculations running on GLM vectors.
• QBCore Integrated: Native support for player jobs, grades, gangs, item requirements, and citizen ID checks.
• Standalone Mode: Ability to run without QBCore for generic scripting setups.

---

Configuration

Settings can be edited inside init.lua. Key configurations include:

• Config.MaxDistance: Maximum range players can target.
• Config.OpenKey: Keyboard mapping to trigger targeting (default is Left Alt: LMENU).
• Config.UIColors: Table of dynamic CSS colors passed to the HTML interface to modify the theme.

---

Client API (Exports)

Use the following exports in your other resources to attach interaction options to entities or zones:

Add options to a specific entity

exports['qb-target']:AddTargetEntity(entity, {
    options = {
        {
            icon = 'fas fa-door-open',
            label = 'Interrogate',
            event = 'my-script:client:interrogate',
            type = 'client',
        }
    },
    distance = 2.0
})

Add options to specific model hashes

exports['qb-target']:AddTargetModel(`prop_dumpster_01a`, {
    options = {
        {
            icon = 'fas fa-trash',
            label = 'Search Dumpster',
            event = 'my-script:client:searchDumpster',
            type = 'client',
        }
    },
    distance = 1.5
})

Add a Box Zone target

exports['qb-target']:AddBoxZone("pd_doors", vector3(442.12, -981.45, 30.68), 1.5, 1.5, {
    name = "pd_doors",
    heading = 90.0,
    debugPoly = false,
    minZ = 29.68,
    maxZ = 31.68
}, {
    options = {
        {
            icon = 'fas fa-key',
            label = 'Unlock Doors',
            event = 'police:client:unlockDoors',
            type = 'client',
            job = 'police' -- job restriction
        }
    },
    distance = 2.0
})