GetPlayerACInfo - Revision history

Fernando187: Remove obsolete Requirements section

2024-11-07T17:12:06Z

Remove obsolete Requirements section

← Older revision		Revision as of 17:12, 7 November 2024
Line 84:		Line 84:
	</syntaxhighlight>		</syntaxhighlight>
	-->		-->
	~~==Requirements==~~
	~~{{Requirements\|1.3.3\|n/a\|}}~~

	==See Also==		==See Also==
	{{Player functions\|server}}		{{Player functions\|server}}

FileEX: /* See Also */

2024-09-06T22:40:49Z

Ccw at 11:43, 11 September 2016

2016-09-11T11:43:36Z

← Older revision		Revision as of 11:43, 11 September 2016
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
	__NOTOC__		__NOTOC__
	{{~~New feature/item\|3.0140\|1.3.3\|5523~~\|		{{Deprecated\|onPlayerACInfo}}
	This function returns anti-cheat info for a player. It can be used to script a white/blacklist of custom d3d9.dll files, or a white/blacklist of players with certain anti-cheat codes. The relevant anti-cheat code has to be disabled (or not enabled) in the server [[Mtaserver.conf#disableac\|mtaserver.conf]] to be of use here.
	~~{{Note\|~~The info returned by this function can change over time, so ~~it should be called every few seconds rather than just when~~ the ~~player joins. See example~~.}}		This function returns anti-cheat info for a player. The info returned by this function can change over time, so use the server event [[onPlayerACInfo]] instead.
	}}
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 18:		Line 17:
	*'''d3d9Size:''' A number representing the file size of any custom d3d9.dll the player may have installed.		*'''d3d9Size:''' A number representing the file size of any custom d3d9.dll the player may have installed.
	*'''d3d9MD5:''' A string containing the MD5 of any custom d3d9.dll the player may have installed.		*'''d3d9MD5:''' A string containing the MD5 of any custom d3d9.dll the player may have installed.
	~~{{New items\|4.0142\|1.4\|~~
	*'''d3d9SHA256:''' A string containing the SHA256 of any custom d3d9.dll the player may have installed.		*'''d3d9SHA256:''' A string containing the SHA256 of any custom d3d9.dll the player may have installed.
	}}

			<!--
	==Example==		==Example==
	This example checks getPlayerACInfo for changes every 3 seconds		This example checks getPlayerACInfo for changes every 3 seconds
Line 85:		Line 83:
	setTimer( checkPlayersACInfo, 3000, 0 )		setTimer( checkPlayersACInfo, 3000, 0 )
	</syntaxhighlight>		</syntaxhighlight>
			-->
	==Requirements==		==Requirements==
	{{Requirements\|1.3.3\|n/a\|}}		{{Requirements\|1.3.3\|n/a\|}}

Ccw: /* Example */

2015-11-24T04:57:43Z

Example

← Older revision		Revision as of 04:57, 24 November 2015
Line 65:		Line 65:

	==Example==		==Example==
	This example allows player serial exceptions for SD #28 (virtual machines)		This example allows player serial exceptions for SD #14 (virtual machines)
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- List of serials which are allowed to use virtual machines		-- List of serials which are allowed to use virtual machines
Line 75:		Line 75:
	for _,plr in ipairs( getElementsByType("player") ) do		for _,plr in ipairs( getElementsByType("player") ) do
	local ACInfo = getPlayerACInfo(plr)		local ACInfo = getPlayerACInfo(plr)
	if string.find( ACInfo.DetectedAC, "28" ) then		if string.find( ACInfo.DetectedAC, "14" ) then
	local serial = getPlayerSerial(plr)		local serial = getPlayerSerial(plr)
	if not allowVM[serial] then		if not allowVM[serial] then

Ccw: /* Example */

2015-11-22T14:52:26Z

Example

← Older revision		Revision as of 14:52, 22 November 2015
Line 68:		Line 68:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- List of serials which are allowed to use virtual machines		-- List of serials which are allowed to use virtual machines
	allowVM = { "0123456789012345601234567890123456" = true,		allowVM = { ["0123456789012345601234567890123456"] = true,
	"A123637892167367281632896790123456" = true,		["A123637892167367281632896790123456"] = true,
	"E123456789012347839207878392123456" = true }		["E123456789012347839207878392123456"] = true }

	function checkPlayersACInfo()		function checkPlayersACInfo()

Ccw: Added example

2015-11-18T22:27:09Z

Added example

@@ Line 58: / Line 58: @@
                  .. " d3d9Size:" .. tostring(info.d3d9Size)
+                 )
          end
      end
@@ Line 66: / Line 88: @@
 ==Requirements==
 {{Requirements|1.3.3|n/a|}}
 ==See Also==
 {{Player_functions}}

MarioKart: /* Syntax */ OOP syntax added

2014-07-15T05:30:37Z

Syntax: OOP syntax added

← Older revision		Revision as of 05:30, 15 July 2014
Line 9:		Line 9:
	table getPlayerACInfo( element thePlayer )		table getPlayerACInfo( element thePlayer )
	</syntaxhighlight>		</syntaxhighlight>
			{{OOP\|\|[[player]]:getACInfo\|ACInfo\|}}
	===Required Arguments===		===Required Arguments===
	*'''thePlayer:''' The [[player]] whose anti-cheat info you want to check.		*'''thePlayer:''' The [[player]] whose anti-cheat info you want to check.
Line 21:		Line 21:
	*'''d3d9SHA256:''' A string containing the SHA256 of any custom d3d9.dll the player may have installed.		*'''d3d9SHA256:''' A string containing the SHA256 of any custom d3d9.dll the player may have installed.
	}}		}}

	==Example==		==Example==
	This example checks getPlayerACInfo for changes every 3 seconds		This example checks getPlayerACInfo for changes every 3 seconds

