Settings

BMT ControlPaneel V3 has two layers of settings: server-wide defaults defined in the config file, and per-player preferences that individual players can change through the in-game settings panel.

---

Server-Wide Settings

These settings are defined in shared/config.lua under Config.Settings and apply as defaults for all players on the server.

Config.Settings = {
    switchWithHornKey = true,
    switchAmbulanceWithoutHorn = true,
    defaultLanguage = "NL",
    stopSirenOutsideVeh = false,
    toggleButtonSoundEnabled = true,
    toggleIndicatorSoundEnabled = true,
    toggleButtonSoundSrc = "button",
    beaconAnimationEnabled = true
}

Setting Reference

Setting	Type	Default	Description
switchWithHornKey	boolean	true	When enabled, a quick tap of the horn key cycles the siren tone (instead of playing the horn). A longer press plays the horn. Does not apply to fire department (bw*) siren types.
switchAmbulanceWithoutHorn	boolean	true	When enabled, ambulance, MUG, ASIMEX, and motorcycle siren types always play the horn on horn key press (no quick-tap tone switching).
defaultLanguage	string	"NL"	Default UI language.
stopSirenOutsideVeh	boolean	false	When enabled, the siren automatically stops when the driver exits the vehicle.
toggleButtonSoundEnabled	boolean	true	Play a click sound when toggling buttons in the control panel.
toggleIndicatorSoundEnabled	boolean	true	Play a sound when toggling indicators.
toggleButtonSoundSrc	string	"button"	The sound file used for button clicks.
beaconAnimationEnabled	boolean	true	Play the hand animation when toggling the beacon (pitje).

---

Per-Player Settings

Several settings can be overridden by individual players through the in-game settings panel (opened with /cp-settings). These preferences are stored locally on the player's machine using FiveM's KVP (Key-Value Pair) system and persist across sessions.

Player-Adjustable Settings

Setting	Description	Stored As
Button sound	Enable/disable the click sound for control panel buttons	button_sound KVP
Button sound source	Choose which click sound to use	button_sound_src KVP
Indicator sound	Enable/disable the indicator toggle sound	indicator_sound KVP
Stop siren outside vehicle	Enable/disable auto-stop siren when exiting	stopSirenOutsideVeh KVP
UI theme	Select a visual theme for the control panel	ui_theme KVP

Per-player settings override the server defaults. If the server has toggleButtonSoundEnabled = true but a player disables it in their settings, the sound won't play for that player.

---

How Settings Flow

Server Config (config.lua)
    ↓ defaults
Player joins → loads KVP overrides
    ↓
Final effective settings for that player

1

The server starts with the values in Config.Settings

These are the defaults that apply to all players unless overridden locally.

2

On player join, the script checks for locally stored KVP values

When a player joins and initializes the UI, the script looks for any stored KVP overrides on that client.

3

KVP values override server defaults for that player

If a KVP value exists, it takes precedence over the server default for that specific player.

4

If no KVP exists, server defaults apply

For first-time players or those who never changed settings, the server-provided defaults are used.

---

Resetting Player Settings

Players can reset their settings by:

• Changing them back manually in the settings panel

• Deleting their FiveM client cache/KVP storage (nuclear option)

Server administrators cannot remotely reset individual player settings since they are stored client-side.

---