Configuration · origen_boosting

All configuration files are located in the config/ folder and are open source (escrow-ignored).

General

Variable	Type	Default	Description
`Config.Debug`	`boolean`	`false`	Enables debug prints in the console
`Config.Language`	`string`	`"en"`	Language of the script. Must match a file in `locales/`
`Config.ContractOfferExpiration`	`number`	`5`	Minutes before a contract offer expires
`Config.MissionDuration`	`number \| false`	`false`	Time in minutes before a mission is considered failed. Set to `false` to disable the timeout
`Config.CustomNotify`	`boolean`	`false`	If `true`, notifications will be routed through `Custom.Notify` in `custom/client/notify.lua`
`Config.origenParking`	`boolean`	`false`	Enable this if you are using `origen_parking` integration

Police

Variable	Type	Default	Description
`Config.PoliceJobName`	`table`	`{ 'police' }`	List of job names considered as police

lua

Config.PoliceJobName = {
    'police',
    'sheriff',
}

Weapons

List of weapons that will be available when creating or editing a contract.

lua

Config.Weapons = {
    'weapon_bat',
    'weapon_pistol',
}

Currency

Variable	Type	Default	Description
`Config.Currency.AllowTransference`	`boolean`	`false`	Allows or disallows transferring the configured currency from within the NUI
`Config.Currency.Account`	`string`	`'bank'`	Account name used for contract purchases

lua

Config.Currency = {
    AllowTransference = false,
    Account = 'bank',
}

Reward

Variable	Type	Default	Description
`Config.Reward.type`	`string`	`'account'`	Reward type: `'account'` to pay to a money account, or `'item'` to give an inventory item
`Config.Reward.name`	`string`	`'bank'`	Account name or item name depending on the reward type

lua

Config.Reward = {
    type = 'account',
    name = 'bank',
}

Admin groups

Groups that are allowed to create and edit contracts from in-game.

lua

Config.AdminGroups = {
    'admin',
    'god',
}

Items

Variable	Default	Description
`Config.Items.OpenBoostingCad`	`'boosting_cad'`	Item name required to open the boosting CAD
`Config.Items.HackLocator`	`'locator_remover'`	Item name required to hack the vehicle locator system

Hacking

Variable	Type	Default	Description
`Config.Hack.Restriction`	`boolean`	`true`	If `true`, players must be moving to hack the locator
`Config.Hack.MinimumSpeed`	`number`	`20`	Minimum vehicle speed required to hack the locator
`Config.Hack.SpeedMultiplier`	`number`	`3.6`	Use `3.6` for km/h or `2.236936` for mph

lua

Config.Hack = {
    Restriction = true,
    MinimumSpeed = 20,
    SpeedMultiplier = 3.6,
}

Plate pattern

Pattern used when generating random license plates for boosted vehicles.

Symbol	Description
`X`	Random letter or number
`L`	Random letter
`N`	Random number
`-`	Blank space

lua

Config.PlatePattern = 'XXXXXXXX' -- Max 8 characters

Blips

Configure the map blips shown during missions.

lua

Config.Blips = {
    Tracker = {
        Sprite = 161,
        Color = 1,
        Scale = 1.0,
    },
    Delivery = {
        Sprite = 225,
        Color = 2,
        Scale = 0.8,
    },
    Vin = {
        Sprite = 402,
        Color = 5,
        Scale = 0.8,
    },
    VehZone = {
        Alpha = 80,
        Color = 1,
        Scale = 0.8,
    },
}

Zones (`config/contracts.lua`)

Variable	Type	Default	Description
`Config.QueueWaitTime`	`number`	`3`	Minutes between each automatic contract offer sent to the player

Configure the world coordinates for each zone type.

lua

Config.Zones = {
    ['spawn'] = {
        vector4(-63.14, 6502.09, 30.88, 134.52)
    },
    ['delivery'] = {
        vector3(951.80, 3615.43, 32.20)
    },
    ['vin'] = {
        { coords = vector4(110.64, 6630.75, 31.8, 200.7) },
    }
}

Zone	Description
`spawn`	Where the target vehicle spawns for the player to steal
`delivery`	Where the player must deliver the stolen vehicle
`vin`	Where the VIN scratch interaction takes place

Guards (`config/contracts.lua`)

Configure the NPC guards that protect the vehicle.

lua

Config.Guards = {
    model = {
        'u_m_y_party_01',
        'g_m_y_mexgang_01',
        'g_m_y_mexgoon_02',
    },
    difficulties = {
        [0] = { accuracy = 10, armor = 0,   health = 100 }, -- Easy
        [1] = { accuracy = 10, armor = 50,  health = 200 }, -- Normal
        [2] = { accuracy = 10, armor = 100, health = 300 }, -- Hard
    }
}

Field	Description
`model`	List of NPC ped models. One is chosen randomly per guard
`difficulties[n].accuracy`	Guard aim accuracy (0–100)
`difficulties[n].armor`	Guard armor value
`difficulties[n].health`	Guard health value

Custom Core (`config/custom_core.lua`)

Use this file to provide a custom framework object when none of the supported frameworks are detected.

Variable	Type	Default	Description
`useCustomCore`	`boolean`	`false`	Set to `true` to use the custom core object
`GetCustomCoreObject`	`function`	`nil`	Return your custom framework core object here

lua

return {
    useCustomCore = true,
 
    GetCustomCoreObject = function()
        return exports['my_custom_core']:GetCore()
    end,
}

Custom Events (`config/custom_events.lua`)

Override the default framework events with custom event names. Set any field to false to keep the default behavior.

Field	Description
`load`	Event triggered when a player is fully loaded
`unload`	Event triggered when a player disconnects or unloads
`jobUpdate`	Event triggered when a player's job changes
`dutyUpdate`	Event triggered when a player's duty state changes

lua

return {
    load = 'my_framework:player:loaded',
    unload = 'my_framework:player:logout',
    jobUpdate = false, -- keep default
    dutyUpdate = false, -- keep default
}