This event is triggered when a player trips anti-cheat detections. 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 to be of use here.

Any resource using this event should call resendPlayerACInfo for each player in onResourceStart

Parameters

table detectedACList, int d3d9Size, string d3d9MD5, string d3d9SHA256

• detectedACList: A table 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.

Source

element: The source of this event is the player

Code Examples

Example 1 Example 2 Example 3

server

This example prints all information into the chatbox

function handleOnPlayerACInfo( detectedACList, d3d9Size, d3d9MD5, d3d9SHA256 )
    outputChatBox( "ACInfo for " .. getPlayerName(source)
                .. " detectedACList:" .. table.concat(detectedACList,",")
                .. " d3d9Size:" .. d3d9Size
                .. " d3d9SHA256:" .. d3d9SHA256
                )
end

addEventHandler( "onPlayerACInfo", root, handleOnPlayerACInfo )

-- Ensure no one gets missed when the resource is (re)started
addEventHandler( "onResourceStart", resourceRoot,
    function()
        for _,plr in ipairs( getElementsByType("player") ) do
            resendPlayerACInfo( plr )
        end
    end
)

server

This example will notify all online admins when someone triggers a (suspicious) detection

function handleAC(detectedACList)
  for _, acCode in ipairs(detectedACList) do
    if acCode == 33 then -- SD #33 in this code example = NetLimiter software (possible lagswitch)
      local playerName = getPlayerName(source)
      warnAdmins(playerName, acCode)
    end
  end
end
addEventHandler("onPlayerACInfo", root, handleAC)

local staffACL = {
  [aclGetGroup("Admin")] = true,
  [aclGetGroup("Moderator")] = true
}

function warnAdmins(playerName, acCode)
  for _, p in ipairs(getElementsByType("player")) do
    local account = getPlayerAccount(p)
    if p and account then
      for group, _ in pairs(staffACL) do
        local name = getAccountName(account)
        if isObjectInACLGroup("user." .. name, group) then
          outputChatBox("The player " .. playerName .. " has triggered SD/AC #" .. acCode .. "! Keep an eye out!", p)
        end
      end
    end
  end
end

-- Ensure no one gets missed when the resource is (re)started
function onRestart()
  for _,p in ipairs (getElementsByType("player")) do
    resendPlayerACInfo(p)
  end
end
addEventHandler("onResourceStart", resourceRoot, onRestart)

server

This example allows player serial exceptions for SD #14 (virtual machines). In order for this to work, it's important that youdon'tadd SD #14 detection into mtaserver.conf, as this is a custom re-implementation.

-- List of serials which are allowed to use virtual machines
allowVM = { ["0123456789012345601234567890123456"] = true,
            ["A123637892167367281632896790123456"] = true,
            ["E123456789012347839207878392123456"] = true }

function handleOnPlayerACInfo( detectedACList, d3d9Size, d3d9MD5, d3d9SHA256 )
    for _,acCode in ipairs( detectedACList ) do
        if acCode == 14 then
            local serial = getPlayerSerial(source)
            if not allowVM[serial] then
                kickPlayer( source, "This server does not allow virtual machines." )
            end
        end
    end
end
addEventHandler( "onPlayerACInfo", root, handleOnPlayerACInfo )

-- Ensure no one gets missed when the resource is (re)started
addEventHandler( "onResourceStart", resourceRoot,
    function()
        for _,plr in ipairs( getElementsByType("player") ) do
            resendPlayerACInfo( plr )
        end
    end
)

See Also

Player Events

• onClientPlayerChangeNick
• onClientPlayerDamage
• onClientPlayerChoke
• onClientPlayerHeliKilled
• onClientPlayerJoin
• onClientPlayerPickupLeave
• onClientPlayerQuit
• onClientPlayerPickupHit
• onClientPlayerRadioSwitch
• onClientPlayerHitByWaterCannon
• onClientPlayerSpawn
• onClientPlayerStealthKill
• onClientPlayerStuntFinish
• onClientPlayerStuntStart
• onClientPlayerVehicleEnter
• onClientPlayerTarget
• onClientPlayerVehicleExit
• onClientPlayerVoiceResumed
• onClientPlayerVoicePause
• onClientPlayerVoiceStart
• onClientPlayerVoiceStop
• onClientPlayerWasted
• onClientPlayerWeaponFire
• onClientPlayerWeaponSwitch
• onPlayerACInfo
• onPlayerBan
• onPlayerChangeNick
• onPlayerChangesProtectedData
• onPlayerChangesWorldSpecialProperty
• onPlayerChat
• onPlayerClick
• onPlayerCommand
• onPlayerConnect
• onPlayerContact
• onPlayerDamage
• onPlayerDiscordJoin
• onPlayerLogin
• onPlayerLogout
• onPlayerDetonateSatchels
• onPlayerMarkerHit
• onPlayerMarkerLeave
• onPlayerJoin
• onPlayerModInfo
• onPlayerMute
• onPlayerNetworkStatus
• onPlayerPickupUse
• onPlayerPickupLeave
• onPlayerPickupHit
• onPlayerProjectileCreation
• onPlayerPrivateMessage
• onPlayerScreenShot
• onPlayerQuit
• onPlayerSpawn
• onPlayerStealthKill
• onPlayerTarget
• onPlayerTeamChange
• onPlayerTeleport
• onPlayerTriggerEventThreshold
• onPlayerTriggerInvalidEvent
• onPlayerUnmute
• onPlayerVehicleExit
• onPlayerVehicleEnter
• onPlayerVoiceStart
• onPlayerVoiceStop
• onPlayerWasted
• onPlayerWeaponFire
• onPlayerWeaponReload
• onPlayerWeaponSwitch

Player Functions

• countPlayersInTeam
• forcePlayerMap
• getControlState
• getPlayerBlurLevel
• getPlayerFromName
• getPlayerMoney
• getPlayerName
• getPlayerNametagColor
• getPlayerNametagText
• getPlayerPing
• getPlayerScriptDebugLevel
• getPlayerSerial
• getPlayerTeam
• getPlayerWantedLevel
• getPlayersInTeam
• givePlayerMoney
• isPlayerMapForced
• isPlayerNametagShowing
• isVoiceEnabled
• setControlState
• setPlayerBlurLevel
• setPlayerHudComponentVisible
• setPlayerMoney
• setPlayerNametagColor
• setPlayerNametagShowing
• setPlayerNametagText
• takePlayerMoney
• getLocalPlayer
• getPlayerHudComponentProperty
• getPlayerMapBoundingBox
• getPlayerMapOpacity
• isPlayerCrosshairVisible
• isPlayerHudComponentVisible
• isPlayerMapVisible
• resetBlurLevel
• resetPlayerHudComponentProperty
• setPlayerHudComponentProperty
• getAlivePlayers
• getDeadPlayers
• getPlayerACInfo
• getPlayerAnnounceValue
• getPlayerCount
• getPlayerIP
• getPlayerIdleTime
• getPlayerVersion
• getRandomPlayer
• isPlayerMuted
• redirectPlayer
• resendPlayerACInfo
• resendPlayerModInfo
• setPlayerAnnounceValue
• setPlayerMuted
• setPlayerName
• setPlayerScriptDebugLevel
• setPlayerTeam
• setPlayerVoiceBroadcastTo
• setPlayerVoiceIgnoreFrom
• setPlayerWantedLevel
• spawnPlayer
• takePlayerScreenShot

Reference

• Scripting Events