Configuration · origen_radio

All configuration lives in config/main.lua. The file is split into two tables: Config (general settings) and RadioConfig (radio behaviour and animations).

General settings

Key	Type	Default	Description
`Config.Framework`	`string`	auto-detected	Active framework. Auto-detected from running resources: `"qbcore"`, `"esx"`, or `"none"`
`Config.Inventory`	`string`	`"origen_inventory"`	Inventory resource to use for item checks. See Dependencies for valid values
`Config.PermissionsGroups`	`table`	`{ "mod" }`	List of job/group names that have full admin permissions over the radio system
`Config.Debug`	`boolean`	`true`	Enables debug print output in the server console
`Config.Language`	`string`	`"es"`	UI language. Accepted values: `"en"`, `"es"`, or any custom locale key added to `locales.lua`
`Config.MetadataSystem`	`boolean`	`false`	Enable the custom metadata system (`origen_metadata` table). If `false`, metadata is read from the framework player object
`Config.CustomReviveEvent`	`string`	`""`	Client event name to listen to for player revive. When triggered, the radio is automatically re-enabled. Leave empty to disable
`Config.BindSystem`	`boolean`	`false`	Enable the keybind system that allows players to bind custom keys to radio actions
`Config.KeepInputOnNUI`	`boolean`	`false`	If `true`, the player can move while the radio NUI is open
`Config.HideWeaponOnTalk`	`boolean`	`true`	If `true`, the player's weapon is hidden while transmitting on the radio
`Config.NeedRadioItem`	`boolean`	`true`	If `true`, the player must have a radio item in their inventory to open the radio interface
`Config.RadioItems`	`table`	`{ "radio" }`	List of item names that open the radio interface when used

RadioConfig

Default keybinds

Key	Default	Description
`RadioConfig.DefaultKey`	`"LMENU"`	Key held to transmit on the active frequency
`RadioConfig.DefaultBroadcastKey`	`"COMMA"`	Key held to broadcast across all frequencies simultaneously
`RadioConfig.DefaultOpenRadioKey`	`"Z"`	Key to open and close the radio NUI

Animations

RadioConfig.Anims is a list of animation presets the player can choose for the talking animation. Each entry can define a dictionary + clip only (no prop), or include a prop attachment.

lua

RadioConfig.Anims = {
    -- Simple animation, no prop
    { Dict = "random@arrests", Anim = "generic_radio_chatter" },
 
    -- Animation with hand-held prop
    {
        Dict = "cellphone@str",
        Anim = "cellphone_call_listen_a",
        Prop = "prop_cs_hand_radio",
        PropBone = 57005,
        PropPlacement = { 0.12, 0.02, -0.02, 20.0, 70.0, 130.0 },
    },
 
    -- Alternative animation with prop
    {
        Dict = "anim@male@holding_radio",
        Anim = "holding_radio_clip",
        Prop = "prop_cs_hand_radio",
        PropBone = 28422,
        PropPlacement = { 0.0750, 0.0230, -0.0230, -90.0000, 0.0, -59.9999 },
    },
}

Field	Type	Description
`Dict`	`string`	Animation dictionary
`Anim`	`string`	Animation clip name
`Prop`	`string`	(Optional) Prop model to attach during the animation
`PropBone`	`number`	(Optional) Bone index to attach the prop to
`PropPlacement`	`table`	(Optional) Prop offset and rotation: `{ x, y, z, rx, ry, rz }`

Players can switch between animation presets in-game. Their choice is persisted via the metadata system.