CallServerFunction - Revision history

Ccw at 23:42, 4 July 2014

2014-07-04T23:42:31Z

← Older revision		Revision as of 23:42, 4 July 2014
Line 1:		Line 1:
	{{Useful Function}}		{{Useful Function}}
	<lowercasetitle/>		<lowercasetitle/>
	__NOTOC__		__NOTOC__{{Warning\|It is strongly advised that you validate the functions being called or potentially a client can do anything they want with your server - banning players, adding themselves as admin (depending how well your ACL is set up) etc. This is why this function is not built into MTA.}}
	{{Warning\|It is strongly advised that you validate the functions being called or potentially a client can do anything they want with your server - banning players, adding themselves as admin (depending how well your ACL is set up) etc. This is why this function is not built into MTA.}}
	This function allows you to call any serverside function from the client's side. Of course only those which are available serverside. It doesn't matter if it's a MTA function, a Lua standard function or a custom function.		This function allows you to call any serverside function from the client's side. Of course only those which are available serverside. It doesn't matter if it's a MTA function, a Lua standard function or a custom function.
	<br /><br />		<br /><br />
Line 36:		Line 35:
	<section name="Serverside Script" class="server" show="true">		<section name="Serverside Script" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
			-- Always, always, always, (always) use a list of allowed servers functions.
			-- Otherwise hackers can call any function and destroy your server.
			allowedFunctions = { ["setPlayerTeam"]=true, ["getListOfCheese"]=true }

	function callServerFunction(funcname, ...)		function callServerFunction(funcname, ...)
			if not allowedFunctions[funcname] then
			-- Protect server from abuse
			outputServerLog( "SECURITY: " .. tostring(getPlayerName(client)) .. " tried to use function " .. tostring(funcname) )
			return
			end

	local arg = { ... }		local arg = { ... }
	if (arg[1]) then		if (arg[1]) then

Jusonex: Replaced info by a warning

2013-08-26T17:46:27Z

Replaced info by a warning

← Older revision		Revision as of 17:46, 26 August 2013
Line 2:		Line 2:
	<lowercasetitle/>		<lowercasetitle/>
	__NOTOC__		__NOTOC__
	{{~~Note_box~~\|It is strongly advised that you validate the functions being called or potentially a client can do anything they want with your server - banning players, adding themselves as admin (depending how well your ACL is set up) etc. This is why this function is not built into MTA.}}		{{Warning\|It is strongly advised that you validate the functions being called or potentially a client can do anything they want with your server - banning players, adding themselves as admin (depending how well your ACL is set up) etc. This is why this function is not built into MTA.}}
	This function allows you to call any serverside function from the client's side. Of course only those which are available serverside. It doesn't matter if it's a MTA function, a Lua standard function or a custom function.		This function allows you to call any serverside function from the client's side. Of course only those which are available serverside. It doesn't matter if it's a MTA function, a Lua standard function or a custom function.
	<br /><br />		<br /><br />

X86dev: Undo revision 31131 by Jaysds (talk)

2012-05-24T09:37:33Z

Undo revision 31131 by Jaysds (talk)

