Installation

1. Move script folder to your server resources

2. Rename the folder to 'evo_sound_player'

3. Add ensure evo_sound_player to your server.cfg file

4. Open config.lua in the script folder and change Config.resourceName to your evo_sound resource name, wich can be evo_sound or xsound

5. (optional) move boombox.png from script folder to your inventory images folder

6. (Qbox/ox_inventory) Add item to /data/items.lua:

   ['boombox'] = {
           label = 'Boombox',
           weight = 1,
           description = 'Boombox'
   },

Initial config

Script comes ready to be used but there are a few config values you should check:

1. Config.locale: should be set to your server language. If the locale file for your server language does not exist just go to /locales folder, duplicate en-US.json file, rename it to whatever your locale is (eg. fr-FR.json), translate the file itself (just translate the values, not the keys) and change Config.locale to whatever you renamed it before (without the .json extension)

2. Config.audioStreams: this contains the radio availables on the UI, modify it to your needs, just make sure every new item you add contains at least title and url, thumbnail is optional

3. Config.radio.modelOverrides: all the vehicles inside this list will override default distance and baseVolume, you can add here as many vehicles as you want, by defualt we added pbus2, to add a new vehicle just duplicate that line and change the values to whatever you want

4. Config.boombox.itemData: update it to whatever you want.

5. Config.zones.list: this list contains the music zones, we've added a zone by default so you can use it to add your zones easily. All fields except requiredJob and requiredGrade are neccesary, also make sure you dont add duplicated id values

6. Config.zones.command & Config.boombox.command: change this to whatever you want for the zone and boombox command, boombox command can be disabled by setting its value to nil

You should be ready to go after that, if you want to learn more about other config values, read Config