Ultimate Speaker , DJ System - Docs

J0 Speaker System - Setup Guide

ox_inventory

Add items to Ox Inventory config

In your ox_inventory items config (for example ox_inventory/data/items.lua), add these items:

lua

   ['speaker_controller'] = {
       label = 'Speaker Controller',
       weight = 500,
       stack = false,
       close = true,
       description = 'Control unit for managing stage speakers.',
   },

   ['prop_speaker_car_01'] = {
       label = 'Car Speaker',
       weight = 2000,
       stack = false,
       close = true,
       description = 'A powerful car-mounted speaker.',
   },

   ['prop_speaker_stand_01'] = {
       label = 'Speaker Stand',
       weight = 1500,
       stack = false,
       close = true,
       description = 'A mounted speaker on a stand.',
   },

   ['prop_speaker_tall_01'] = {
       label = 'Tall Speaker 01',
       weight = 2500,
       stack = false,
       close = true,
       description = 'A tall professional stage speaker.',
   },

   ['prop_speaker_tall_03'] = {
       label = 'Tall Speaker 03',
       weight = 2500,
       stack = false,
       close = true,
       description = 'A high-powered tall speaker for events.',
   },

   ['prop_stage_01'] = {
       label = 'Stage Platform 01',
       weight = 5000,
       stack = false,
       close = true,
       description = 'A modular stage platform.',
   },

   ['prop_stage_02'] = {
       label = 'Stage Platform 02',
       weight = 5000,
       stack = false,
       close = true,
       description = 'An extended modular stage platform.',
   },

   ['sf_prop_sf_dj_desk_01a'] = {
       label = 'DJ Desk',
       weight = 3500,
       stack = false,
       close = true,
       description = 'A professional DJ performance desk.',
   },

Install item icons (Ox Inventory)
- Go to J0-Speaker/readme/images in this resource.
- Copy all PNG files from there into your ox_inventory/web/images folder.
- Restart ox_inventory (or the server) so it reloads the images.

qb-inventory

Add items to QB-Inventory config

In your qb-inventory items file (for example qb-inventory/shared/items.lua), add these items:

lua

   -- Speaker Controller
   ['speaker_controller'] = {
       ['name'] = 'speaker_controller',
       ['label'] = 'Speaker Controller',
       ['weight'] = 500,
       ['type'] = 'item',
       ['image'] = 'speaker_controller.png',
       ['unique'] = false,
       ['useable'] = true,
       ['shouldClose'] = true,
       ['combinable'] = nil,
       ['description'] = 'Control unit for managing stage speakers.'
   },

   -- Car Speaker
   ['prop_speaker_car_01'] = {
       ['name'] = 'prop_speaker_car_01',
       ['label'] = 'Car Speaker',
       ['weight'] = 2000,
       ['type'] = 'item',
       ['image'] = 'prop_speaker_car_01.png',
       ['unique'] = false,
       ['useable'] = true,
       ['shouldClose'] = true,
       ['combinable'] = nil,
       ['description'] = 'A powerful car-mounted speaker.'
   },

   -- Speaker Stand
   ['prop_speaker_stand_01'] = {
       ['name'] = 'prop_speaker_stand_01',
       ['label'] = 'Speaker Stand',
       ['weight'] = 1500,
       ['type'] = 'item',
       ['image'] = 'prop_speaker_stand_01.png',
       ['unique'] = false,
       ['useable'] = true,
       ['shouldClose'] = true,
       ['combinable'] = nil,
       ['description'] = 'A mounted speaker on a stand.'
   },

   -- Tall Speaker 01
   ['prop_speaker_tall_01'] = {
       ['name'] = 'prop_speaker_tall_01',
       ['label'] = 'Tall Speaker 01',
       ['weight'] = 2500,
       ['type'] = 'item',
       ['image'] = 'prop_speaker_tall_01.png',
       ['unique'] = false,
       ['useable'] = true,
       ['shouldClose'] = true,
       ['combinable'] = nil,
       ['description'] = 'A tall professional stage speaker.'
   },

   -- Tall Speaker 03
   ['prop_speaker_tall_03'] = {
       ['name'] = 'prop_speaker_tall_03',
       ['label'] = 'Tall Speaker 03',
       ['weight'] = 2500,
       ['type'] = 'item',
       ['image'] = 'prop_speaker_tall_03.png',
       ['unique'] = false,
       ['useable'] = true,
       ['shouldClose'] = true,
       ['combinable'] = nil,
       ['description'] = 'A high-powered tall speaker for events.'
   },

   -- Stage 01
   ['prop_stage_01'] = {
       ['name'] = 'prop_stage_01',
       ['label'] = 'Stage Platform 01',
       ['weight'] = 5000,
       ['type'] = 'item',
       ['image'] = 'prop_stage_01.png',
       ['unique'] = false,
       ['useable'] = true,
       ['shouldClose'] = true,
       ['combinable'] = nil,
       ['description'] = 'A modular stage platform.'
   },

   -- Stage 02
   ['prop_stage_02'] = {
       ['name'] = 'prop_stage_02',
       ['label'] = 'Stage Platform 02',
       ['weight'] = 5000,
       ['type'] = 'item',
       ['image'] = 'prop_stage_02.png',
       ['unique'] = false,
       ['useable'] = true,
       ['shouldClose'] = true,
       ['combinable'] = nil,
       ['description'] = 'An extended modular stage platform.'
   },

   -- DJ Desk
   ['sf_prop_sf_dj_desk_01a'] = {
       ['name'] = 'sf_prop_sf_dj_desk_01a',
       ['label'] = 'DJ Desk',
       ['weight'] = 3500,
       ['type'] = 'item',
       ['image'] = 'sf_prop_sf_dj_desk_01a.png',
       ['unique'] = false,
       ['useable'] = true,
       ['shouldClose'] = true,
       ['combinable'] = nil,
       ['description'] = 'A professional DJ performance desk.'
   },