← Older revision		Revision as of 09:37, 24 May 2012
Line 65:		Line 65:

	Author: NeonBlack		Author: NeonBlack
	~~[http://community.mtasa.com/index.php?p=resources&s=details&id=4858 Resource includes both]~~

	==See Also==		==See Also==
	{{Useful_Functions}}		{{Useful_Functions}}

Jaysds at 20:41, 23 May 2012

2012-05-23T20:41:18Z

← Older revision		Revision as of 20:41, 23 May 2012
Line 65:		Line 65:

	Author: NeonBlack		Author: NeonBlack
			[http://community.mtasa.com/index.php?p=resources&s=details&id=4858 Resource includes both]

	==See Also==		==See Also==
	{{Useful_Functions}}		{{Useful_Functions}}

Ccw: Changed example to reduce the chance of event name clashes

2010-02-26T00:13:00Z

Changed example to reduce the chance of event name clashes

← Older revision		Revision as of 00:13, 26 February 2010
Line 29:		Line 29:
	end		end
	end		end
	triggerServerEvent("onClientCallsServerFunction", ~~root~~, funcname, unpack(arg))		-- If the serverside event handler is not in the same resource, replace 'resourceRoot' with the appropriate element
			triggerServerEvent("onClientCallsServerFunction", resourceRoot , funcname, unpack(arg))
	end		end
	</syntaxhighlight>		</syntaxhighlight>
Line 43:		Line 44:
	end		end
	addEvent("onClientCallsServerFunction", true)		addEvent("onClientCallsServerFunction", true)
	addEventHandler("onClientCallsServerFunction", ~~root~~, callServerFunction)		addEventHandler("onClientCallsServerFunction", resourceRoot , callServerFunction)
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

NeonBlack: update

2009-07-28T12:16:03Z

update

← Older revision		Revision as of 12:16, 28 July 2009
Line 1:		Line 1:
	{{Useful Function}}		{{Useful Function}}
			<lowercasetitle/>
	__NOTOC__		__NOTOC__
	{{Note_box\|It is strongly advised that you validate the functions being called or potentially a client can do anything they want with your server - banning players, adding themselves as admin (depending how well your ACL is set up) etc. This is why this function is not built into MTA.}}		{{Note_box\|It is strongly advised that you validate the functions being called or potentially a client can do anything they want with your server - banning players, adding themselves as admin (depending how well your ACL is set up) etc. This is why this function is not built into MTA.}}
	This function allows you to call any serverside function from the client's side. Of course only those which are available serverside. It doesn't matter if it's a MTA function, a Lua standard function or a custom function.		This function allows you to call any serverside function from the client's side. Of course only those which are available serverside. It doesn't matter if it's a MTA function, a Lua standard function or a custom function.
			<br /><br />
	Numbers are automatically converted to a string and vice versa serverside to avoid data being lost. If you don't need this feature just delete it.		Numbers are automatically converted to a string and vice versa serverside to avoid data being lost. If you don't need this feature just delete it.
			<br /><br />
			'''Important Note:''' Bear in mind that the funcname has to be a '''string'''!

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">void ~~CallServerFunction~~( string funcname, [ var ~~argument1~~, ... ] )</syntaxhighlight>		<syntaxhighlight lang="lua">void callServerFunction( string funcname, [ var arg1, ... ] )</syntaxhighlight>

	===Required Arguments===		===Required Arguments===
Line 14:		Line 17:
	===Optional Arguments===		===Optional Arguments===
	{{OptionalArg}}		{{OptionalArg}}
	* '''~~argument1, ...~~''': The arguments that should be passed to the function.		* '''arg1-argn''': The arguments that should be passed to the function.

	==Code==		==Code==
	<section name="Clientside Script" class="client" show="true">		<section name="Clientside Script" class="client" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~local _root = getRootElement()~~		function callServerFunction(funcname, ...)
	function ~~CallServerFunction~~(funcname, ...)
	local arg = { ... }		local arg = { ... }
	if (arg[1]) then		if (arg[1]) then
	for key, value in ~~pairs(~~arg) do		for key, value in next, arg do
	if (type(value) == "number") then arg[key] = tostring(value) end		if (type(value) == "number") then arg[key] = tostring(value) end
	end		end
	end		end
	triggerServerEvent("~~OnClientCallsServerFunction~~", ~~_root~~, funcname, unpack(arg))		triggerServerEvent("onClientCallsServerFunction", root, funcname, unpack(arg))
	end		end
	</syntaxhighlight>		</syntaxhighlight>
Line 33:		Line 35:
	<section name="Serverside Script" class="server" show="true">		<section name="Serverside Script" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~local _root = getRootElement()~~		function callServerFunction(funcname, ...)
	function ~~CallServerFunction~~(funcname, ...)
	local arg = { ... }		local arg = { ... }
	if (arg[1]) then		if (arg[1]) then
	for key, value in ~~pairs(~~arg) do arg[key] = tonumber(value) or value end		for key, value in next, arg do arg[key] = tonumber(value) or value end
	end		end
	loadstring("return "..funcname)()(unpack(arg))		loadstring("return "..funcname)()(unpack(arg))
	end		end
	addEvent("~~OnClientCallsServerFunction~~", true)		addEvent("onClientCallsServerFunction", true)
	addEventHandler("~~OnClientCallsServerFunction~~", ~~_root~~, ~~CallServerFunction~~)		addEventHandler("onClientCallsServerFunction", root, callServerFunction)
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>
Line 53:		Line 54:
	local _local = getLocalPlayer()		local _local = getLocalPlayer()
	-- define the leaveTeam command handler function		-- define the leaveTeam command handler function
	function ~~CmdLeaveTeam~~()		function cmdLeaveTeam()
	-- set the player's team to nil		-- set the player's team to nil
	~~CallServerFunction~~("setPlayerTeam", _local)		callServerFunction("setPlayerTeam", _local)
	end		end
	-- add the command handler		-- add the command handler
	addCommandHandler("leaveTeam", ~~CmdLeaveTeam~~, false)		addCommandHandler("leaveTeam", cmdLeaveTeam, false)
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

Sebassje at 05:51, 29 June 2009

2009-06-29T05:51:58Z

← Older revision		Revision as of 05:51, 29 June 2009
Line 7:		Line 7:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">~~nil~~ CallServerFunction( string funcname, [ var argument1, ... ] )</syntaxhighlight>		<syntaxhighlight lang="lua">void CallServerFunction( string funcname, [ var argument1, ... ] )</syntaxhighlight>

	===Required Arguments===		===Required Arguments===

Sebassje at 21:53, 15 May 2009

2009-05-15T21:53:51Z

← Older revision		Revision as of 21:53, 15 May 2009
Line 63:		Line 63:

	Author: NeonBlack		Author: NeonBlack

			==See Also==
			{{Useful_Functions}}

NeonBlack: added a definition of local arg since arg is deprecated

2009-05-15T18:40:49Z

added a definition of local arg since arg is deprecated

← Older revision		Revision as of 18:40, 15 May 2009
Line 21:		Line 21:
	local _root = getRootElement()		local _root = getRootElement()
	function CallServerFunction(funcname, ...)		function CallServerFunction(funcname, ...)
			local arg = { ... }
	if (arg[1]) then		if (arg[1]) then
	for key, value in pairs(arg) do		for key, value in pairs(arg) do
Line 34:		Line 35:
	local _root = getRootElement()		local _root = getRootElement()
	function CallServerFunction(funcname, ...)		function CallServerFunction(funcname, ...)
			local arg = { ... }
	if (arg[1]) then		if (arg[1]) then
	for key, value in pairs(arg) do arg[key] = tonumber(value) or value end		for key, value in pairs(arg) do arg[key] = tonumber(value) or value end

EAi at 23:54, 14 May 2009

2009-05-14T23:54:54Z

← Older revision		Revision as of 23:54, 14 May 2009
Line 1:		Line 1:
	{{Useful Function}}		{{Useful Function}}
	__NOTOC__		__NOTOC__
			{{Note_box\|It is strongly advised that you validate the functions being called or potentially a client can do anything they want with your server - banning players, adding themselves as admin (depending how well your ACL is set up) etc. This is why this function is not built into MTA.}}
	This function allows you to call any serverside function from the client's side. Of course only those which are available serverside. It doesn't matter if it's a MTA function, a Lua standard function or a custom function.		This function allows you to call any serverside function from the client's side. Of course only those which are available serverside. It doesn't matter if it's a MTA function, a Lua standard function or a custom function.
	~~<br /><br />~~
	Numbers are automatically converted to a string and vice versa serverside to avoid data being lost. If you don't need this feature just delete it.		Numbers are automatically converted to a string and vice versa serverside to avoid data being lost. If you don't need this feature just delete it.