Revision Difference
GM:PlayerBindPress#528762
<function name="PlayerBindPress" parent="GM" type="hook">
<ishook>yes</ishook>
<description>
Runs when a bind has been pressed. Allows to block commands.
<note>By using the "alias" console command, this hook can be effectively circumvented. To prevent this use <page>input.TranslateAlias</page>.</note>⤶
⤶
<note>To stop the user from using `+attack`, `+left` and any other movement commands of the sort, please look into using <page>GM:StartCommand</page> instead</note>⤶
<note>By using the "alias" console command, this hook can be effectively circumvented. To prevent this use <page>input.TranslateAlias</page>.⤶
⤶
To stop the user from using `+attack`, `+left` and any other movement commands of the sort, please look into using <page>GM:StartCommand</page> instead.</note>⤶
<bug issue="1176">The third argument will always be true.</bug>
<bug issue="2888">This does not run for function keys binds (F1-F12).</bug>
</description>
<realm>Client</realm>
<predicted>No</predicted>
<args>
<arg name="ply" type="Player">The player who used the command; this will always be equal to <page>Global.LocalPlayer</page></arg>⤶
<arg name="bind" type="string">The bind command</arg>⤶
<arg name="pressed" type="boolean">If the bind was activated or deactivated</arg>⤶
<arg name="ply" type="Player">The player who used the command; this will always be equal to <page>Global.LocalPlayer</page>.</arg>⤶
<arg name="bind" type="string">The bind command.</arg>⤶
<arg name="pressed" type="boolean">If the bind was activated or deactivated.</arg>⤶
</args>
<rets>
<ret name="" type="boolean">Return true to prevent the bind</ret>⤶
<ret name="" type="boolean">Return `true` to prevent the bind.</ret>⤶
</rets>
</function>
<example>
<description>Prevents players from using flashlight.</description>
<code>
hook.Add( "PlayerBindPress", "PlayerBindPressExample", function( ply, bind, pressed )
--To block more commands, you could add another line similar to
--the one below, just replace the command
if ( string.find( bind, "impulse 100" ) ) then return true end⤶
if ( string.find( bind, "impulse 100" ) ) then⤶
return true⤶
end⤶
end )
</code>
</example>