Configuration

Everything is configured in config.lua. No other file needs to be touched.

Global settings

Key	Description
Config.Framework	'auto' detects ESX or QBCore. Force with 'esx' or 'qb' if auto-detection fails.
Config.Locale	Active language: 'en' or 'es'. Add more files in locales/ for other languages.
Config.PayAccount	Account the reward is paid into: 'money' (cash), 'bank' or 'black_money' (falls back to cash on QBCore).
Config.Cooldown	Seconds to wait between contracts after payout.
Config.InteractDistance	Metres from the contractor NPC required to interact.
Config.InteractKey	GTA key code (default 38 = E).
Config.PromptKey	Letter shown in the floating prompt badge (keep in sync with InteractKey).
Config.CleanupDelay	Seconds before the target and guard bodies are removed from the world.
Config.RequirePlayerKill	true — only completes if the player delivers the killing blow.
Config.KillFallbackRange	Metres. If the game cannot resolve the killer entity (returns 0), accept the kill when the player is within this range.

Contractor NPC (Config.Contractor)

Config.Contractor = {
    model  = 's_m_m_highsec_01',
    coords = vector4(105.6, -1305.6, 28.75, 300.0),
    scenario = 'WORLD_HUMAN_SMOKING',
    blip = {
        enable = true,
        sprite = 491,   -- contract icon
        color  = 1,     -- red
        scale  = 0.9
    },
    promptDistance = 12.0
}

Contract types (Config.Contracts)

Each entry in the table is a contract type shown on the NUI board.

Config.Contracts = {
    {
        id          = 'normal',
        label       = { en = 'Standard contract', es = 'Encargo estandar' },
        description  = { en = '...', es = '...' },
        danger      = 1,        -- 1..3 stars in the UI
        rewardMin   = 2500,
        rewardMax   = 5000,
        guards      = 0
    },
    {
        id          = 'dangerous',
        danger      = 3,
        rewardMin   = 6000,
        rewardMax   = 12000,
        guards      = 3,
        guardHealth   = 200,
        guardAccuracy = 45      -- 0..100
    }
}

Add as many types as you like. The NUI board renders them all.

Models and locations

Config.TargetModels    = { 'a_m_m_business_01', ... }   -- target ped model pool
Config.TargetLocations = { vector4(...), ... }            -- spawn point pool (Z auto-snapped)
Config.GuardModels     = { 'g_m_y_lost_01', ... }        -- guard ped model pool
Config.GuardWeapons    = { 'WEAPON_PISTOL', ... }         -- guard weapon pool