View source for Squirrel/Server/Events/Player/onPlayerKeyStateChange

{{Squirrel/Title|onPlayerKeyStateChange}}
This is called when a player press a GTA's control keys.

== Syntax ==

<code>function onPlayerKeyStateChange ( Player player, OldKeys, NewKeys )</code>

=== Arguments ===

* '''player''' - The pointer of the player
* '''OldKeys''' - The last known keys pressed by the player
* '''NewKeys''' - The new key states

=== Returns ===

This event does not handle return values.

== Example ==

This example detects whether the fire key was pressed

<code lang="squirrel">
function onPlayerKeyStateChange ( pPlayer, oldkeys, newkeys ) {

	if ( ( oldkeys & KEY_ONFOOT_FIRE == 0 ) && ( newkeys & KEY_ONFOOT_FIRE != 0 ) )
	{
		MessagePlayer ( "Fire key pressed", pPlayer );
	}

	return;
}
</code>

=== Notes ===

The functions [[Squirrel/Server/Functions/Messages/MessagePlayer|MessagePlayer]] and [[Squirrel/Server/Functions/Players/Pos|Player.Pos]] were used in this example. More info about them can be found in the corresponding pages.

== Related Events ==

{{Squirrel/Server/Events/Player}}