ToggleAllControls
From Multi Theft Auto: Wiki
Enables or disables the use of all GTA controls for a specified player.
Syntax
Click to collapse [-]
Serverbool toggleAllControls ( player thePlayer, bool enabled, [ bool gtaControls = true, bool mtaControls = true ] )
Required Arguments
- thePlayer: The player you wish to toggle the control ability of.
- enabled: A boolean value representing whether or not the controls will be usable.
Optional Arguments
NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.
- gtaControls: A boolean deciding whether the enabled parameter will affect GTA's internal controls.
- mtaControls: A boolean deciding whether the enabled parameter will affect MTA's own controls., e.g. chatbox.
Click to collapse [-]
Clientbool toggleAllControls ( bool enabled, [ bool gtaControls = true, bool mtaControls = true ] )
Required Arguments
- enabled: A boolean value representing whether or not the controls will be usable.
Optional Arguments
NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.
- gtaControls: A boolean deciding whether the enabled parameter will affect GTA's internal controls.
- mtaControls: A boolean deciding whether the enabled parameter will affect MTA's own controls., e.g. chatbox.
Returns
This function returns true if controls were toggled successfully, false otherwise.
Example
Click to collapse [-]
ServerThis function will disable the use of all controls in order to freeze a player, which will be used every time someone enters a vehicle.
function freezeThisDude ( thePlayer, freezeTime )
toggleAllControls ( thePlayer, false ) -- disable this player's controls
setTimer ( toggleAllControls, freezeTime, 1, thePlayer, true ) -- enable this player's controls after the specified time
end
function freezeOnEnterVehicle ( theVehicle, seat, jacked )
freezeThisDude ( source, 5000 ) -- 'freeze' him for 5000ms = 5 seconds
end
addEventHandler ( "onPlayerVehicleEnter", getRootElement(), freezeOnEnterVehicle )
