Home › Documentation › Configuration · origen_importheist

Configuration · origen_importheist

All configuration files are located in the config/ folder and are open (not escrowed).

config/_framework.lua

General script behaviour and framework settings.

Framework & language

Variable	Type	Default	Description
`Config.Framework`	`string`	`'auto'`	Framework to use. Accepted values: `'auto'`, `'qbcore'`, `'esx'`
`Config.Language`	`string`	`'en'`	UI language. Available: `'en'`, `'es'`, `'fr'`, `'it'`
`Config.Debug`	`boolean`	`true`	Prints debug messages to the server console. Set to `false` in production
`Config.CheckVersions`	`boolean`	`true`	Checks for new script versions on startup

Reward system

Variable	Type	Default	Description
`Config.Reward.useItem`	`boolean`	`false`	If `true`, gives an item instead of money
`Config.Reward.item`	`string`	`'cash'`	Item name to give when `useItem` is `true`
`Config.Reward.account`	`string`	`'money'`	Money account to use when `useItem` is `false`

Heist behaviour

Variable	Type	Default	Description
`Config.MinCops`	`integer`	`0`	Minimum number of on-duty police officers required to start the heist
`Config.Cooldown`	`integer`	`20`	Minutes a player must wait before starting the heist again
`Config.DamageDivisor`	`integer`	`53`	Money deducted from the reward for every 1% of vehicle damage
`Config.TimeDivisor`	`table`	`{10, 13}`	Every `[1]` seconds, `[2]` dollars are deducted from the reward
`Config.DefaultBucket`	`integer`	`0`	Routing bucket used for players and vehicles during the heist. Do not change unless you know what you are doing

lua

Config.TimeDivisor = {10, 13}
-- Every 10 seconds → subtract $13 from the reward

Police & GPS

Variable	Type	Default	Description
`Config.NotifyCopsOnEntry`	`boolean`	`true`	Sends a police alert when a player enters the warehouse
`Config.GPSCooldown`	`integer`	`10`	Seconds between GPS position updates sent to police
`Config.GPSDuration`	`integer`	`5`	Minutes the GPS blip remains active on police screens

Interaction & animations

Variable	Type	Default	Description
`Config.Interaction`	`boolean`	`true`	If `false`, disables the built-in interaction zone. Use your own trigger: `TriggerEvent('origen_importheist:StartRob')` (client-side)

lua

Config.Animations = {
    ['search'] = {
        dict    = 'mini@repair',
        anim    = 'fixing_a_ped',
        canMove = true,
        time    = 5000,      -- ms
    },
    ['checking'] = {
        dict    = 'mini@repair',
        anim    = 'fixing_a_ped',
        canMove = false,
        time    = false,     -- loops indefinitely until stopped
    },
}

config/locations.lua

Defines the warehouse interiors, vehicle spawn points, locker positions, and delivery points.

Config.Interiors

Four pre-configured interiors are included. Each interior contains:

Key	Type	Description
`Interior`	`vector4`	Entry/teleport position inside the warehouse
`Vehicles`	`vector4[]`	Spawn positions for the import vehicles inside the warehouse
`Lockers`	`vector4[]`	Positions of the loot lockers inside the warehouse

Config.WareHouses

The warehouses that appear on the map as interaction points. Each entry contains:

Key	Type	Description
`Coords`	`vector4`	World position of the warehouse entrance
`Name`	`string`	Display name shown to the player
`Deliver`	`string`	Delivery zone group. Must match a key in `Config.DeliverPoints` (`'LS'` or `'BC'`)
`Interior`	`integer`	Index referencing a `Config.Interiors` entry

Default warehouses:

Name	Zone
Brakes Services	BC
Flints Autos	BC
Mosley Autos	BC
No one's repairs	BC
Jhonan Services	LS
Auto Repairs	LS
Xeros Station	LS

Config.DeliverPoints

Groups of delivery coordinates used once the heist is complete. Keyed by zone name ('LS' or 'BC').

lua

Config.DeliverPoints = {
    ["LS"] = { vector4(...), vector4(...), ... },
    ["BC"] = { vector4(...), vector4(...), ... },
}

The Deliver field in each warehouse entry must match exactly one of the keys defined in Config.DeliverPoints.

config/models.lua

List of vehicle models that can spawn during the heist, each with an associated base reward price.

lua

Config.Models = {
    { Model = "coquette4",  Price = 2950 },
    { Model = "autarch",    Price = 2770 },
    { Model = "tigon",      Price = 2770 },
    -- ...
}

Key	Type	Description
`Model`	`string`	GTA V vehicle model name (spawn name)
`Price`	`integer`	Base reward in dollars before damage/time deductions

config/npc.lua

Defines the contact NPC that players interact with to start the heist.

lua

Config.NPCS = {
    {
        model  = 's_m_m_highsec_01',
        name   = 'Dom',
        coords = vector4(1013.8998, 138.8919, 84.9908, 262.2115),
    },
}

Key	Type	Description
`model`	`string`	Ped model name
`name`	`string`	Name displayed above the NPC
`coords`	`vector4`	World position (x, y, z, heading)

config/logs/logs.lua

Server-side Discord webhook configuration for activity logs.

Variable	Type	Default	Description
`ServerConfig.UseIdentifiers`	`boolean`	`true`	Appends player identifiers (source, name, license, steam, etc.) to each log entry
`ServerConfig.Logs.StartRobbery`	`string`	`'YOUR_DISCORD_WEBHOOK'`	Webhook URL for the robbery start log. Leave as-is to disable

lua

ServerConfig.Logs = {
    StartRobbery = 'https://discord.com/api/webhooks/...',
}

The webhook URL is validated at runtime. If the value does not contain discord.com/api/webhooks, the log will be silently skipped.