Vehicle Radio

In-car stereo system for Unturned. Install a radio on any vehicle and control music from the driver seat.

Custom UI with track carousel, volume panel, and hotkey controls — great for roleplay servers and car culture.

Features

Radio installation — mount a configured boombox barricade on a vehicle with /placeradio (permission required).
Driver controls — change tracks and volume while sitting in the driver seat.
Custom UI effect — track list with cover images, volume slider, and “Now playing” chat message.
Hotkey support — use CodeHotkeys.
Track playlist — fully configurable song list with GUID, name, and cover image.
Auto sync — /vehicleradio sync scans loaded StereoSongAsset tracks and writes them to config.
Optional owner confirmation — if enabled in config, the installer sends an offer and the vehicle owner confirms with /placeradio confirm.
Optional price & reward — charge experience on install and grant a reward to the installer (configurable, off by default).
One radio per vehicle — optional limit so each car keeps a single stereo.
Smart mute — auto fade/mute when the driver exits or disconnects (fully configurable delays).
Admin tools — reload config, list tracks, mute all radios, test disconnect behavior.
Live config reload — edit config.yaml and apply with /vehicleradio reload.
All songs, messages, permissions, timings, and install rules are editable via config.yaml.

Driver controls

While driving a vehicle with an installed radio:

Action	Keys
Previous track	CodeHotkey2
Next track	CodeHotkey3
Volume down	CodeHotkey4
Volume up	CodeHotkey5

Commands

Command	Permission	Description
`/placeradio`	`placeradio`	Install a radio (requires permission; optional owner confirm in config)
`/placeradio confirm`	`placeradio`	Accept a pending installation offer (vehicle owner)
`/vehicleradio` / `/vradio`	—	Show admin command help
`/vehicleradio reload`	`vehicleradio.reload`	Reload `config.yaml` from disk
`/vehicleradio tracks`	`vehicleradio.tracks`	Print configured songs
`/vehicleradio sync`	`vehicleradio.sync`	Sync songs from loaded stereo assets into config
`/vehicleradio disableall`	`vehicleradio.disableall`	Mute every configured radio on the map
`/vehicleradio testdisconnect`	`vehicleradio.testdisconnect`	Test disconnect fade/mute on your radios

Permissions

Permission	Purpose
`placeradio`	Install radios (and confirm, if owner confirmation is enabled)
`vehicleradio.reload`	Reload config
`vehicleradio.tracks`	List tracks in chat/console
`vehicleradio.sync`	Sync track list from game assets
`vehicleradio.disableall`	Mute all radios
`vehicleradio.testdisconnect`	Test disconnect mute behavior

Configuration

Main section: VehicleRadio: in config.yaml.

VehicleRadio:
  EffectId: 19054
  RadioBarricadeId: 13568
  MaxVolume: 100
  PlacedRadioInitialVolume: 35
  TrackChangeCooldown: 0.5
  HidingSoundsListTime: 5
  AutoMuteOnVehicleExit: true
  ExitVehicleAutoMuteDelay: 60
  Installation:
    RequirePermission: true
    AllowOnlyOneRadioPerVehicle: true
    Price: 0
    MechanicReward: 0
    RequireOwnerConfirmation: false
  Songs:
    - Id: "d89bee43-c77e-48db-8c81-0abe841cb26d"
      Name: "Song1"
      Image: "https://example.com/cover.png"

After editing the file on the server, run /vehicleradio reload.