ToggleAllControls: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(12 intermediate revisions by 8 users not shown)
Line 4: Line 4:


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">bool toggleAllControls ( player thePlayer, bool enabled, [bool gtaContols=true, bool mtaControls=true] ) </syntaxhighlight>  
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">bool toggleAllControls ( player thePlayer, bool enabled, [ bool gtaControls = true, bool mtaControls = true ] ) </syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
*'''thePlayer:''' The player you wish to toggle the control ability of.
*'''thePlayer:''' The player you wish to toggle the control ability of.
*'''enable:''' A boolean value representing whether or not the controls will be usable or not.
*'''enabled:''' A boolean value representing whether or not the controls will be usable.
 
===Optional Arguments===
{{OptionalArg}}
*'''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.
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">bool toggleAllControls ( bool enabled, [ bool gtaControls = true, bool mtaControls = true ] ) </syntaxhighlight>
 
===Required Arguments===
*'''enabled:''' A boolean value representing whether or not the controls will be usable.
 
===Optional Arguments===
{{OptionalArg}}
*'''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.
</section>
 
===Returns===
This function returns ''true'' if controls were toggled successfully, false otherwise.


==Example==   
==Example==   
<section name="Server" class="server" show="true">
This function will disable the use of all controls in order to freeze a player, which will be used every time someone enters a vehicle.
This function will disable the use of all controls in order to freeze a player, which will be used every time someone enters a vehicle.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function freezeThisDude ( thePlayer, time )
function freezeThisDude ( thePlayer, freezeTime )
     toggleAllControls ( thePlayer, false ) -- disable this players controls
     toggleAllControls ( thePlayer, false )                         -- disable this player's controls
     setTimer ( toggleAllControls, time, 1, thePlayer, true ) -- enable this players controls after the specified time
     setTimer ( toggleAllControls, freezeTime, 1, thePlayer, true ) -- enable this player's controls after the specified time
end
end


function onPlayerEnterVehicle ( theVehicle, seat, jacked )
function freezeOnEnterVehicle ( theVehicle, seat, jacked )
     freezeThisDude ( source, 5000 ) -- 'freeze' him for 5000ms/5secs
     freezeThisDude ( source, 5000 ) -- 'freeze' him for 5000ms = 5 seconds
end
end
addEventHandler ( "onPlayerEnterVehicle", root, onPlayerEnterVehicle )
addEventHandler ( "onPlayerVehicleEnter", root, freezeOnEnterVehicle )
</syntaxhighlight>
</syntaxhighlight>
</section>


==See Also==
==See Also==
{{Input functions}}
{{Input functions}}

Latest revision as of 08:43, 4 November 2020

Enables or disables the use of all GTA controls for a specified player.

Syntax

Click to collapse [-]
Server
bool 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 [-]
Client
bool 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 [-]
Server

This 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", root, freezeOnEnterVehicle )

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/ToggleAllControls?oldid=67702"