Install item icons (QB-Inventory)
- Go to J0-Speaker/readme/images in this resource.
- Copy all PNG files from there into your qb-inventory/html/images folder.
- Restart qb-inventory (or the server) so it reloads the images.

You are now ready to use the J0 Speaker System items in your inventory.

Dependencies (3 scripts required)

This script needs the following 3 dependencies. Download and install them before using J0 Speaker:

cr-3dnui
- https://github.com/cody-raves/cr-3dnui/tree/main
ox_lib
- https://github.com/communityox/ox_lib/releases
xSound
- https://github.com/Xogy/xsound/releases

Make sure all three are in your server resources and started before J0 Speaker.

server.cfg

Add these lines to your server.cfg. Start dependencies first, then J0 Speaker:

cfg

ensure ox_lib
ensure xsound
ensure cr-3dnui
ensure J0-Speaker

['speaker_controller'] = { label = 'Speaker Controller', weight = 500, stack = false, close = true, description = 'Control unit for managing stage speakers.', }, ['prop_speaker_car_01'] = { label = 'Car Speaker', weight = 2000, stack = false, close = true, description = 'A powerful car-mounted speaker.', }, ['prop_speaker_stand_01'] = { label = 'Speaker Stand', weight = 1500, stack = false, close = true, description = 'A mounted speaker on a stand.', }, ['prop_speaker_tall_01'] = { label = 'Tall Speaker 01', weight = 2500, stack = false, close = true, description = 'A tall professional stage speaker.', }, ['prop_speaker_tall_03'] = { label = 'Tall Speaker 03', weight = 2500, stack = false, close = true, description = 'A high-powered tall speaker for events.', }, ['prop_stage_01'] = { label = 'Stage Platform 01', weight = 5000, stack = false, close = true, description = 'A modular stage platform.', }, ['prop_stage_02'] = { label = 'Stage Platform 02', weight = 5000, stack = false, close = true, description = 'An extended modular stage platform.', }, ['sf_prop_sf_dj_desk_01a'] = { label = 'DJ Desk', weight = 3500, stack = false, close = true, description = 'A professional DJ performance desk.', },

-- Speaker Controller ['speaker_controller'] = { ['name'] = 'speaker_controller', ['label'] = 'Speaker Controller', ['weight'] = 500, ['type'] = 'item', ['image'] = 'speaker_controller.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Control unit for managing stage speakers.' }, -- Car Speaker ['prop_speaker_car_01'] = { ['name'] = 'prop_speaker_car_01', ['label'] = 'Car Speaker', ['weight'] = 2000, ['type'] = 'item', ['image'] = 'prop_speaker_car_01.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'A powerful car-mounted speaker.' }, -- Speaker Stand ['prop_speaker_stand_01'] = { ['name'] = 'prop_speaker_stand_01', ['label'] = 'Speaker Stand', ['weight'] = 1500, ['type'] = 'item', ['image'] = 'prop_speaker_stand_01.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'A mounted speaker on a stand.' }, -- Tall Speaker 01 ['prop_speaker_tall_01'] = { ['name'] = 'prop_speaker_tall_01', ['label'] = 'Tall Speaker 01', ['weight'] = 2500, ['type'] = 'item', ['image'] = 'prop_speaker_tall_01.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'A tall professional stage speaker.' }, -- Tall Speaker 03 ['prop_speaker_tall_03'] = { ['name'] = 'prop_speaker_tall_03', ['label'] = 'Tall Speaker 03', ['weight'] = 2500, ['type'] = 'item', ['image'] = 'prop_speaker_tall_03.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'A high-powered tall speaker for events.' }, -- Stage 01 ['prop_stage_01'] = { ['name'] = 'prop_stage_01', ['label'] = 'Stage Platform 01', ['weight'] = 5000, ['type'] = 'item', ['image'] = 'prop_stage_01.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'A modular stage platform.' }, -- Stage 02 ['prop_stage_02'] = { ['name'] = 'prop_stage_02', ['label'] = 'Stage Platform 02', ['weight'] = 5000, ['type'] = 'item', ['image'] = 'prop_stage_02.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'An extended modular stage platform.' }, -- DJ Desk ['sf_prop_sf_dj_desk_01a'] = { ['name'] = 'sf_prop_sf_dj_desk_01a', ['label'] = 'DJ Desk', ['weight'] = 3500, ['type'] = 'item', ['image'] = 'sf_prop_sf_dj_desk_01a.png', ['unique'] = false, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'A professional DJ performance desk.' },