❓F.A.Q

How do I do it? What is it and what does it do?

---

Song cannot be longer than 5 minutes

This limit was set when the script was created. This duration cannot be increased or decreased on the server.

Why?

• A dedicated server runs in the background for songs played through the speaker.

• Songs longer than 5 minutes increase the Disk Space they occupy while increasing the Network Bandwidth.

If the script is generally well-liked and highly preferred, I will begin working to set this duration between 6 and 10 minutes.

---

How to Open Menu

Boombox Menu

• Place a boombox and look at the boombox with the [TARGET] button. Click the Open menu option.

Vehicle Speaker

You can open the compact menu in the vehicle using the “G” key.

---

Interaction Distances

Whats This?

• These distances are selectable by users.

• Even if a user renders a vehicle or speaker, they will not be able to hear the sound unless they approach within the selected distance.

• When it enters within the selected distance, the sound will play at 0.0 volume. The level will increase as it approaches.

What can I do?

• The distances you will set are specified in the config. wais-speaker/config.lua

• The distances you set for vehicles and boomboxes are the maximum distances at which this sound can be heard.

• When I render a boombox, I start to hear the sound if it is within the maximum distance I set. This distance can also be adjusted in the menu.

• The sound can rise and fall depending on the distance.

---

Blacklist Vehicles

From here, you can disable the speaker menu for the vehicle class or specific models of your choice. So that the song menu will no longer open and songs will not play in those vehicles.

Add Class

• To do this, go to the wais-speaker/config.lua file.

• Go to the [“class”] table and enter the tool class for which you do not want the speaker menu to work.

Add Specific Model

• To do this, go to the wais-speaker/config.lua file.

• You can disable the speaker menu on that vehicle by entering a specific model in the [“models”] table.

---

Blacklist Zones

You can add blacklist coordinates so that people cannot place speakers there. If someone dies in that area, the speaker is returned to the inventory. Songs cannot be played in vehicles within that area.

How can i add?

• To do this, go to the wais-speaker/config.lua file.

• Find the Config.BlacklistedCoords table, then add a location as shown in the example. Locations must be vec3. radius is the width of this area.

• { coords = vector3(x, y, z), radius = 10.0 }

If you have a speaker in your hand or enter the area with a song playing in your car, the song will not stop. Because why should it stop? I think that much force is unnecessary.

---

Boomboxes

From here, you can add or remove boombox models, learn how to place them, put them back, or do similar things.

Add New Boombox Item

• To do this, go to the wais-speaker/config.lua file.

• To do this, go to the Config.BoomBoxes table, then add an item as shown in the example.

What are variables?

• boombox_item_name: It is the name of the new boombox item in your inventory.

• model: This is the prop model for the new boombox. You can usually get it from Plebmaster.

• attach: If this prop is portable, add the attach table. If you do not want it to be portable, delete the attach table, including the storage.

["boombox_item_name"] = {
    ["model"] = "prop_model_name",
    ["attach"] = {
        ["bone"] =  0, -- Bone index to attach to
        ["offsets"] = vector3(0.0, 0.0, 0.0), -- Offsets from the bone (x, y, z)
        ["rotation"] = vector3(0.0, 0.0, 0.0), -- Rotation offsets (x, y, z)
        ["animation"] = {
            ["dict"] = "dict_name",
            ["clip"] = "clip_name",
            ["flag"] = 49,
        }
    },
},

Disable Selectable Place

• To do this, go to the wais-speaker/config.lua file.

• Go to the Config.Actions table and find the variable [“select_speaker_location”] = true. Change the value from true to false.

• Thus, when the boombox item is used, it will be placed directly in front of the character.

["select_speaker_location"] = false, -- Enable/Disable boombox placement feature

Change Detach Speaker Key

• To do this, go to the wais-speaker/config.lua file.

• Go to the Config.Actions table and find the [“detach”] table.

• Find the table containing [“key”] = ‘X’. Replace the “X” key with the key you want.

Remove When Player Dropped

• To do this, go to the wais-speaker/config.lua file.

• Find the variable Config.DeleteBoomboxWhenOwnerQuit = false and change the value from false to true.

If you set it to true, boomboxes placed by a user will be automatically deleted when they leave the server.

If you set it to false, boomboxes will remain even if the player who placed them leaves.

---

Vehicle / Car Play

Here you can learn about settings related to your vehicle and CarPlay.

Disable Carplay

• To do this, go to the wais-speaker/config.lua file.

• Find the variable [“enabled”] = true in the Config.Carplay table and change the true value to false.

This will completely shut down CarPlay. It will not be usable in the vehicle.

Can't Hear/Select Radio Stations

The wais-speaker script stops GTA5 radios and stations by default. Fixing this is very easy.

• To do this, go to the wais-speaker/config.lua file.

• Find the variable Config.DisableGTARadio = true and change the value true to false.

A server restart is required to fix this.

Stop music when player left the vehicle

• To do this, go to the wais-speaker/config.lua file.

• Find the variable Config.StopMusicWhenVehicleIsEmpty = false and change its value from false to true.

If you set it to true, the music will stop when there are no players in the vehicle.

If you set it to false, the music will continue to play even if there are no players in the vehicle.

Change Menu Key

• To do this, go to the wais-speaker/config.lua file.

• Find the variable [“open”] = ‘G’ in the Config.Carplay table and replace the “G” key with any key you want.

Install Carplay Option

Caution if you are going to use this system You need to make some changes to your garage script for this system. If you can't do it or your script doesn't allow it (those parts are rescrow), please don't use it.

• To do this, go to the wais-speaker/config.lua file.

• Find the variable [“use”] = false. Change the value false to true.

Thus, you can install CarPlay on your car using the “car_play” value or the item you specified, such as [‘item’] = “car_play”

• Trigger the following events/exports on the server or client side of your garage script when a new vehicle is spawned:

-- vehicleNetId: You can get the network ID of the vehicle
-- Server side Event
TriggerServerEvent('wais:speaker:server:CheckCarPlay', vehicleNetId)

-- Server side export
exports["wais-speaker"]:CheckCarPlay(vehicleNetId)

Open Carplay TriggerEvent

• The event has been registered on the client side.

• wais:speaker:client:openMenu

Keep Input / Control vehicle when menu is up

• To do this, go to the wais-speaker/config.lua file.

• Find the variable [“keep_input”] = false in the Config.Carplay table and change the value from false to true.

If it is true, you can continue driving when CarPlay is activated. You will not be able to control the vehicle when you click on Input.

If it is false, vehicle controls will not return until the menu closes when CarPlay is activated.

---

There are no more available yet, please open a ticket if the topics here are not suitable for what you are looking for.

---

Who developed it / How can I get help

You can recognise our script developers by the short names of the script. Scripts with short name ‘Wais’ are made by Ayazwai.

You can visit our Discord address to ask questions in your mind / To get support