From Multi Theft Auto: Wiki
Jump to navigation Jump to search

This function allows you to disable world sounds. A world sound is a sound effect which has not been caused by playSound or playSound3D.

[[{{{image}}}|link=|]] Note:
  • The values for group and index can be determined by using the client command showsound in conjunction with setDevelopmentMode
  • This function does not affect sounds which are already playing, such as the wind sound that can only be stopped by entering an interior.
  • See also: setAmbientSoundEnabled


bool setWorldSoundEnabled ( int group, [ int index = -1, ] bool enable [, bool immediate = false ] )

Required Arguments

Optional Arguments

  • index: An integer representing an individual sound within the group
  • immediate: A boolean if set to true will cancel the sound if it's already playing. This parameter only works for stopping the sound.


Returns true if the world sound was correctly enabled/disabled, false if invalid values were passed.


This is a simplified example that lets the client toggle their weapon sounds.

function toggleWeaponSounds_f ( )
    local enabled = isWorldSoundEnabled ( 5 ) -- We place this variable here for checking.
    enabled       = not enabled -- And here we invert (toggle) the variable, so if it's false, it becomes true, if it's true, it becomes false.
    -- Used for the chat declaration:
    local state   = "enabled"

    if ( not enabled ) then
        state = "disabled"

    setWorldSoundEnabled ( 5, enabled ) -- And here the toggling happens.
    outputChatBox ( "Weapon sounds " .. state )
addCommandHandler ( "toggleweaponsounds", toggleWeaponSounds_f )

This is the more advanced version of the

function toggleWeaponSounds_f ( )
    local enabled = not isWorldSoundEnabled (5)
    setWorldSoundEnabled ( 5, enabled ) -- And here the toggling happens.
    outputChatBox ( "Weapon sounds " .. (enabled and "enabled" or "disabled"))
addCommandHandler ( "toggleweaponsounds", toggleWeaponSounds_f )

This example disables the wind sound effect immediately without changing the interior afterwards.

setWorldSoundEnabled(0, 0, false, true)
setWorldSoundEnabled(0, 29, false, true)
setWorldSoundEnabled(0, 30, false, true)


Minimum supported server version n/a
Minimum supported client version 1.3.0-9.04134

Note: Using this function/event requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.3.0-9.04134" />


Version Description
1.5.5-9.11860 Added immediate argument

See Also

* FEATURE ADDED IN 1.5.9 (BETA: 1.5.8 r20675):