Configuration

All settings live in config.lua, which stays open and editable after escrow. Change a value, save, restart the resource.

Opening the UI

Option	Default	Description
Config.OpenCommand	'autoplay'	Chat command that opens the UI (/autoplay).
Config.OpenKey	'F5'	Default keybind. Each player can rebind it in the FiveM key bindings menu.

Control

Option	Default	Description
Config.ControlScope	'driver'	'driver' lets only the driver (seat -1) control playback. 'occupants' lets anyone seated in the vehicle control it.

Audibility and proximity (metres)

Option	Default	Description
Config.MaxDistance	25.0	Beyond this, outside listeners hear nothing.
Config.MinDistance	2.0	Within this, volume is at full.
Config.InsideBoost	1.0	Volume multiplier when you are inside the car (1.0 is full).
Config.NearField	3.5	Metres over which volume eases from full to muffled as you step out, so exiting never lurches.

Cabin muffle (volume part)

Option	Default	Description
Config.MuffleClosed	0.65	Outside listener volume for a sealed cabin.
Config.MuffleOpen	0.90	Outside listener volume when a door is open, roof is down, or a window is out.
Config.DoorOpenRatio	0.10	Door angle ratio above which a door counts as open.

3D spatial audio (HRTF)

Option	Default	Description
Config.Spatial3D	true	HRTF left / right / front / back positioning. false is legacy mono.
Config.Muffle3D	true	Real low pass filter on top of the volume muffle above.
Config.MuffleCutoffOpen	22000	Low pass cutoff in Hz when open or inside (effectively no filtering).
Config.MuffleCutoffClosed	520	Low pass cutoff in Hz when sealed and distant (bassy, muffled). Lower is more muffled.

Tone, bass, and EQ are a per player in game equalizer (Settings, then Equalizer), not a config value. The default preset "Car System" gives the bass forward feel.

Voice ducking

Option	Default	Description
Config.VoiceDuck	true	Master enable.
Config.VoiceDuckRadius	6.0	A talker within this many metres dips your music.
Config.VoiceDuckAmount	0.15	Music volume while ducked (0.15 is 15 percent, 0.0 is full mute).
Config.VoiceDuckHold	300	Milliseconds to stay ducked after talking stops (prevents pumping).

Sync and performance

Option	Default	Description
Config.RenderInterval	100	Milliseconds between attenuation and position recalcs (10 per second).
Config.ScanRadius	60.0	Only vehicles within this radius are considered for audio.
Config.MaxConcurrent	6	Maximum simultaneous car streams rendered on one client.
Config.ActionCooldown	750	Minimum milliseconds between control actions per player (anti spam, server enforced).

Sources and security

Option	Default	Description
Config.AllowYouTube	true	Allow YouTube links (via the official IFrame API).
Config.AllowFreeUrl	true	Allow players to type their own URL (subject to the checks below).
Config.AllowDirectStreams	false	Allow raw stream URLs (mp3, ogg, and so on). Off means YouTube only.
Config.RequireHttps	true	Require https:// for direct streams.
Config.AllowedExtensions	mp3, ogg, ...	Permitted file types for direct streams.
Config.AllowedHosts	{} (any)	Whitelist of hosts for direct streams.
Config.MaxUrlLength	512	Maximum accepted URL length.

If you enable AllowDirectStreams, lock AllowedHosts down to CDNs you trust. That blocks NSFW and SSRF abuse from players pasting arbitrary URLs.

Playlists and limits

Option	Default	Description
Config.MaxPlaylists	30	Playlists per player.
Config.MaxTracksPerPlaylist	100	Tracks per playlist.
Config.PlaylistNameMaxLen	40	Maximum playlist name length.

Misc

Option	Default	Description
Config.AutoResume	false	true auto plays the last track when the UI opens in a quiet car. false shows a Resume option (no surprise audio).
Config.UseOxLibNotify	true	Use ox_lib notifications if present, else chat.
Config.Website	your URL	Shown in the UI About section.
Config.VersionCheck	false	Optional console update notice. Tebex and Cfx already notify owners, so it is off by default.
Config.VersionUrl	your URL	Where the checker fetches { "version": "x" } if enabled.