Boombox
A portable and in-vehicle speaker with 3D synced music from YouTube, a direct audio URL or a preset — and no xsound required.
- Version
- 1.0.3
- Resource
- SF-Boombox
Overview#
Its own audio engine
Runs without xsound. If xsound is already installed, it is picked up and used automatically.
Three sources
A YouTube link, a direct audio URL, or one of the stations you preconfigured in the menu.
3D and synced
Everyone within range hears the same thing at the same moment, positioned in the world.
Vehicle speaker
A second speaker lives in cars, opened with /carmusic from inside or nearby.
Streamer mode
/stream mutes the music for that player only. Everyone else keeps hearing it.
Control policy
Either everyone can control the speaker, or only whoever put it down — your call.
Volume ceiling
A maximum volume nobody can exceed, which is what stops the speaker becoming a troll tool.
Five languages
French, English, Spanish, German and Italian, in files that stay editable after escrow.
Dependencies#
| Resource | Required | What for |
|---|---|---|
ox_lib | Required | Interface and shared helpers |
xsound | Optional | Used automatically if present — never required |
ox_target | Optional | Otherwise a marker and the E key |
Installation#
- Drop
SF-Boomboxinto yourresourcesfolder. - Declare the
boomboxitem — seeITEMS.md. - Add the line below to your
server.cfg, after ox_lib and your framework. - Authorise your streamers — see the streamer mode section of the README.
ensure ox_lib ensure SF-Boombox
Configuration#
| Setting | Default | What it does |
|---|---|---|
Config.MaxDistance | 30.0 | Listening range, in metres |
Config.MaxVolume | — | Highest volume a player may set |
Config.ControlMode | 'everyone' | 'everyone' or 'owner' — who may control the speaker |
Config.ControlDistance | — | How close you must stand to control it |
Config.Presets | — | The stations offered in the menu |
Config.Vehicle | — | Enable the vehicle speaker, and whether you must be inside |
Config.Audio.preferXSound | false | Force the built-in engine even when xsound is installed |
Commands#
| Command | What it does |
|---|---|
/boombox | Put the speaker down, or pick it back up |
/boomboxmenu | Open the menu without targeting |
/carmusic | The vehicle speaker |
/stream | Streamer mode — mutes the music for you alone |
/stopallmusic | (admin) Stop every speaker on the server |
/sf_boombox_myid | Show your own licence, to paste into the config |