GetPlayerACInfo: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
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|}}

Latest revision as of 11:43, 11 September 2016


Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use onPlayerACInfo instead.


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

table getPlayerACInfo( element thePlayer )

OOP Syntax Help! I don't understand this!

Method: player:getACInfo(...)
Variable: .ACInfo


Required Arguments

  • thePlayer: The player whose anti-cheat info you want to check.

Returns

Returns a table with the following entries:

  • DetectedAC: A string containing a comma separated list of 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.
  • d3d9SHA256: A string containing the SHA256 of any custom d3d9.dll the player may have installed.

Requirements

Minimum server version 1.3.3
Minimum client version n/a

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version server="1.3.3" />

See Also