OnPlayerCommand - Revision history

Fernando187: /* Result of cancelling this event */

2025-06-01T12:22:13Z

Result of cancelling this event

← Older revision		Revision as of 12:22, 1 June 2025
Line 13:		Line 13:
	The [[event system#Event source\|source]] of this event is the [[player]] who tried to execute a command.		The [[event system#Event source\|source]] of this event is the [[player]] who tried to execute a command.

	==~~Result of cancelling this event~~==		==Canceling==
	The command will not be executed. (Only server-side commands can be canceled.)		The command will not be executed. (Only server-side commands can be canceled.)

Fernando187: params

2025-05-31T12:25:21Z

params

← Older revision		Revision as of 12:25, 31 May 2025
Line 8:		Line 8:
	string command		string command
	</syntaxhighlight>		</syntaxhighlight>
			*'''command:''' a [[string]] containing the name of the command executed.

	==Source==		==Source==

Patrick2562: /* Example */

2020-08-31T15:27:41Z

Example

← Older revision		Revision as of 15:27, 31 August 2020
Line 86:		Line 86:
	end)		end)
	</syntaxhighlight>		</syntaxhighlight>
	~~Author: !Patrick~~
	</section>		</section>

	{{See also/Server event\|Player events}}		{{See also/Server event\|Player events}}

Patrick2562: /* Result of cancelling this event */

2020-04-08T14:29:05Z

Result of cancelling this event

← Older revision		Revision as of 14:29, 8 April 2020
Line 13:		Line 13:

	==Result of cancelling this event==		==Result of cancelling this event==
	The command will not be executed.		The command will not be executed. (Only server-side commands can be canceled.)

	==Example==		==Example==

Patrick2562: /* Example */

2020-04-07T18:09:02Z

Example

@@ Line 52: / Line 52: @@
 end)
 </syntaxhighlight>
 </section>
 {{See also/Server event|Player events}}

Pirulax: /* Example */

2018-10-11T19:53:23Z

Example

← Older revision		Revision as of 19:53, 11 October 2018
Line 17:		Line 17:
	==Example==		==Example==
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	This example implements an anti-flood protection timer for commands		This example implements an anti-flood protection timer for commands.
			'''Be sure to give the resource a function.kickPlayer right.
			Also, note, that if the server freezes for a frame and a player executes a command 2x he/she'll get kicked, because those 2 commands will be processed after each other, with very little delay'''
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local CMD_INTERVAL = 200 --// The interval that needs to pass before the player can execute another cmd		local CMD_INTERVAL = 200 --// The interval that needs to pass before the player can execute another cmd
Line 23:		Line 25:

	local executions = setmetatable({}, { --// Metatable for non-existing indexes		local executions = setmetatable({}, { --// Metatable for non-existing indexes
	__index = function(t, k)		__index = function(t, player)
	~~rawset~~(~~t, k, 0~~)		return getTickCount()-CMD_INTERVAL
	~~return 0~~
	end		end
	})		})

Botder at 03:00, 27 September 2018

2018-09-27T03:00:07Z

← Older revision		Revision as of 03:00, 27 September 2018
Line 53:		Line 53:
	</section>		</section>

	==See ~~Also==~~		{{See also/Server event\|Player events}}
	~~===~~Player events~~===~~
	~~{{Player_events}}~~
	~~===Event functions===~~
	~~{{Event functions~~}}

Botder at 02:12, 27 September 2018

2018-09-27T02:12:56Z

← Older revision		Revision as of 02:12, 27 September 2018
Line 52:		Line 52:
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

			==See Also==
			===Player events===
			{{Player_events}}
			===Event functions===
			{{Event functions}}

Dutchman101: fix typo

2018-09-21T03:40:11Z

fix typo

← Older revision		Revision as of 03:40, 21 September 2018
Line 42:		Line 42:
	</syntaxhighlight>		</syntaxhighlight>

	~~<section name="Server" class="server" show="true">~~
	This example disables the hardcoded command 'whois'		This example disables the hardcoded command 'whois'
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

Dutchman101: overall page improvements

2018-09-21T03:37:54Z

overall page improvements

← Older revision		Revision as of 03:37, 21 September 2018
Line 2:		Line 2:
	{{Server event}}		{{Server event}}
	This event is triggered when a player issues a command.		This event is triggered when a player issues a command.
	{{Note\|This event triggers regardless of whether the command exists or ~~not~~. Also, typing anything in chat will execute command "say", so this event will be triggered on every chat message as well.}}		{{Note\|This event triggers regardless of whether the command exists in a script or is hardcoded. Also, typing anything in chat will execute the internal command "say", so this event will be triggered on every chat message as well. Therefore you should avoid excessive use of this function on busy servers, out of performance considerations.}}

	==Parameters==		==Parameters==
Line 12:		Line 12:
	The [[event system#Event source\|source]] of this event is the [[player]] who tried to execute a command.		The [[event system#Event source\|source]] of this event is the [[player]] who tried to execute a command.

	==~~Cancel effect~~==		==Result of cancelling this event==
	The command will not be executed.		The command will not be executed.

			==Example==
			<section name="Server" class="server" show="true">
			This example implements an anti-flood protection timer for commands
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local CMD_INTERVAL = 200 --// The interval that needs to pass before the player can execute another cmd		local CMD_INTERVAL = 200 --// The interval that needs to pass before the player can execute another cmd
	local KICK_AFTER_INTERVAL = 50 --// Kick ~~her~~ if ~~she executes~~ more than 20 cmds/sec		local KICK_AFTER_INTERVAL = 50 --// Kick the player if they execute more than 20 cmds/sec

	local executions = setmetatable({}, { --// Metatable for non-existing indexes		local executions = setmetatable({}, { --// Metatable for non-existing indexes
Line 38:		Line 41:
	)		)
	</syntaxhighlight>		</syntaxhighlight>

			<section name="Server" class="server" show="true">
			This example disables the hardcoded command 'whois'
			<syntaxhighlight lang="lua">
			addEventHandler("onPlayerCommand",root,
			function(command)
			if (command == "whois") then
			cancelEvent()
			end
			end)
			</syntaxhighlight>
			</section>