Configuration Reference

Every setting in oxide-radio, what it does, and its default value.

How Configuration Is Stored

This is the most important thing to understand about configuring oxide-radio.

• Before the first start, the resource reads its settings from shared/config.lua.
• On the first start, it copies every setting from that file into a database table called oxide_settings.
• From then on, the database is the source of truth. Editing shared/config.lua after the first start changes nothing — the value already lives in the database and wins.

So there are two ways to work:

1. First-time setup: edit shared/config.lua before you first start the resource. Your values get imported automatically.
2. Changing a setting later: run /radio settings in game as an admin. The menu edits the database-backed settings live — no file editing, no restart. See Admin → The Settings Menu.

A few settings are config-only — they live in shared/config.lua and are not editable from the menu because they're animation and prop data, not the kind of thing you tune day to day. Those are marked below and appear as read-only "config-only" tiles in the settings menu so you know they exist.

Config File: shared/config.lua

All settings live in one file: shared/config.lua.

General

Config.Enabled = true
Config.Debug = false

Radio Item

Config.Item = 'radio'
Config.RequireItem = true

Frequencies

These set the range of open civilian frequencies. Restricted job channels are not limited by this range — they can sit on any frequency.

Config.MinFrequency = 1
Config.MaxFrequency = 9999

Timing

Config.TalkingDelay = 50
Config.RevalidateInterval = 30000

Overlay

Settings for the on-screen roster overlay (the small list of who's on your channel).

Config.ShowRoster = true
Config.OverlayKey = 'U'

Config.JobChannels

The restricted channels reserved for specific jobs. This is a table mapping a frequency number to a channel definition.

Each definition has these fields:

The defaults ship with police and EMS channels:

Config.JobChannels = {
    [1] = {
        label = 'Police Dispatch',
        jobs = { 'police', 'lspd', 'bcso', 'sasp', 'sheriff', 'statetrooper', 'LSPD', 'BCSO', 'SASP' },
        minRank = 0,
        dutyOnly = false,
        default = true,
    },
    [2] = {
        label = 'Police Tac 1',
        jobs = { 'police', 'lspd', 'bcso', 'sasp', 'sheriff', 'statetrooper', 'LSPD', 'BCSO', 'SASP' },
        minRank = 0,
        dutyOnly = false,
        default = false,
    },
    [3] = {
        label = 'Police Command',
        jobs = { 'police', 'lspd', 'bcso', 'sasp', 'sheriff', 'statetrooper', 'LSPD', 'BCSO', 'SASP' },
        minRank = 3,       -- only grade 3 and up
        dutyOnly = false,
        default = false,
    },
    [4] = {
        label = 'EMS Dispatch',
        jobs = { 'ambulance', 'ems', 'EMS' },
        minRank = 0,
        dutyOnly = false,
        default = true,
    },
    [5] = {
        label = 'EMS Tac',
        jobs = { 'ambulance', 'ems', 'EMS' },
        minRank = 0,
        dutyOnly = false,
        default = false,
    },
}

Notes and tips:

• Match your job names exactly. The jobs list is case-sensitive. If a channel isn't working for a job, the job name spelling or capitalization is almost always the cause. The defaults include several common spellings so they work on more servers out of the box — trim each list down to the names your server actually uses.
• Any frequency is allowed. A restricted channel can use any whole frequency, even one outside your MinFrequency–MaxFrequency range. The open range only limits free civilian tuning.
• Editing in-game. After the first start, edit these live from /radio settings under Channels — a grid where you add and remove frequencies and set each one's label, jobs, min rank, duty flag, and clock-on default.

Config.AutoJoinDefault

Config.AutoJoinDefault = true

When a player clocks on, they are tuned automatically to the lowest-numbered channel their job qualifies for that is marked default = true. A player who is already on a channel is never moved, so anyone who tuned somewhere else keeps their channel. Set this to false to make everyone dial in by hand.

• Running oxide-police / oxide-ems? Those resources register their own channels at runtime, which take priority over anything here on the same frequency. Configure their channels in those resources, not here. See Features → Job resource integration.

Config.Animation (config-only)

The animation and handheld prop played while a player is transmitting on the radio. This is config-only — it is not in the settings menu, because it's animation data rather than a day-to-day setting. To change it, edit shared/config.lua before the first start (or edit the file and delete the resource's oxide_settings rows to re-import).

Config.Animation = {
    animDict = 'random@arrests',
    animClip = 'generic_radio_chatter',
    flag = 50,
    prop = {
        model = 'prop_cs_hand_radio',
        bone = 6286,
        offset = vec3(0.08, 0.03, -0.01),
        rotation = vec3(-59.99, 15.54, -52.55),
    },
}

Config.HoldAnimation (config-only)

The held pose and prop shown while the radio panel is open (a phone-style pose). Also config-only, for the same reason as above.

Config.HoldAnimation = {
    enabled = true,
    model = 'prop_amb_phone',
    bone = 28422,
    offset = vec3(0.0, -0.005, 0.0),
    rotation = vec3(0.0, 0.0, 180.0),
}

Next Steps

• Admin Guide — the settings menu and admin commands
• Features — how these settings play out in game
• Troubleshooting — fixes for common problems