Scripting/Squirrel/Functions/BindKey: Difference between revisions

From Vice City Multiplayer
Jump to navigation Jump to search
Caution icon
This wiki is using an old backup from 2020
Some information may be old/missing
(How to bind different keys for different actions in game, could be useful, created by Doom_Killer)
 
No edit summary
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
'''Syntax'''
'''BindKey''' allows the server to be informed when a player presses a key or a combination of up to three keys.


BindKey( bool:press, key, args..., args2...)
== Syntax ==


'''Arguments'''
<pre>BindKey(press, key1, key2, key3)</pre>


'''bool:press''' This is the bool for the key function to be called once the key is 'pressed' or 'released'.
== Arguments ==


'''key''' The key you bind at, you can get key codes from [http://msdn.microsoft.com/en-us/library/windows/desktop/dd375731(v=vs.85).aspx Key Codes]
*''bool'' '''press''' - This is the bool for the key function to be called once the key is 'pressed' or 'released'


'''args...''' You can have this 0.
*''int'' '''key1''' - The primary key you bind it to, you can get the key codes from [https://msdn.microsoft.com/en-us/library/windows/desktop/dd375731(v=vs.85).aspx here]


'''args2...''' You can have this 0.
*''int'' '''key2''' - The second key that needs to be pressed for this bind, or zero if not needed.


'''Example'''
*''int'' '''key3''' - The third key that needs to be pressed for this bind, or zero if not needed.


The following example will bind the left-shift key for player and send him a message when a player press that key:
== Example ==
 
The following example will bind the left-shift key for a player and will send him a message when he player presses that key:


<source lang=squirrel>
<source lang=squirrel>
Line 32: Line 34:
</source>
</source>


'''Notes'''
=== Notes ===
 
* Callbacks [[onScriptLoad]] and [[onKeyDown]] were used in this example. More info about them in the corresponding pages.
* [https://msdn.microsoft.com/en-us/library/windows/desktop/dd375731(v=vs.85).aspx Virtual Key Codes] — a list of keys and their key codes that can be used for keybinds
 
== Related Functions ==


Call onScriptLoad, onKeyDown were used in this example. More info about them in the corresponding pages.
{{Scripting/Squirrel/Functions/Game_Functions}}
[[Category:Scripting/Squirrel/Functions/Game_Functions]]

Latest revision as of 18:05, 30 January 2017

BindKey allows the server to be informed when a player presses a key or a combination of up to three keys.

Syntax

BindKey(press, key1, key2, key3)

Arguments

  • bool press - This is the bool for the key function to be called once the key is 'pressed' or 'released'
  • int key1 - The primary key you bind it to, you can get the key codes from here
  • int key2 - The second key that needs to be pressed for this bind, or zero if not needed.
  • int key3 - The third key that needs to be pressed for this bind, or zero if not needed.

Example

The following example will bind the left-shift key for a player and will send him a message when he player presses that key:

function onScriptLoad()
{
    lshift <- BindKey(true, 0xA0, 0, 0);
}

function onKeyDown( player, key )
{
    if( key == lshift )
    {
        MessagePlayer( ">> You pressed the left shift key", player );
    }
}

Notes

  • Callbacks onScriptLoad and onKeyDown were used in this example. More info about them in the corresponding pages.
  • Virtual Key Codes — a list of keys and their key codes that can be used for keybinds

Related Functions