config.lua

A configuration file to set up the script for your needs.

General Settings

• Locale: "EN" – Language of the radio system.

• Framework: "ESX" / "QB" / "CUSTOM" – Framework used on the server.

• VoiceSystem: "PMA" / "Salty" / "CUSTOM" – Voice system used.

• customServerKey: "cs_76238472873467272438hdsiuduzsdfb359835987" – Unique server key (set once during installation).

• enableJoinFunctionality: true / false – Allows players to join frequencies using the menu.

Frequency Input Settings

• maxBeforeDecimal: Maximum digits before the decimal point. Example: 3 (allows 999)

• maxAfterDecimal: Maximum digits after the decimal point. Example: 2 (allows 999.99)

Command Settings

• commandName: Command to open the radio menu. Example: "radio"

• commandKey: Default keybind to open the radio menu. Example: "F9"

• neededItem: Required item to use the radio. Example: "radio" or false to deactivate

Webhook Settings

• SendWebhook.Join: true / false – Logs when a player joins a frequency

• SendWebhook.Leave: true / false – Logs when a player leaves a frequency

• SendWebhook.RenameChannel: true / false – Logs when a channel is renamed

• SendWebhook.RenameSelf: true / false – Logs when a player renames themselves

Other Settings

• UseRPNames: true / false – Use character names instead of FiveM names

• HideRadioListDefault: true / false – Hide the radio list by default

• LetPlayersSetTheirOwnNameInRadio: true / false – Allow players to change their own display name

• LetPlayersChangeRadioChannelsName: true / false – Allow players to rename radio channels

• ShowPlayerServerId: true / false – Display the player’s server ID

• PlayerServerIdPos: "left" / "right" – Position of server ID

• LetPlayersOverrideRadioChannelsWithName: true / false – Override channel names with custom names

• RadioChannelsWithName: Define custom names for frequency ranges.

Example:

{
  range = { min = 1.0, max = 1.99 },
  name = "Police"
}

LockedChannels: Restrict specific frequencies to certain jobs.

Example:

{
range = { min = 1.0, max = 1.99 },
allowedJobs = { "police" }
}

---

Notifications & Locales

Notification(title, msg, type) → Uses cs_hud to display notifications

NotifyTypes: "info", "error", "success", "warning"

Locale Support

English (EN) messages included for:

• UI labels (menu, list, volume)

• Notifications (join/leave, errors, volume change)

• Webhook messages (join/leave, rename channel/self)