Skip to content

F.A.Q

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


Song cannot be longer than 10 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 10 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 15 and 17 minutes.

Is it replaceable?

No, it can’t be changed; this limit has been hard-coded on the back end. Extending this time limit would result in additional costs.

You can support me by purchasing Coffe, which will allow me to make some improvements to the time limit. Buy Me A Coffe


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.
  • lua
    { coords = vector3(x, y, z), radius = 10.0 }
    

{% hint style="info" %} 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. {% endhint %}


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.
lua
["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.
lua
["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.

I can't use the Boombox Item#

By default, the script is integrated with popular inventory systems. You must integrate your new or custom inventory systems. Supported popular inventory systems:

  • Ox Inventory
  • QB Inventory (ps too)
  • QS Inventory

At this point, if you are using a different inventory, you will need to integrate your script into the

wais-speaker/bridge/editable/server.lua\ Config_Sv.lua

{% hint style="warning" %} If you do not integrate them, you will continue to be unable to use the boombox items. {% endhint %}

{% hint style="success" %} If you do not integrate it, the Speaker script will work correctly in vehicles and other applications, except for the boombox. {% endhint %}


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:

IMPORTANT: Once the car's plate number has been correctly set in the entity, trigger this. At this point, you can use a wait statement or a while loop to wait for the plate number to be set. Then trigger this event or export.

lua
-- 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)
Disable Uninstall Carplay
  • To do this, go to the wais-speaker/config.lua file.
  • Go to the Config.Carplay table, then change the [“remove_key”] = ‘H’, “H” key from string to false.

The final appearance should be as follows:

lua
["remove_key"] = false,
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.


A lot of things aren’t working properly / Distance Etc.#

  • If you're using AntiCheat scripts like Waveshield or Fiveguard, you need to register the wais scripts.
  • You'll usually encounter errors such as: “Distance Check,” “You're Not in the Car,” or “You're Not in the Area.”

{% hint style="info" %} There are no more available yet, please open a ticket if the topics here are not suitable for what you are looking for. {% endhint %}


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.

{% hint style="success" %} You can visit our Discord address to ask questions in your mind / To get support {% endhint %}