Ccw at 20:23, 25 June 2014

2014-06-25T20:23:35Z

← Older revision		Revision as of 20:23, 25 June 2014
Line 16:		Line 16:
	Returns a table with the following entries:		Returns a table with the following entries:
	* '''DetectedAC:''' A string containing a comma separated list of [[Anti-cheat_guide\|anti-cheat]] codes the player has triggered.		* '''DetectedAC:''' A string containing a comma separated list of [[Anti-cheat_guide\|anti-cheat]] codes the player has triggered.
			*'''d3d9Size:''' A number representing the file size of any custom d3d9.dll the player may have installed.
	*'''d3d9MD5:''' A string containing the MD5 of any custom d3d9.dll the player may have installed.		*'''d3d9MD5:''' A string containing the MD5 of any custom d3d9.dll the player may have installed.
	*'''~~d3d9Size~~:''' A ~~number representing~~ the ~~file size~~ of any custom d3d9.dll the player may have installed.		{{New items\|4.0142\|1.4\|
			*'''d3d9SHA256:''' A string containing the SHA256 of any custom d3d9.dll the player may have installed.
			}}
	==Example==		==Example==
	This example checks getPlayerACInfo for changes every 3 seconds		This example checks getPlayerACInfo for changes every 3 seconds

Ccw at 16:24, 1 February 2014

2014-02-01T16:24:59Z

← Older revision		Revision as of 16:24, 1 February 2014
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
	~~{{Needs_Example}}~~
	__NOTOC__		__NOTOC__
	{{New feature/item\|3.0140\|1.3.3\|5523\|		{{New feature/item\|3.0140\|1.3.3\|5523\|
	This function returns anti-cheat info for a player. It can be used to script a white/blacklist of custom d3d9.dll files, or a white/blacklist of players with certain anti-cheat codes. The relevant anti-cheat code has to be disabled (or not enabled) in the server [[Mtaserver.conf#disableac\|mtaserver.conf]] to be of use here.		This function returns anti-cheat info for a player. It can be used to script a white/blacklist of custom d3d9.dll files, or a white/blacklist of players with certain anti-cheat codes. The relevant anti-cheat code has to be disabled (or not enabled) in the server [[Mtaserver.conf#disableac\|mtaserver.conf]] to be of use here.
	{{Note\|The info returned by this function can change over time, so it should be called every few seconds rather than just when the player joins.}}		{{Note\|The info returned by this function can change over time, so it should be called every few seconds rather than just when the player joins. See example.}}
	}}		}}
	==Syntax==		==Syntax==
Line 21:		Line 20:

	==Example==		==Example==
	This ~~untested~~ example checks getPlayerACInfo every 3 seconds ~~for new datum~~		This example checks getPlayerACInfo for changes every 3 seconds
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	lastDetectedACList = {}		lastDetectedACList = {}

			addEventHandler( "onResourceStart", resourceRoot,
			function()
			for _,plr in ipairs( getElementsByType("player") ) do
			lastDetectedACList[plr] = ""
			end
			end
			)

	addEventHandler( "onPlayerJoin", root,		addEventHandler( "onPlayerJoin", root,

Ccw at 03:12, 1 February 2014

2014-02-01T03:12:35Z

@@ Line 19: / Line 19: @@
 *'''d3d9MD5:''' A string containing the MD5 of any custom d3d9.dll the player may have installed.
 *'''d3d9Size:''' A number representing the file size of any custom d3d9.dll the player may have installed.
 ==Requirements==

← Older revision		Revision as of 22:40, 6 September 2024
Line 88:		Line 88:

	==See Also==		==See Also==
	{{~~Player_functions~~}}		{{Player functions\|server}}