Installing the Resource
Download the latest release
Permissions
To give players access to the menu, you’ll need to give them the following ace permission:
command.enginesound
Example to give all players regardless of roles, access to the menu:
add_ace builtin.everyone command.enginesound allow
If you want to give permissions a different way, such as linked to your framework, a script or something else - you can edit the permissions function inside of server_config
HasPermission = function(src)
-- your permission function here - you can integrate your framework for jobs/perms etc
return IsPlayerAceAllowed(src, 'command.enginesound')
end
Configuration & Adding Custom Sounds
You’ll now need to edit client_config
- here you can change the keybind, menu positioning and more!
We also have a feature called StoreSoundsByModel
which will automatically save what engine sound you last used on a specific model (spawncode) and re-apply that sound when you re-enter that vehicle.
Additionally, you can add your own notification script here, by default we use ox_lib.
At the bottom, you will see the list of engine sounds players can choose from:
EngineSounds = {
-- Engine Sound Name/Label --> Hash of engine audio (what you'd normally put in vehicles.meta)
["Baller"] = "baller",
["Adder"] = "adder",
["Lazer"] = "lazer",
}
The left hand side is the label (display name) - this is what users see.
The right side is our engine sound hash or key.
Engine sound hashes on custom vehicles already in your server can be found inside its vehicles.meta
file under audioNameHash
Example Installation of Custom Engine Sound
Here’s an example engine sound mod from Aquaphobic on GTA5Mods
Once downloaded and installed, you can see in his mod description, he says to add aqm275amg
to the vehicles.meta
under audioNameHash
.
You will now edit the config above to look like this:
EngineSounds = {
-- Engine Sound Name/Label --> Hash of engine audio (what you'd normally put in vehicles.meta)
["Baller"] = "baller",
["Adder"] = "adder",
["Lazer"] = "lazer",
["Toyota Chaser 1JZ-GTE I6T"] = "aqm275amg",
}
Start the Resource
start ox_lib
start chroma-enginesoundmenu
Make sure that ox_lib is started before our resource.