isControlEnabled | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

isControlEnabled

Client-side
Server-side
Shared

Manual Review Required

Please finish this page using the corresponding Old Wiki article. Go to Contribution guidelines for more information.

Checks whether a GTA control is enabled or disabled for a certain player.

Syntax 

bool isControlEnabled ( string control )
Required Arguments
  • control: The control you wish to check. See control names for a list of possible controls.

Returns

  • bool: value

Returns true if control is enabled, false otherwise.

Code Examples

server

This example uses a command handler to allow a player to toggle whether he can use vehicle weapons by disabling or enabling the primary and secondary vehicle fire keys. The command handler is trigged with 'toggleweapons'

function changeWeaponControls ( player, commandName )
  --Check to see if the player can use primary/secondary vehicle fire controls
        primaryWeaponControl = isControlEnabled ( player, "vehicle_fire" )
        secondaryWeaponControl = isControlEnabled ( player, "vehicle_secondary_fire" )
  --Toggle the use of the primary vehicle fire control ability.
        if ( primaryWeaponControl == true ) then
             toggleControl ( player, "vehicle_fire", false )
           outputChatBox ( "Disabled your ability to use primary vehicle weapons." )
        else
             toggleControl ( player, "vehicle_fire", true )
           outputChatBox ( "Enabled your ability to use primary vehicle weapons." )
        end
        --Toggle the use of the secondar vehicle fire control ability.
        if ( secondaryWeaponControl == true ) then
             toggleControl ( player, "vehicle_secondary_fire", false )
           outputChatBox ( "Disabled your ability to use secondary vehicle weapons." )
        else
             toggleControl ( player, "vehicle_secondary_fire", true )
           outputChatBox ( "Enabled your ability to use secondary vehicle weapons." )
        end
end
addCommandHandler ( "toggleweapons", changeWeaponControls )

See Also

Input Functions
Input Events
Reference