Multi Theft Auto: Wiki - User contributions [en]

XmlLoadString

2024-12-01T10:31:23Z

CrosRoad95:

__NOTOC__
{{Server client function}}
{{New feature/item|3.0158|1.5.7|19626|This function creates an [[Xmlnode]] from a string input.}}
==Syntax==
<syntaxhighlight lang="lua">
xmlnode xmlLoadString ( string xmlString )
</syntaxhighlight>
{{OOP|This function is a static function underneath the XML class.|[[XML]].loadstring||}}
===Required Arguments===
*'''xmlString:''' A string containing XML data

===Returns===
Returns the root [[xmlnode]] object of an xml string if successful, or ''false'' otherwise (invalid XML string).

==Example==
This example loads an XML string and loops the children while outputting to debugscript.
<syntaxhighlight lang="lua">
local rootNode = xmlLoadString("<animals test='x'><monkey name='dutchman'></monkey> <fox name='luxy'></fox></animals>")

if rootNode then
local rootAttributes = xmlNodeGetAttributes(rootNode)
print("Root Node", "Name: "..xmlNodeGetName(rootNode), "Attributes :"..toJSON(rootAttributes))

local children = xmlNodeGetChildren(rootNode)

for i, childNode in ipairs(children) do
local attributes = xmlNodeGetAttributes(childNode)
print("Child #"..i, "Name: "..xmlNodeGetName(childNode), "Attributes :"..toJSON(attributes))
end
end
</syntaxhighlight>

==See Also==
{{Shared xml functions}}
[[ru:xmlLoadString]]

FileGetContents

2024-10-19T05:24:15Z

CrosRoad95:

__NOTOC__
{{Server client function}}

{{Added feature/item|1.6.1|1.6.0|21938|
Reads the entire contents of the file, optionally verifies the read contents by computing and comparing the checksum with the expected one, and returns the content as string. The file cursor position is not modified by calls to this function. File must be added in the [[meta.xml]].
}}

Please note that even if you enable SD #22 and #23 on your server, you are not protected from user attacks, which can happen after verification of the file, but before you read the contents of such verified file. This function enables you to safely read the contents of a meta.xml-listed file on both client and server.

==Syntax==
<syntaxhighlight lang="lua">
nil|string fileGetContents ( file theFile [ , bool verifyContents = true ] )
</syntaxhighlight>
{{OOP||[[file]]:getContents}}

===Required Arguments===
*'''theFile:''' A handle to the file you wish to get the contents from. Use [[fileOpen]] to obtain this handle.
*'''verifyContents:''' Set to true, to compare the computed and the expected checksum of the file content.

===Returns===
Returns the bytes that were read from the file, but only if verification was disabled or if the checksum comparison succeeded. On failure, this function returns ''nil''.

==Example==
This example opens the code.lua file, checks its contents, and then runs it.
<syntaxhighlight lang="lua">
local handle = fileOpen("code.lua", true)
local buffer = fileGetContents(handle) -- code.lua must be listed in meta.xml (for example as <file> for this example)
fileClose(handle)

if buffer then
loadstring(buffer)() -- This is just an example. You should avoid using loadstring. If you are dealing with configuration use json functions instead for security reasons.
end
</syntaxhighlight>

==See Also==
{{File functions}}
[[pt-br:fileGetContents]]

Slipe

2024-09-29T06:01:21Z

CrosRoad95: Created page with "<big><big>Native C# for MTA</big></big> With Slipe Server you're able to run a Native C# MTA server. Making use of the entire dotnet ecosytem, any NuGet package you want, industry-standard ORMs and logging frameworks, and far more. Slipe Server enables you to make use of the full power of C#. This includes but is not limited to: type safety, inheritance, multithreading and async/await. See more at: https://server.mta-slipe.com/ Get started at: https://github.com/mta..."

<big><big>Native C# for MTA</big></big>

With Slipe Server you're able to run a Native C# MTA server. Making use of the entire dotnet ecosytem, any NuGet package you want, industry-standard ORMs and logging frameworks, and far more.

Slipe Server enables you to make use of the full power of C#. This includes but is not limited to: type safety, inheritance, multithreading and async/await.

See more at: https://server.mta-slipe.com/

Get started at: https://github.com/mta-slipe/Slipe-Server

ExecuteBrowserJavascript

2024-07-05T19:16:43Z

CrosRoad95: removed vulnerability from example :) because i want to backdoor everyone

__NOTOC__
{{Client function}}
{{New feature/item|3.0150|1.5||
This function executes a Javascript string to the specified [[Element/Browser|browser]]. Works only with local browsers.
}}

==Syntax==
<syntaxhighlight lang="lua">
bool executeBrowserJavascript ( browser webBrowser, string jsCode )
</syntaxhighlight>
{{OOP||[[Element/Browser|browser]]:executeJavascript}}

===Required Arguments===
*'''webBrowser:''' The web browser which will execute the Javascript code
*'''jsCode:''' The Javascript code string

===Returns===
Returns ''true'' if executing Javascript is allowed in the current context, ''false'' otherwise.

==Example==
This example shows how to display the name (nick) of the local player on the webpage.
<syntaxhighlight lang="lua">
local browser = guiGetBrowser(guiCreateBrowser(200, 200, 400, 200, true, false, false))

addEventHandler("onClientBrowserCreated", browser,
function ()
loadBrowserURL(source, "http://mta/local/example.html") --Containing somewhere in the file
end)

--The page has to load first
addEventHandler("onClientBrowserDocumentReady", browser,
function ()
executeBrowserJavascript(source, string.format("document.getElementById('nick').innerText = %q;", getPlayerName(localPlayer)))
end)
</syntaxhighlight>

==See Also==
{{CEF_functions}}

[[hu:executeBrowserJavascript]]
[[RO:executeBrowserJavascript]]

Script security

2024-05-31T18:59:16Z

CrosRoad95: /* Securing setElementData */

==Awareness of client memory==

Starting from very basics:
* You should be aware that everything you store on client-side is at risk, this includes Lua itself. Any confidential (and/or) important data could be accessed by malicious clients.
* To keep sensitive data (and/or) Lua logic safe - use server-side.
* Do note that scripts marked as '''shared''' act also as '''client code''', which means that everything above applies to them. For example defining:

<syntaxhighlight lang="xml">
<script src="script.lua" type="shared"/> 
</syntaxhighlight>

Is same as doing:

<syntaxhighlight lang="xml">
<script src="script.lua" type="client"/> 
<script src="script.lua" type="server"/> 
</syntaxhighlight>

==Additional protection layer==

In order to make things ''slightly harder*'' for those having bad intentions towards your server, you can make use of cache attribute (and/or [https://luac.mtasa.com/ Lua compile (also known as Luac) with extra obfuscation set to level '''3'''] - [https://wiki.multitheftauto.com/wiki/Lua_compilation_API API]) available in [https://wiki.multitheftauto.com/wiki/Meta.xml meta.xml], along with configuring MTA's built-in AC by toggling SD (Special detections), see: [https://wiki.multitheftauto.com/wiki/Anti-cheat_guide Anti-cheat guide].

<syntaxhighlight lang="xml">
<script src="shared.lua" type="shared" cache="false"/> 
<script src="client.lua" type="client" cache="false"/> 
</syntaxhighlight>

* ''Slightly harder'' '''but not impossible''' for some to obtain client code, yet does good job at keeping '''most''' people away from inspecting your .lua files - those looking for possible logic flaws (bugs) or missing/incorrect security based checks.
* Can be used on both '''client''' and '''shared''' script type (has no effect on server-sided Lua).
* It doesn't remove Lua files which were previously downloaded.

==Detecting and dealing with backdoors and cheats==
'''To ensure minimum (or no) damage resulting from Lua scripts:'''
* Keep your server up-to-date, you can [https://nightly.multitheftauto.com/ download latest server builds from MTA:SA nightly site.] Information on specific builds can be [https://buildinfo.multitheftauto.com/ found here.]
* Keep your resources up-to-date, you can [https://github.com/multitheftauto/mtasa-resources download latest (default) resources from GitHub repository.] Those often contain latest security fixes, which could mean difference between having your server resist from attack or not.
* Make sure to properly configure [https://wiki.multitheftauto.com/wiki/Access%20Control%20List ACL (Access Control List)] - which will block resources from using certain, potentially dangerous functions.
* Zero-trust with giving away admin rights for resources (including maps) coming from unknown sources.
* Before running any resource you don't trust, analyze:
** [https://wiki.multitheftauto.com/wiki/Meta.xml meta.xml] of it, for possible hidden scripts lurking beneath other file extensions.
** It's source code, for malicious logic.
* Do not run/keep using compiled resources (scripts) of which legitimacy you aren't sure.

'''To ensure minimum damage when a cheater connects to your server:'''
* When making scripts, remember to never trust data coming from a client.
* While reviewing scripts for possible security holes. Look at any data coming from the client that is being trusted.
* Any kind of data could be sent, hence server scripts which communicate with client by receiving data sent by players should validate it, before further use in latter parts of code. Mostly, it will be done either by [[setElementData]] or [[triggerServerEvent]].
* You shouldn't rely only on player [https://wiki.multitheftauto.com/wiki/Serial serial], when it comes to processing crucial operations (auto-login/admin actions). '''Serials aren't guaranted to be unique or non-fakable'''. This is why you should '''put it behind''' account system, as '''important authentication factor''' (e.g: '''login & password''').
* Server-side logic '''can not be bypassed''' or '''tampered''' with (unless server is breached or when there is a bug in code, but that's whole different scenario) - '''use it to your advantage'''. In majority of cases, you will be able to perform security validations with no participation of client-side.
* Using concept of '''''“All parameters including source can be faked and should not be trusted. Global variable client can be trusted.”''''' - gives you reliable assurance that player to which you refer (via '''client''') '''is''' in fact, '''the one which really called event'''. This approach will protect you from situations where cheater can call (and process) admin events (e.g kick/ban player) by passing the actual admin ('''2nd''' argument in '''[[triggerServerEvent]]''') - as a consequence of using wrong variable. To make sure you fully understood it, take a look at examples below:

<syntaxhighlight lang="lua">
--[[
DON'T EVER DO THAT - THAT IS COMPLETELY WRONG AND INSECURE
THE ISSUE: BY USING 'source' IN hasObjectPermissionTo YOU ARE LEAVING DOOR STRAIGHT OPEN FOR CHEATERS
]]

function onServerWrongAdminEvent(playerToBan)
if (not client) then -- 'client' points to the player who triggered the event, and should be used as security measure (in order to prevent player faking)
return false -- if this variable doesn't exists at the moment (for unknown reason, or it was the server who triggered this event), stop code execution
end

local defaultPermission = false -- do not allow action by default, see (defaultPermission): https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo
local canAdminBanPlayer = hasObjectPermissionTo(source, "function.banPlayer", defaultPermission) -- the vulnerability lies here...

if (not canAdminBanPlayer) then -- if player doesn't have permissions
return false -- don't do it
end

local validElement = isElement(playerToBan) -- check whether argument passed from client is an element

if (not validElement) then -- it is not
return false -- stop code processing
end

local elementType = getElementType(playerToBan) -- it's an element, so get it's type
local playerType = (elementType == "player") -- make sure that it's a player

if (not playerType) then -- it's not a player
return false -- stop here
end

-- banPlayer(...) -- do what needs to be done
end
addEvent("onServerWrongAdminEvent", true)
addEventHandler("onServerWrongAdminEvent", root, onServerWrongAdminEvent)

--[[
onServerCorrectAdminEvent IS PERFECTLY SECURED, AS IT SHOULD BE
NO ISSUE HERE: WE'VE USED 'client' IN hasObjectPermissionTo WHICH MAKES IT SAFE FROM FAKING PLAYER WHO CALLED EVENT
]]

function onServerCorrectAdminEvent(playerToBan)
if (not client) then -- 'client' points to the player who triggered the event, and should be used as security measure (in order to prevent player faking)
return false -- if this variable doesn't exists at the moment (for unknown reason, or it was the server who triggered this event), stop code execution
end

local defaultPermission = false -- do not allow action by default, see (defaultPermission): https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo
local canAdminBanPlayer = hasObjectPermissionTo(client, "function.banPlayer", defaultPermission) -- is player allowed to do that?

if (not canAdminBanPlayer) then -- if player doesn't have permissions
return false -- don't do it
end

local validElement = isElement(playerToBan) -- check whether argument passed from client is an element

if (not validElement) then -- it is not
return false -- stop code processing
end

local elementType = getElementType(playerToBan) -- it's an element, so get it's type
local playerType = (elementType == "player") -- make sure that it's a player

if (not playerType) then -- it's not a player
return false -- stop here
end

-- banPlayer(...) -- do what needs to be done
end
addEvent("onServerCorrectAdminEvent", true)
addEventHandler("onServerCorrectAdminEvent", root, onServerCorrectAdminEvent)
</syntaxhighlight>

==Securing setElementData==

* Don't use setElementData, send to client only necessary data using triggerClientEvent only when needed.
* All parameters including '''source''' can be faked and should not be trusted.
* Global variable '''client''' can be trusted.

----------
<section name="Server" class="server" show="true">
Example of basic element data anti-cheat.
<syntaxhighlight lang="lua">
local function reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue) -- helper function to log and revert changes
local logClient = inspect(clientElement) -- in-depth view of player which forced element data sync
local logSerial = getPlayerSerial(clientElement) or "N/A" -- client serial, or "N/A" if not possible, for some reason
local logSource = tostring(sourceElement) -- element which received data
local logOldValue = tostring(oldValue) -- old value
local logNewValue = tostring(newValue) -- new value
local logText = -- fill our report with data
"=======================================\n"..
"Detected element data abnormality:\n"..
"Client: "..logClient.."\n"..
"Client serial: "..logSerial.."\n"..
"Source: "..logSource.."\n"..
"Data key: "..dataKey.."\n"..
"Old data value: "..logOldValue.."\n"..
"New data value: "..logNewValue.."\n"..
"======================================="

local logVisibleTo = root -- specify who will see this log in console, in this case each player connected to server
local hadData = (oldValue ~= nil) -- check if element had such data before

if (hadData) then -- if element had such data before
setElementData(sourceElement, dataKey, oldValue) -- revert changes, it will call onElementDataChange event, but will fail (stop) on first condition - because server (not client) forced change
else
removeElementData(sourceElement, dataKey) -- remove it completely
end

outputConsole(logText, logVisibleTo) -- print it to console

return true -- all success
end

function onElementDataChangeBasicAC(dataKey, oldValue, newValue) -- the heart of our anti-cheat, which does all the magic security measurements
if (not client) then -- check if data is coming from client
return false -- if it's not, do not go further
end

local checkSpecialThing = (dataKey == "special_thing") -- compare whether dataKey matches "special_thing"
local checkFlagWaving = (dataKey == "flag_waving") -- compare whether dataKey matches "flag_waving"

if (checkSpecialThing) then -- if it does, do our security checks
local invalidElement = (client ~= source) -- verify whether source element is different from player which changed data

if (invalidElement) then -- if it's so
reportAndRevertDataChange(client, source, dataKey, oldValue, newValue) -- revert data change, because "special_thing" can only be set for player himself
end
end

if (checkFlagWaving) then -- if it does, do our security checks
local playerVehicle = getPedOccupiedVehicle(client) -- get player's current vehicle
local invalidVehicle = (playerVehicle ~= source) -- verify whether source element is different from player's vehicle

if (invalidVehicle) then -- if it's so
reportAndRevertDataChange(client, source, dataKey, oldValue, newValue) -- revert data change, because "flag_waving" can only be set for player's own vehicle
end
end
end
addEventHandler("onElementDataChange", root, onElementDataChangeBasicAC)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
Example of comfortable advanced element data anti-cheat.
<syntaxhighlight lang="lua">
--[[
For maximum security set punishPlayerOnDetect, punishmentBan, allowOnlyProtectedKeys to true (as per default configuration)
If allowOnlyProtectedKeys is enabled, do not forget to add every client-side element data key to protectedKeys table - otherwise you will face false-positives

Anti-cheat (handleDataChange) table structure and it's options:

["keyName"] = { -- name of key which would be protected
onlyForPlayerHimself = true, -- enabling this (true) will make sure that this element data key can only be set on player who synced it (ignores onlyForOwnPlayerVeh and allowForElements), use false/nil to disable this
onlyForOwnPlayerVeh = false, -- enabling this (true) will make sure that this element data key can only be set on player's current vehicle who synced it (ignores allowForElements), use false/nil to disable this
allowForElements = { -- restrict this key for certain element type(s), set to false/nil or leave it empty to not check this (full list of element types: https://wiki.multitheftauto.com/wiki/GetElementsByType)
["player"] = true,
["ped"] = true,
["vehicle"] = true,
["object"] = true,
},
allowedDataTypes = { -- restrict this key for certain value type(s), set to false/nil or leave it empty to not check this
["string"] = true,
["number"] = true,
["table"] = true,
["boolean"] = true,
["nil"] = true,
},
allowedStringLength = {1, 32}, -- if value is a string, then it's length must be in between (min-max), set it to false/nil to not check string length - do note that allowedDataTypes must contain ["string"] = true
allowedTableLength = {1, 64}, -- if value is a table, then it's length must be in between (min-max), set it to false/nil to not check table length - do note that allowedDataTypes must contain ["table"] = true
allowedNumberRange = {1, 128}, -- if value is a number, then it must be in between (min-max), set it to false/nil to not check number range - do note that allowedDataTypes must contain ["number"] = true
}
]]

local punishPlayerOnDetect = true -- should player be punished upon detection (make sure that resource which runs this code has admin rights)
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick
local punishmentReason = "Altering element data" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent
local allowOnlyProtectedKeys = true -- disallow (remove by using removeElementData, if it didn't existed before) every element data besides those given in protectedKeys table; in case someone wanted to flood server with garbage keys, which would be kept in memory until server restart or manual remove - setElementData(source, key, nil) won't remove it; it has to be removeElementData
local debugLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors
local debugR = 255 -- debug message - red color
local debugG = 127 -- debug message - green color
local debugB = 0 -- debug message - blue color
local protectedKeys = {
["vehicleNumber"] = { -- we want vehicleNumber to be set only on vehicles, with stricte numbers in range of 1-100
allowForElements = {
["vehicle"] = true,
},
allowedDataTypes = {
["number"] = true,
},
allowedNumberRange = {1, 100},
},
["personalVehData"] = { -- we want be able to set personalVehData only on current vehicle, also it should be a string with length between 1-24
onlyForOwnPlayerVeh = true,
allowedDataTypes = {
["string"] = true,
},
allowedStringLength = {1, 24},
},
-- perform security checks on keys stored in this table, in a convenient way
}

local function reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- helper function to log and revert changes
local logClient = inspect(clientElement) -- in-depth view of player which forced element data sync
local logSerial = getPlayerSerial(clientElement) or "N/A" -- client serial, or "N/A" if not possible, for some reason
local logSource = inspect(sourceElement) -- in-depth view of element which received data
local logOldValue = inspect(oldValue) -- in-depth view of old value
local logNewValue = inspect(newValue) -- in-depth view of new value
local logText = -- fill our report with data
"*\n"..
"Detected element data abnormality:\n"..
"Client: "..logClient.."\n"..
"Client serial: "..logSerial.."\n"..
"Source: "..logSource.."\n"..
"Data key: "..dataKey.."\n"..
"Old data value: "..logOldValue.."\n"..
"New data value: "..logNewValue.."\n"..
"Fail reason: "..failReason.."\n"..
"*"

outputDebugString(logText, debugLevel, debugR, debugG, debugB) -- print it to debug

if (forceRemove) then -- we don't want this element data key to exist at all
removeElementData(sourceElement, dataKey) -- remove it

return true -- return success and stop here, we don't need further checks
end

setElementData(sourceElement, dataKey, oldValue) -- revert changes, it will call onElementDataChange event, but will fail (stop) on first condition - because server (not client) forced change

return true -- return success
end

local function handleDataChange(clientElement, sourceElement, dataKey, oldValue, newValue) -- the heart of our anti-cheat, which does all the magic security measurements, returns true if there was no altering from client (based on data from protectedKeys), false otherwise
local protectedKey = protectedKeys[dataKey] -- look up whether key changed is stored in protectedKeys table

if (not protectedKey) then -- if it's not

if (allowOnlyProtectedKeys) then -- if we don't want garbage keys
local failReason = "Key isn't present in protectedKeys" -- reason shown in report
local forceRemove = true -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end

return true -- this key isn't protected, let it through
end

local onlyForPlayerHimself = protectedKey.onlyForPlayerHimself -- if key has "self-set" lock
local onlyForOwnPlayerVeh = protectedKey.onlyForOwnPlayerVeh -- if key has "self-vehicle" lock
local allowForElements = protectedKey.allowForElements -- if key has element type check
local allowedDataTypes = protectedKey.allowedDataTypes -- if key has allowed data type check

if (onlyForPlayerHimself) then -- if "self-set" lock is active
local matchingElement = (clientElement == sourceElement) -- verify whether player who set data is equal to element which received data

if (not matchingElement) then -- if it's not matching
local failReason = "Can only set on player himself" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end

if (onlyForOwnPlayerVeh) then -- if "self-vehicle" lock is active
local playerVehicle = getPedOccupiedVehicle(clientElement) -- get current vehicle of player which set data
local matchingVehicle = (playerVehicle == sourceElement) -- check whether it matches the one which received data

if (not matchingVehicle) then -- if it doesn't match
local failReason = "Can only set on player's own vehicle" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end

if (allowForElements) then -- check if it's one of them
local elementType = getElementType(sourceElement) -- get type of element whose data changed
local matchingElementType = allowForElements[elementType] -- verify whether it's allowed

if (not matchingElementType) then -- this isn't matching
local failReason = "Invalid element type" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end

if (allowedDataTypes) then -- if there's allowed data types
local valueType = type(newValue) -- get data type of value
local matchingType = allowedDataTypes[valueType] -- check if it's one of allowed

if (not matchingType) then -- if it's not then
local failReason = "Invalid data type" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end

local allowedStringLength = protectedKey.allowedStringLength -- if key has specified string length check
local dataString = (valueType == "string") -- make sure it's a string

if (allowedStringLength and dataString) then -- if we should check string length
local minLength = allowedStringLength[1] -- retrieve min length
local maxLength = allowedStringLength[2] -- retrieve max length
local stringLength = utf8.len(newValue) -- get length of data string
local matchingLength = (stringLength >= minLength) and (stringLength <= maxLength) -- compare whether value fits in between

if (not matchingLength) then -- if it doesn't
local failReason = "Invalid string length (must be between "..minLength.."-"..maxLength..")" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end

local allowedTableLength = protectedKey.allowedTableLength -- if key has table length check
local dataTable = (valueType == "table") -- make sure it's a table

if (allowedTableLength and dataTable) then -- if we should check table length
local minLength = allowedTableLength[1] -- retrieve min length
local maxLength = allowedTableLength[2] -- retrieve max length
local minLengthAchieved = false -- variable which checks 'does minimum length was achieved'
local maxLengthExceeded = false -- variable which checks 'does length has exceeds more than allowed maximum'
local tableLength = 0 -- store initial table length

for _, _ in pairs(newValue) do -- loop through whole table
tableLength = (tableLength + 1) -- add + 1 on each table entry
minLengthAchieved = (tableLength >= minLength) -- is length bigger or at very minimum we require
maxLengthExceeded = (tableLength > maxLength) -- does table exceeded more than max length?

if (maxLengthExceeded) then -- it is bigger than it should be
break -- break the loop (due of condition above being worthy, it makes no point to count further and waste CPU, on a table which potentially could have huge amount of entries)
end
end

local matchingLength = (minLengthAchieved and not maxLengthExceeded) -- check if min length has been achieved, and make sure that it doesn't go beyond max length

if (not matchingLength) then -- this table doesn't match requirements
local failReason = "Invalid table length (must be between "..minLength.."-"..maxLength..")" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end

local allowedNumberRange = protectedKey.allowedNumberRange -- if key has allowed number range check
local dataNumber = (valueType == "number") -- make sure it's a number

if (allowedNumberRange and dataNumber) then -- if we should check number range
local minRange = allowedNumberRange[1] -- retrieve min number range
local maxRange = allowedNumberRange[2] -- retrieve max number range
local matchingRange = (newValue >= minRange) and (newValue <= maxRange) -- compare whether value fits in between

if (not matchingRange) then -- if it doesn't
local failReason = "Invalid number range (must be between "..minRange.."-"..maxRange..")" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end
end

return true -- security checks passed, we are all clear with this data key
end

function onElementDataChangeAdvancedAC(dataKey, oldValue, newValue) -- this event makes use of handleDataChange, the code was split for better readability
if (not client) then -- check if data is coming from client
return false -- if it's not, do not continue
end

local approvedChange = handleDataChange(client, source, dataKey, oldValue, newValue) -- run our security checks

if (approvedChange) then -- it's all cool and good
return false -- we don't need further action
end

if (not punishPlayerOnDetect) then -- we don't want to punish player for some reason
return false -- so stop here
end

if (punishmentBan) then -- if it's ban
banPlayer(client, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server
else -- otherwise
kickPlayer(client, punishedBy, punishmentReason) -- simply kick player out of server
end
end
addEventHandler("onElementDataChange", root, onElementDataChangeAdvancedAC)
</syntaxhighlight>
</section>

==Securing triggerServerEvent==

* All parameters including '''source''' can be faked and should not be trusted.
* Global variable '''client''' can be trusted.
* '''Admin''' styled '''events''' should be verifying player (client) '''ACL rights''', either by [https://wiki.multitheftauto.com/wiki/IsObjectInACLGroup isObjectInACLGroup] or [https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo hasObjectPermissionTo].

----------
<section name="Server" class="server" show="true">
Example of comfortable anti-cheat function designed for events, used for data validation for both normal, and admin events which are called from client-side.
<syntaxhighlight lang="lua">
--[[
For maximum security set punishPlayerOnDetect, punishmentBan to true (as per default configuration)

Anti-cheat (processServerEventData) table structure and it's options:

checkACLGroup = { -- check whether player who called event belongs to at least one group below, set to false/nil to not check this
"Admin",
},
checkPermissions = { -- check whether player who called event has permission to at least one thing below, set to false/nil to not check this
"function.kickPlayer",
},
checkEventData = {
{
debugData = "source", -- optional details for report shown in debug message
eventData = source, -- data we want to verify
equalTo = client, -- compare whether eventData == equalTo
allowedElements = { -- restrict eventData to be certain element type(s), set to false/nil or leave it empty to not check this (full list of element types: https://wiki.multitheftauto.com/wiki/GetElementsByType)
["player"] = true,
["ped"] = true,
["vehicle"] = true,
["object"] = true,
},
allowedDataTypes = { -- restrict eventData to be certain value type(s), set to false/nil or leave it empty to not check this
["string"] = true,
["number"] = true,
["table"] = true,
["boolean"] = true,
["nil"] = true,
},
allowedStringLength = {1, 32}, -- if eventData is a string, then it's length must be in between (min-max), set it to false/nil to not check string length - do note that allowedDataTypes must contain ["string"] = true
allowedTableLength = {1, 64}, -- if eventData is a table, then it's length must be in between (min-max), set it to false/nil to not check table length - do note that allowedDataTypes must contain ["table"] = true
allowedNumberRange = {1, 128}, -- if eventData is a number, then it must be in between (min-max), set it to false/nil to not check number range - do note that allowedDataTypes must contain ["number"] = true
},
},
]]

local punishPlayerOnDetect = true -- should player be punished upon detection (make sure that resource which runs this code has admin rights)
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick
local punishmentReason = "Altering server event data" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent
local debugLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors
local debugR = 255 -- debug message - red color
local debugG = 127 -- debug message - green color
local debugB = 0 -- debug message - blue color

function processServerEventData(clientElement, sourceElement, serverEvent, securityChecks) -- the heart of our anti-cheat, which does all the magic security measurements, returns true if there was no altering from client (based on data from securityChecks), false otherwise
if (not securityChecks) then -- if we haven't passed any security checks
return true -- nothing to check, let code go further
end

if (not clientElement) then -- if client variable isn't available for some reason (although it should never happen)
local failReason = "Client variable not present" -- reason shown in report
local skipPunishment = true -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

local checkACLGroup = securityChecks.checkACLGroup -- if there's any ACL groups to check
local checkPermissions = securityChecks.checkPermissions -- if there's any permissions to check
local checkEventData = securityChecks.checkEventData -- if there's any data checks

if (checkACLGroup) then -- let's check player ACL groups
local playerAccount = getPlayerAccount(clientElement) -- get current account of player
local guestAccount = isGuestAccount(playerAccount) -- if account is guest (meaning player is not logged in)

if (guestAccount) then -- it's the case
local failReason = "Can't retrieve player login - guest account" -- reason shown in report
local skipPunishment = true -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

local accountName = getAccountName(playerAccount) -- get name of player's current account
local aclString = "user."..accountName -- format it for further use in isObjectInACLGroup function

for groupID = 1, #checkACLGroup do -- iterate over table of given groups
local groupName = checkACLGroup[groupID] -- get each group name
local aclGroup = aclGetGroup(groupName) -- check if such group exists

if (not aclGroup) then -- it doesn't
local failReason = "ACL group '"..groupName.."' is missing" -- reason shown in report
local skipPunishment = true -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

local playerInACLGroup = isObjectInACLGroup(aclString, aclGroup) -- check if player belong to the group

if (playerInACLGroup) then -- yep, it's the case
return true -- so it's a success
end
end

local failReason = "Player doesn't belong to any given ACL group" -- reason shown in report
local skipPunishment = true -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

if (checkPermissions) then -- check if player has at least one desired permission
local allowedByDefault = false -- does he have access by default

for permissionID = 1, #checkPermissions do -- iterate over all permissions
local permissionName = checkPermissions[permissionID] -- get permission name
local hasPermission = hasObjectPermissionTo(clientElement, permissionName, allowedByDefault) -- check whether player is allowed to perform certain action

if (hasPermission) then -- if player has access
return true -- one is available (and enough), server won't bother to check others (as return keywords also breaks loop)
end
end

local failReason = "Not enough permissions" -- reason shown in report
local skipPunishment = true -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

if (checkEventData) then -- if there is some data to verify

for dataID = 1, #checkEventData do -- iterate over each of data
local dataToCheck = checkEventData[dataID] -- get each data set
local eventData = dataToCheck.eventData -- this is the one we'll be verifying
local equalTo = dataToCheck.equalTo -- we want to compare whether eventData == equalTo
local allowedElements = dataToCheck.allowedElements -- check whether is element, and whether belongs to certain element types
local allowedDataTypes = dataToCheck.allowedDataTypes -- do we restrict data to be certain type?
local debugData = dataToCheck.debugData -- additional helper data
local debugText = debugData and " ("..debugData..")" or "" -- if it's present, format it nicely

if (equalTo) then -- equal check exists
local matchingData = (eventData == equalTo) -- compare whether those two values are equal

if (not matchingData) then -- they aren't
local failReason = "Data isn't equal @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end
end

if (allowedElements) then -- we do check whether is an element, and belongs to at least one given in the list
local validElement = isElement(eventData) -- check if it's actual element

if (not validElement) then -- it's not
local failReason = "Data isn't element @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

local elementType = getElementType(eventData) -- it's element, so we want to know it's type
local matchingElementType = allowedElements[elementType] -- verify whether it's allowed

if (not matchingElementType) then -- it's not allowed
local failReason = "Invalid element type @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end
end

if (allowedDataTypes) then -- let's check allowed data types
local dataType = type(eventData) -- get data type
local matchingType = allowedDataTypes[dataType] -- verify whether it's allowed

if (not matchingType) then -- it isn't
local failReason = "Invalid data type @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

local allowedStringLength = dataToCheck.allowedStringLength -- if data has string length check
local dataString = (dataType == "string") -- make sure it's a string

if (allowedStringLength and dataString) then -- if we should check string length
local minLength = allowedStringLength[1] -- retrieve min length
local maxLength = allowedStringLength[2] -- retrieve max length
local stringLength = utf8.len(eventData) -- get length of data string
local matchingLength = (stringLength >= minLength) and (stringLength <= maxLength) -- compare whether value fits in between

if (not matchingLength) then -- if it doesn't
local failReason = "Invalid string length (must be between "..minLength.."-"..maxLength..") @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end
end

local allowedTableLength = dataToCheck.allowedTableLength -- if data has table length check
local dataTable = (dataType == "table") -- make sure it's a table

if (allowedTableLength and dataTable) then -- if we should check table length
local minLength = allowedTableLength[1] -- retrieve min length
local maxLength = allowedTableLength[2] -- retrieve max length
local minLengthAchieved = false -- variable which checks 'does minimum length was achieved'
local maxLengthExceeded = false -- variable which checks 'does length has exceeds more than allowed maximum'
local tableLength = 0 -- store initial table length

for _, _ in pairs(eventData) do -- loop through whole table
tableLength = (tableLength + 1) -- add + 1 on each table entry
minLengthAchieved = (tableLength >= minLength) -- is length bigger or at very minimum we require
maxLengthExceeded = (tableLength > maxLength) -- does table exceeded more than max length?

if (maxLengthExceeded) then -- it is bigger than it should be
break -- break the loop (due of condition above being worthy, it makes no point to count further and waste CPU, on a table which potentially could have huge amount of entries)
end
end

local matchingLength = (minLengthAchieved and not maxLengthExceeded) -- check if min length has been achieved, and make sure that it doesn't go beyond max length

if (not matchingLength) then -- this table doesn't match requirements
local failReason = "Invalid table length (must be between "..minLength.."-"..maxLength..") @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end
end

local allowedNumberRange = dataToCheck.allowedNumberRange -- if data has number range check
local dataNumber = (dataType == "number") -- make sure it's a number

if (allowedNumberRange and dataNumber) then -- if we should check number range
local minRange = allowedNumberRange[1] -- retrieve min number range
local maxRange = allowedNumberRange[2] -- retrieve max number range
local matchingRange = (eventData >= minRange) and (eventData <= maxRange) -- compare whether value fits in between

if (not matchingRange) then -- if it doesn't
local failReason = "Invalid number range (must be between "..minRange.."-"..maxRange..") @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end
end
end
end
end

return true -- security checks passed, we are all clear with this event call
end

function reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- helper function to log and handle accidents
local logClient = inspect(clientElement) -- in-depth view player which called event
local logSerial = getPlayerSerial(clientElement) or "N/A" -- client serial, or "N/A" if not possible, for some reason
local logSource = inspect(sourceElement) -- in-depth view of source element
local logText = -- fill our report with data
"*\n"..
"Detected event abnormality:\n"..
"Client: "..logClient.."\n"..
"Client serial: "..logSerial.."\n"..
"Source: "..logSource.."\n"..
"Event: "..serverEvent.."\n"..
"Reason: "..failReason.."\n"..
"*"

outputDebugString(logText, debugLevel, debugR, debugG, debugB) -- print it to debug

if (not punishPlayerOnDetect or skipPunishment) then -- we don't want to punish player for some reason
return true -- stop here
end

if (punishmentBan) then -- if it's ban
banPlayer(clientElement, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server
else -- otherwise
kickPlayer(clientElement, punishedBy, punishmentReason) -- simply kick player out of server
end

return true -- all done, report success
end

function onServerEvent(clientData)
--[[
Assume this server event (function) is called in such way:

local dataToPass = 10

triggerServerEvent("onServerEvent", localPlayer, dataToPass)
]]

local shouldProcessServerCode = processServerEventData(
client, -- client element - responsible for calling event
source, -- source element - passed in triggerServerEvent (as 2nd argument)
eventName, -- name of event - in this case 'onServerEvent'
{
checkEventData = { -- we want to verify everything what comes from client
{
eventData = source, -- first to check, source variable
equalTo = client, -- we want to check whether it matches player who called event
debugData = "source", -- helper details which would be shown in report
},
{
eventData = clientData, -- let's check the data which client sent to us
allowedDataTypes = {
["number"] = true, -- we want it to be only number
},
allowedNumberRange = {1, 100}, -- in range of 1 to 100
debugData = "clientData", -- if something goes wrong, let server know where (it will appear in debug report)
},
},
}
)

if (not shouldProcessServerCode) then -- something isn't right, no green light for processing code behind this scope
return false -- stop code execution
end

-- do code as usual
end
addEvent("onServerEvent", true)
addEventHandler("onServerEvent", root, onServerEvent)

function onServerAdminEvent(playerToBan)
--[[
Assume this server admin event (function) is called in such way:

local playerToBan = getPlayerFromName("playerToBan")

triggerServerEvent("onServerAdminEvent", localPlayer, playerToBan)
]]

local shouldProcessServerCode = processServerEventData(
client, -- client element - responsible for calling event
source, -- source element - passed in triggerServerEvent (as 2nd argument)
eventName, -- name of event - in this case 'onServerAdminEvent'
{
checkACLGroup = { -- we need to check whether player who called event belongs to ACL groups
"Admin", -- in this case admin group
},
checkEventData = { -- we want to verify everything what comes from client
{
eventData = source, -- first to check, source variable
equalTo = client, -- we want to check whether it matches player who called event
debugData = "source", -- helper details which would be shown in report
},
{
eventData = playerToBan, -- let's check the data which client sent to us
allowedDataTypes = {
["player"] = true, -- we want it to be player
},
debugData = "playerToBan", -- if something goes wrong, let server know where (it will appear in debug report)
},
},
}
)

if (not shouldProcessServerCode) then -- something isn't right, no green light for processing code behind this scope
return false -- stop code execution
end

-- do code as usual
end
addEvent("onServerAdminEvent", true)
addEventHandler("onServerAdminEvent", root, onServerAdminEvent)
</syntaxhighlight>
</section>

==Securing server-only events==
* It is very important to '''disable remote triggering''' ability in [https://wiki.multitheftauto.com/wiki/AddEvent addEvent], to prevent calling server-side only events from client-side.
* '''Admin''' styled '''events''' should be verifying player '''ACL rights''', either by [https://wiki.multitheftauto.com/wiki/IsObjectInACLGroup isObjectInACLGroup] or [https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo hasObjectPermissionTo].

----------
<section name="Server" class="server" show="true">
This example shows how you should make event server-side only.
<syntaxhighlight lang="lua">
function onServerSideOnlyEvent()
-- do some server-side stuff
end
addEvent("onServerSideOnlyEvent", false) -- set second argument (allowRemoteTriger) to false, so it can't be called from client
addEventHandler("onServerSideOnlyEvent", root, onServerSideOnlyEvent) -- associate our event with function onServerSideOnlyEvent
</syntaxhighlight>
</section>

==Securing projectiles & explosions==
This section (and '''code''' is '''work in progress''') - '''use at your own risk'''.

----------
<section name="Server" class="server" show="false">
Projectile ammo tracker:
<syntaxhighlight lang="lua">
local playerProjectileAmmo = {} -- store player-held weapons ammo here
local playerWeaponsToTrack = { -- keep track of ammo for certain player-held weapon types, basically those which create projectile; [weaponID] = weaponSlot
[16] = 8, -- grenade
[17] = 8, -- teargas
[18] = 8, -- molotov
[35] = 7, -- rocket launcher
[36] = 7, -- rocket launcher (heat-seeking)
[39] = 8, -- satchel charge
}

local function updateProjectileAmmoForPlayer(playerElement)
local validElement = isElement(playerElement)

if (not validElement) then
return false
end

local playerDead = isPedDead(playerElement)

if (playerDead) then
return false
end

for weaponID, weaponSlot in pairs(playerWeaponsToTrack) do
local weaponInSlot = getPedWeapon(playerElement, weaponSlot)
local weaponTotalAmmo = getPedTotalAmmo(playerElement, weaponSlot)
local weaponHasAmmo = (weaponTotalAmmo > 0)
local weaponMatching = (weaponInSlot == weaponID)
local updateWeaponAmmo = (weaponMatching and weaponHasAmmo)

if (updateWeaponAmmo) then
local storedProjectileAmmo = playerProjectileAmmo[playerElement]
local newWeaponAmmo = (updateWeaponAmmo and weaponTotalAmmo or nil)

if (not storedProjectileAmmo) then
playerProjectileAmmo[playerElement] = {}
storedProjectileAmmo = playerProjectileAmmo[playerElement]
end

storedProjectileAmmo[weaponID] = newWeaponAmmo
end
end

return true
end

function hasPlayerProjectileAmmo(playerElement, projectileWeapon)
local validElement = isElement(playerElement)

if (not validElement) then
return false
end

local playerDead = isPedDead(playerElement)

if (playerDead) then
return false
end

local projectileData = playerProjectileAmmo[playerElement]
local projectileAmmo = (projectileData and projectileData[projectileWeapon])

return projectileAmmo
end

function decreasePlayerProjectileAmmo(playerElement, projectileWeapon)
local validElement = isElement(playerElement)

if (not validElement) then
return false
end

local playerDead = isPedDead(playerElement)

if (playerDead) then
return false
end

local playerProjectileData = playerProjectileAmmo[playerElement]

if (not playerProjectileData) then
return false
end

local projectileWeaponAmmo = playerProjectileData[projectileWeapon]
local tempProjectileAmmo = (projectileWeaponAmmo - 1)
local newProjectileAmmo = (tempProjectileAmmo > 0 and tempProjectileAmmo or nil)

playerProjectileData[projectileWeapon] = newProjectileAmmo

return true
end

function onPlayerWeaponSwitchAntiCheat(previousWeaponID, currentWeaponID)
setTimer(updateProjectileAmmoForPlayer, 50, 1, source)
end
addEventHandler("onPlayerWeaponSwitch", root, onPlayerWeaponSwitchAntiCheat)

function onResourceStartAntiCheat()
local playersTable = getElementsByType("player")

for playerID = 1, #playersTable do
local playerElement = playersTable[playerID]

updateProjectileAmmoForPlayer(playerElement)
end
end
addEventHandler("onResourceStart", resourceRoot, onResourceStartAntiCheat)

function onPlayerWastedQuitAntiCheat()
playerProjectileAmmo[source] = nil
end
addEventHandler("onPlayerWasted", root, onPlayerWastedQuitAntiCheat)
addEventHandler("onPlayerQuit", root, onPlayerWastedQuitAntiCheat)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="false">
Projectile handler:
<syntaxhighlight lang="lua">
local playerCreatedProjectiles = {} -- store count of legitimately created player projectiles; [playerElement] = {[projectileType] = activeProjectiles}
local projectileTypes = {
[16] = { -- Grenade
projectileAllowed = true,
projectileMaxDistanceFromCreator = 2,
projectileAllowedWeapons = {
[16] = true, -- grenade
},
},
[17] = { -- Teargas
projectileAllowed = true,
projectileMaxDistanceFromCreator = 2,
projectileAllowedWeapons = {
[17] = true, -- teargas
},
},
[18] = { -- Molotov
projectileAllowed = true,
projectileMaxDistanceFromCreator = 2,
projectileAllowedWeapons = {
[18] = true, -- molotov
},
},
[19] = { -- Rocket
projectileAllowed = true,
projectileMaxDistanceFromCreator = 5,
projectileMaxVelocity = 2,
projectileAllowedWeapons = {
[35] = true, -- rocket launcher
},
projectileAllowedVehicles = {
[425] = true, -- hunter
[520] = true, -- hydra
},
},
[20] = { -- Rocket (heat-seeking)
projectileAllowed = true,
projectileMaxDistanceFromCreator = 5,
projectileMaxVelocity = 2,
projectileAllowedWeapons = {
[36] = true, -- rocket launcher (heat-seeking)
},
projectileAllowedVehicles = {
[520] = true, -- hydra
},
},
[21] = { -- Airbomb
projectileAllowed = true,
projectileAllowedVehicles = {
[520] = true, -- hydra
},
},
[39] = { -- Satchel charge
projectileAllowed = true,
projectileMaxDistanceFromCreator = 2,
projectileAllowedWeapons = {
[39] = true, -- satchel charge
},
},
[58] = { -- Hydra flare
projectileAllowed = true,
projectileMaxDistanceFromCreator = 5,
projectileAllowedVehicles = {
[520] = true, -- hydra
},
},
}

local reportAbnormality = true -- whether to report about abnormality in debug script - by default
local punishPlayerOnDetect = false -- should player be punished upon detection; true - yes, or false to not do anything (make sure that resource which runs this code has admin rights)
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick
local punishmentReason = "Projectile/explosion anti-cheat" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent
local debugMsgLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors
local debugMsgR = 255 -- debug message - red color
local debugMsgG = 127 -- debug message - green color
local debugMsgB = 0 -- debug message - blue color

local function reportProjectileAbnormality(playerElement, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ, detectionCode)
local projectileSyncer = inspect(playerElement)
local projectilePosition = (projectileX..", "..projectileY..", "..projectileZ)
local projectileZoneName = getZoneName(projectileX, projectileY, projectileZ, false)
local projectileCityName = getZoneName(projectileX, projectileY, projectileZ, true)
local projectileLog =
"* Detected projectile abnormality - "..detectionCode.." *\n"..
"Projectile syncer: "..projectileSyncer.."\n"..
"Projectile type: "..projectileType.."\n"..
"Projectile position: "..projectilePosition.. " ("..projectileZoneName..", "..projectileCityName..")\n"

outputDebugString(projectileLog, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)

return true
end

local function processProjectileChecks(playerElement, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)
local projectileData = projectileTypes[projectileType]
local projectileAllowed = projectileData.projectileAllowed

if (not projectileAllowed) then
return false, "Projectile not allowed"
end

local projectileAllowedWeapons = projectileData.projectileAllowedWeapons

if (projectileAllowedWeapons) then
local playerWeapon = getPedWeapon(playerElement)
local allowedWeapon = projectileAllowedWeapons[playerWeapon]

if (not allowedWeapon) then
return false, "Player is not holding correct weapon"
end

local weaponAmmo = hasPlayerProjectileAmmo(playerElement, playerWeapon)
local playerHasAmmo = (weaponAmmo > 0)

if (not playerHasAmmo) then
return false, "Player doesn't have ammo for weapon"
end

decreasePlayerProjectileAmmo(playerElement, playerWeapon)
end

local playerVehicle = getPedOccupiedVehicle(playerElement)

if (playerVehicle) then
local projectileAllowedVehicles = projectileData.projectileAllowedVehicles

if (projectileAllowedVehicles) then
local vehicleModel = getElementModel(playerVehicle)
local allowedVehicle = projectileAllowedVehicles[vehicleModel]

if (not allowedVehicle) then
return false, "Player is not inside allowed vehicles"
end

local vehicleDriver = getVehicleController(playerVehicle)
local playerDriver = (playerElement == vehicleDriver)

if (not playerDriver) then
return false, "Player is not vehicle driver"
end

return true
end

return false, "Player in vehicle"
end

local projectileMaxDistanceFromCreator = projectileData.projectileMaxDistanceFromCreator

if (projectileMaxDistanceFromCreator) then
local playerX, playerY, playerZ = getElementPosition(playerElement)
local distanceToProjectile = getDistanceBetweenPoints3D(playerX, playerY, playerZ, projectileX, projectileY, projectileZ)
local matchingProjectileDistance = (distanceToProjectile <= projectileMaxDistanceFromCreator)

if (not matchingProjectileDistance) then
return false, "Projectile distance mismatch"
end
end

local projectileMaxVelocity = projectileData.projectileMaxVelocity

if (projectileMaxVelocity) then
local projectileVelocity = (projectileVX ^ 2 + projectileVY ^ 2 + projectileVZ ^ 2)
local projectileSpeed = math.sqrt(projectileVelocity)
local matchingProjectileVelocity = (projectileSpeed <= projectileMaxVelocity)

if (not matchingProjectileVelocity) then
return false, "Projectile velocity mismatch"
end
end

return true
end

local function trackPlayerProjectile(playerElement, projectileID)
local validElement = isElement(playerElement)

if (not validElement) then
return false
end

local playerProjectiles = playerCreatedProjectiles[playerElement]

if (not playerProjectiles) then
playerCreatedProjectiles[playerElement] = {}
playerProjectiles = playerCreatedProjectiles[playerElement]
end

local projectilesByType = playerProjectiles[projectileID] or 0
local newProjectilesCount = (projectilesByType + 1)

playerProjectiles[projectileID] = newProjectilesCount

return true
end

local function getProjectileDetectionOverwrittenBehavior(projectileType)
local projectileData = projectileTypes[projectileType]

if (not projectileData) then
return reportAbnormality, punishPlayerOnDetect, punishmentBan
end

local projectileBehaviour = projectileData.projectileOverwriteBehaviour

if (not projectileBehaviour) then
return reportAbnormality, punishPlayerOnDetect, punishmentBan
end

local overwriteReport = projectileBehaviour.reportAbnormality
local overwritePunish = projectileBehaviour.punishPlayerOnDetect
local overwriteBan = projectileBehaviour.punishmentBan

return overwriteReport, overwritePunish, overwriteBan
end

function decreasePlayerProjectiles(playerElement, projectileID)
local validElement = isElement(playerElement)

if (not validElement) then
return false
end

local playerProjectiles = playerCreatedProjectiles[playerElement]

if (not playerProjectiles) then
return false, true
end

local projectilesByType = playerProjectiles[projectileID]

if (not projectilesByType) then
return false, true
end

local tempProjectilesCount = (projectilesByType - 1)
local newProjectilesCount = (tempProjectilesCount > 0 and tempProjectilesCount or nil)

playerProjectiles[projectileID] = newProjectilesCount

return true
end

function onPlayerProjectileCreationAntiCheat(projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)
local approvedProjectile, detectionCode = processProjectileChecks(source, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)

if (approvedProjectile) then
trackPlayerProjectile(source, projectileType)

return true
end

local reportAbnormality, punishPlayerOnDetect, punishmentBan = getProjectileDetectionOverwrittenBehavior(projectileType)

if (reportAbnormality) then
reportProjectileAbnormality(source, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ, detectionCode)
end

cancelEvent()

if (not punishPlayerOnDetect) then -- we don't want to punish player for some reason
return false -- so stop here
end

if (punishmentBan) then -- if it's ban
banPlayer(source, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server
else -- otherwise
kickPlayer(source, punishedBy, punishmentReason) -- simply kick player out of server
end
end
addEventHandler("onPlayerProjectileCreation", root, onPlayerProjectileCreationAntiCheat)

function onPlayerQuitAntiCheat()
playerCreatedProjectiles[source] = nil
end
addEventHandler("onPlayerQuit", root, onPlayerQuitAntiCheat)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="false">
Explosions handler:
<syntaxhighlight lang="lua">
local rocketInstantExplosionDistanceThreshold = 1.55 -- distance below which only explosion will be created (and not rocket projectile, hence not calling onPlayerProjectileCreation); do not change it
local explosionTypes = { -- more specific info on explosion, and whether it is allowed
[0] = { -- Grenade
explosionAllowed = true,
explosionAllowedProjectiles = {
[16] = true, -- grenade
},
},
[1] = { -- Molotov
explosionAllowed = true,
explosionAllowedProjectiles = {
[18] = true, -- molotov
},
},
[2] = { -- Rocket
explosionAllowed = true,
explosionAllowedWeapons = {
[35] = true, -- rocket launcher
[36] = true, -- rocket launcher (heat-seeking)
},
explosionAllowedProjectiles = {
[19] = true, -- rocket
[20] = true, -- rocket (heat-seeking)
},
},
[3] = { -- Rocket weak
explosionAllowed = true,
explosionAllowedProjectiles = {
[19] = true, -- rocket
[20] = true, -- rocket (heat-seeking)
},
},
[4] = { -- Car
explosionAllowed = true,
},
[5] = { -- Car quick
explosionAllowed = true,
},
[6] = { -- Boat
explosionAllowed = true,
},
[7] = { -- Heli
explosionAllowed = true,
},
[8] = { -- Mine
explosionAllowed = true,
},
[9] = { -- Object
explosionAllowed = true,
},
[10] = { -- Tank grenade
explosionAllowed = true,
explosionMaxDistanceFromCreator = 80,
explosionAllowedVehicles = {
[432] = true,
}
},
[11] = { -- Small
explosionAllowed = true,
},
[12] = { -- Tiny
explosionAllowed = true,
},
}

local reportAbnormality = true -- whether to report about abnormality in debug script - by default
local punishPlayerOnDetect = false -- should player be punished upon detection; true - yes, or false to not do anything (make sure that resource which runs this code has admin rights)
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick
local punishmentReason = "Projectile/explosion anti-cheat" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent
local debugMsgLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors
local debugMsgR = 255 -- debug message - red color
local debugMsgG = 127 -- debug message - green color
local debugMsgB = 0 -- debug message - blue color

local function reportExplosionAbnormality(playerElement, explosionType, explosionX, explosionY, explosionZ, detectionCode)
local explosionSyncer = inspect(playerElement)
local explosionType = explosionType
local explosionPosition = (explosionX..", "..explosionY..", "..explosionZ)
local explosionZoneName = getZoneName(explosionX, explosionY, explosionZ, false)
local explosionCityName = getZoneName(explosionX, explosionY, explosionZ, true)
local explosionLog =
"* Detected explosion abnormality - "..detectionCode.." *\n"..
"Explosion syncer: "..explosionSyncer.."\n"..
"Explosion type: "..explosionType.."\n"..
"Explosion position: "..explosionPosition.. " ("..explosionZoneName..", "..explosionCityName..")\n"

outputDebugString(explosionLog, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)

return true
end

local function processExplosionChecks(playerElement, explosionType, explosionX, explosionY, explosionZ)
local explosionData = explosionTypes[explosionType]
local explosionAllowed = explosionData.explosionAllowed

if (not explosionAllowed) then
return false, "Explosion type not allowed"
end

local rocketExplosion = (explosionType == 2)

if (rocketExplosion) then
local playerX, playerY, playerZ = getElementPosition(playerElement)
local distanceToExplosion = getDistanceBetweenPoints3D(playerX, playerY, playerZ, explosionX, explosionY, explosionZ)
local instantExplosion = (distanceToExplosion < rocketInstantExplosionDistanceThreshold)

if (instantExplosion) then
local explosionAllowedWeapons = explosionData.explosionAllowedWeapons
local playerWeapon = getPedWeapon(playerElement)
local allowedWeapon = explosionAllowedWeapons[playerWeapon]

if (not allowedWeapon) then
return false, "Player is not holding rocket launcher"
end

local weaponAmmo = hasPlayerProjectileAmmo(playerElement, playerWeapon)
local playerHasAmmo = (weaponAmmo > 0)

if (not playerHasAmmo) then
return false, "Player doesn't have ammo for rocket launcher"
end

decreasePlayerProjectileAmmo(playerElement, playerWeapon)

return true
end
end

local explosionAllowedProjectiles = explosionData.explosionAllowedProjectiles

if (explosionAllowedProjectiles) then

for projectileID, _ in pairs(explosionAllowedProjectiles) do
local atleastOneProjectile = decreasePlayerProjectiles(playerElement, projectileID)

if (atleastOneProjectile) then
return true
end
end

return false, "Explosion created without respective projectile"
end

local explosionAllowedVehicles = explosionData.explosionAllowedVehicles

if (explosionAllowedVehicles) then
local playerVehicle = getPedOccupiedVehicle(playerElement)

if (not playerVehicle) then
return false, "Player is not in vehicle"
end

local vehicleModel = getElementModel(playerVehicle)
local allowedVehicle = explosionAllowedVehicles[vehicleModel]

if (not allowedVehicle) then
return false, "Player is inside not allowed vehicles"
end

local vehicleDriver = getVehicleController(playerVehicle)
local playerDriver = (playerElement == vehicleDriver)

if (not playerDriver) then
return false, "Player is not vehicle driver"
end
end

local explosionMaxDistanceFromCreator = explosionData.explosionMaxDistanceFromCreator

if (explosionMaxDistanceFromCreator) then
local playerX, playerY, playerZ = getElementPosition(playerElement)
local distanceToExplosion = getDistanceBetweenPoints3D(playerX, playerY, playerZ, explosionX, explosionY, explosionZ)
local matchingExplosionDistance = (distanceToExplosion < explosionMaxDistanceFromCreator)

if (not matchingExplosionDistance) then
return false, "Explosion distance mismatch"
end
end

return true
end

local function getExplosionDetectionOverwrittenBehavior(explosionType)
local explosionData = explosionTypes[explosionType]

if (not explosionData) then
return reportAbnormality, punishPlayerOnDetect, punishmentBan
end

local explosionBehaviour = explosionData.explosionOverwriteBehaviour

if (not explosionBehaviour) then
return reportAbnormality, punishPlayerOnDetect, punishmentBan
end

local overwriteReport = explosionBehaviour.reportAbnormality
local overwritePunish = explosionBehaviour.punishPlayerOnDetect
local overwriteBan = explosionBehaviour.punishmentBan

return overwriteReport, overwritePunish, overwriteBan
end

function onExplosionAntiCheat(explosionX, explosionY, explosionZ, explosionType)
local serverSyncExplosion = (source == root)

if (serverSyncExplosion) then
return true
end

local approvedExplosion, detectionCode = processExplosionChecks(source, explosionType, explosionX, explosionY, explosionZ)

if (approvedExplosion) then
return true
end

local reportAbnormality, punishPlayerOnDetect, punishmentBan = getExplosionDetectionOverwrittenBehavior(explosionType)

if (reportAbnormality) then
reportExplosionAbnormality(source, explosionType, explosionX, explosionY, explosionZ, detectionCode)
end

cancelEvent()

if (not punishPlayerOnDetect) then -- we don't want to punish player for some reason
return false -- so stop here
end

if (punishmentBan) then -- if it's ban
banPlayer(source, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server
else -- otherwise
kickPlayer(source, punishedBy, punishmentReason) -- simply kick player out of server
end
end
addEventHandler("onExplosion", root, onExplosionAntiCheat)
</syntaxhighlight>
</section>

==Handling non-registered events==

See: [[onPlayerTriggerInvalidEvent]]

==Handling events spam==
See: [[onPlayerTriggerEventThreshold]]

Script security

2024-05-31T18:58:52Z

CrosRoad95: /* Securing setElementData */

==Awareness of client memory==

Starting from very basics:
* You should be aware that everything you store on client-side is at risk, this includes Lua itself. Any confidential (and/or) important data could be accessed by malicious clients.
* To keep sensitive data (and/or) Lua logic safe - use server-side.
* Do note that scripts marked as '''shared''' act also as '''client code''', which means that everything above applies to them. For example defining:

<syntaxhighlight lang="xml">
<script src="script.lua" type="shared"/> 
</syntaxhighlight>

Is same as doing:

<syntaxhighlight lang="xml">
<script src="script.lua" type="client"/> 
<script src="script.lua" type="server"/> 
</syntaxhighlight>

==Additional protection layer==

In order to make things ''slightly harder*'' for those having bad intentions towards your server, you can make use of cache attribute (and/or [https://luac.mtasa.com/ Lua compile (also known as Luac) with extra obfuscation set to level '''3'''] - [https://wiki.multitheftauto.com/wiki/Lua_compilation_API API]) available in [https://wiki.multitheftauto.com/wiki/Meta.xml meta.xml], along with configuring MTA's built-in AC by toggling SD (Special detections), see: [https://wiki.multitheftauto.com/wiki/Anti-cheat_guide Anti-cheat guide].

<syntaxhighlight lang="xml">
<script src="shared.lua" type="shared" cache="false"/> 
<script src="client.lua" type="client" cache="false"/> 
</syntaxhighlight>

* ''Slightly harder'' '''but not impossible''' for some to obtain client code, yet does good job at keeping '''most''' people away from inspecting your .lua files - those looking for possible logic flaws (bugs) or missing/incorrect security based checks.
* Can be used on both '''client''' and '''shared''' script type (has no effect on server-sided Lua).
* It doesn't remove Lua files which were previously downloaded.

==Detecting and dealing with backdoors and cheats==
'''To ensure minimum (or no) damage resulting from Lua scripts:'''
* Keep your server up-to-date, you can [https://nightly.multitheftauto.com/ download latest server builds from MTA:SA nightly site.] Information on specific builds can be [https://buildinfo.multitheftauto.com/ found here.]
* Keep your resources up-to-date, you can [https://github.com/multitheftauto/mtasa-resources download latest (default) resources from GitHub repository.] Those often contain latest security fixes, which could mean difference between having your server resist from attack or not.
* Make sure to properly configure [https://wiki.multitheftauto.com/wiki/Access%20Control%20List ACL (Access Control List)] - which will block resources from using certain, potentially dangerous functions.
* Zero-trust with giving away admin rights for resources (including maps) coming from unknown sources.
* Before running any resource you don't trust, analyze:
** [https://wiki.multitheftauto.com/wiki/Meta.xml meta.xml] of it, for possible hidden scripts lurking beneath other file extensions.
** It's source code, for malicious logic.
* Do not run/keep using compiled resources (scripts) of which legitimacy you aren't sure.

'''To ensure minimum damage when a cheater connects to your server:'''
* When making scripts, remember to never trust data coming from a client.
* While reviewing scripts for possible security holes. Look at any data coming from the client that is being trusted.
* Any kind of data could be sent, hence server scripts which communicate with client by receiving data sent by players should validate it, before further use in latter parts of code. Mostly, it will be done either by [[setElementData]] or [[triggerServerEvent]].
* You shouldn't rely only on player [https://wiki.multitheftauto.com/wiki/Serial serial], when it comes to processing crucial operations (auto-login/admin actions). '''Serials aren't guaranted to be unique or non-fakable'''. This is why you should '''put it behind''' account system, as '''important authentication factor''' (e.g: '''login & password''').
* Server-side logic '''can not be bypassed''' or '''tampered''' with (unless server is breached or when there is a bug in code, but that's whole different scenario) - '''use it to your advantage'''. In majority of cases, you will be able to perform security validations with no participation of client-side.
* Using concept of '''''“All parameters including source can be faked and should not be trusted. Global variable client can be trusted.”''''' - gives you reliable assurance that player to which you refer (via '''client''') '''is''' in fact, '''the one which really called event'''. This approach will protect you from situations where cheater can call (and process) admin events (e.g kick/ban player) by passing the actual admin ('''2nd''' argument in '''[[triggerServerEvent]]''') - as a consequence of using wrong variable. To make sure you fully understood it, take a look at examples below:

<syntaxhighlight lang="lua">
--[[
DON'T EVER DO THAT - THAT IS COMPLETELY WRONG AND INSECURE
THE ISSUE: BY USING 'source' IN hasObjectPermissionTo YOU ARE LEAVING DOOR STRAIGHT OPEN FOR CHEATERS
]]

function onServerWrongAdminEvent(playerToBan)
if (not client) then -- 'client' points to the player who triggered the event, and should be used as security measure (in order to prevent player faking)
return false -- if this variable doesn't exists at the moment (for unknown reason, or it was the server who triggered this event), stop code execution
end

local defaultPermission = false -- do not allow action by default, see (defaultPermission): https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo
local canAdminBanPlayer = hasObjectPermissionTo(source, "function.banPlayer", defaultPermission) -- the vulnerability lies here...

if (not canAdminBanPlayer) then -- if player doesn't have permissions
return false -- don't do it
end

local validElement = isElement(playerToBan) -- check whether argument passed from client is an element

if (not validElement) then -- it is not
return false -- stop code processing
end

local elementType = getElementType(playerToBan) -- it's an element, so get it's type
local playerType = (elementType == "player") -- make sure that it's a player

if (not playerType) then -- it's not a player
return false -- stop here
end

-- banPlayer(...) -- do what needs to be done
end
addEvent("onServerWrongAdminEvent", true)
addEventHandler("onServerWrongAdminEvent", root, onServerWrongAdminEvent)

--[[
onServerCorrectAdminEvent IS PERFECTLY SECURED, AS IT SHOULD BE
NO ISSUE HERE: WE'VE USED 'client' IN hasObjectPermissionTo WHICH MAKES IT SAFE FROM FAKING PLAYER WHO CALLED EVENT
]]

function onServerCorrectAdminEvent(playerToBan)
if (not client) then -- 'client' points to the player who triggered the event, and should be used as security measure (in order to prevent player faking)
return false -- if this variable doesn't exists at the moment (for unknown reason, or it was the server who triggered this event), stop code execution
end

local defaultPermission = false -- do not allow action by default, see (defaultPermission): https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo
local canAdminBanPlayer = hasObjectPermissionTo(client, "function.banPlayer", defaultPermission) -- is player allowed to do that?

if (not canAdminBanPlayer) then -- if player doesn't have permissions
return false -- don't do it
end

local validElement = isElement(playerToBan) -- check whether argument passed from client is an element

if (not validElement) then -- it is not
return false -- stop code processing
end

local elementType = getElementType(playerToBan) -- it's an element, so get it's type
local playerType = (elementType == "player") -- make sure that it's a player

if (not playerType) then -- it's not a player
return false -- stop here
end

-- banPlayer(...) -- do what needs to be done
end
addEvent("onServerCorrectAdminEvent", true)
addEventHandler("onServerCorrectAdminEvent", root, onServerCorrectAdminEvent)
</syntaxhighlight>

==Securing setElementData==

* 1. Don't use setElementData, send to client only necessary data using triggerClientEvent only when needed.
* All parameters including '''source''' can be faked and should not be trusted.
* Global variable '''client''' can be trusted.

----------
<section name="Server" class="server" show="true">
Example of basic element data anti-cheat.
<syntaxhighlight lang="lua">
local function reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue) -- helper function to log and revert changes
local logClient = inspect(clientElement) -- in-depth view of player which forced element data sync
local logSerial = getPlayerSerial(clientElement) or "N/A" -- client serial, or "N/A" if not possible, for some reason
local logSource = tostring(sourceElement) -- element which received data
local logOldValue = tostring(oldValue) -- old value
local logNewValue = tostring(newValue) -- new value
local logText = -- fill our report with data
"=======================================\n"..
"Detected element data abnormality:\n"..
"Client: "..logClient.."\n"..
"Client serial: "..logSerial.."\n"..
"Source: "..logSource.."\n"..
"Data key: "..dataKey.."\n"..
"Old data value: "..logOldValue.."\n"..
"New data value: "..logNewValue.."\n"..
"======================================="

local logVisibleTo = root -- specify who will see this log in console, in this case each player connected to server
local hadData = (oldValue ~= nil) -- check if element had such data before

if (hadData) then -- if element had such data before
setElementData(sourceElement, dataKey, oldValue) -- revert changes, it will call onElementDataChange event, but will fail (stop) on first condition - because server (not client) forced change
else
removeElementData(sourceElement, dataKey) -- remove it completely
end

outputConsole(logText, logVisibleTo) -- print it to console

return true -- all success
end

function onElementDataChangeBasicAC(dataKey, oldValue, newValue) -- the heart of our anti-cheat, which does all the magic security measurements
if (not client) then -- check if data is coming from client
return false -- if it's not, do not go further
end

local checkSpecialThing = (dataKey == "special_thing") -- compare whether dataKey matches "special_thing"
local checkFlagWaving = (dataKey == "flag_waving") -- compare whether dataKey matches "flag_waving"

if (checkSpecialThing) then -- if it does, do our security checks
local invalidElement = (client ~= source) -- verify whether source element is different from player which changed data

if (invalidElement) then -- if it's so
reportAndRevertDataChange(client, source, dataKey, oldValue, newValue) -- revert data change, because "special_thing" can only be set for player himself
end
end

if (checkFlagWaving) then -- if it does, do our security checks
local playerVehicle = getPedOccupiedVehicle(client) -- get player's current vehicle
local invalidVehicle = (playerVehicle ~= source) -- verify whether source element is different from player's vehicle

if (invalidVehicle) then -- if it's so
reportAndRevertDataChange(client, source, dataKey, oldValue, newValue) -- revert data change, because "flag_waving" can only be set for player's own vehicle
end
end
end
addEventHandler("onElementDataChange", root, onElementDataChangeBasicAC)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
Example of comfortable advanced element data anti-cheat.
<syntaxhighlight lang="lua">
--[[
For maximum security set punishPlayerOnDetect, punishmentBan, allowOnlyProtectedKeys to true (as per default configuration)
If allowOnlyProtectedKeys is enabled, do not forget to add every client-side element data key to protectedKeys table - otherwise you will face false-positives

Anti-cheat (handleDataChange) table structure and it's options:

["keyName"] = { -- name of key which would be protected
onlyForPlayerHimself = true, -- enabling this (true) will make sure that this element data key can only be set on player who synced it (ignores onlyForOwnPlayerVeh and allowForElements), use false/nil to disable this
onlyForOwnPlayerVeh = false, -- enabling this (true) will make sure that this element data key can only be set on player's current vehicle who synced it (ignores allowForElements), use false/nil to disable this
allowForElements = { -- restrict this key for certain element type(s), set to false/nil or leave it empty to not check this (full list of element types: https://wiki.multitheftauto.com/wiki/GetElementsByType)
["player"] = true,
["ped"] = true,
["vehicle"] = true,
["object"] = true,
},
allowedDataTypes = { -- restrict this key for certain value type(s), set to false/nil or leave it empty to not check this
["string"] = true,
["number"] = true,
["table"] = true,
["boolean"] = true,
["nil"] = true,
},
allowedStringLength = {1, 32}, -- if value is a string, then it's length must be in between (min-max), set it to false/nil to not check string length - do note that allowedDataTypes must contain ["string"] = true
allowedTableLength = {1, 64}, -- if value is a table, then it's length must be in between (min-max), set it to false/nil to not check table length - do note that allowedDataTypes must contain ["table"] = true
allowedNumberRange = {1, 128}, -- if value is a number, then it must be in between (min-max), set it to false/nil to not check number range - do note that allowedDataTypes must contain ["number"] = true
}
]]

local punishPlayerOnDetect = true -- should player be punished upon detection (make sure that resource which runs this code has admin rights)
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick
local punishmentReason = "Altering element data" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent
local allowOnlyProtectedKeys = true -- disallow (remove by using removeElementData, if it didn't existed before) every element data besides those given in protectedKeys table; in case someone wanted to flood server with garbage keys, which would be kept in memory until server restart or manual remove - setElementData(source, key, nil) won't remove it; it has to be removeElementData
local debugLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors
local debugR = 255 -- debug message - red color
local debugG = 127 -- debug message - green color
local debugB = 0 -- debug message - blue color
local protectedKeys = {
["vehicleNumber"] = { -- we want vehicleNumber to be set only on vehicles, with stricte numbers in range of 1-100
allowForElements = {
["vehicle"] = true,
},
allowedDataTypes = {
["number"] = true,
},
allowedNumberRange = {1, 100},
},
["personalVehData"] = { -- we want be able to set personalVehData only on current vehicle, also it should be a string with length between 1-24
onlyForOwnPlayerVeh = true,
allowedDataTypes = {
["string"] = true,
},
allowedStringLength = {1, 24},
},
-- perform security checks on keys stored in this table, in a convenient way
}

local function reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- helper function to log and revert changes
local logClient = inspect(clientElement) -- in-depth view of player which forced element data sync
local logSerial = getPlayerSerial(clientElement) or "N/A" -- client serial, or "N/A" if not possible, for some reason
local logSource = inspect(sourceElement) -- in-depth view of element which received data
local logOldValue = inspect(oldValue) -- in-depth view of old value
local logNewValue = inspect(newValue) -- in-depth view of new value
local logText = -- fill our report with data
"*\n"..
"Detected element data abnormality:\n"..
"Client: "..logClient.."\n"..
"Client serial: "..logSerial.."\n"..
"Source: "..logSource.."\n"..
"Data key: "..dataKey.."\n"..
"Old data value: "..logOldValue.."\n"..
"New data value: "..logNewValue.."\n"..
"Fail reason: "..failReason.."\n"..
"*"

outputDebugString(logText, debugLevel, debugR, debugG, debugB) -- print it to debug

if (forceRemove) then -- we don't want this element data key to exist at all
removeElementData(sourceElement, dataKey) -- remove it

return true -- return success and stop here, we don't need further checks
end

setElementData(sourceElement, dataKey, oldValue) -- revert changes, it will call onElementDataChange event, but will fail (stop) on first condition - because server (not client) forced change

return true -- return success
end

local function handleDataChange(clientElement, sourceElement, dataKey, oldValue, newValue) -- the heart of our anti-cheat, which does all the magic security measurements, returns true if there was no altering from client (based on data from protectedKeys), false otherwise
local protectedKey = protectedKeys[dataKey] -- look up whether key changed is stored in protectedKeys table

if (not protectedKey) then -- if it's not

if (allowOnlyProtectedKeys) then -- if we don't want garbage keys
local failReason = "Key isn't present in protectedKeys" -- reason shown in report
local forceRemove = true -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end

return true -- this key isn't protected, let it through
end

local onlyForPlayerHimself = protectedKey.onlyForPlayerHimself -- if key has "self-set" lock
local onlyForOwnPlayerVeh = protectedKey.onlyForOwnPlayerVeh -- if key has "self-vehicle" lock
local allowForElements = protectedKey.allowForElements -- if key has element type check
local allowedDataTypes = protectedKey.allowedDataTypes -- if key has allowed data type check

if (onlyForPlayerHimself) then -- if "self-set" lock is active
local matchingElement = (clientElement == sourceElement) -- verify whether player who set data is equal to element which received data

if (not matchingElement) then -- if it's not matching
local failReason = "Can only set on player himself" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end

if (onlyForOwnPlayerVeh) then -- if "self-vehicle" lock is active
local playerVehicle = getPedOccupiedVehicle(clientElement) -- get current vehicle of player which set data
local matchingVehicle = (playerVehicle == sourceElement) -- check whether it matches the one which received data

if (not matchingVehicle) then -- if it doesn't match
local failReason = "Can only set on player's own vehicle" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end

if (allowForElements) then -- check if it's one of them
local elementType = getElementType(sourceElement) -- get type of element whose data changed
local matchingElementType = allowForElements[elementType] -- verify whether it's allowed

if (not matchingElementType) then -- this isn't matching
local failReason = "Invalid element type" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end

if (allowedDataTypes) then -- if there's allowed data types
local valueType = type(newValue) -- get data type of value
local matchingType = allowedDataTypes[valueType] -- check if it's one of allowed

if (not matchingType) then -- if it's not then
local failReason = "Invalid data type" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end

local allowedStringLength = protectedKey.allowedStringLength -- if key has specified string length check
local dataString = (valueType == "string") -- make sure it's a string

if (allowedStringLength and dataString) then -- if we should check string length
local minLength = allowedStringLength[1] -- retrieve min length
local maxLength = allowedStringLength[2] -- retrieve max length
local stringLength = utf8.len(newValue) -- get length of data string
local matchingLength = (stringLength >= minLength) and (stringLength <= maxLength) -- compare whether value fits in between

if (not matchingLength) then -- if it doesn't
local failReason = "Invalid string length (must be between "..minLength.."-"..maxLength..")" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end

local allowedTableLength = protectedKey.allowedTableLength -- if key has table length check
local dataTable = (valueType == "table") -- make sure it's a table

if (allowedTableLength and dataTable) then -- if we should check table length
local minLength = allowedTableLength[1] -- retrieve min length
local maxLength = allowedTableLength[2] -- retrieve max length
local minLengthAchieved = false -- variable which checks 'does minimum length was achieved'
local maxLengthExceeded = false -- variable which checks 'does length has exceeds more than allowed maximum'
local tableLength = 0 -- store initial table length

for _, _ in pairs(newValue) do -- loop through whole table
tableLength = (tableLength + 1) -- add + 1 on each table entry
minLengthAchieved = (tableLength >= minLength) -- is length bigger or at very minimum we require
maxLengthExceeded = (tableLength > maxLength) -- does table exceeded more than max length?

if (maxLengthExceeded) then -- it is bigger than it should be
break -- break the loop (due of condition above being worthy, it makes no point to count further and waste CPU, on a table which potentially could have huge amount of entries)
end
end

local matchingLength = (minLengthAchieved and not maxLengthExceeded) -- check if min length has been achieved, and make sure that it doesn't go beyond max length

if (not matchingLength) then -- this table doesn't match requirements
local failReason = "Invalid table length (must be between "..minLength.."-"..maxLength..")" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end

local allowedNumberRange = protectedKey.allowedNumberRange -- if key has allowed number range check
local dataNumber = (valueType == "number") -- make sure it's a number

if (allowedNumberRange and dataNumber) then -- if we should check number range
local minRange = allowedNumberRange[1] -- retrieve min number range
local maxRange = allowedNumberRange[2] -- retrieve max number range
local matchingRange = (newValue >= minRange) and (newValue <= maxRange) -- compare whether value fits in between

if (not matchingRange) then -- if it doesn't
local failReason = "Invalid number range (must be between "..minRange.."-"..maxRange..")" -- reason shown in report
local forceRemove = false -- should key be completely removed

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player

return false -- return failure
end
end
end

return true -- security checks passed, we are all clear with this data key
end

function onElementDataChangeAdvancedAC(dataKey, oldValue, newValue) -- this event makes use of handleDataChange, the code was split for better readability
if (not client) then -- check if data is coming from client
return false -- if it's not, do not continue
end

local approvedChange = handleDataChange(client, source, dataKey, oldValue, newValue) -- run our security checks

if (approvedChange) then -- it's all cool and good
return false -- we don't need further action
end

if (not punishPlayerOnDetect) then -- we don't want to punish player for some reason
return false -- so stop here
end

if (punishmentBan) then -- if it's ban
banPlayer(client, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server
else -- otherwise
kickPlayer(client, punishedBy, punishmentReason) -- simply kick player out of server
end
end
addEventHandler("onElementDataChange", root, onElementDataChangeAdvancedAC)
</syntaxhighlight>
</section>

==Securing triggerServerEvent==

* All parameters including '''source''' can be faked and should not be trusted.
* Global variable '''client''' can be trusted.
* '''Admin''' styled '''events''' should be verifying player (client) '''ACL rights''', either by [https://wiki.multitheftauto.com/wiki/IsObjectInACLGroup isObjectInACLGroup] or [https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo hasObjectPermissionTo].

----------
<section name="Server" class="server" show="true">
Example of comfortable anti-cheat function designed for events, used for data validation for both normal, and admin events which are called from client-side.
<syntaxhighlight lang="lua">
--[[
For maximum security set punishPlayerOnDetect, punishmentBan to true (as per default configuration)

Anti-cheat (processServerEventData) table structure and it's options:

checkACLGroup = { -- check whether player who called event belongs to at least one group below, set to false/nil to not check this
"Admin",
},
checkPermissions = { -- check whether player who called event has permission to at least one thing below, set to false/nil to not check this
"function.kickPlayer",
},
checkEventData = {
{
debugData = "source", -- optional details for report shown in debug message
eventData = source, -- data we want to verify
equalTo = client, -- compare whether eventData == equalTo
allowedElements = { -- restrict eventData to be certain element type(s), set to false/nil or leave it empty to not check this (full list of element types: https://wiki.multitheftauto.com/wiki/GetElementsByType)
["player"] = true,
["ped"] = true,
["vehicle"] = true,
["object"] = true,
},
allowedDataTypes = { -- restrict eventData to be certain value type(s), set to false/nil or leave it empty to not check this
["string"] = true,
["number"] = true,
["table"] = true,
["boolean"] = true,
["nil"] = true,
},
allowedStringLength = {1, 32}, -- if eventData is a string, then it's length must be in between (min-max), set it to false/nil to not check string length - do note that allowedDataTypes must contain ["string"] = true
allowedTableLength = {1, 64}, -- if eventData is a table, then it's length must be in between (min-max), set it to false/nil to not check table length - do note that allowedDataTypes must contain ["table"] = true
allowedNumberRange = {1, 128}, -- if eventData is a number, then it must be in between (min-max), set it to false/nil to not check number range - do note that allowedDataTypes must contain ["number"] = true
},
},
]]

local punishPlayerOnDetect = true -- should player be punished upon detection (make sure that resource which runs this code has admin rights)
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick
local punishmentReason = "Altering server event data" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent
local debugLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors
local debugR = 255 -- debug message - red color
local debugG = 127 -- debug message - green color
local debugB = 0 -- debug message - blue color

function processServerEventData(clientElement, sourceElement, serverEvent, securityChecks) -- the heart of our anti-cheat, which does all the magic security measurements, returns true if there was no altering from client (based on data from securityChecks), false otherwise
if (not securityChecks) then -- if we haven't passed any security checks
return true -- nothing to check, let code go further
end

if (not clientElement) then -- if client variable isn't available for some reason (although it should never happen)
local failReason = "Client variable not present" -- reason shown in report
local skipPunishment = true -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

local checkACLGroup = securityChecks.checkACLGroup -- if there's any ACL groups to check
local checkPermissions = securityChecks.checkPermissions -- if there's any permissions to check
local checkEventData = securityChecks.checkEventData -- if there's any data checks

if (checkACLGroup) then -- let's check player ACL groups
local playerAccount = getPlayerAccount(clientElement) -- get current account of player
local guestAccount = isGuestAccount(playerAccount) -- if account is guest (meaning player is not logged in)

if (guestAccount) then -- it's the case
local failReason = "Can't retrieve player login - guest account" -- reason shown in report
local skipPunishment = true -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

local accountName = getAccountName(playerAccount) -- get name of player's current account
local aclString = "user."..accountName -- format it for further use in isObjectInACLGroup function

for groupID = 1, #checkACLGroup do -- iterate over table of given groups
local groupName = checkACLGroup[groupID] -- get each group name
local aclGroup = aclGetGroup(groupName) -- check if such group exists

if (not aclGroup) then -- it doesn't
local failReason = "ACL group '"..groupName.."' is missing" -- reason shown in report
local skipPunishment = true -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

local playerInACLGroup = isObjectInACLGroup(aclString, aclGroup) -- check if player belong to the group

if (playerInACLGroup) then -- yep, it's the case
return true -- so it's a success
end
end

local failReason = "Player doesn't belong to any given ACL group" -- reason shown in report
local skipPunishment = true -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

if (checkPermissions) then -- check if player has at least one desired permission
local allowedByDefault = false -- does he have access by default

for permissionID = 1, #checkPermissions do -- iterate over all permissions
local permissionName = checkPermissions[permissionID] -- get permission name
local hasPermission = hasObjectPermissionTo(clientElement, permissionName, allowedByDefault) -- check whether player is allowed to perform certain action

if (hasPermission) then -- if player has access
return true -- one is available (and enough), server won't bother to check others (as return keywords also breaks loop)
end
end

local failReason = "Not enough permissions" -- reason shown in report
local skipPunishment = true -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

if (checkEventData) then -- if there is some data to verify

for dataID = 1, #checkEventData do -- iterate over each of data
local dataToCheck = checkEventData[dataID] -- get each data set
local eventData = dataToCheck.eventData -- this is the one we'll be verifying
local equalTo = dataToCheck.equalTo -- we want to compare whether eventData == equalTo
local allowedElements = dataToCheck.allowedElements -- check whether is element, and whether belongs to certain element types
local allowedDataTypes = dataToCheck.allowedDataTypes -- do we restrict data to be certain type?
local debugData = dataToCheck.debugData -- additional helper data
local debugText = debugData and " ("..debugData..")" or "" -- if it's present, format it nicely

if (equalTo) then -- equal check exists
local matchingData = (eventData == equalTo) -- compare whether those two values are equal

if (not matchingData) then -- they aren't
local failReason = "Data isn't equal @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end
end

if (allowedElements) then -- we do check whether is an element, and belongs to at least one given in the list
local validElement = isElement(eventData) -- check if it's actual element

if (not validElement) then -- it's not
local failReason = "Data isn't element @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

local elementType = getElementType(eventData) -- it's element, so we want to know it's type
local matchingElementType = allowedElements[elementType] -- verify whether it's allowed

if (not matchingElementType) then -- it's not allowed
local failReason = "Invalid element type @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end
end

if (allowedDataTypes) then -- let's check allowed data types
local dataType = type(eventData) -- get data type
local matchingType = allowedDataTypes[dataType] -- verify whether it's allowed

if (not matchingType) then -- it isn't
local failReason = "Invalid data type @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end

local allowedStringLength = dataToCheck.allowedStringLength -- if data has string length check
local dataString = (dataType == "string") -- make sure it's a string

if (allowedStringLength and dataString) then -- if we should check string length
local minLength = allowedStringLength[1] -- retrieve min length
local maxLength = allowedStringLength[2] -- retrieve max length
local stringLength = utf8.len(eventData) -- get length of data string
local matchingLength = (stringLength >= minLength) and (stringLength <= maxLength) -- compare whether value fits in between

if (not matchingLength) then -- if it doesn't
local failReason = "Invalid string length (must be between "..minLength.."-"..maxLength..") @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end
end

local allowedTableLength = dataToCheck.allowedTableLength -- if data has table length check
local dataTable = (dataType == "table") -- make sure it's a table

if (allowedTableLength and dataTable) then -- if we should check table length
local minLength = allowedTableLength[1] -- retrieve min length
local maxLength = allowedTableLength[2] -- retrieve max length
local minLengthAchieved = false -- variable which checks 'does minimum length was achieved'
local maxLengthExceeded = false -- variable which checks 'does length has exceeds more than allowed maximum'
local tableLength = 0 -- store initial table length

for _, _ in pairs(eventData) do -- loop through whole table
tableLength = (tableLength + 1) -- add + 1 on each table entry
minLengthAchieved = (tableLength >= minLength) -- is length bigger or at very minimum we require
maxLengthExceeded = (tableLength > maxLength) -- does table exceeded more than max length?

if (maxLengthExceeded) then -- it is bigger than it should be
break -- break the loop (due of condition above being worthy, it makes no point to count further and waste CPU, on a table which potentially could have huge amount of entries)
end
end

local matchingLength = (minLengthAchieved and not maxLengthExceeded) -- check if min length has been achieved, and make sure that it doesn't go beyond max length

if (not matchingLength) then -- this table doesn't match requirements
local failReason = "Invalid table length (must be between "..minLength.."-"..maxLength..") @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end
end

local allowedNumberRange = dataToCheck.allowedNumberRange -- if data has number range check
local dataNumber = (dataType == "number") -- make sure it's a number

if (allowedNumberRange and dataNumber) then -- if we should check number range
local minRange = allowedNumberRange[1] -- retrieve min number range
local maxRange = allowedNumberRange[2] -- retrieve max number range
local matchingRange = (eventData >= minRange) and (eventData <= maxRange) -- compare whether value fits in between

if (not matchingRange) then -- if it doesn't
local failReason = "Invalid number range (must be between "..minRange.."-"..maxRange..") @ argument "..dataID..debugText -- reason shown in report
local skipPunishment = false -- should server skip punishment

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player

return false -- return failure
end
end
end
end
end

return true -- security checks passed, we are all clear with this event call
end

function reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- helper function to log and handle accidents
local logClient = inspect(clientElement) -- in-depth view player which called event
local logSerial = getPlayerSerial(clientElement) or "N/A" -- client serial, or "N/A" if not possible, for some reason
local logSource = inspect(sourceElement) -- in-depth view of source element
local logText = -- fill our report with data
"*\n"..
"Detected event abnormality:\n"..
"Client: "..logClient.."\n"..
"Client serial: "..logSerial.."\n"..
"Source: "..logSource.."\n"..
"Event: "..serverEvent.."\n"..
"Reason: "..failReason.."\n"..
"*"

outputDebugString(logText, debugLevel, debugR, debugG, debugB) -- print it to debug

if (not punishPlayerOnDetect or skipPunishment) then -- we don't want to punish player for some reason
return true -- stop here
end

if (punishmentBan) then -- if it's ban
banPlayer(clientElement, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server
else -- otherwise
kickPlayer(clientElement, punishedBy, punishmentReason) -- simply kick player out of server
end

return true -- all done, report success
end

function onServerEvent(clientData)
--[[
Assume this server event (function) is called in such way:

local dataToPass = 10

triggerServerEvent("onServerEvent", localPlayer, dataToPass)
]]

local shouldProcessServerCode = processServerEventData(
client, -- client element - responsible for calling event
source, -- source element - passed in triggerServerEvent (as 2nd argument)
eventName, -- name of event - in this case 'onServerEvent'
{
checkEventData = { -- we want to verify everything what comes from client
{
eventData = source, -- first to check, source variable
equalTo = client, -- we want to check whether it matches player who called event
debugData = "source", -- helper details which would be shown in report
},
{
eventData = clientData, -- let's check the data which client sent to us
allowedDataTypes = {
["number"] = true, -- we want it to be only number
},
allowedNumberRange = {1, 100}, -- in range of 1 to 100
debugData = "clientData", -- if something goes wrong, let server know where (it will appear in debug report)
},
},
}
)

if (not shouldProcessServerCode) then -- something isn't right, no green light for processing code behind this scope
return false -- stop code execution
end

-- do code as usual
end
addEvent("onServerEvent", true)
addEventHandler("onServerEvent", root, onServerEvent)

function onServerAdminEvent(playerToBan)
--[[
Assume this server admin event (function) is called in such way:

local playerToBan = getPlayerFromName("playerToBan")

triggerServerEvent("onServerAdminEvent", localPlayer, playerToBan)
]]

local shouldProcessServerCode = processServerEventData(
client, -- client element - responsible for calling event
source, -- source element - passed in triggerServerEvent (as 2nd argument)
eventName, -- name of event - in this case 'onServerAdminEvent'
{
checkACLGroup = { -- we need to check whether player who called event belongs to ACL groups
"Admin", -- in this case admin group
},
checkEventData = { -- we want to verify everything what comes from client
{
eventData = source, -- first to check, source variable
equalTo = client, -- we want to check whether it matches player who called event
debugData = "source", -- helper details which would be shown in report
},
{
eventData = playerToBan, -- let's check the data which client sent to us
allowedDataTypes = {
["player"] = true, -- we want it to be player
},
debugData = "playerToBan", -- if something goes wrong, let server know where (it will appear in debug report)
},
},
}
)

if (not shouldProcessServerCode) then -- something isn't right, no green light for processing code behind this scope
return false -- stop code execution
end

-- do code as usual
end
addEvent("onServerAdminEvent", true)
addEventHandler("onServerAdminEvent", root, onServerAdminEvent)
</syntaxhighlight>
</section>

==Securing server-only events==
* It is very important to '''disable remote triggering''' ability in [https://wiki.multitheftauto.com/wiki/AddEvent addEvent], to prevent calling server-side only events from client-side.
* '''Admin''' styled '''events''' should be verifying player '''ACL rights''', either by [https://wiki.multitheftauto.com/wiki/IsObjectInACLGroup isObjectInACLGroup] or [https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo hasObjectPermissionTo].

----------
<section name="Server" class="server" show="true">
This example shows how you should make event server-side only.
<syntaxhighlight lang="lua">
function onServerSideOnlyEvent()
-- do some server-side stuff
end
addEvent("onServerSideOnlyEvent", false) -- set second argument (allowRemoteTriger) to false, so it can't be called from client
addEventHandler("onServerSideOnlyEvent", root, onServerSideOnlyEvent) -- associate our event with function onServerSideOnlyEvent
</syntaxhighlight>
</section>

==Securing projectiles & explosions==
This section (and '''code''' is '''work in progress''') - '''use at your own risk'''.

----------
<section name="Server" class="server" show="false">
Projectile ammo tracker:
<syntaxhighlight lang="lua">
local playerProjectileAmmo = {} -- store player-held weapons ammo here
local playerWeaponsToTrack = { -- keep track of ammo for certain player-held weapon types, basically those which create projectile; [weaponID] = weaponSlot
[16] = 8, -- grenade
[17] = 8, -- teargas
[18] = 8, -- molotov
[35] = 7, -- rocket launcher
[36] = 7, -- rocket launcher (heat-seeking)
[39] = 8, -- satchel charge
}

local function updateProjectileAmmoForPlayer(playerElement)
local validElement = isElement(playerElement)

if (not validElement) then
return false
end

local playerDead = isPedDead(playerElement)

if (playerDead) then
return false
end

for weaponID, weaponSlot in pairs(playerWeaponsToTrack) do
local weaponInSlot = getPedWeapon(playerElement, weaponSlot)
local weaponTotalAmmo = getPedTotalAmmo(playerElement, weaponSlot)
local weaponHasAmmo = (weaponTotalAmmo > 0)
local weaponMatching = (weaponInSlot == weaponID)
local updateWeaponAmmo = (weaponMatching and weaponHasAmmo)

if (updateWeaponAmmo) then
local storedProjectileAmmo = playerProjectileAmmo[playerElement]
local newWeaponAmmo = (updateWeaponAmmo and weaponTotalAmmo or nil)

if (not storedProjectileAmmo) then
playerProjectileAmmo[playerElement] = {}
storedProjectileAmmo = playerProjectileAmmo[playerElement]
end

storedProjectileAmmo[weaponID] = newWeaponAmmo
end
end

return true
end

function hasPlayerProjectileAmmo(playerElement, projectileWeapon)
local validElement = isElement(playerElement)

if (not validElement) then
return false
end

local playerDead = isPedDead(playerElement)

if (playerDead) then
return false
end

local projectileData = playerProjectileAmmo[playerElement]
local projectileAmmo = (projectileData and projectileData[projectileWeapon])

return projectileAmmo
end

function decreasePlayerProjectileAmmo(playerElement, projectileWeapon)
local validElement = isElement(playerElement)

if (not validElement) then
return false
end

local playerDead = isPedDead(playerElement)

if (playerDead) then
return false
end

local playerProjectileData = playerProjectileAmmo[playerElement]

if (not playerProjectileData) then
return false
end

local projectileWeaponAmmo = playerProjectileData[projectileWeapon]
local tempProjectileAmmo = (projectileWeaponAmmo - 1)
local newProjectileAmmo = (tempProjectileAmmo > 0 and tempProjectileAmmo or nil)

playerProjectileData[projectileWeapon] = newProjectileAmmo

return true
end

function onPlayerWeaponSwitchAntiCheat(previousWeaponID, currentWeaponID)
setTimer(updateProjectileAmmoForPlayer, 50, 1, source)
end
addEventHandler("onPlayerWeaponSwitch", root, onPlayerWeaponSwitchAntiCheat)

function onResourceStartAntiCheat()
local playersTable = getElementsByType("player")

for playerID = 1, #playersTable do
local playerElement = playersTable[playerID]

updateProjectileAmmoForPlayer(playerElement)
end
end
addEventHandler("onResourceStart", resourceRoot, onResourceStartAntiCheat)

function onPlayerWastedQuitAntiCheat()
playerProjectileAmmo[source] = nil
end
addEventHandler("onPlayerWasted", root, onPlayerWastedQuitAntiCheat)
addEventHandler("onPlayerQuit", root, onPlayerWastedQuitAntiCheat)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="false">
Projectile handler:
<syntaxhighlight lang="lua">
local playerCreatedProjectiles = {} -- store count of legitimately created player projectiles; [playerElement] = {[projectileType] = activeProjectiles}
local projectileTypes = {
[16] = { -- Grenade
projectileAllowed = true,
projectileMaxDistanceFromCreator = 2,
projectileAllowedWeapons = {
[16] = true, -- grenade
},
},
[17] = { -- Teargas
projectileAllowed = true,
projectileMaxDistanceFromCreator = 2,
projectileAllowedWeapons = {
[17] = true, -- teargas
},
},
[18] = { -- Molotov
projectileAllowed = true,
projectileMaxDistanceFromCreator = 2,
projectileAllowedWeapons = {
[18] = true, -- molotov
},
},
[19] = { -- Rocket
projectileAllowed = true,
projectileMaxDistanceFromCreator = 5,
projectileMaxVelocity = 2,
projectileAllowedWeapons = {
[35] = true, -- rocket launcher
},
projectileAllowedVehicles = {
[425] = true, -- hunter
[520] = true, -- hydra
},
},
[20] = { -- Rocket (heat-seeking)
projectileAllowed = true,
projectileMaxDistanceFromCreator = 5,
projectileMaxVelocity = 2,
projectileAllowedWeapons = {
[36] = true, -- rocket launcher (heat-seeking)
},
projectileAllowedVehicles = {
[520] = true, -- hydra
},
},
[21] = { -- Airbomb
projectileAllowed = true,
projectileAllowedVehicles = {
[520] = true, -- hydra
},
},
[39] = { -- Satchel charge
projectileAllowed = true,
projectileMaxDistanceFromCreator = 2,
projectileAllowedWeapons = {
[39] = true, -- satchel charge
},
},
[58] = { -- Hydra flare
projectileAllowed = true,
projectileMaxDistanceFromCreator = 5,
projectileAllowedVehicles = {
[520] = true, -- hydra
},
},
}

local reportAbnormality = true -- whether to report about abnormality in debug script - by default
local punishPlayerOnDetect = false -- should player be punished upon detection; true - yes, or false to not do anything (make sure that resource which runs this code has admin rights)
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick
local punishmentReason = "Projectile/explosion anti-cheat" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent
local debugMsgLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors
local debugMsgR = 255 -- debug message - red color
local debugMsgG = 127 -- debug message - green color
local debugMsgB = 0 -- debug message - blue color

local function reportProjectileAbnormality(playerElement, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ, detectionCode)
local projectileSyncer = inspect(playerElement)
local projectilePosition = (projectileX..", "..projectileY..", "..projectileZ)
local projectileZoneName = getZoneName(projectileX, projectileY, projectileZ, false)
local projectileCityName = getZoneName(projectileX, projectileY, projectileZ, true)
local projectileLog =
"* Detected projectile abnormality - "..detectionCode.." *\n"..
"Projectile syncer: "..projectileSyncer.."\n"..
"Projectile type: "..projectileType.."\n"..
"Projectile position: "..projectilePosition.. " ("..projectileZoneName..", "..projectileCityName..")\n"

outputDebugString(projectileLog, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)

return true
end

local function processProjectileChecks(playerElement, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)
local projectileData = projectileTypes[projectileType]
local projectileAllowed = projectileData.projectileAllowed

if (not projectileAllowed) then
return false, "Projectile not allowed"
end

local projectileAllowedWeapons = projectileData.projectileAllowedWeapons

if (projectileAllowedWeapons) then
local playerWeapon = getPedWeapon(playerElement)
local allowedWeapon = projectileAllowedWeapons[playerWeapon]

if (not allowedWeapon) then
return false, "Player is not holding correct weapon"
end

local weaponAmmo = hasPlayerProjectileAmmo(playerElement, playerWeapon)
local playerHasAmmo = (weaponAmmo > 0)

if (not playerHasAmmo) then
return false, "Player doesn't have ammo for weapon"
end

decreasePlayerProjectileAmmo(playerElement, playerWeapon)
end

local playerVehicle = getPedOccupiedVehicle(playerElement)

if (playerVehicle) then
local projectileAllowedVehicles = projectileData.projectileAllowedVehicles

if (projectileAllowedVehicles) then
local vehicleModel = getElementModel(playerVehicle)
local allowedVehicle = projectileAllowedVehicles[vehicleModel]

if (not allowedVehicle) then
return false, "Player is not inside allowed vehicles"
end

local vehicleDriver = getVehicleController(playerVehicle)
local playerDriver = (playerElement == vehicleDriver)

if (not playerDriver) then
return false, "Player is not vehicle driver"
end

return true
end

return false, "Player in vehicle"
end

local projectileMaxDistanceFromCreator = projectileData.projectileMaxDistanceFromCreator

if (projectileMaxDistanceFromCreator) then
local playerX, playerY, playerZ = getElementPosition(playerElement)
local distanceToProjectile = getDistanceBetweenPoints3D(playerX, playerY, playerZ, projectileX, projectileY, projectileZ)
local matchingProjectileDistance = (distanceToProjectile <= projectileMaxDistanceFromCreator)

if (not matchingProjectileDistance) then
return false, "Projectile distance mismatch"
end
end

local projectileMaxVelocity = projectileData.projectileMaxVelocity

if (projectileMaxVelocity) then
local projectileVelocity = (projectileVX ^ 2 + projectileVY ^ 2 + projectileVZ ^ 2)
local projectileSpeed = math.sqrt(projectileVelocity)
local matchingProjectileVelocity = (projectileSpeed <= projectileMaxVelocity)

if (not matchingProjectileVelocity) then
return false, "Projectile velocity mismatch"
end
end

return true
end

local function trackPlayerProjectile(playerElement, projectileID)
local validElement = isElement(playerElement)

if (not validElement) then
return false
end

local playerProjectiles = playerCreatedProjectiles[playerElement]

if (not playerProjectiles) then
playerCreatedProjectiles[playerElement] = {}
playerProjectiles = playerCreatedProjectiles[playerElement]
end

local projectilesByType = playerProjectiles[projectileID] or 0
local newProjectilesCount = (projectilesByType + 1)

playerProjectiles[projectileID] = newProjectilesCount

return true
end

local function getProjectileDetectionOverwrittenBehavior(projectileType)
local projectileData = projectileTypes[projectileType]

if (not projectileData) then
return reportAbnormality, punishPlayerOnDetect, punishmentBan
end

local projectileBehaviour = projectileData.projectileOverwriteBehaviour

if (not projectileBehaviour) then
return reportAbnormality, punishPlayerOnDetect, punishmentBan
end

local overwriteReport = projectileBehaviour.reportAbnormality
local overwritePunish = projectileBehaviour.punishPlayerOnDetect
local overwriteBan = projectileBehaviour.punishmentBan

return overwriteReport, overwritePunish, overwriteBan
end

function decreasePlayerProjectiles(playerElement, projectileID)
local validElement = isElement(playerElement)

if (not validElement) then
return false
end

local playerProjectiles = playerCreatedProjectiles[playerElement]

if (not playerProjectiles) then
return false, true
end

local projectilesByType = playerProjectiles[projectileID]

if (not projectilesByType) then
return false, true
end

local tempProjectilesCount = (projectilesByType - 1)
local newProjectilesCount = (tempProjectilesCount > 0 and tempProjectilesCount or nil)

playerProjectiles[projectileID] = newProjectilesCount

return true
end

function onPlayerProjectileCreationAntiCheat(projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)
local approvedProjectile, detectionCode = processProjectileChecks(source, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)

if (approvedProjectile) then
trackPlayerProjectile(source, projectileType)

return true
end

local reportAbnormality, punishPlayerOnDetect, punishmentBan = getProjectileDetectionOverwrittenBehavior(projectileType)

if (reportAbnormality) then
reportProjectileAbnormality(source, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ, detectionCode)
end

cancelEvent()

if (not punishPlayerOnDetect) then -- we don't want to punish player for some reason
return false -- so stop here
end

if (punishmentBan) then -- if it's ban
banPlayer(source, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server
else -- otherwise
kickPlayer(source, punishedBy, punishmentReason) -- simply kick player out of server
end
end
addEventHandler("onPlayerProjectileCreation", root, onPlayerProjectileCreationAntiCheat)

function onPlayerQuitAntiCheat()
playerCreatedProjectiles[source] = nil
end
addEventHandler("onPlayerQuit", root, onPlayerQuitAntiCheat)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="false">
Explosions handler:
<syntaxhighlight lang="lua">
local rocketInstantExplosionDistanceThreshold = 1.55 -- distance below which only explosion will be created (and not rocket projectile, hence not calling onPlayerProjectileCreation); do not change it
local explosionTypes = { -- more specific info on explosion, and whether it is allowed
[0] = { -- Grenade
explosionAllowed = true,
explosionAllowedProjectiles = {
[16] = true, -- grenade
},
},
[1] = { -- Molotov
explosionAllowed = true,
explosionAllowedProjectiles = {
[18] = true, -- molotov
},
},
[2] = { -- Rocket
explosionAllowed = true,
explosionAllowedWeapons = {
[35] = true, -- rocket launcher
[36] = true, -- rocket launcher (heat-seeking)
},
explosionAllowedProjectiles = {
[19] = true, -- rocket
[20] = true, -- rocket (heat-seeking)
},
},
[3] = { -- Rocket weak
explosionAllowed = true,
explosionAllowedProjectiles = {
[19] = true, -- rocket
[20] = true, -- rocket (heat-seeking)
},
},
[4] = { -- Car
explosionAllowed = true,
},
[5] = { -- Car quick
explosionAllowed = true,
},
[6] = { -- Boat
explosionAllowed = true,
},
[7] = { -- Heli
explosionAllowed = true,
},
[8] = { -- Mine
explosionAllowed = true,
},
[9] = { -- Object
explosionAllowed = true,
},
[10] = { -- Tank grenade
explosionAllowed = true,
explosionMaxDistanceFromCreator = 80,
explosionAllowedVehicles = {
[432] = true,
}
},
[11] = { -- Small
explosionAllowed = true,
},
[12] = { -- Tiny
explosionAllowed = true,
},
}

local reportAbnormality = true -- whether to report about abnormality in debug script - by default
local punishPlayerOnDetect = false -- should player be punished upon detection; true - yes, or false to not do anything (make sure that resource which runs this code has admin rights)
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick
local punishmentReason = "Projectile/explosion anti-cheat" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent
local debugMsgLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors
local debugMsgR = 255 -- debug message - red color
local debugMsgG = 127 -- debug message - green color
local debugMsgB = 0 -- debug message - blue color

local function reportExplosionAbnormality(playerElement, explosionType, explosionX, explosionY, explosionZ, detectionCode)
local explosionSyncer = inspect(playerElement)
local explosionType = explosionType
local explosionPosition = (explosionX..", "..explosionY..", "..explosionZ)
local explosionZoneName = getZoneName(explosionX, explosionY, explosionZ, false)
local explosionCityName = getZoneName(explosionX, explosionY, explosionZ, true)
local explosionLog =
"* Detected explosion abnormality - "..detectionCode.." *\n"..
"Explosion syncer: "..explosionSyncer.."\n"..
"Explosion type: "..explosionType.."\n"..
"Explosion position: "..explosionPosition.. " ("..explosionZoneName..", "..explosionCityName..")\n"

outputDebugString(explosionLog, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)

return true
end

local function processExplosionChecks(playerElement, explosionType, explosionX, explosionY, explosionZ)
local explosionData = explosionTypes[explosionType]
local explosionAllowed = explosionData.explosionAllowed

if (not explosionAllowed) then
return false, "Explosion type not allowed"
end

local rocketExplosion = (explosionType == 2)

if (rocketExplosion) then
local playerX, playerY, playerZ = getElementPosition(playerElement)
local distanceToExplosion = getDistanceBetweenPoints3D(playerX, playerY, playerZ, explosionX, explosionY, explosionZ)
local instantExplosion = (distanceToExplosion < rocketInstantExplosionDistanceThreshold)

if (instantExplosion) then
local explosionAllowedWeapons = explosionData.explosionAllowedWeapons
local playerWeapon = getPedWeapon(playerElement)
local allowedWeapon = explosionAllowedWeapons[playerWeapon]

if (not allowedWeapon) then
return false, "Player is not holding rocket launcher"
end

local weaponAmmo = hasPlayerProjectileAmmo(playerElement, playerWeapon)
local playerHasAmmo = (weaponAmmo > 0)

if (not playerHasAmmo) then
return false, "Player doesn't have ammo for rocket launcher"
end

decreasePlayerProjectileAmmo(playerElement, playerWeapon)

return true
end
end

local explosionAllowedProjectiles = explosionData.explosionAllowedProjectiles

if (explosionAllowedProjectiles) then

for projectileID, _ in pairs(explosionAllowedProjectiles) do
local atleastOneProjectile = decreasePlayerProjectiles(playerElement, projectileID)

if (atleastOneProjectile) then
return true
end
end

return false, "Explosion created without respective projectile"
end

local explosionAllowedVehicles = explosionData.explosionAllowedVehicles

if (explosionAllowedVehicles) then
local playerVehicle = getPedOccupiedVehicle(playerElement)

if (not playerVehicle) then
return false, "Player is not in vehicle"
end

local vehicleModel = getElementModel(playerVehicle)
local allowedVehicle = explosionAllowedVehicles[vehicleModel]

if (not allowedVehicle) then
return false, "Player is inside not allowed vehicles"
end

local vehicleDriver = getVehicleController(playerVehicle)
local playerDriver = (playerElement == vehicleDriver)

if (not playerDriver) then
return false, "Player is not vehicle driver"
end
end

local explosionMaxDistanceFromCreator = explosionData.explosionMaxDistanceFromCreator

if (explosionMaxDistanceFromCreator) then
local playerX, playerY, playerZ = getElementPosition(playerElement)
local distanceToExplosion = getDistanceBetweenPoints3D(playerX, playerY, playerZ, explosionX, explosionY, explosionZ)
local matchingExplosionDistance = (distanceToExplosion < explosionMaxDistanceFromCreator)

if (not matchingExplosionDistance) then
return false, "Explosion distance mismatch"
end
end

return true
end

local function getExplosionDetectionOverwrittenBehavior(explosionType)
local explosionData = explosionTypes[explosionType]

if (not explosionData) then
return reportAbnormality, punishPlayerOnDetect, punishmentBan
end

local explosionBehaviour = explosionData.explosionOverwriteBehaviour

if (not explosionBehaviour) then
return reportAbnormality, punishPlayerOnDetect, punishmentBan
end

local overwriteReport = explosionBehaviour.reportAbnormality
local overwritePunish = explosionBehaviour.punishPlayerOnDetect
local overwriteBan = explosionBehaviour.punishmentBan

return overwriteReport, overwritePunish, overwriteBan
end

function onExplosionAntiCheat(explosionX, explosionY, explosionZ, explosionType)
local serverSyncExplosion = (source == root)

if (serverSyncExplosion) then
return true
end

local approvedExplosion, detectionCode = processExplosionChecks(source, explosionType, explosionX, explosionY, explosionZ)

if (approvedExplosion) then
return true
end

local reportAbnormality, punishPlayerOnDetect, punishmentBan = getExplosionDetectionOverwrittenBehavior(explosionType)

if (reportAbnormality) then
reportExplosionAbnormality(source, explosionType, explosionX, explosionY, explosionZ, detectionCode)
end

cancelEvent()

if (not punishPlayerOnDetect) then -- we don't want to punish player for some reason
return false -- so stop here
end

if (punishmentBan) then -- if it's ban
banPlayer(source, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server
else -- otherwise
kickPlayer(source, punishedBy, punishmentReason) -- simply kick player out of server
end
end
addEventHandler("onExplosion", root, onExplosionAntiCheat)
</syntaxhighlight>
</section>

==Handling non-registered events==

See: [[onPlayerTriggerInvalidEvent]]

==Handling events spam==
See: [[onPlayerTriggerEventThreshold]]

User:CrosRoad95

2024-05-12T09:58:06Z

CrosRoad95: Blanked the page

DxDrawModel3D

2023-10-14T06:06:44Z

CrosRoad95:

__NOTOC__
{{Client function}}
{{Important Note|You can not use this function to draw vehicles and ped}}
{{Important Note|This function doesn't obey any streaming limits, you can draw as many models as you want}}
{{Important Note|You can not render model to render target.}}
This function draws a 3D model - rendered for '''one''' frame. Drawn models are indistinguishable from this one created by [[createObject]] function. This should be used in conjunction with [[onClientRender]] in order to display continuously.

==Syntax==
<syntaxhighlight lang="lua">
bool dxDrawModel( int modelId, float positionX, float positionY, float positionZ, float rotationX, float rotationY, float rotationZ [, float scaleX, float scaleY, float scaleZ ])
</syntaxhighlight>

[[Image:DxDrawModel3D_at_day.png|thumb|Model during day]]
[[Image:DxDrawModel3D_at_night.png|thumb|Model during night]]

===Required Arguments===
* '''modelId:''' Model you want to draw, must be regular object, you can not draw vehicles and peds
* '''positionX/Y/Z:''' Position of model
* '''rotationX/Y/Z:''' Rotation of model

===Optional Arguments===
* '''scaleX/Y/Z:''' Scale of model, by default {1,1,1}

===Returns===
Returns true if the operation was successful, false otherwise.

==Example==
<section name="Client" class="client" show="true">
Simple example
<syntaxhighlight lang="lua">
addEventHandler("onClientPreRender", root, function()
dxDrawModel3d(3276, -719.64984, 951.26685, 12.13281, 0, 0,90)
end)
</syntaxhighlight>
</section>

==See Also==
{{Drawing_functions}}

DxDrawModel3D

2023-10-14T06:06:06Z

CrosRoad95: Created page with "__NOTOC__ {{Client function}} {{Important Note|You can not use this function to draw vehicles and ped}} {{Important Note|This function doesn't obey any streaming limits, you can draw as many models as you want}} {{Important Note|You can not render model to render target.}} This function draws a 3D model - rendered for '''one''' frame. Drawn models are indistinguishable from this one created by "createObject" function. This should be used in conjunction with onClientR..."

__NOTOC__
{{Client function}}
{{Important Note|You can not use this function to draw vehicles and ped}}
{{Important Note|This function doesn't obey any streaming limits, you can draw as many models as you want}}
{{Important Note|You can not render model to render target.}}
This function draws a 3D model - rendered for '''one''' frame. Drawn models are indistinguishable from this one created by "createObject" function. This should be used in conjunction with [[onClientRender]] in order to display continuously.

==Syntax==
<syntaxhighlight lang="lua">
bool dxDrawModel( int modelId, float positionX, float positionY, float positionZ, float rotationX, float rotationY, float rotationZ [, float scaleX, float scaleY, float scaleZ ])
</syntaxhighlight>

[[Image:DxDrawModel3D_at_day.png|thumb|Model during day]]
[[Image:DxDrawModel3D_at_night.png|thumb|Model during night]]

===Required Arguments===
* '''modelId:''' Model you want to draw, must be regular object, you can not draw vehicles and peds
* '''positionX/Y/Z:''' Position of model
* '''rotationX/Y/Z:''' Rotation of model

===Optional Arguments===
* '''scaleX/Y/Z:''' Scale of model, by default {1,1,1}

===Returns===
Returns true if the operation was successful, false otherwise.

==Example==
<section name="Client" class="client" show="true">
Simple example
<syntaxhighlight lang="lua">
addEventHandler("onClientPreRender", root, function()
dxDrawModel3d(3276, -719.64984, 951.26685, 12.13281, 0, 0,90)
end)
</syntaxhighlight>
</section>

==See Also==
{{Drawing_functions}}

File:DxDrawModel3D at night.png

2023-10-14T06:04:36Z

CrosRoad95:

File:DxDrawModel3D at day.png

2023-10-14T06:03:47Z

CrosRoad95:

Template:Useful Functions

2023-10-06T16:13:56Z

CrosRoad95:

__NOTOC__
=== Table functions ===
*[[addTableChangeHandler]] » This function monitors the changes of a table.
*[[getTableFromSql]] » This functionality is used to obtain saved tables using the function ([https://wiki.multitheftauto.com/wiki/SetTableToSql SetTableToSql ]).
*[[isValueInTable]] » This function returns true if the value exists in the table, false if the value does not exist in the table.
*[[pairsByKeys]] » This function sort pairs table.
*[[rangeToTable]] » This function converts a string range to a table containing number values.
*[[setTableProtected]] » This function protects a table and makes it read-only.
*[[setTableToSql]] » This function is used to save the table in the database (sql).
*[[Sort_Functions]] » These functions are able to sort your tables by a key.
*[[table.compare]] » This function checks whether two given tables are equal.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.deepmerge]] » This function deep merges two tables. Every nested table will be correspondingly merged.
*[[table.element]] » This function returns a new table with only userdata content.
*[[table.flip]] » This function flip table values.
*[[table.fromString]] » This function converts string to a table.
*[[table.getRandomRows]] » This function returns random rows from table.
*[[table.map]] » This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.
*[[table.merge]] » This function merges two or more tables together.
*[[table.random]] » This function retrieves a random value from a table.
*[[table.removeValue]] » This function removes a specified value from a table.
*[[table.size]] » This function returns the absolute size of a table.
*[[table.toString]] » This function converts table to a string.

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[getAccountRanks]] » This function is used to detect the account name groups and put them in the chat.
*[[getPlayerAcls]] » This function returns a table of all ACL groups on a player.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.
*[[isPlayerACLAdmin]] » This function checks if a player element belong to Admin group in ACL

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.

=== Colshape functions ===
*[[createGarageColShape]] » This function creates a collision shape from the specified garage.

=== Cursor functions ===
*[[getCursorMovedOn]] » This function checks in which way the cursor is currently moving.
*[[setCursorCenteredOnRectangle]] » This functions will center the cursor inside a rectangle.

=== Drawing functions ===
*[[dxDrawAnimWindow]] » This function draws an animated 2D window on the screen.
*[[dxDrawBorderedRectangle]] » This is a function that will create a bordered rectangle.
*[[dxDrawBorderedText]] » This is a function that will create a bordered text.
*[[dxDrawDashedLine]] » This function draws a line with dashes.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites in 2D.
*[[dxDrawImage3D]] » This function draws a 3D image in GTA world.
*[[dxDrawImageOnElement]] » This function draws an image on any element.
*[[dxDrawLinedRectangle]] » This is a function that will create a rectangle outline with dx lines.
*[[dxDrawLoading]] » This function draws a loading bar on the screen.
*[[dxDrawOctagon3D]] » This function creates a 3D Octagon
*[[dxDrawPolygon]] » This function draws a custom polygon on the screen.
*[[dxDrawProgressBar]] » This function simulates a progress bar drawed using DirectDraw.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle in GTA world.
*[[dxDrawRectangleOnPlayer]] » This function draws a 3D rectangle above the player.
*[[dxDrawRing]] » This function draws a ring with dx lines.
*[[dxDrawRombo]] » This function creates a Rhombus.
*[[dxDrawSprite]] » This function draw a sprite in the 3D world.
*[[dxDrawTextOnElement]] » This function draws a text on any element.
*[[dxDrawTextOnRectangle]] » Esta funcion crea un rectangle con un texto dentro.
*[[dxDrawTriangle]] » This is a function that will create a triangle with dx lines.
*[[dxGetFontSizeFromHeight]] » This function calculates the font size from given height.
*[[dxGetRealFontHeight]] » This function calculates the height of a font.
*[[getScreenStartPositionFromBox]] » This function helps with getting the correct position for your dx-effects.
*[[wordWrap]] » This function breaks a long string into a table of separate lines limited to a specific length in pixels, for drawing separately.
*[[CreateRectangle3D]] » This is a function that will create a 3d rectangle on the player screen.
*[[DxDrawBordered3DLine]] »This function creates a bordered area with 3D dx lines.

=== Effects functions ===
*[[attachEffect]] » This function allows you attach an effect to an element.
*[[setScreenFlash]] » This function will make the screen flash(like a screenshot).

=== Element functions ===
*[[autoAttach]] » This function attaches one element into another at the same position and rotation they are.
*[[attachElementToBone]] » This function allows you to attach an element to ped bone accurately using new bone functions.
*[[getElementDirectionCardialPoint]] » This function returns the direction of the element according to the ''wind rose''.
*[[getElementSpeed]] » This function returns the specified element's speed in m/s, km/h or mph.
*[[getElementUsingData]] » This function returns table elements that contains the elements data with the given key and value.
*[[getElementsInDimension]] » This function returns a table of elements that are in the specified dimension.
*[[getElementsWithinMarker]] » This function returns a table of elements that are within a marker's collision shape.
*[[getNearestElement]] » This function returns the nearest element (of a specific type) to a player.
*[[isElementInAir]] » This function checks if an element is in air or not.
*[[isElementInPhotograph]] » This function checks if an element is in the player's camera picture area.
*[[isElementInRange]] » This function allows you to check if an element's range to a main point is within the maximum range.
*[[isElementMoving]] » This function checks if an element is moving.
*[[isElementPlayer]] » This function checks whether the element is a player or not.
*[[isElementWithinAColShape]] » This function checks if an element is within a collision shape element.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[setElementSpeed]] » This function allows you to set the speed of an element in kph or mph units.

=== Events ===
*[[onPlayerZoneChange]] » This code implements an event that is triggered when the player enters a new area on the map.
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicle's weapon.

=== Input functions ===
*[[bindControlKeys]] » This function allows you to bind each key bound to a control individually. Doing this bypasses a little MTA restriction.
*[[getBoundControls]] » This function returns a table of control names that are bound to the specified key.
*[[unbindControlKeys]] » This function allows you to unbind each key bound to a control individually. Use this function with [[bindControlKeys]].
*[[isCommandHandlerAdded]] » This function allows you to check if a command is added or not in the respective resource.

=== Data functions ===
*[[byte2human]] » This function converts an integer (number of bytes) into a human-readable unit.
*[[capitalize]] » This function capitalizes a given string.
*[[convertDate]] » This function converts date to another look.
*[[convertServerTickToTimeStamp]] » This function converts server ticks to a unix timestamp.
*[[convertTextToSpeech]] » This function converts the provided text to a speech in the provided language which players can hear.
*[[findRotation3D]] » This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B.
*[[findRotation]] » This function takes two points and returns the direction from point A to point B.
*[[formatDate]] » This function formats a date on the basis of a format string and returns it.
*[[formatNumber]] » This function formats large numbers by adding commas.
*[[generateRandomASCIIString]] » This function returns a random string which uses ASCII characters. 
*[[generateString]] » This function generates a random string with any characters.
*[[getAge]] » This function calculates the age of a given birthday.
*[[getDistanceBetweenElements]] » Returns the distance between two elements.
*[[getDistanceBetweenPointAndSegment2D]] » This function takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getEasterDate]] » This function returns easter date monthday and month for a given year.
*[[getElementRelatedAngle]] » This function returns the related angle between one element to another. This is useful to check which side an element is to another.
*[[getFreeDimension]] » This function get free dimension.
*[[getKeyFromValueInTable]] » This function returns the key of the specified value in a table.
*[[getOffsetFromXYZ]] » This function allows you to take an entity and a position and calculate the relative offset between them accounting for rotations.
*[[getPointFromDistanceRotation]] » This function finds a point based on a starting point, direction and distance.
*[[getRealMonth]] » This function returns the current month name
*[[getRGColorFromPercentage]] »This function returns two integers representing red and green colors according to the specified percentage.
*[[getScreenRotationFromWorldPosition]] » This function returns a screen relative rotation to a world position.
*[[getTimestamp]] » This function returns the UNIX timestamp of a specified date and time.
*[[gradientString]] » This function transforms a string in a new coloured gradient string.
*[[hex2rgb]] » This function convert hex to rgb.
*[[hexColorToRGB]] » This function convert hex string/number to RGBA values.
*[[isLeapYear]] » This function returns a boolean representing if a given year is a leap year.
*[[isValidMail]] » This function checks whether a provided e-mail string is valid.
*[[removeHex]] » This function is used to remove hexadecimal numbers (colors, for example) from strings.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[RGBToHSV]] » This function convert RGB to HSV color space.
*[[RGBToDecimal]] » This function convert RGB to Decimal color.
*[[secondsToTimeDesc]] » This function converts a plain seconds-integer into a user-friendly time description.
*[[string.count]] » This function counts the amount of occurences of a string in a string.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[string.insert]] » This function inserts a string within another string at a given position.
*[[switch]] » This function allows the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[tocolor2rgba]] » This function convert tocolor to rgba.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used client-side.
*[[var dump]] » This function outputs information about one or more variables using outputConsole.
*[[wavelengthToRGBA]] » This function converts a physical wavelength of light to a RGBA color.

=== GUI functions ===
*[[centerWindow]] » This function centers a CEGUI window element responsively in any resolution.
*[[guiMoveElement]] » This function moves guiElement by/like using moveObject.
*[[guiSetStaticImageMovable]] » This function allows you to move a static image like a gui window.
*[[isMouseOnGUICloseButton]] » This function allows you to check whether the mouse cursor/pointer is within a gui-window's native close button.
*[[isMouseOnGuiElement]] » This function allows you to check whether or not your mouse is over a specific gui element, this is especially useful if the gui element has a parent. 
=====Comboboxes=====
*[[guiComboBoxAdjustHeight]] » This function adjusts a CEGUI combobox element to have the correct height.

=====Gridlists=====
*[[convertGridListToText]] » This function converts grid list contents to text.
*[[getGridListRowIndexFromText]] » This function returns the GridList row index from the specified text.
*[[guiGridListAddPlayers]] » This function add all online players to a grid list.
*[[guiGridListGetColumnIDFromTitle]] » This function gets a gridlist's column ID from the column title.
*[[guiGridListGetSelectedText]] » This function returns a string containing the inner text of a selected gridlist item.
*[[guiGridListSetColumnNonSortable]] » This function makes a gridlist column become non-sortable.
*[[isTextInGridList]] » This function checks if some text exist or not in the GridList.

=====Labels=====
*[[guiLabelAddEffect]] » This function add an effects to the gui-label like (shadow, outline).

=== Marker functions ===
*[[createMarkerAttachedTo]] » This function creates a marker that is attached to an element.

=== Math functions ===
*[[math.clamp]] » This function returns the number between range of numbers or it's minimum or maximum.
*[[math.getBezierPoint]] » Get N-th order bezier point.
*[[math.hypot]] » This function returns the Hypotenuse of the triangle given by sides x and y.
*[[math.isPointInPolygon]] » Check if point is inside polygon or not.
*[[math.lerp]] » Get val between two integer.
*[[math.percent]] » This function returns a percentage from two number values.
*[[math.polygonArea]] » Compute area of any polygon.
*[[math.randomDiff]] » Generates a pseudo-random integer that's always different from the last random number generated.
*[[math.rotVecToEulerAngle]] » Rotation Vector To Euler Angle
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[mathNumber]] » This function is a workaround for the client-side floating-point precision of 24-bits.
*[[reMap]] » Re-maps a number from one range to another.
*[[Math.percentProgress|math.percentProgress]] » Returns a percentage progress from two specific values.
*[[math.average]] » This function returns the simple arithmetic mean of multiple numbers.

=== Map functions ===
*[[assignLod]] » This function lets you conveniently generate and apply a LOD model to a mapping object.
*[[getWorldPositionFromMapPosition]] » This function converts an F11 map position to world position.

=== Ped functions ===
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns a table of the alive players client-side.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getGuestPlayers]] » This function gets a players not login or players Guest .
*[[getOnlineAdmins]] » This function returns a table of all logged-in administrators.
*[[getPedEyesPosition]] » This function allows you to get peds eyes position.
*[[getPedGender]] » This function allows you to get peds their gender.
*[[getPedMaxHealth]] » This function returns a pedestrians's maximum health by converting it from their maximum health stat.
*[[getPedMaxOxygenLevel]] » This function returns a ped's maximum oxygen level by converting it from their maximum underwater stamina stat.
*[[getPedWeaponSkill]] » This function returns a ped's corresponding weapon skill level name.
*[[getPedHitBone]] » This function gets the approximate number of the bone where the ped is hit.
*[[getPlayerFromNamePart]] » This function returns a player from partial name.
*[[getPlayerFromSerial]] » This function returns a player from their serial.
*[[getPlayersByData]] » This function returns a table of players that have the specified data name.
*[[getPlayersInPhotograph]] » This function returns a table of all players in photograph.
*[[getPlayersInVehicles]] » This function returns a table of the players insides vehicles from a specified dimension.
*[[isPedAiming]]» This function checks if a pedestrian is aiming their weapon.
*[[isPedAimingNearPed]] » This is similar to isPedAiming but uses a colshape to be more precise.
*[[isPedDiving]] » This feature checks that pedestrian is diving in the water.
*[[isPedDrivingVehicle]] » This function checks if a specified pedestrian is driving a vehicle.
*[[isPlayerInTeam]] » This function checks if a player is in a specified team.
*[[setPedAttack]] » This function will make a ped attack a specified target.
*[[setPedFollow]] » This function will make a ped follow a specified target.
*[[getPlayerNameFromID]] » This function will get the player name from the ID element data.

=== Player functions ===
*[[countPlayersInRange]] » This function returns the number of players that are within a certain range of the specified coordinates.
*[[getPlayerPreviousAndNextWeapon]] » This function returns the player previous and next weapon.
*[[getPlayersInRange]] » This function make a table of players within certain range.
*[[isPlayerActuallyInVehicle]] » This function checks if a player is actually in a vehicle instead of just in the process of entering.
*[[isPlayerHitByVehicle]] » This function cancels event when a element is hit by a vehicle.

=== Resource functions ===
*[[getFilesInResourceFolder]] » This function gets a list of files that are inside a folder of a resource.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceSize]] » This function returns the size of a specified resource in kB(kilobyte)
*[[refreshResource]] » This function refreshes your resource if you changed any of the files
*[[setResourcePriority]] » This function set resource download priority group.

=== Sound functions ===
*[[isSoundFinished]] » This function checks if a sound element has finished.
*[[isSoundPlaying]] » This function checks if a sound element is playing or not.
*[[stopSoundSlowly]] » This function stop your sound element slowly.

=== Browser functions ===
*[[playVideo]] » This function plays a video on the screen.

=== Team functions ===
*[[getTeamFromColor]] » This function returns a team element by the specified color.
*[[getTeamWithFewestPlayers]] » This function returns a team element with least players of all the specified teams.

=== Vehicle functions ===
*[[findEmptyCarSeat]] » This function finds you the first empty seat in a vehicle.
*[[getNearestVehicle]] » This function gets the nearest vehicle to the specified player in a specified distance.
*[[getRandomVehicle]] » This function gets a random vehicle.
*[[getValidVehicleModels]] » This function returns a table of all valid vehicle models.
*[[getVehiclesCountByType]] » This function returns the amount of vehicles by the given type as an integer value.
*[[getVehicleTurnVelocityCenterOfMass]]» This function gets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[isVehicleDoubleExhaust]] » This function checks is exhaust vehicle double.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isVehicleOccupied]] » This function checks if a specified vehicle is occupied.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleOnFire]] » This function checks if the vehicle is on fire or not.
*[[isVehicleReversing]] » This function checks if a specified vehicle is moving backwards.
*[[isVehicleUpgraded]] » This function checks is vehicle upgraded by upgrade ID.
*[[setVehicleGravityPoint]] » This function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[setVehicleTurnVelocityCenterOfMass]] » This function sets a vehicle's turn velocity relative to the vehicle's center or mass.
*[[setVehicleHandlingFromText]] » This function sets a vehicle's handling from text.
*[[setVehicleWheelModel]] » This function changes the wheel model of the informed vehicle.

=== Weapon functions ===
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.

=== Object functions ===
*[[getDynamicDoorObjectOpenRatio]] » This function tells you how open a dynamic door is in a range from 0 to 1.
*[[isElementObject]] » This function tells you if an element is an object or no.

=== XML functions ===
*[[getXMLNodes]] » This function returns all children of a XML node.

=== Engine functions ===
*[[engineGetCOLsFromLibrary]] » This function gets the collision data from the col library.
*[[engineLoadIMGContainer]] » This function loads the IMG container.

=== Utility ===
*[[animate]] » This function allows you to use interpolateBetween without render event and easily used.
*[[callClientFunction]] » This function allows you to call any client-side function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[check]] » This function checks if its arguments are of the right type and calls the error-function if one is not.
*[[checkPassiveTimer]] » This function allows you to use passive timers in your conditions. For example you want to prevent players repeatedly using a command.
*[[coroutine.resume]] » This function applies a fix for hidden coroutine error messages.
*[[compact]] » This function create table containing variables and their values.
*[[getBanFromName]] » This functions returns the ban of the given playername.
*[[getCurrentFPS]] » This function returns the frames per second at which GTA: SA is running.
*[[getSkinNameFromID]] » This function returns the name of the skin from the given id.
*[[IfElse]] » This function returns one of two values based on a boolean expression.
*[[isCharInString]] » This shared function allows you to check if a char specified is in a string value.
*[[isLastExecuteInTimer]] » This function check if the execute is the last execute in the timer.
*[[isMouseInCircle]] » This function checks if a cursor position is in circular area or not.
*[[isMouseInPosition]] » This function allows you to check whether the mouse cursor/pointer is within a rectangular position.
*[[iterElements]] » This function returns ''a time-saving'' iterator for your for-loops.
*[[PlotTrajectoryAtTime]] » Calculate projectile/water trajectory.
*[[preprocessor]] » This function allow you to use gcc macros.
*[[vector3:compare]] » This method checks whether two vectors match, with optional precision.
*[[svgCreateRoundedRectangle]] » This function creates a rectangle with rounded edges.
*[[debounce]] » This function is removing unwanted input noise.

<noinclude>[[Category:Useful Functions]]</noinclude>

Debounce

2023-10-06T16:09:34Z

CrosRoad95: Created page with "{{Useful Function}} <lowercasetitle></lowercasetitle> __NOTOC__ This function is removing unwanted input noise from buttons, switches or other user input. see: https://www.techtarget.com/whatis/definition/debouncing ==Syntax== <syntaxhighlight lang="lua"> void debounce( number timeout, function callback, ...arguments) </syntaxhighlight> ==Code== <section name="Shared" class="both" show="true"> <syntaxhighlight lang="lua"> local debounces = {} function debounce(timeou..."

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function is removing unwanted input noise from buttons, switches or other user input.
see: https://www.techtarget.com/whatis/definition/debouncing

==Syntax==
<syntaxhighlight lang="lua">
void debounce( number timeout, function callback, ...arguments)
</syntaxhighlight>

==Code==
<section name="Shared" class="both" show="true">
<syntaxhighlight lang="lua">
local debounces = {}

function debounce(timeout, callback, ...)
local id = tostring(callback)

if(isTimer(debounces[id]))then
killTimer(debounces[id])
debounces[id] = nil;
end
debounces[id] = setTimer(function(...)
callback(...)
debounces[id] = nil;
end, timeout, 1, ...)
end
</syntaxhighlight>
</section>

'''Author:''' CrosRoad95

==Example==
<section name="Shared" class="both" show="true">
This example will ignore first 9 calls and only last one get called within 500ms timeout
<syntaxhighlight lang="lua">
function callback(i)
print(i)
end

for i=1,10 do
debounce(500, callback, i);
end

-- Result in console: 10
</syntaxhighlight>
</section>

==See Also==

{{Useful_Functions}}

EngineRequestModel

2023-09-03T10:13:16Z

CrosRoad95:

__NOTOC__
{{Client function}}
{{New feature/item|3.0158|1.5.7|20147|This function is used to assign the next available model ID to a certain element type.}}
{{note|Before release '''1.5.8 r20716''' this must be "ped". After release '''1.5.8 r20716''' this function supports "vehicle" and "object" too.}}
{{note|Vehicle unique features may be unsupported, see [https://github.com/multitheftauto/mtasa-blue/issues/1861 issue 1861] for examples and details}}
{{Important Note|Unlike some other functions, the side-effects of this function aren't reverted on resource stop, so you must manually call [[engineFreeModel]] in [[onClientResourceStop]] (Just like the example below does)}}
==Syntax==
<syntaxhighlight lang="lua">
int engineRequestModel ( string elementType [, int parentID ] )
</syntaxhighlight>
===Required Arguments===
*'''elementType''': "ped", "object", "vehicle", "timed-object", "clump"

===Optional Arguments===
*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds, 3425 - clump models, 4715 - timed objects).

===Returns===
{{New feature/item|3.0158|1.5.7|20147| Returns an ''integer'' of the model ID that was available to be assigned to the element type, ''false'' if no free model ID available or invalid element type.}}
Do not rely on the model numbers returned being consistent across multiple clients or multiple runs of resources. There is no guarantee for the order of the numbers or that the same numbers will always correspond to the same element type. Any patterns are coincidental.

==Example==
This example creates a ped and then gives you the opportunity to change its model. If the resource stops, then the IDs allocated will be deallocated. Use ''/cap'' for creating the ped and ''/sap'' to skin the ped. You will need some skins added to a folder and to the meta.xml for ''/sap'' to work:
<syntaxhighlight lang="lua">
local peds = {}
function createAllocatedPed()
local x, y, z = getElementPosition(localPlayer)
local id = engineRequestModel("ped")
peds[id] = createPed(id, x+0.5, y, z+0.5)
outputChatBox("New ped with ID "..id.." created.")
end
addCommandHandler("cap", createAllocatedPed, false, false)

function skinAllocatedPeds()
local txd, dff;
for id,ped in pairs(peds) do
if fileExists("skins/" .. id .. ".txd") and fileExists("skins/" .. id .. ".dff") then
txd = engineLoadTXD("skins/" .. id .. ".txd")
engineImportTXD(txd, id)
dff = engineLoadDFF("skins/" .. id .. ".dff")
engineReplaceModel(dff, id)
outputChatBox("Model ID "..id.." changed correctly.")
else
outputChatBox("Model ID "..id.." couldn't change. REASON: skins/" .. id .. ".txd or skins/" .. id .. ".dff does not exist.")
end
end
end
addCommandHandler("sap", skinAllocatedPeds, false, false)

function onStop()
for id,ped in pairs(peds) do
engineFreeModel(id)
end
end
addEventHandler("onClientResourceStop", resourceRoot, onStop)
</syntaxhighlight>

==Requirements==
{{Requirements|n/a|1.5.7-9.20147|}}

==See Also==
{{Engine functions}}

DxCreateRenderTarget

2023-08-10T16:34:17Z

CrosRoad95:

{{Client function}}
__NOTOC__
This function creates a render target element, which is a special type of [[texture]] that can be drawn on with the dx functions. Successful render target creation is not guaranteed, and may fail due to hardware or memory limitations.

To see if creation is likely to fail, use [[dxGetStatus]]. (When '''VideoMemoryFreeForMTA''' is zero, failure ''is'' guaranteed.)
{{Tip|Use [[dxSetBlendMode]] to get better quality}}
{{Tip|It is highly recommended that [[dxSetTestMode]] is used when writing and testing scripts using dxCreateRenderTarget.}}
{{Note|Render targets are usually cleared when the player minimizes MTA (i.e. alt-tab). See [[onClientRestore]] for details on when to restore any fixed content.}}

==Syntax==
<syntaxhighlight lang="lua">
element dxCreateRenderTarget ( int width, int height [, bool withAlpha = false ] )
</syntaxhighlight>
{{Added feature/item|1.6.1|1.6.0|21938|
<syntaxhighlight lang="lua">
element dxCreateRenderTarget ( int width, int height, surface-format surfaceFormat )
</syntaxhighlight>
}}
{{OOP||[[Texture|DxRenderTarget]]}}
===Required Arguments===
*'''width :''' The width of the texture in pixels.
*'''height :''' The height of the texture in pixels.
*'''withAlpha:''' The render target will be created with an alpha channel. 'false' will turn images' alpha channels to black color
{{Added feature/item|1.6.1|1.6.0|21938|
*'''surfaceFormat :''' See [[Surface format|Surface formats]]
}}

===Returns===
Returns a [[texture]] element if successful, ''false'' if the system is unable to create a render target.

'''You should always check to see if this function has returned false.'''

==Explanation==
What is a render target?

A render target is like a blank canvas. You can draw on the render target as many times as you like - and even clear it.

If your dxDraw* calls are static (meaning the appearance doesn't change), or only update periodically, then a render target can be useful not only for cleaner code - but for performance reasons too. Instead of making possibly hundreds of dxDraw* calls every frame, you can simply make those calls on a single frame and draw directly to the render target, then use a '''single''' dxDrawImage call every frame afterwards to display the render target.

Render targets can also be used to create and display the same thing multiple times, as shown in the example below.

==Example==
<syntaxhighlight lang="lua">
local myRenderTarget

addEventHandler("onClientResourceStart", resourceRoot,
function()
myRenderTarget = dxCreateRenderTarget(250, 100, true) -- Create a render target

if (myRenderTarget) then
updateRenderTarget() -- Our function to draw to the render target (see below)
end
end
)

addEventHandler( "onClientRender", root,
function()
if myRenderTarget then
-- Draw the render target lots of times in different positions on the screen
dxDrawImage(350, 50, 250, 100, myRenderTarget)
dxDrawImage(450, 380, 250, 100, myRenderTarget)
dxDrawImage(550, 250, 250, 100, myRenderTarget)
dxDrawImage(650, 70, 250, 100, myRenderTarget)
end
end
)

function updateRenderTarget()
dxSetRenderTarget(myRenderTarget, true)
dxSetBlendMode("modulate_add") -- Set 'modulate_add' when drawing stuff on the render target

dxDrawText("Hello " .. getTickCount(), 10, 10, 0, 0, tocolor(255, 255, 255, 255), 2, "clear") -- Draw a message
dxDrawRectangle(10, 50, 40, 40, tocolor(math.random(255), math.random(255), math.random(255))) -- Draw a square with random color

-- ... etc, imagine you have a lot of dxDraw* calls to make, this is where render targets come in handy!

dxSetBlendMode("blend") -- Restore default blending
dxSetRenderTarget() -- Restore default render target
end

-- We can even update the render target on the fly, by binding it to a key
bindKey("r", "down", updateRenderTarget)

</syntaxhighlight>

==See Also==
{{Drawing_functions}}

[[hu:dxCreateRenderTarget]]

Surface format

2023-08-10T16:33:09Z

CrosRoad95: Add surface format page

Based on: https://learn.microsoft.com/en-us/windows/win32/direct3d9/d3dformat
{| class="wikitable"
!Name
!Description
|-
|r8g8b8
| 32-bit ARGB pixel format with alpha, using 8 bits per channel.
|-
|a8r8g8b8
| 32-bit ARGB pixel format with alpha, using 8 bits per channel.
|-
|x8r8g8b8
|32-bit RGB pixel format, where 8 bits are reserved for each color.
|-
|r5g6b5
|16-bit RGB pixel format with 5 bits for red, 6 bits for green, and 5 bits for blue.
|-
|x1r5g5b5
|16-bit pixel format where 5 bits are reserved for each color.
|-
|a1r5g5b5
|16-bit pixel format where 5 bits are reserved for each color and 1 bit is reserved for alpha.
|-
|a4r4g4b4
|16-bit ARGB pixel format with 4 bits for each channel.
|-
|r3g3b2
|8-bit RGB texture format using 3 bits for red, 3 bits for green, and 2 bits for blue.
|-
|a8
|8-bit alpha only.
|-
|a8r3g3b2
|16-bit ARGB texture format using 8 bits for alpha, 3 bits each for red and green, and 2 bits for blue.
|-
|x4r4g4b4
|16-bit RGB pixel format using 4 bits for each color.
|-
|a2b10g10r10
|32-bit pixel format using 10 bits for each color and 2 bits for alpha.
|-
|a8b8g8r8
|32-bit ARGB pixel format with alpha, using 8 bits per channel.
|-
|x8b8g8r8
|32-bit RGB pixel format, where 8 bits are reserved for each color.
|-
|g16r16
|32-bit pixel format using 16 bits each for green and red.
|-
|a2r10g10b10
|32-bit pixel format using 10 bits each for red, green, and blue, and 2 bits for alpha.
|-
|a16b16g16r16
|64-bit pixel format using 16 bits for each component.
|-
|a8p8
|8-bit color indexed with 8 bits of alpha.
|-
|p8
|8-bit color indexed.
|-
|l8
|8-bit luminance only.
|-
|l16
|16-bit luminance only.
|-
|a8l8
|16-bit using 8 bits each for alpha and luminance.
|-
|r8g8b8
|24-bit RGB pixel format with 8 bits per channel.
|-
|a4l4
|8-bit using 4 bits each for alpha and luminance.
|-
|r16f
|16-bit float format using 16 bits for the red channel.
|-
|g16r16f
|32-bit float format using 16 bits for the red channel and 16 bits for the green channel.
|-
|a16b16g16r16f
|64-bit float format using 16 bits for the each channel (alpha, blue, green, red).
|-
|r32f
|32-bit float format using 32 bits for the red channel.
|-
|g32r32f
|64-bit float format using 32 bits for the red channel and 32 bits for the green channel.
|-
|a32b32g32r32f
|128-bit float format using 32 bits for the each channel (alpha, blue, green, red).
|}

ReloadBrowserPage

2023-08-09T14:27:29Z

CrosRoad95: add missing "ignoreCache" argument

__NOTOC__
{{Client function}}
{{New feature/item|3.0153|1.5.3|9912|
This function reloads the current browser's page.
}}

==Syntax==
<syntaxhighlight lang="lua">
bool reloadBrowserPage( browser webBrowser [, bool ignoreCache ] )
</syntaxhighlight>

===Required Arguments===
*'''webBrowser:''' The browser that you want to reload.
*'''ignoreCache :''' Ignoring cached content, Equivalent to "Shift + F5" in most browsers

===Returns===
Returns ''true'' if the browser has reloaded, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This example creates a browser that can return to the last and previous pages and can also be refreshed:
<syntaxhighlight lang="lua">
window = guiCreateWindow(126, 122, 848, 674, "Firechrome", false)
guiWindowSetSizable(window, false)

navigateBackBtn = guiCreateButton(10, 19, 39, 36, "<", false, window)
navigateForwardBtn = guiCreateButton(98, 19, 39, 36, ">", false, window)
addressBar = guiCreateEdit(137, 19, 701, 36, "", false, window)
guiSetEnabled( addressBar, false )
reloadBtn = guiCreateButton(49, 19, 49, 36, "reload", false, window)
browser = guiCreateBrowser(10, 55, 828, 609, false, false, false, window)

-- Load our page on browser creation.
local theBrowser = guiGetBrowser(browser)
addEventHandler("onClientBrowserCreated", theBrowser,
function()
loadBrowserURL(source, "https://forum.mtasa.com/")
end
)

-- This checks to see if the browser can navigate in any direction and enables the back or forward buttons
addEventHandler( "onClientBrowserDocumentReady", theBrowser, function( )
navigateForwardBtn.enabled = (canBrowserNavigateForward(theBrowser))
navigateBackBtn.enabled = (canBrowserNavigateBack(theBrowser))
guiSetText( addressBar, getBrowserURL( theBrowser ) )
end )

-- This part handles the GUI navigation buttons for the browser.
addEventHandler( "onClientGUIClick", resourceRoot, function ( )
if source == navigateBackBtn then
navigateBrowserBack(theBrowser)
elseif source == navigateForwardBtn then
navigateBrowserForward(theBrowser)
elseif source == reloadBtn then
reloadBrowserPage(theBrowser)
end
end )
</syntaxhighlight>
</section>

==See Also==
{{CEF_functions}}

[[hu:reloadBrowserPage]]
[[RO:reloadBrowserPage]]

Math.lerp

2023-03-12T06:02:10Z

CrosRoad95: add variant of mathlerp that doesn't care about order of number

{{Useful Function}}
==Syntax==
<syntaxhighlight lang="lua">int math.lerp(int from, int to, int val)</syntaxhighlight>

===Required Arguments===
* '''val''': The number from 0 to 1

===Returns===
Returns a number if everything went good, ''to'' otherwise.

==Code==
<syntaxhighlight lang="lua">
-- Where b must be greater than a
function math.lerp(a, b, k)
local result = a * (1-k) + b * k
if result >= b then
result = b
elseif result <= a then
result = a
end
return result
end

function math.lerp(a, b, k)
if(a > b)then
local _a = a;
a = b;
b = _a;
end
local result = a * (1-k) + b * k
if result >= b then
result = b
elseif result <= a then
result = a
end
return result
end
</syntaxhighlight>

==Example==
<syntaxhighlight lang="lua">
math.lerp(100, 250, 0.5)
-- Returns: 175
</syntaxhighlight>

==See Also==
{{Useful_Functions}}

GetPointFromDistanceRotation

2023-03-11T17:38:49Z

CrosRoad95: Remove unnecessary new lines

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function takes a set of XY coordinates, a distance and a rotation argument. It returns XY coordinates of the point that is the given distance away from the given point, in the given direction.

==Syntax==
<syntaxhighlight lang="lua">float, float getPointFromDistanceRotation(float x, float y, float dist, float angle)</syntaxhighlight>

===Required Arguments===
* '''x''': The X coordinate of the starting point.
* '''y''': The Y coordinate of the starting point.
* '''dist''': The distance from the starting point to the target point.
* '''angle''': The direction from the starting point to the target point.

==Code==
<section name="Function source" class="both" show="true">
<syntaxhighlight lang="lua">
function getPointFromDistanceRotation(x, y, dist, angle)
local a = math.rad(90 - angle);
local dx = math.cos(a) * dist;
local dy = math.sin(a) * dist;
return x+dx, y+dy;
end
</syntaxhighlight>
</section>

==Example==
<section name="Server" class="server" show="true">
This command surrounds a player with peds.
<syntaxhighlight lang="lua">
addCommandHandler("surround",
function (player)

local x,y,z = getElementPosition(player);

for i=1, 8 do
local newX, newY = getPointFromDistanceRotation(x, y, 2, 360 * (i/8));
createPed(10, newX, newY, z)
end

end
);
</syntaxhighlight>
</section>

Author: robhol.

==See Also==
{{Useful_Functions}}

Vehicle Upgrades

2021-08-28T15:26:50Z

CrosRoad95: typo, should be Stratum not Statum

{| class="wikitable sortable" style="width:100%;"
|-
! scope="col"| ID
! scope="col"| Modelname
! scope="col"| Part
! scope="col"| Type
! scope="col"| Cars
|-
| '''1000''' || spl_b_mar_m || Spoiler || Pro || Certain Transfender cars
|-
| '''1001''' || spl_b_bab_m || Spoiler || Win || Certain Transfender cars
|-
| '''1002''' || spl_b_bar_m || Spoiler || Drag || Certain Transfender cars
|-
| '''1003''' || spl_b_mab_m || Spoiler || Alpha || Certain Transfender cars
|-
| '''1004''' || bnt_b_sc_m || Vents || Champ Scoop || Certain Transfender cars
|-
| '''1005''' || bnt_b_sc_l || Vents || Fury Scoop || Certain Transfender cars
|-
| '''1006''' || rf_b_sc_r || Roof || Roof Scoop || Certain Transfender cars
|-
| '''1007''' || wg_l_b_ssk || Sideskirt || Right Sideskirt || Certain Transfender cars
|-
| '''1008''' || nto_b_l || Nitro || 5 times || Most cars
|-
| '''1009''' || nto_b_s || Nitro || 2 times || Most cars
|-
| '''1010''' || nto_b_tw || Nitro || 10 times || Most cars
|-
| '''1011''' || bnt_b_sc_p_m || Vents || Race Scoop || Certain Transfender cars
|-
| '''1012''' || bnt_b_sc_p_l || Vents || Worx Scoop || Certain Transfender cars
|-
| '''1013''' || lgt_b_rspt || Lamps || Round Fog || Certain Transfender cars
|-
| '''1014''' || spl_b_bar_l || Spoiler || Champ || Certain Transfender cars
|-
| '''1015''' || spl_b_bbr_l || Spoiler || Race || Certain Transfender cars
|-
| '''1016''' || spl_b_bbr_m || Spoiler || Worx || Certain Transfender cars
|-
| '''1017''' || wg_r_b_ssk || Sideskirt || Left Sideskirt || Certain Transfender cars
|-
| '''1018''' || exh_b_ts || Exhaust || Upswept || Certain Transfender cars
|-
| '''1019''' || exh_b_t || Exhaust || Twin || Certain Transfender cars
|-
| '''1020''' || exh_b_l || Exhaust || Large || Certain Transfender cars
|-
| '''1021''' || exh_b_m || Exhaust || Medium || Certain Transfender cars
|-
| '''1022''' || exh_b_s || Exhaust || Small || Certain Transfender cars
|-
| '''1023''' || spl_b_bbb_m || Spoiler || Fury || Certain Transfender cars
|-
| '''1024''' || lgt_b_sspt || Lamps || Square Fog || Certain Transfender cars
|-
| '''1025''' || wheel_or1 || Wheels || Offroad || Certain Transfender cars
|-
| '''1026''' || wg_l_a_s || Sideskirt || Right Alien Sideskirt || Sultan
|-
| '''1027''' || wg_r_a_s || Sideskirt || Left Alien Sideskirt || Sultan
|-
| '''1028''' || exh_a_s || Exhaust || Alien || Sultan
|-
| '''1029''' || exh_c_s || Exhaust || X-Flow || Sultan
|-
| '''1030''' || wg_r_c_s || Sideskirt || Left X-Flow Sideskirt || Sultan
|-
| '''1031''' || wg_l_c_s || Sideskirt || Right X-Flow Sideskirt || Sultan
|-
| '''1032''' || rf_a_s || Roof || Alien Roof Vent || Sultan
|-
| '''1033''' || rf_c_s || Roof || X-Flow Roof Vent || Sultan
|-
| '''1034''' || exh_a_l || Exhaust || Alien || Elegy
|-
| '''1035''' || rf_c_l || Roof || X-Flow Roof Vent || Elegy
|-
| '''1036''' || wg_l_a_l || SideSkirt || Right Alien Sideskirt || Elegy
|-
| '''1037''' || exh_c_l || Exhaust || X-Flow || Elegy
|-
| '''1038''' || rf_a_l || Roof || Alien Roof Vent || Elegy
|-
| '''1039''' || wg_l_c_l || SideSkirt || Left X-Flow Sideskirt || Elegy
|-
| '''1040''' || wg_r_a_l || SideSkirt || Left Alien Sideskirt || Elegy
|-
| '''1041''' || wg_r_c_l || SideSkirt || Right X-Flow Sideskirt || Elegy
|-
| '''1042''' || wg_l_lr_br1 || SideSkirt || Right Chrome Sideskirt || Broadway
|-
| '''1043''' || exh_lr_br2 || Exhaust || Slamin || Broadway
|-
| '''1044''' || exh_lr_br1 || Exhaust || Chrome || Broadway
|-
| '''1045''' || exh_c_f || Exhaust || X-Flow || Flash
|-
| '''1046''' || exh_a_f || Exhaust || Alien || Flash
|-
| '''1047''' || wg_l_a_f || SideSkirt || Right Alien Sideskirt || Flash
|-
| '''1048''' || wg_l_c_f || SideSkirt || Right X-Flow Sideskirt || Flash
|-
| '''1049''' || spl_a_f_r || Spoiler || Alien || Flash
|-
| '''1050''' || spl_c_f_r || Spoiler || X-Flow || Flash
|-
| '''1051''' || wg_r_a_f || SideSkirt || Left Alien Sideskirt || Flash
|-
| '''1052''' || wg_r_c_f || SideSkirt || Left X-Flow Sideskirt || Flash
|-
| '''1053''' || rf_c_f || Roof || X-Flow || Flash
|-
| '''1054''' || rf_a_f || Roof || Alien || Flash
|-
| '''1055''' || rf_a_st || Roof || Alien || Stratum
|-
| '''1056''' || wg_l_a_st || Sideskirt || Right Alien Sideskirt || Stratum
|-
| '''1057''' || wg_l_c_st || Sideskirt || Right X-Flow Sideskirt || Stratum
|-
| '''1058''' || spl_a_st_r || Spoiler || Alien || Stratum
|-
| '''1059''' || exh_c_st || Exhaust || X-Flow || Stratum
|-
| '''1060''' || spl_c_st_r || Spoiler || X-Flow || Stratum
|-
| '''1061''' || rf_c_st || Roof || X-Flow || Stratum
|-
| '''1062''' || wg_r_a_st || Sideskirt || Left Alien Sideskirt || Stratum
|-
| '''1063''' || wg_r_c_st || Sideskirt || Left X-Flow Sideskirt || Stratum
|-
| '''1064''' || exh_a_st || Exhaust || Alien || Stratum
|-
| '''1065''' || exh_a_j || Exhaust || Alien || Jester
|-
| '''1066''' || exh_c_j || Exhaust || X-Flow || Jester
|-
| '''1067''' || rf_a_j || Roof || Alien || Jester
|-
| '''1068''' || rf_c_j || Roof || X-Flow || Jester
|-
| '''1069''' || wg_l_a_j || Sideskirt || Right Alien Sideskirt || Jester
|-
| '''1070''' || wg_l_c_j || Sideskirt || Right X-Flow Sideskirt || Jester
|-
| '''1071''' || wg_r_a_j || Sideskirt || Left Alien Sideskirt || Jester
|-
| '''1072''' || wg_r_c_j || Sideskirt || Left X-Flow Sideskirt || Jester
|-
| '''1073''' || wheel_sr6 || Wheels || Shadow || Most cars
|-
| '''1074''' || wheel_sr3 || Wheels || Mega || Most cars
|-
| '''1075''' || wheel_sr2 || Wheels || Rimshine || Most cars
|-
| '''1076''' || wheel_lr4 || Wheels || Wires || Most cars
|-
| '''1077''' || wheel_lr1 || Wheels || Classic || Most cars
|-
| '''1078''' || wheel_lr3 || Wheels || Twist || Most cars
|-
| '''1079''' || wheel_sr1 || Wheels || Cutter || Most cars
|-
| '''1080''' || wheel_sr5 || Wheels || Switch || Most cars
|-
| '''1081''' || wheel_sr4 || Wheels || Grove || Most cars
|-
| '''1082''' || wheel_gn1 || Wheels || Import || Most cars
|-
| '''1083''' || wheel_lr2 || Wheels || Dollar || Most cars
|-
| '''1084''' || wheel_lr5 || Wheels || Trance || Most cars
|-
| '''1085''' || wheel_gn2 || Wheels || Atomic || Most cars
|-
| '''1086''' || stereo || Stereo || Stereo || Most cars
|-
| '''1087''' || hydralics || Hydraulics || Hydraulics || Most cars
|-
| '''1088''' || rf_a_u || Roof || Alien || Uranus
|-
| '''1089''' || exh_c_u || Exhaust || X-Flow || Uranus
|-
| '''1090''' || wg_l_a_u || Sideskirt || Right Alien Sideskirt || Uranus
|-
| '''1091''' || rf_c_u || Roof || X-Flow || Uranus
|-
| '''1092''' || exh_a_u || Exhaust || Alien || Uranus
|-
| '''1093''' || wg_l_c_u || Sideskirt || Right X-Flow Sideskirt || Uranus
|-
| '''1094''' || wg_r_a_u || Sideskirt || Left Alien Sideskirt || Uranus
|-
| '''1095''' || wg_r_c_u || Sideskirt || Right X-Flow Sideskirt || Uranus
|-
| '''1096''' || wheel_gn3 || Wheels || Ahab || Most cars
|-
| '''1097''' || wheel_gn4 || Wheels || Virtual || Most cars
|-
| '''1098''' || wheel_gn5 || Wheels || Access || Most cars
|-
| '''1099''' || wg_r_lr_br1 || Sideskirt || Left Chrome Sideskirt || Broadway
|-
| '''1100''' || misc_c_lr_rem1 || Bullbar || Chrome Grill || Remington
|-
| '''1101''' || wg_r_lr_rem1 || Sideskirt || Left `Chrome Flames` Sideskirt || Remington
|-
| '''1102''' || wg_r_lr_sv || Sideskirt || Left `Chrome Strip` Sideskirt || Savanna
|-
| '''1103''' || rf_lr_bl2 || Roof || Covertible || Blade
|-
| '''1104''' || exh_lr_bl1 || Exhaust || Chrome || Blade
|-
| '''1105''' || exh_lr_bl2 || Exhaust || Slamin || Blade
|-
| '''1106''' || wg_l_lr_rem2 || Sideskirt || Right `Chrome Arches` || Remington
|-
| '''1107''' || wg_r_lr_bl1 || Sideskirt || Left `Chrome Strip` Sideskirt || Blade
|-
| '''1108''' || wg_l_lr_bl1 || Sideskirt || Right `Chrome Strip` Sideskirt || Blade
|-
| '''1109''' || bbb_lr_slv1 || Rear Bullbars || Chrome || Slamvan
|-
| '''1110''' || bbb_lr_slv2 || Rear Bullbars || Slamin || Slamvan
|-
| '''1111''' || bnt_lr_slv1 || Front Sign? || Little Sign? || Slamvan
|-
| '''1112''' || bnt_lr_slv2 || Front Sign? || Little Sign? || Slamvan
|-
| '''1113''' || exh_lr_slv1 || Exhaust || Chrome || Slamvan
|-
| '''1114''' || exh_lr_slv2 || Exhaust || Slamin || Slamvan
|-
| '''1115''' || fbb_lr_slv1 || Front Bullbars || Chrome || Slamvan
|-
| '''1116''' || fbb_lr_slv2 || Front Bullbars || Slamin || Slamvan
|-
| '''1117''' || fbmp_lr_slv1 || Front Bumper || Chrome || Slamvan
|-
| '''1118''' || wg_l_lr_slv1 || Sideskirt || Right `Chrome Trim` Sideskirt || Slamvan
|-
| '''1119''' || wg_l_lr_slv2 || Sideskirt || Right `Wheelcovers` Sideskirt || Slamvan
|-
| '''1120''' || wg_r_lr_slv1 || Sideskirt || Left `Chrome Trim` Sideskirt || Slamvan
|-
| '''1121''' || wg_r_lr_slv2 || Sideskirt || Left `Wheelcovers` Sideskirt || Slamvan
|-
| '''1122''' || wg_l_lr_rem1 || Sideskirt || Right `Chrome Flames` Sideskirt || Remington
|-
| '''1123''' || misc_c_lr_rem2 || Bullbars || Bullbar Chrome Bars || Remington
|-
| '''1124''' || wg_r_lr_rem2 || Sideskirt || Left `Chrome Arches` Sideskirt || Remington
|-
| '''1125''' || misc_c_lr_rem3 || Bullbars || Bullbar Chrome Lights || Remington
|-
| '''1126''' || exh_lr_rem1 || Exhaust || Chrome Exhaust || Remington
|-
| '''1127''' || exh_lr_rem2 || Exhaust || Slamin Exhaust || Remington
|-
| '''1128''' || rf_lr_bl1 || Roof || Vinyl Hardtop || Blade
|-
| '''1129''' || exh_lr_sv1 || Exhaust || Chrome || Savanna
|-
| '''1130''' || rf_lr_sv1 || Roof || Hardtop || Savanna
|-
| '''1131''' || rf_lr_sv2 || Roof || Softtop || Savanna
|-
| '''1132''' || exh_lr_sv2 || Exhaust || Slamin || Savanna
|-
| '''1133''' || wg_l_lr_sv || Sideskirt || Right `Chrome Strip` Sideskirt || Savanna
|-
| '''1134''' || wg_l_lr_t1 || SideSkirt || Right `Chrome Strip` Sideskirt || Tornado
|-
| '''1135''' || exh_lr_t2 || Exhaust || Slamin || Tornado
|-
| '''1136''' || exh_lr_t1 || Exhaust || Chrome || Tornado
|-
| '''1137''' || wg_r_lr_t1 || Sideskirt || Left `Chrome Strip` Sideskirt || Tornado
|-
| '''1138''' || spl_a_s_b || Spoiler || Alien || Sultan
|-
| '''1139''' || spl_c_s_b || Spoiler || X-Flow || Sultan
|-
| '''1140''' || rbmp_c_s || Rear Bumper || X-Flow || Sultan
|-
| '''1141''' || rbmp_a_s || Rear Bumper || Alien || Sultan
|-
| '''1142''' || bntr_b_ov || Hood || Left Oval Hoods || Certain Transfender Cars
|-
| '''1143''' || bntl_b_ov || Hood || Right Oval Hoods || Certain Transfender Cars
|-
| '''1144''' || bntr_b_sq || Hood || Left Square Hoods || Certain Transfender Cars
|-
| '''1145''' || bntl_b_sq || Hood || Right Square Hoods || Certain Transfender Cars
|-
| '''1146''' || spl_c_l_b || Spoiler || X-Flow || Elegy
|-
| '''1147''' || spl_a_l_b || Spoiler || Alien || Elegy
|-
| '''1148''' || rbmp_c_l || Rear Bumper || X-Flow || Elegy
|-
| '''1149''' || rbmp_a_l || Rear Bumper || Alien || Elegy
|-
| '''1150''' || rbmp_a_f || Rear Bumper || Alien || Flash
|-
| '''1151''' || rbmp_c_f || Rear Bumper || X-Flow || Flash
|-
| '''1152''' || fbmp_c_f || Front Bumper || X-Flow || Flash
|-
| '''1153''' || fbmp_a_f || Front Bumper || Alien || Flash
|-
| '''1154''' || rbmp_a_st || Rear Bumper || Alien || Stratum
|-
| '''1155''' || fbmp_a_st || Front Bumper || Alien || Stratum
|-
| '''1156''' || rbmp_c_st || Rear Bumper || X-Flow || Stratum
|-
| '''1157''' || fbmp_c_st || Front Bumper || X-Flow || Stratum
|-
| '''1158''' || spl_c_j_b || Spoiler || X-Flow || Jester
|-
| '''1159''' || rbmp_a_j || Rear Bumper || Alien || Jester
|-
| '''1160''' || fbmp_a_j || Front Bumper || Alien || Jester
|-
| '''1161''' || rbmp_c_j || Rear Bumper || X-Flow || Jester
|-
| '''1162''' || spl_a_j_b || Spoiler || Alien || Jester
|-
| '''1163''' || spl_c_u_b || Spoiler || X-Flow || Uranus
|-
| '''1164''' || spl_a_u_b || Spoiler || Alien || Uranus
|-
| '''1165''' || fbmp_c_u || Front Bumper || X-Flow || Uranus
|-
| '''1166''' || fbmp_a_u || Front Bumper || Alien || Uranus
|-
| '''1167''' || rbmp_c_u || Rear Bumper || X-Flow || Uranus
|-
| '''1168''' || rbmp_a_u || Rear Bumper || Alien || Uranus
|-
| '''1169''' || fbmp_a_s || Front Bumper || Alien || Sultan
|-
| '''1170''' || fbmp_c_s || Front Bumper || X-Flow || Sultan
|-
| '''1171''' || fbmp_a_l || Front Bumper || Alien || Elegy
|-
| '''1172''' || fbmp_c_l || Front Bumper || X-Flow || Elegy
|-
| '''1173''' || fbmp_c_j || Front Bumper || X-Flow || Jester
|-
| '''1174''' || fbmp_lr_br1 || Front Bumper || Chrome || Broadway
|-
| '''1175''' || fbmp_lr_br2 || Rear Bumper || Slamin || Broadway
|-
| '''1176''' || rbmp_lr_br1 || Front Bumper || Chrome || Broadway
|-
| '''1177''' || rbmp_lr_br2 || Rear Bumper || Slamin || Broadway
|-
| '''1178''' || rbmp_lr_rem2 || Rear Bumper || Slamin || Remington
|-
| '''1179''' || fbmp_lr_rem1 || Front Bumper || Chrome || Remington
|-
| '''1180''' || rbmp_lr_rem1 || Rear Bumper || Chrome || Remington
|-
| '''1181''' || fbmp_lr_bl2 || Front Bumper || Slamin || Blade
|-
| '''1182''' || fbmp_lr_bl1 || Front Bumper || Chrome || Blade
|-
| '''1183''' || rbmp_lr_bl2 || Rear Bumper || Slamin || Blade
|-
| '''1184''' || rbmp_lr_bl1 || Rear Bumper || Chrome || Blade
|-
| '''1185''' || fbmp_lr_rem2 || Front Bumper || Slamin || Remington
|-
| '''1186''' || rbmp_lr_sv2 || Rear Bumper || Slamin || Savanna
|-
| '''1187''' || rbmp_lr_sv1 || Rear Bumper || Chrome || Savanna
|-
| '''1188''' || fbmp_lr_sv2 || Front Bumper || Slamin || Savanna
|-
| '''1189''' || fbmp_lr_sv1 || Front Bumper || Chrome || Savanna
|-
| '''1190''' || fbmp_lr_t2 || Front Bumper || Slamin || Tornado
|-
| '''1191''' || fbmp_lr_t1 || Front Bumper || Chrome || Tornado
|-
| '''1192''' || rbmp_lr_t1 || Rear Bumper || Chrome || Tornado
|-
| '''1193''' || rbmp_lr_t2 || Rear Bumper || Slamin || Tornado
|}
 

==All valid upgrades per vehicle==

{| class="wikitable"
! scope="col" style="width:8%;"| Name
! scope="col" style="width:2%;"| ID
! scope="col" style="width:50%;"| Component ID
|-
|'''Landstalker'''||400|| 1008, 1009, 1010, 1013, 1018, 1019, 1020, 1021, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Bravura'''||401|| 1001, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1013, 1017, 1019, 1020, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1146, 1147, 1158, 1162, 1163
|-
|'''Buffalo'''||402|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Linerunner'''||403|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Perrenial'''||404|| 1000, 1002, 1007, 1008, 1009, 1010, 1013, 1016, 1017, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Sentinel'''||405|| 1000, 1001, 1008, 1009, 1010, 1014, 1018, 1019, 1020, 1021, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Dumper'''||406|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Firetruck'''||407|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Trashmaster'''||408|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Stretch'''||409|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Manana'''||410|| 1001, 1003, 1007, 1008, 1009, 1010, 1013, 1017, 1019, 1020, 1021, 1023, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Infernus'''||411|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Voodoo'''||412|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Pony'''||413|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Mule'''||414|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Cheetah'''||415|| 1001, 1003, 1007, 1008, 1009, 1010, 1017, 1018, 1019, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Ambulance'''||416|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Leviathan'''||417|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Moonbeam'''||418|| 1002, 1006, 1008, 1009, 1010, 1016, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Esperanto'''||419|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Taxi'''||420|| 1001, 1003, 1004, 1005, 1008, 1009, 1010, 1019, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Washington'''||421|| 1000, 1008, 1009, 1010, 1014, 1016, 1018, 1019, 1020, 1021, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Bobcat'''||422|| 1007, 1008, 1009, 1010, 1013, 1017, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Mr Whoopee'''||423|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''BF Injection'''||424|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Hunter'''||425|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Premier'''||426|| 1001, 1003, 1004, 1005, 1006, 1008, 1009, 1010, 1019, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Enforcer'''||427|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Securicar'''||428|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Banshee'''||429|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Predator'''||430
|-
|'''Bus'''||431|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Rhino'''||432|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Barracks'''||433|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Hotknife'''||434|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Trailer 1'''||435|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Previon'''||436|| 1001, 1003, 1006, 1007, 1008, 1009, 1010, 1013, 1017, 1019, 1020, 1021, 1022, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Coach'''||437|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Cabbie'''||438|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Stallion'''||439|| 1001, 1003, 1007, 1008, 1009, 1010, 1013, 1017, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145
|-
|'''Rumpo'''||440|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''RC Bandit'''||441|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Romero'''||442|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Packer'''||443|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Monster'''||444|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Admiral'''||445|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Squalo'''||446
|-
|'''Seasparrow'''||447|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Pizzaboy'''||448
|-
|'''Tram'''||449
|-
|'''Trailer 2'''||450|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Turismo'''||451|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Speeder'''||452
|-
|'''Reefer'''||453
|-
|'''Tropic'''||454
|-
|'''Flatbed'''||455|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Yankee'''||456|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Caddy'''||457|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Solair'''||458|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Berkley's RC Van'''||459|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Skimmer'''||460|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''PCJ-600'''||461
|-
|'''Faggio'''||462
|-
|'''Freeway'''||463
|-
|'''RC Baron'''||464|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''RC Raider'''||465|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Glendale'''||466|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Oceanic'''||467|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Sanchez'''||468
|-
|'''Sparrow'''||469|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Patriot'''||470|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Quad'''||471|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Coastguard'''||472
|-
|'''Dinghy'''||473
|-
|'''Hermes'''||474|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Sabre'''||475|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Rustler'''||476|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''ZR-350'''||477|| 1006, 1007, 1008, 1009, 1010, 1017, 1018, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Walton'''||478|| 1004, 1005, 1008, 1009, 1010, 1012, 1013, 1020, 1021, 1022, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Regina'''||479|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Comet'''||480|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''BMX'''||481
|-
|'''Burrito'''||482|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Camper'''||483|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Marquis'''||484
|-
|'''Baggage'''||485|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Dozer'''||486|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Maverick'''||487|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''News Chopper'''||488|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Rancher'''||489|| 1000, 1002, 1004, 1005, 1006, 1008, 1009, 1010, 1013, 1016, 1018, 1019, 1020, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''FBI Rancher'''||490|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Virgo'''||491|| 1003, 1007, 1008, 1009, 1010, 1014, 1017, 1018, 1019, 1020, 1021, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145
|-
|'''Greenwood'''||492|| 1000, 1004, 1005, 1006, 1008, 1009, 1010, 1016, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Jetmax'''||493
|-
|'''Hotring'''||494|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Sandking'''||495|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Blista Compact'''||496|| 1001, 1002, 1003, 1006, 1007, 1008, 1009, 1010, 1011, 1017, 1019, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143
|-
|'''Police Maverick'''||497|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Boxville'''||498|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Benson'''||499|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Mesa'''||500|| 1008, 1009, 1010, 1013, 1019, 1020, 1021, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''RC Goblin'''||501|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Hotring Racer A'''||502|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Hotring Racer B'''||503|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Bloodring Banger'''||504|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Rancher'''||505|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Super GT'''||506|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Elegant'''||507|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Journey'''||508|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Bike'''||509
|-
|'''Mountain Bike'''||510
|-
|'''Beagle'''||511|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Cropdust'''||512|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Stunt'''||513|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Tanker'''||514|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Roadtrain'''||515|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Nebula'''||516|| 1000, 1002, 1004, 1007, 1008, 1009, 1010, 1015, 1016, 1017, 1018, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Majestic'''||517|| 1002, 1003, 1007, 1008, 1009, 1010, 1016, 1017, 1018, 1019, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145
|-
|'''Buccaneer'''||518|| 1001, 1003, 1005, 1006, 1007, 1008, 1009, 1010, 1013, 1017, 1018, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145
|-
|'''Shamal'''||519|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Hydra'''||520|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''FCR-900'''||521
|-
|'''NRG-500'''||522
|-
|'''HPV1000'''||523
|-
|'''Cement Truck'''||524|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Tow Truck'''||525|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Fortune'''||526|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Cadrona'''||527|| 1001, 1007, 1008, 1009, 1010, 1014, 1015, 1017, 1018, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''FBI Truck'''||528|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Willard'''||529|| 1001, 1003, 1006, 1007, 1008, 1009, 1010, 1011, 1012, 1017, 1018, 1019, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Forklift'''||530|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Tractor'''||531|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Combine'''||532|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Feltzer'''||533|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Remington'''||534|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1100, 1101, 1106, 1122, 1123, 1124, 1125, 1126, 1127, 1178, 1179, 1180, 1185
|-
|'''Slamvan'''||535|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1109, 1110, 1113, 1114, 1115, 1116, 1117, 1118, 1119, 1120, 1121
|-
|'''Blade'''||536|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1103, 1104, 1105, 1107, 1108, 1128, 1181, 1182, 1183, 1184
|-
|'''Freight'''||537
|-
|'''Streak'''||538
|-
|'''Vortex'''||539|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Vincent'''||540|| 1001, 1004, 1006, 1007, 1008, 1009, 1010, 1017, 1018, 1019, 1020, 1023, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145
|-
|'''Bullet'''||541|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Clover'''||542|| 1008, 1009, 1010, 1014, 1015, 1018, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1144, 1145
|-
|'''Sadler'''||543|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Firetruck LA'''||544|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Hustler'''||545|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Intruder'''||546|| 1001, 1002, 1004, 1006, 1007, 1008, 1009, 1010, 1017, 1018, 1019, 1023, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145
|-
|'''Primo'''||547|| 1000, 1003, 1008, 1009, 1010, 1016, 1018, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143
|-
|'''Cargobob'''||548|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Tampa'''||549|| 1001, 1003, 1007, 1008, 1009, 1010, 1011, 1012, 1017, 1018, 1019, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145
|-
|'''Sunrise'''||550|| 1001, 1003, 1004, 1005, 1006, 1008, 1009, 1010, 1018, 1019, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145
|-
|'''Merit'''||551|| 1002, 1003, 1005, 1006, 1008, 1009, 1010, 1016, 1018, 1019, 1020, 1021, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Utility'''||552|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Nevada'''||553|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Yosemite'''||554|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Windsor'''||555|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Monster A'''||556|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Monster B'''||557|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Uranus'''||558|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1088, 1089, 1090, 1091, 1092, 1093, 1094, 1095, 1096, 1097, 1098, 1163, 1164, 1165, 1166, 1167, 1168
|-
|'''Jester'''||559|| 1008, 1009, 1010, 1025, 1065, 1066, 1067, 1068, 1069, 1070, 1071, 1072, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1158, 1159, 1160, 1161, 1162, 1173
|-
|'''Sultan'''||560|| 1008, 1009, 1010, 1025, 1026, 1027, 1028, 1029, 1030, 1031, 1032, 1033, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1138, 1139, 1140, 1141, 1169, 1170
|-
|'''Stratum'''||561|| 1008, 1009, 1010, 1025, 1026, 1027, 1030, 1031, 1055, 1056, 1057, 1058, 1059, 1060, 1061, 1062, 1063, 1064, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1154, 1155, 1156, 1157
|-
|'''Elegy'''||562|| 1008, 1009, 1010, 1025, 1034, 1035, 1036, 1037, 1038, 1039, 1040, 1041, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1146, 1147, 1148, 1149, 1171, 1172
|-
|'''Raindance'''||563|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''RC Tiger'''||564|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Flash'''||565|| 1008, 1009, 1010, 1025, 1045, 1046, 1047, 1048, 1049, 1050, 1051, 1052, 1053, 1054, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1150, 1151, 1152, 1153
|-
|'''Tahoma'''||566|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Savanna'''||567|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1102, 1129, 1130, 1131, 1132, 1133, 1186, 1187, 1188, 1189
|-
|'''Bandito'''||568|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Freight Flat'''||569
|-
|'''Streak Carriage'''||570
|-
|'''Kart'''||571|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Mower'''||572|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Duneride'''||573|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Sweeper'''||574|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Broadway'''||575|| 1008, 1009, 1010, 1025, 1042, 1043, 1044, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1099, 1174, 1175, 1176, 1177
|-
|'''Tornado'''||576|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1134, 1135, 1136, 1137, 1190, 1191, 1192, 1193
|-
|'''AT-400'''||577|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''DFT-30'''||578|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Huntley'''||579|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Stafford'''||580|| 1001, 1006, 1007, 1008, 1009, 1010, 1017, 1018, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''BF-400'''||581
|-
|'''Newsvan'''||582|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Tug'''||583|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Trailer 3'''||584|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Emperor'''||585|| 1000, 1002, 1003, 1006, 1007, 1008, 1009, 1010, 1013, 1014, 1015, 1016, 1017, 1018, 1019, 1020, 1021, 1022, 1023, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145
|-
|'''Wayfarer'''||586
|-
|'''Euros'''||587|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Hotdog'''||588|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Club'''||589|| 1000, 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1013, 1016, 1017, 1018, 1020, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1144, 1145
|-
|'''Freight Carriage'''||590
|-
|'''Trailer 3'''||591|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Andromada'''||592|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Dodo'''||593|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''RC Cam'''||594|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Launch'''||595
|-
|'''Police Car (LSPD)'''||596|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Police Car (SFPD)'''||597|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Police Car (LVPD)'''||598|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Police Ranger'''||599|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Picador'''||600|| 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1013, 1017, 1018, 1020, 1022, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''S.W.A.T. Van'''||601|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Alpha'''||602|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Phoenix'''||603|| 1001, 1006, 1007, 1008, 1009, 1010, 1017, 1018, 1019, 1020, 1023, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145
|-
|'''Glendale'''||604|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Sadler'''||605|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Luggage Trailer A'''||606|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Luggage Trailer B'''||607|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Stair Trailer'''||608|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Boxville'''||609|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Farm Plow'''||610|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|-
|'''Utility Trailer'''||611|| 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098
|}

==Vehicle Functions==
<section name="Functions" class="Server client"> {{Vehicle functions}} </section>

==Vehicles Upgrades (table form)==
<section name="Table (click to expand)" show="false">
<syntaxhighlight lang="lua">
{
[1000] = {
cars = "Certain Transfender cars",
modelName = "spl_b_mar_m",
part = "Spoiler",
partType = "Pro"
},
[1001] = {
cars = "Certain Transfender cars",
modelName = "spl_b_bab_m",
part = "Spoiler",
partType = "Win"
},
[1002] = {
cars = "Certain Transfender cars",
modelName = "spl_b_bar_m",
part = "Spoiler",
partType = "Drag"
},
[1003] = {
cars = "Certain Transfender cars",
modelName = "spl_b_mab_m",
part = "Spoiler",
partType = "Alpha"
},
[1004] = {
cars = "Certain Transfender cars",
modelName = "bnt_b_sc_m",
part = "Vents",
partType = "Champ Scoop"
},
[1005] = {
cars = "Certain Transfender cars",
modelName = "bnt_b_sc_l",
part = "Vents",
partType = "Fury Scoop"
},
[1006] = {
cars = "Certain Transfender cars",
modelName = "rf_b_sc_r",
part = "Roof",
partType = "Roof Scoop"
},
[1007] = {
cars = "Certain Transfender cars",
modelName = "wg_l_b_ssk",
part = "Sideskirt",
partType = "Right Sideskirt"
},
[1008] = {
cars = "Most cars",
modelName = "nto_b_l",
part = "Nitro",
partType = "5 times"
},
[1009] = {
cars = "Most cars",
modelName = "nto_b_s",
part = "Nitro",
partType = "2 times"
},
[1010] = {
cars = "Most cars",
modelName = "nto_b_tw",
part = "Nitro",
partType = "10 times"
},
[1011] = {
cars = "Certain Transfender cars",
modelName = "bnt_b_sc_p_m",
part = "Vents",
partType = "Race Scoop"
},
[1012] = {
cars = "Certain Transfender cars",
modelName = "bnt_b_sc_p_l",
part = "Vents",
partType = "Worx Scoop"
},
[1013] = {
cars = "Certain Transfender cars",
modelName = "lgt_b_rspt",
part = "Lamps",
partType = "Round Fog"
},
[1014] = {
cars = "Certain Transfender cars",
modelName = "spl_b_bar_l",
part = "Spoiler",
partType = "Champ"
},
[1015] = {
cars = "Certain Transfender cars",
modelName = "spl_b_bbr_l",
part = "Spoiler",
partType = "Race"
},
[1016] = {
cars = "Certain Transfender cars",
modelName = "spl_b_bbr_m",
part = "Spoiler",
partType = "Worx"
},
[1017] = {
cars = "Certain Transfender cars",
modelName = "wg_r_b_ssk",
part = "Sideskirt",
partType = "Left Sideskirt"
},
[1018] = {
cars = "Certain Transfender cars",
modelName = "exh_b_ts",
part = "Exhaust",
partType = "Upswept"
},
[1019] = {
cars = "Certain Transfender cars",
modelName = "exh_b_t",
part = "Exhaust",
partType = "Twin"
},
[1020] = {
cars = "Certain Transfender cars",
modelName = "exh_b_l",
part = "Exhaust",
partType = "Large"
},
[1021] = {
cars = "Certain Transfender cars",
modelName = "exh_b_m",
part = "Exhaust",
partType = "Medium"
},
[1022] = {
cars = "Certain Transfender cars",
modelName = "exh_b_s",
part = "Exhaust",
partType = "Small"
},
[1023] = {
cars = "Certain Transfender cars",
modelName = "spl_b_bbb_m",
part = "Spoiler",
partType = "Fury"
},
[1024] = {
cars = "Certain Transfender cars",
modelName = "lgt_b_sspt",
part = "Lamps",
partType = "Square Fog"
},
[1026] = {
cars = "Sultan",
modelName = "wg_l_a_s",
part = "Sideskirt",
partType = "Right Alien Sideskirt"
},
[1027] = {
cars = "Sultan",
modelName = "wg_r_a_s",
part = "Sideskirt",
partType = "Left Alien Sideskirt"
},
[1028] = {
cars = "Sultan",
modelName = "exh_a_s",
part = "Exhaust",
partType = "Alien"
},
[1029] = {
cars = "Sultan",
modelName = "exh_c_s",
part = "Exhaust",
partType = "X-Flow"
},
[1030] = {
cars = "Sultan",
modelName = "wg_r_c_s",
part = "Sideskirt",
partType = "Left X-Flow Sideskirt"
},
[1031] = {
cars = "Sultan",
modelName = "wg_l_c_s",
part = "Sideskirt",
partType = "Right X-Flow Sideskirt"
},
[1032] = {
cars = "Sultan",
modelName = "rf_a_s",
part = "Roof",
partType = "Alien Roof Vent"
},
[1033] = {
cars = "Sultan",
modelName = "rf_c_s",
part = "Roof",
partType = "X-Flow Roof Vent"
},
[1034] = {
cars = "Elegy",
modelName = "exh_a_l",
part = "Exhaust",
partType = "Alien"
},
[1035] = {
cars = "Elegy",
modelName = "rf_c_l",
part = "Roof",
partType = "X-Flow Roof Vent"
},
[1036] = {
cars = "Elegy",
modelName = "wg_l_a_l",
part = "SideSkirt",
partType = "Right Alien Sideskirt"
},
[1037] = {
cars = "Elegy",
modelName = "exh_c_l",
part = "Exhaust",
partType = "X-Flow"
},
[1038] = {
cars = "Elegy",
modelName = "rf_a_l",
part = "Roof",
partType = "Alien Roof Vent"
},
[1039] = {
cars = "Elegy",
modelName = "wg_l_c_l",
part = "SideSkirt",
partType = "Left X-Flow Sideskirt"
},
[1040] = {
cars = "Elegy",
modelName = "wg_r_a_l",
part = "SideSkirt",
partType = "Left Alien Sideskirt"
},
[1041] = {
cars = "Elegy",
modelName = "wg_r_c_l",
part = "SideSkirt",
partType = "Right X-Flow Sideskirt"
},
[1045] = {
cars = "Flash",
modelName = "exh_c_f",
part = "Exhaust",
partType = "X-Flow"
},
[1046] = {
cars = "Flash",
modelName = "exh_a_f",
part = "Exhaust",
partType = "Alien"
},
[1047] = {
cars = "Flash",
modelName = "wg_l_a_f",
part = "SideSkirt",
partType = "Right Alien Sideskirt"
},
[1048] = {
cars = "Flash",
modelName = "wg_l_c_f",
part = "SideSkirt",
partType = "Right X-Flow Sideskirt"
},
[1049] = {
cars = "Flash",
modelName = "spl_a_f_r",
part = "Spoiler",
partType = "Alien"
},
[1050] = {
cars = "Flash",
modelName = "spl_c_f_r",
part = "Spoiler",
partType = "X-Flow"
},
[1051] = {
cars = "Flash",
modelName = "wg_r_a_f",
part = "SideSkirt",
partType = "Left Alien Sideskirt"
},
[1052] = {
cars = "Flash",
modelName = "wg_r_c_f",
part = "SideSkirt",
partType = "Left X-Flow Sideskirt"
},
[1053] = {
cars = "Flash",
modelName = "rf_c_f",
part = "Roof",
partType = "X-Flow"
},
[1054] = {
cars = "Flash",
modelName = "rf_a_f",
part = "Roof",
partType = "Alien"
},
[1055] = {
cars = "Statum",
modelName = "rf_a_st",
part = "Roof",
partType = "Alien"
},
[1056] = {
cars = "Statum",
modelName = "wg_l_a_st",
part = "Sideskirt",
partType = "Right Alien Sideskirt"
},
[1057] = {
cars = "Statum",
modelName = "wg_l_c_st",
part = "Sideskirt",
partType = "Right X-Flow Sideskirt"
},
[1058] = {
cars = "Statum",
modelName = "spl_a_st_r",
part = "Spoiler",
partType = "Alien"
},
[1059] = {
cars = "Statum",
modelName = "exh_c_st",
part = "Exhaust",
partType = "X-Flow"
},
[1060] = {
cars = "Statum",
modelName = "spl_c_st_r",
part = "Spoiler",
partType = "X-Flow"
},
[1061] = {
cars = "Statum",
modelName = "rf_c_st",
part = "Roof",
partType = "X-Flow"
},
[1062] = {
cars = "Statum",
modelName = "wg_r_a_st",
part = "Sideskirt",
partType = "Left Alien Sideskirt"
},
[1063] = {
cars = "Statum",
modelName = "wg_r_c_st",
part = "Sideskirt",
partType = "Left X-Flow Sideskirt"
},
[1064] = {
cars = "Statum",
modelName = "exh_a_st",
part = "Exhaust",
partType = "Alien"
},
[1065] = {
cars = "Jester",
modelName = "exh_a_j",
part = "Exhaust",
partType = "Alien"
},
[1066] = {
cars = "Jester",
modelName = "exh_c_j",
part = "Exhaust",
partType = "X-Flow"
},
[1067] = {
cars = "Jester",
modelName = "rf_a_j",
part = "Roof",
partType = "Alien"
},
[1068] = {
cars = "Jester",
modelName = "rf_c_j",
part = "Roof",
partType = "X-Flow"
},
[1069] = {
cars = "Jester",
modelName = "wg_l_a_j",
part = "Sideskirt",
partType = "Right Alien Sideskirt"
},
[1070] = {
cars = "Jester",
modelName = "wg_l_c_j",
part = "Sideskirt",
partType = "Right X-Flow Sideskirt"
},
[1071] = {
cars = "Jester",
modelName = "wg_r_a_j",
part = "Sideskirt",
partType = "Left Alien Sideskirt"
},
[1072] = {
cars = "Jester",
modelName = "wg_r_c_j",
part = "Sideskirt",
partType = "Left X-Flow Sideskirt"
},
[1086] = {
cars = "Most cars",
modelName = "stereo",
part = "Stereo",
partType = "Stereo"
},
[1087] = {
cars = "Most cars",
modelName = "hydralics",
part = "Hydraulics",
partType = "Hydraulics"
},
[1088] = {
cars = "Uranus",
modelName = "rf_a_u",
part = "Roof",
partType = "Alien"
},
[1089] = {
cars = "Uranus",
modelName = "exh_c_u",
part = "Exhaust",
partType = "X-Flow"
},
[1090] = {
cars = "Uranus",
modelName = "wg_l_a_u",
part = "Sideskirt",
partType = "Right Alien Sideskirt"
},
[1091] = {
cars = "Uranus",
modelName = "rf_c_u",
part = "Roof",
partType = "X-Flow"
},
[1092] = {
cars = "Uranus",
modelName = "exh_a_u",
part = "Exhaust",
partType = "Alien"
},
[1093] = {
cars = "Uranus",
modelName = "wg_l_c_u",
part = "Sideskirt",
partType = "Right X-Flow Sideskirt"
},
[1094] = {
cars = "Uranus",
modelName = "wg_r_a_u",
part = "Sideskirt",
partType = "Left Alien Sideskirt"
},
[1095] = {
cars = "Uranus",
modelName = "wg_r_c_u",
part = "Sideskirt",
partType = "Right X-Flow Sideskirt"
},
[1102] = {
cars = "Savanna",
modelName = "wg_r_lr_sv",
part = "Sideskirt",
partType = "Left `Chrome Strip` Sideskirt"
},
[1133] = {
cars = "Savanna",
modelName = "wg_l_lr_sv",
part = "Sideskirt",
partType = "Right `Chrome Strip` Sideskirt"
},
[1138] = {
cars = "Sultan",
modelName = "spl_a_s_b",
part = "Spoiler",
partType = "Alien"
},
[1139] = {
cars = "Sultan",
modelName = "spl_c_s_b",
part = "Spoiler",
partType = "X-Flow"
},
[1140] = {
cars = "Sultan",
modelName = "rbmp_c_s",
part = "Rear Bumper",
partType = "X-Flow"
},
[1141] = {
cars = "Sultan",
modelName = "rbmp_a_s",
part = "Rear Bumper",
partType = "Alien"
},
[1142] = {
cars = "Certain Transfender Cars",
modelName = "bntr_b_ov",
part = "Hood",
partType = "Left Oval Hoods"
},
[1143] = {
cars = "Certain Transfender Cars",
modelName = "bntl_b_ov",
part = "Hood",
partType = "Right Oval Hoods"
},
[1144] = {
cars = "Certain Transfender Cars",
modelName = "bntr_b_sq",
part = "Hood",
partType = "Left Square Hoods"
},
[1145] = {
cars = "Certain Transfender Cars",
modelName = "bntl_b_sq",
part = "Hood",
partType = "Right Square Hoods"
},
[1146] = {
cars = "Elegy",
modelName = "spl_c_l_b",
part = "Spoiler",
partType = "X-Flow"
},
[1147] = {
cars = "Elegy",
modelName = "spl_a_l_b",
part = "Spoiler",
partType = "Alien"
},
[1148] = {
cars = "Elegy",
modelName = "rbmp_c_l",
part = "Rear Bumper",
partType = "X-Flow"
},
[1149] = {
cars = "Elegy",
modelName = "rbmp_a_l",
part = "Rear Bumper",
partType = "Alien"
},
[1150] = {
cars = "Flash",
modelName = "rbmp_a_f",
part = "Rear Bumper",
partType = "Alien"
},
[1151] = {
cars = "Flash",
modelName = "rbmp_c_f",
part = "Rear Bumper",
partType = "X-Flow"
},
[1152] = {
cars = "Flash",
modelName = "fbmp_c_f",
part = "Front Bumper",
partType = "X-Flow"
},
[1153] = {
cars = "Flash",
modelName = "fbmp_a_f",
part = "Front Bumper",
partType = "Alien"
},
[1154] = {
cars = "Stratum",
modelName = "rbmp_a_st",
part = "Rear Bumper",
partType = "Alien"
},
[1155] = {
cars = "Stratum",
modelName = "fbmp_a_st",
part = "Front Bumper",
partType = "Alien"
},
[1156] = {
cars = "Stratum",
modelName = "rbmp_c_st",
part = "Rear Bumper",
partType = "X-Flow"
},
[1157] = {
cars = "Stratum",
modelName = "fbmp_c_st",
part = "Front Bumper",
partType = "X-Flow"
},
[1158] = {
cars = "Jester",
modelName = "spl_c_j_b",
part = "Spoiler",
partType = "X-Flow"
},
[1159] = {
cars = "Jester",
modelName = "rbmp_a_j",
part = "Rear Bumper",
partType = "Alien"
},
[1160] = {
cars = "Jester",
modelName = "fbmp_a_j",
part = "Front Bumper",
partType = "Alien"
},
[1161] = {
cars = "Jester",
modelName = "rbmp_c_j",
part = "Rear Bumper",
partType = "X-Flow"
},
[1162] = {
cars = "Jester",
modelName = "spl_a_j_b",
part = "Spoiler",
partType = "Alien"
},
[1163] = {
cars = "Uranus",
modelName = "spl_c_u_b",
part = "Spoiler",
partType = "X-Flow"
},
[1164] = {
cars = "Uranus",
modelName = "spl_a_u_b",
part = "Spoiler",
partType = "Alien"
},
[1165] = {
cars = "Uranus",
modelName = "fbmp_c_u",
part = "Front Bumper",
partType = "X-Flow"
},
[1166] = {
cars = "Uranus",
modelName = "fbmp_a_u",
part = "Front Bumper",
partType = "Alien"
},
[1167] = {
cars = "Uranus",
modelName = "rbmp_c_u",
part = "Rear Bumper",
partType = "X-Flow"
},
[1168] = {
cars = "Uranus",
modelName = "rbmp_a_u",
part = "Rear Bumper",
partType = "Alien"
},
[1169] = {
cars = "Sultan",
modelName = "fbmp_a_s",
part = "Front Bumper",
partType = "Alien"
},
[1170] = {
cars = "Sultan",
modelName = "fbmp_c_s",
part = "Front Bumper",
partType = "X-Flow"
},
[1171] = {
cars = "Elegy",
modelName = "fbmp_a_l",
part = "Front Bumper",
partType = "Alien"
},
[1172] = {
cars = "Elegy",
modelName = "fbmp_c_l",
part = "Front Bumper",
partType = "X-Flow"
},
[1173] = {
cars = "Jester",
modelName = "fbmp_c_j",
part = "Front Bumper",
partType = "X-Flow"
}
}
</syntaxhighlight>
</section>

==All valid upgrades per vehicle (table form)==
<section name="Table (click to expand)" show="false">
<syntaxhighlight lang="lua">
tunning_avalible = {
[400] = { 1008, 1009, 1010, 1013, 1018, 1019, 1020, 1021, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[401] = { 1001, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1013, 1017, 1019, 1020, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1146, 1147, 1158, 1162, 1163 },
[402] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[403] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[404] = { 1000, 1002, 1007, 1008, 1009, 1010, 1013, 1016, 1017, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[405] = { 1000, 1001, 1008, 1009, 1010, 1014, 1018, 1019, 1020, 1021, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[406] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[407] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[408] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[409] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[410] = { 1001, 1003, 1007, 1008, 1009, 1010, 1013, 1017, 1019, 1020, 1021, 1023, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[411] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[412] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[413] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[414] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[415] = { 1001, 1003, 1007, 1008, 1009, 1010, 1017, 1018, 1019, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[416] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[417] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[418] = { 1002, 1006, 1008, 1009, 1010, 1016, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[419] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[420] = { 1001, 1003, 1004, 1005, 1008, 1009, 1010, 1019, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[421] = { 1000, 1008, 1009, 1010, 1014, 1016, 1018, 1019, 1020, 1021, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[422] = { 1007, 1008, 1009, 1010, 1013, 1017, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[423] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[424] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[425] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[426] = { 1001, 1003, 1004, 1005, 1006, 1008, 1009, 1010, 1019, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[427] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[428] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[429] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[430] = { },
[431] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[432] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[433] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[434] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[436] = { 1001, 1003, 1006, 1007, 1008, 1009, 1010, 1013, 1017, 1019, 1020, 1021, 1022, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[437] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[438] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[439] = { 1001, 1003, 1007, 1008, 1009, 1010, 1013, 1017, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145 },
[440] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[441] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[442] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[443] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[444] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[445] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[446] = { },
[447] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[448] = { },
[449] = { },
[451] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[452] = { },
[453] = { },
[454] = { },
[455] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[456] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[457] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[458] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[459] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[460] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[461] = { },
[462] = { },
[463] = { },
[464] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[465] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[466] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[467] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[468] = { 1086 },
[469] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[470] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[471] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[472] = { },
[473] = { },
[474] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[475] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[476] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[478] = { 1004, 1005, 1008, 1009, 1010, 1012, 1013, 1020, 1021, 1022, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[479] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[480] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[481] = { },
[482] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[483] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[484] = { },
[485] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[486] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[487] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[488] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[489] = { 1000, 1002, 1004, 1005, 1006, 1008, 1009, 1010, 1013, 1016, 1018, 1019, 1020, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[490] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[491] = { 1003, 1007, 1008, 1009, 1010, 1014, 1017, 1018, 1019, 1020, 1021, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145 },
[492] = { 1000, 1004, 1005, 1006, 1008, 1009, 1010, 1016, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[493] = { },
[494] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[495] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[496] = { 1001, 1002, 1003, 1006, 1007, 1008, 1009, 1010, 1011, 1017, 1019, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143 },
[497] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[498] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[499] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[500] = { 1008, 1009, 1010, 1013, 1019, 1020, 1021, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[501] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[502] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[503] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[504] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[505] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[506] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[507] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[508] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[509] = { },
[510] = { },
[511] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[512] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[513] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[514] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[515] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[516] = { 1000, 1002, 1004, 1007, 1008, 1009, 1010, 1015, 1016, 1017, 1018, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[517] = { 1002, 1003, 1007, 1008, 1009, 1010, 1016, 1017, 1018, 1019, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145 },
[518] = { 1001, 1003, 1005, 1006, 1007, 1008, 1009, 1010, 1013, 1017, 1018, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145 },
[519] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[520] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[521] = { },
[522] = { },
[523] = { },
[524] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[525] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[526] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[527] = { 1001, 1007, 1008, 1009, 1010, 1014, 1015, 1017, 1018, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[528] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[529] = { 1001, 1003, 1006, 1007, 1008, 1009, 1010, 1011, 1012, 1017, 1018, 1019, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[530] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[531] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[532] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[533] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[534] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1100, 1101, 1106, 1122, 1123, 1124, 1125, 1126, 1127, 1178, 1179, 1180, 1185 },
[535] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1109, 1110, 1113, 1114, 1115, 1116, 1117, 1118, 1119, 1120, 1121 },
[536] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1103, 1104, 1105, 1107, 1108, 1128, 1181, 1182, 1183, 1184 },
[537] = { },
[538] = { },
[539] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[540] = { 1001, 1004, 1006, 1007, 1008, 1009, 1010, 1017, 1018, 1019, 1020, 1023, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145 },
[541] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[542] = { 1008, 1009, 1010, 1014, 1015, 1018, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1144, 1145 },
[543] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[544] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[545] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[546] = { 1001, 1002, 1004, 1006, 1007, 1008, 1009, 1010, 1017, 1018, 1019, 1023, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145 },
[547] = { 1000, 1003, 1008, 1009, 1010, 1016, 1018, 1019, 1020, 1021, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143 },
[548] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[549] = { 1001, 1003, 1007, 1008, 1009, 1010, 1011, 1012, 1017, 1018, 1019, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145 },
[550] = { 1001, 1003, 1004, 1005, 1006, 1008, 1009, 1010, 1018, 1019, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145 },
[551] = { 1002, 1003, 1005, 1006, 1008, 1009, 1010, 1016, 1018, 1019, 1020, 1021, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[552] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[553] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[554] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[555] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[556] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[557] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[558] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1088, 1089, 1090, 1091, 1092, 1093, 1094, 1095, 1096, 1097, 1098, 1163, 1164, 1165, 1166, 1167, 1168 },
[559] = { 1008, 1009, 1010, 1025, 1065, 1066, 1067, 1068, 1069, 1070, 1071, 1072, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1158, 1159, 1160, 1161, 1162, 1173 },
[560] = { 1008, 1009, 1010, 1025, 1026, 1027, 1028, 1029, 1030, 1031, 1032, 1033, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1138, 1139, 1140, 1141, 1169, 1170 },
[561] = { 1008, 1009, 1010, 1025, 1026, 1027, 1030, 1031, 1055, 1056, 1057, 1058, 1059, 1060, 1061, 1062, 1063, 1064, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1154, 1155, 1156, 1157 },
[562] = { 1008, 1009, 1010, 1025, 1034, 1035, 1036, 1037, 1038, 1039, 1040, 1041, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1146, 1147, 1148, 1149, 1171, 1172 },
[563] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[564] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[565] = { 1008, 1009, 1010, 1025, 1045, 1046, 1047, 1048, 1049, 1050, 1051, 1052, 1053, 1054, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1150, 1151, 1152, 1153 },
[566] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[567] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1102, 1129, 1130, 1131, 1132, 1133, 1186, 1187, 1188, 1189 },
[568] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[569] = { },
[570] = { },
[571] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[572] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[573] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[574] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[575] = { 1008, 1009, 1010, 1025, 1042, 1043, 1044, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1099, 1174, 1175, 1176, 1177 },
[576] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1134, 1135, 1136, 1137, 1190, 1191, 1192, 1193 },
[579] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[580] = { 1001, 1006, 1007, 1008, 1009, 1010, 1017, 1018, 1020, 1023, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[581] = { },
[582] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[583] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[585] = { 1000, 1002, 1003, 1006, 1007, 1008, 1009, 1010, 1013, 1014, 1015, 1016, 1017, 1018, 1019, 1020, 1021, 1022, 1023, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145 },
[587] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[586] = { },
[588] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[589] = { 1000, 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1013, 1016, 1017, 1018, 1020, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1144, 1145 },
[590] = { },
[591] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[592] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[593] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[594] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[595] = { },
[596] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[597] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[598] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[599] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[600] = { 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1013, 1017, 1018, 1020, 1022, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[601] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[602] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[603] = { 1001, 1006, 1007, 1008, 1009, 1010, 1017, 1018, 1019, 1020, 1023, 1024, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098, 1142, 1143, 1144, 1145 },
[604] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[605] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[606] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[607] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[608] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[609] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[610] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 },
[611] = { 1008, 1009, 1010, 1025, 1073, 1074, 1075, 1076, 1077, 1078, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086, 1087, 1096, 1097, 1098 }
}
</syntaxhighlight>
</section>

==See Also==
[[id|ID Lists]]

[[hu:Vehicle Upgrades]]
[[pl:Vehicle_Upgrades]]
[[it:Miglioramenti Veicoli]]

[[Category:ID Lists]]

CEF Tutorial

2021-05-31T13:48:01Z

CrosRoad95:

This page gives you a brief introduction to CEF.

=What is CEF?=
CEF stands for '''C'''hromium '''E'''mbedded '''F'''ramework and is a framework for embedding Chromium-based browsers in other applications - in our case MTA. CEF is based on Google's Chromium project so it is also a fast, secure and stable web engine.

You can find more information about CEF on CEF's GoogleCode project page: https://bitbucket.org/chromiumembedded/cef

=The basics=
Creating a new browser is really simple. Let's open YouTube for example:
<syntaxhighlight lang="lua">
-- Create a new remote browser (size is 800*600px) with transparency enabled
local browser = createBrowser(800, 600, true, true)

-- "Wait" for the browser (this is necessary because CEF runs in a secondary thread and hence requires the 'asynchronous' event mechanism)
addEventHandler("onClientBrowserCreated", browser,
function()
-- We're ready to load the URL now (the source of this event is the browser that has been created)
loadBrowserURL(source, "https://youtube.com/")
end
)</syntaxhighlight>
This example does not require any domain requests as YouTube is whitelisted by default. More about domain requests below.

=Domain request system=
In order to prevent people from abusing the possibilities CEF offers, we decided to introduce a request system.
This means the domain you want to load has to meet at least one of the following requirements:
*it is whitelisted globally by the MTA team (you can create a post in [this topic] to suggest a new domain to be whitelisted) - '''**TODO: Add forum URL here**'''
*the domain was requested via requestBrowserDomains/Browser.requestDomains and accepted by the player '''before'''
*the domain is on the user's whitelist (MTA settings => Tab: Browser => Whitelist)

Apart from these options, a domain might be blacklisted due to malicious content. Such domains cannot be requested.

=Local vs remote mode=
There are two modes CEF can run in:

Characteristics of local mode:
*you '''can''' execute Javascript code without any restriction (See: [[executeBrowserJavascript]])
*you '''can''' only load websites stored in the resource folder
*you '''cannot''' load remote content

Characteristics of remote mode:
*you '''cannot''' execute Javascript code
*you '''can''' only load remote content
*keep in mind that either loading remote websites or Javascript on remote websites can be disabled in the MTA settings

Changing the mode after the browser was created is not possible due to technical reasons.

=Resource management=
==How to load local HTML files==
Loading local HTML files works similar to loading images.

Add your HTML files to your meta.xml through the file tag:
<syntaxhighlight lang="xml">
<file src="html/myAwesomeUI.html"/></syntaxhighlight>

==How to load local resources in local HTML files==
Imagine you want to load an image or play a video from your MTA resource. This is possible via a custom URI scheme named '''''"http://mta/"'''''

===Example===
This examples shows how to play a video. Note that you have to enable OOP.
====Lua====
<syntaxhighlight lang="lua">
-- Create a browser (local mode is also required to access local data)
local webView = Browser(640, 480, true, true)

addEventHandler("onClientBrowserCreated", webView,
function()

-- Load HTML UI
webView:loadURL("http://mta/local/html/myVideo.html")

end
)</syntaxhighlight>
====meta.xml====
<syntaxhighlight lang="lua">
<file src="html/myVideo.html"/>
<file src="media/myVideo.webm"/></syntaxhighlight>
====HTML====
This is the most interesting part:
<syntaxhighlight lang="html">
<!DOCTYPE HTML>
<html>
<head></head>
<body>
<video width="640" height="480" controls>
<source src="http://mta/local/myVideo.webm" type="video/webm"/>
</video>
</body>
</html></syntaxhighlight>

=Lua <==> Javascript communication=
First of all, communication between Lua and Javascript is only available in local mode due to security reasons.

==Lua to Javascript==
Lua to javascript is pretty easy as you can execute Javascript code from Lua using [[executeBrowserJavascript]].

So, a bit Lua code around it and you have got the first direction:
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/src/WebWindow.lua#L180-189
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/src/mtaevents.js#L9-L15

==Javascript to Lua==
You are able to trigger a client event via the Javascript method ''triggerEvent'' which is part of the static class/namespace ''mta''.
The syntax is as follows:
<syntaxhighlight lang="javascript">
mta.triggerEvent(string event, var parameter1, var parameter2, var parameter3, ...)
</syntaxhighlight>
The source of this event is always the browser element that triggered the event.

An example is available here:
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/examples/html/ui2.html#L66
* https://github.com/Jusonex/mtasa_cef_tools/blob/master/webui/examples/Main.lua#L35-L40

=Debugging=
The ''web development mode'' can be enabled as follows (type it in the client's F8 console):
<syntaxhighlight lang="lua">start runcode
crun setDevelopmentMode(true, true)
debugscript 3</syntaxhighlight>
Now, you should be able to see web errors and blocked domains/URLs in the debug window at the bottom.

=Things you should keep in mind while working with CEF=
You should always keep in mind that some modern browser features are not available on some computers.
This is for example true for '''WebGL'''.

Another problematic feature is '''Adobe Flash'''. Adobe Flash is enabled by default, but you should avoid using it due to the fact that plugins can be disabled in the settings on the one hand (Java is disabled completely by the way) and Flash is very restrictive on the other hand. Restrictive means it runs in a separate process uses a very old interface and offers therefore just a few ways to control it.
As a consequence, you cannot control the volume of flash objects. Fortunately, HTML5 is an even better replacement and provides very good audio and video interface (http://www.w3schools.com/tags/ref_av_dom.asp) which even supports 3D sound (@all bored people among us: Feel free to write a 3D sound 'wrapper' that maps the GTA onto HTML5 coordinates :P).

=Advanced usage=
Since our CEF implementation does not do z-ordering by default, you have to provide your own z-ordering mechanism.
You can find a basic implementation of such a mechanism here: https://github.com/Jusonex/mtasa_cef_tools
There are also a few utility functions that allow you to integrate these classes easily into your own object-oriented UI system.
I'll provide some code to use CEF along with CEGUI soon too.

=Performance=
Creating lots of browsers does not influence MTA directly (except the fact MTA has to copy the texture data in the main/GTA thread due to technical restrictions), because one part of CEF runs in another process and the other part in a secondary thread.
So if you do not want to show the browser, it is definitely the best to destroy the browser. If you cannot destroy the browser (imagine you have to save the website's state for some reason), you can save a lot of resources by disabling rendering via [[setBrowserRenderingPaused]]. This will stop CEF from rendering new frames/processing input and MTA from copying the texture data.

=Troubleshooting=
===google.com doesn't work (even though I requested google.com)===
Google redirects to a country-specific website by default. If you want to prevent Google from doing this, load the following URL: https://www.google.com/ncr

=3-rd party=

==Typescript==
Typescript declaration for mta functions:

<syntaxhighlight lang="ts">
declare var mta: {
triggerEvent(event: string): void;
triggerEvent(event: string, ...any): void;
};
</syntaxhighlight>

==React==
Example how to call react function from mta:
1. Create a hook:

<syntaxhighlight lang="ts">
const useMta = () => {
const dispatch = yourDispatcherHere();
const w = window as any;
w.MtaPrefixSomeName = () => dispatch(dispatchFunction());
}
export default useMta;
</syntaxhighlight>
2. Add this hook to main App component.

3. Call from lua:

<syntaxhighlight lang="lua">
function callReactFunction(name, arg)
local name = string.format(name, "[^a-zA-Z0-9]", "");
local code;
if(arg~= nil)then
code = string.format("MtaPrefix%s(%q)",name, arg)
else
code = string.format("MtaPrefix%s()",name)
end
return executeBrowserJavascript(theBrowser, code)
end
</syntaxhighlight>
Use of prefix let you call only mta specific functions with bare minimum of validation required.
option `%q` puts quotes around a string argument's value. Read more at https://www.gammon.com.au/scripts/doc.php?lua=string.format

=Scripting functions=
{{CEF_functions}}
=Scripting events=
{{CEF_events}}

[[Category:Tutorials]]

[[pt-br:Tutorial_CEF]]

SetColPolygonHeight

2021-03-02T15:05:54Z

CrosRoad95:

{{Server client function}}
__NOTOC__
{{New feature/item|3.0160|1.5.8|20807|This function is used to change the height of an existing [[createColPolygon|colshape polygon]].
By default, a colshape polygon is infinitely tall.}}

==Syntax==
<syntaxhighlight lang="lua">
bool setColPolygonHeight( colshape shape, float floor, float ceil )
</syntaxhighlight>
{{OOP||[[colshape]]:setHeight|}}

===Required Arguments===
*'''shape:''' The [[colshape]] polygon
*'''floor:''' The polygon floor (lowest Z coordinate). Parse ''false'' to reset this value to infinitely tall in negative z coord, equivalent of "math.min".
*'''ceil:''' The polygon ceiling (highest Z coordinate). Parse ''false'' to reset this value to infinitely tall in positive z coord, equivalent of "math.max".

===Returns===
Returns ''true'' if the polygon was changed, ''false'' if invalid arguments were passed.

==Example==
This example sets every polygon colshape's max heigh to 50 units once resource starts.
<section name="Server side script" class="server" show="true">
<syntaxhighlight lang="lua">
function setPolygonsHeight()
for i, v in ipairs(getElementsByType("colshape")) do
if (getColShapeType(v) == 4) then -- if it's a polygon colshape do it otherwise don't
setColPolygonHeight(v, false, 50)
end
end
end
addEventHandler("onResourceStart", resourceRoot, setPolygonsHeight)
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|1.5.8-9.20807|1.5.8-9.20807|}}

==See Also==
{{Collision_shape_functions}}

SetColPolygonHeight

2021-01-17T08:40:30Z

CrosRoad95: Created page with "{{Server client function}} __NOTOC__ {{New feature/item|3.0158|1.5.7|20397|This function is used to change height of an existing colshape polygon.}} ==Sy..."

{{Server client function}}
__NOTOC__
{{New feature/item|3.0158|1.5.7|20397|This function is used to change height of an existing [[createColPolygon|colshape polygon]].}}

==Syntax==
<syntaxhighlight lang="lua">
bool setColPolygonHeight( colshape shape, float fFloor, float fCeil)
</syntaxhighlight>
{{OOP||[[colshape]]:setHeight|}}

===Required Arguments===
*'''shape:''' The [[colshape]] polygon
*'''fFloor:''' The polygon floor
*'''fCeil:''' The polygon ceil

===Returns===
Returns ''true'' if the polygon was changed, ''false'' if invalid arguments were passed.

==Example==
<syntaxhighlight lang="lua">
TODO
</syntaxhighlight>

==Requirements==
{{Requirements|1.5.7-9.20397|1.5.7-9.20397|}}

==See Also==
{{Collision_shape_functions}}

Scripting Tips

2021-01-05T20:56:09Z

CrosRoad95: /* Speed comparison between structural and OOP scripting */

This page contains a variety of things that knowing, make life easier for MTA scripters.

== General Lua ==
* The ''infinite loop / too long execution error'' which aborts execution can be disabled with ''debug.sethook(nil)''
* Be careful when looping a table where you intend to delete multiple rows, if 2 of them are in a row the 2nd one will get skipped! You must loop the table backwards (reverse ipairs). For example: ''for i = #table, 1, -1 do''
* Rather than having if checks inside if checks inside if checks, consider using ''return'' for example ''if (not ready) then return false end''
* Keep event, variable & function names short but understandable - longer names will make the file larger in size. In client files, this will increase download time.
* Remember that 'false' boolean has a value - If you want to delete a variable or element/account data, use 'nil' instead - this will reduce memory and disk usage (minuscule optimization, only notable on larger servers)

== MTA Scripting ==
* Remember that 99% of the time it's a bug in your script, not an MTA bug! Don't report something to GitHub Issues until you're absolutely certain the bug can be reproduced with a small piece of script.
* As MTA already has so many functions and events virtually everything you want to do is already possible, as long as you're willing to do the work! You'll find better solutions to problems as there are many ways to achieve the same thing as long as you know all the functions and events.
* If a script is getting too complicated, try putting back-end stuff in another file so the main script calls the functions in the 2nd one. For example rather than having meaningless things like ''vehicleTable[vehicle][7]'' in the main file, put that in a function in the 2nd file and have the main file call a meaningfully named function so rather than seeing a useless ''7'' you'd see something like ''getFuel'' and although this might take longer to set-up you'll save time in the long run as you'll spend less time being confused when you come back to it in a weeks time to debug a problem.
* Your client side scripts can cause desync if you're not careful, try to keep the psychical world equal with every player. For example if your script creates a client side object make sure your script will create it for everyone nearby, else people will be wondering why a player appears to be constantly floating and falling.
* Instead of using ''onClientResourceStart'' or ''onResourceStart'' events attached to ''resourceRoot'' like this:
<syntaxhighlight lang="lua">function warnPeopleThatThisResourceStarted()
outputChatBox("The resource " .. getResourceName(resource) .. " has just started!", 0, 255, 0)
end
addEventHandler("onClientResourceStart", resourceRoot, warnPeopleThatThisResourceStarted)</syntaxhighlight>
You can also use this outside of any function:
<syntaxhighlight lang="lua">outputChatBox("The resource " .. getResourceName(resource) .. " has just started!", 0, 255, 0)</syntaxhighlight>
And the result will be the same, because Lua executes every instruction in every script file of a resource when it starts.
* string.dump produces unsigned compiled Lua code which is not allowed for security reasons. The only way to transport code now is by using the source code. e.g.:
<syntaxhighlight lang="lua">exampleFunction = [===[
return param
]===]

local loadedFunction = loadstring(exampleFunction)</syntaxhighlight>

== MTA Scripting - Element IDs Being Reused ==
* If your script is covered in [[isTimer]] and [[isElement]] checks to hide debug warnings from deleted elements not being dereferenced (making the variable nil) you will regret it when that element ID or timer pointer has to be re-used by MTA in a weeks time and your script starts acting strangely and you won't have a clue why. Dereference destroyed elements and disconnected players!
* Why would MTA reuse it in a weeks time? Everything has a userdata value whether it's a function or an element, there is a limited amount of these available meaning that eventually the server will be forced to use the same userdata value twice, as long as whatever that userdata value was for is no longer valid. This could happen within hours, weeks or even never depending on how many elements are being created and destroyed by your scripts.
* For example if you have a race server that has 100 objects in every map and the map was changing every 5 minutes your server would go through at least 1200 an hour, 28,800 a day, 201,600 a week in userdata values, it can't keep going up and up though eventually it will have to reuse the same userdata values and as long as you're dereferencing in your scripts, it won't be a problem.

The is an example of a script which fails to dereference, because when the player quits their userdata value remains in the table, but what if in a weeks time another player joins and they get assigned the same userdata value?
<syntaxhighlight lang="lua">

local admins = {}
local secretPasswordOnlyAdminsShouldKnow = "12345678"

function adminLogin()
if (hasObjectPermissionTo(source, "command.ban", false)) then
admins[source] = true
end
end
addEventHandler("onPlayerLogin", root, adminLogin)

function cmdGetSecretPassword(plr)
if (not admins[plr]) then
return false
end
outputChatBox("The secret password is "..secretPasswordOnlyAdminsShouldKnow, plr)
end
addCommandHandler("getsecretpass", cmdGetSecretPassword)
</syntaxhighlight>

Some random player who joins in a weeks time gets the same userdata value as an admin, that player can now use "getsecretpass". Solution? De-reference on destruction!
<syntaxhighlight lang="lua">

function onQuit()
admins[source] = nil
end
addEventHandler("onPlayerQuit", root, onQuit)
</syntaxhighlight>

== Server Performance ==
* Server lagging? Check [[Debugging#Debugging_Performance_Issues|this page of debugging performance issues]]
* Using resourceRoot in event handlers for events from clients is much more efficient than using root.
* Try to be efficient, but if what you're doing is too time consuming or complex, is it really efficient?
* It's much more efficient to [[SetElementHealth]] and [[setElementRotation]] on a player client side, consider a client event all your server scripts can call to set a players health.
* Unless you have hundreds of players, don't worry about making little optimizations, check ''performancebrowser'' or ''ipb'' (ingame performancebrowser) and make sure no resource is using significantly more than the others.

== Client Performance ==
* The biggest cause of client script CPU usage is anything done in onClient/Pre/Hud/Render because it is called so often. For example if you have a script which calls dxDrawLine3D 20 times, 60 times a second, if those lines are only in 1 part of the map, consider adding a [[getDistanceBetweenPoints3D]] check between the local player and the general area that those lines are in and if they're no where near the player, don't draw the lines.
* Another thing that gets called a lot and could therefore be quite consuming if not careful are events like [[onClientPlayerWeaponFire]] and [[onClientPlayerDamage]] so any scripts that use these should only be bound to the necessary elements (such as localPlayer instead of root) and run the simplest if statements for example if you wanted to handle a certain weapon being fired in a certain dimension it's better to check weapon first as that's a simple weaponID == x rather than getElementDimension(source) == y.
* Start checking variables since least aggravating. Example, first do simple checks: interior, dimension, distance, then check elementDatas, exports etc.

== Speed comparison between local and global variables ==

=== Slower ===

<syntaxhighlight lang="lua">

start = getTickCount()
a = 1
for i=1,10000000 do
a = 1
end
stop = getTickCount()
print("global", stop - start ) -- more than 500ms
</syntaxhighlight>
=== Faster ===
<syntaxhighlight lang="lua">
start = getTickCount()
local b = 1
for i=1,10000000 do
b = 1
end
stop = getTickCount()
print("local", stop - start ) -- less than 200ms
</syntaxhighlight>

== Speed comparison between structural and OOP scripting ==
=== Slower ===
<syntaxhighlight lang="lua">
start = getTickCount()
a = 1
for i=1,1000000 do
a = localPlayer.position
end
stop = getTickCount()
print("variable", stop - start ) -- more than 1500ms
</syntaxhighlight>
=== Faster ===
<syntaxhighlight lang="lua">
start = getTickCount()
b = nil
for i=1,1000000 do
b = getElementPosition(localPlayer)
end
stop = getTickCount()
print("structural", stop - start ) -- less than 200ms
</syntaxhighlight>

Scripting Tips

2021-01-05T20:55:58Z

CrosRoad95: fix typo, then -> than

This page contains a variety of things that knowing, make life easier for MTA scripters.

== General Lua ==
* The ''infinite loop / too long execution error'' which aborts execution can be disabled with ''debug.sethook(nil)''
* Be careful when looping a table where you intend to delete multiple rows, if 2 of them are in a row the 2nd one will get skipped! You must loop the table backwards (reverse ipairs). For example: ''for i = #table, 1, -1 do''
* Rather than having if checks inside if checks inside if checks, consider using ''return'' for example ''if (not ready) then return false end''
* Keep event, variable & function names short but understandable - longer names will make the file larger in size. In client files, this will increase download time.
* Remember that 'false' boolean has a value - If you want to delete a variable or element/account data, use 'nil' instead - this will reduce memory and disk usage (minuscule optimization, only notable on larger servers)

== MTA Scripting ==
* Remember that 99% of the time it's a bug in your script, not an MTA bug! Don't report something to GitHub Issues until you're absolutely certain the bug can be reproduced with a small piece of script.
* As MTA already has so many functions and events virtually everything you want to do is already possible, as long as you're willing to do the work! You'll find better solutions to problems as there are many ways to achieve the same thing as long as you know all the functions and events.
* If a script is getting too complicated, try putting back-end stuff in another file so the main script calls the functions in the 2nd one. For example rather than having meaningless things like ''vehicleTable[vehicle][7]'' in the main file, put that in a function in the 2nd file and have the main file call a meaningfully named function so rather than seeing a useless ''7'' you'd see something like ''getFuel'' and although this might take longer to set-up you'll save time in the long run as you'll spend less time being confused when you come back to it in a weeks time to debug a problem.
* Your client side scripts can cause desync if you're not careful, try to keep the psychical world equal with every player. For example if your script creates a client side object make sure your script will create it for everyone nearby, else people will be wondering why a player appears to be constantly floating and falling.
* Instead of using ''onClientResourceStart'' or ''onResourceStart'' events attached to ''resourceRoot'' like this:
<syntaxhighlight lang="lua">function warnPeopleThatThisResourceStarted()
outputChatBox("The resource " .. getResourceName(resource) .. " has just started!", 0, 255, 0)
end
addEventHandler("onClientResourceStart", resourceRoot, warnPeopleThatThisResourceStarted)</syntaxhighlight>
You can also use this outside of any function:
<syntaxhighlight lang="lua">outputChatBox("The resource " .. getResourceName(resource) .. " has just started!", 0, 255, 0)</syntaxhighlight>
And the result will be the same, because Lua executes every instruction in every script file of a resource when it starts.
* string.dump produces unsigned compiled Lua code which is not allowed for security reasons. The only way to transport code now is by using the source code. e.g.:
<syntaxhighlight lang="lua">exampleFunction = [===[
return param
]===]

local loadedFunction = loadstring(exampleFunction)</syntaxhighlight>

== MTA Scripting - Element IDs Being Reused ==
* If your script is covered in [[isTimer]] and [[isElement]] checks to hide debug warnings from deleted elements not being dereferenced (making the variable nil) you will regret it when that element ID or timer pointer has to be re-used by MTA in a weeks time and your script starts acting strangely and you won't have a clue why. Dereference destroyed elements and disconnected players!
* Why would MTA reuse it in a weeks time? Everything has a userdata value whether it's a function or an element, there is a limited amount of these available meaning that eventually the server will be forced to use the same userdata value twice, as long as whatever that userdata value was for is no longer valid. This could happen within hours, weeks or even never depending on how many elements are being created and destroyed by your scripts.
* For example if you have a race server that has 100 objects in every map and the map was changing every 5 minutes your server would go through at least 1200 an hour, 28,800 a day, 201,600 a week in userdata values, it can't keep going up and up though eventually it will have to reuse the same userdata values and as long as you're dereferencing in your scripts, it won't be a problem.

The is an example of a script which fails to dereference, because when the player quits their userdata value remains in the table, but what if in a weeks time another player joins and they get assigned the same userdata value?
<syntaxhighlight lang="lua">

local admins = {}
local secretPasswordOnlyAdminsShouldKnow = "12345678"

function adminLogin()
if (hasObjectPermissionTo(source, "command.ban", false)) then
admins[source] = true
end
end
addEventHandler("onPlayerLogin", root, adminLogin)

function cmdGetSecretPassword(plr)
if (not admins[plr]) then
return false
end
outputChatBox("The secret password is "..secretPasswordOnlyAdminsShouldKnow, plr)
end
addCommandHandler("getsecretpass", cmdGetSecretPassword)
</syntaxhighlight>

Some random player who joins in a weeks time gets the same userdata value as an admin, that player can now use "getsecretpass". Solution? De-reference on destruction!
<syntaxhighlight lang="lua">

function onQuit()
admins[source] = nil
end
addEventHandler("onPlayerQuit", root, onQuit)
</syntaxhighlight>

== Server Performance ==
* Server lagging? Check [[Debugging#Debugging_Performance_Issues|this page of debugging performance issues]]
* Using resourceRoot in event handlers for events from clients is much more efficient than using root.
* Try to be efficient, but if what you're doing is too time consuming or complex, is it really efficient?
* It's much more efficient to [[SetElementHealth]] and [[setElementRotation]] on a player client side, consider a client event all your server scripts can call to set a players health.
* Unless you have hundreds of players, don't worry about making little optimizations, check ''performancebrowser'' or ''ipb'' (ingame performancebrowser) and make sure no resource is using significantly more than the others.

== Client Performance ==
* The biggest cause of client script CPU usage is anything done in onClient/Pre/Hud/Render because it is called so often. For example if you have a script which calls dxDrawLine3D 20 times, 60 times a second, if those lines are only in 1 part of the map, consider adding a [[getDistanceBetweenPoints3D]] check between the local player and the general area that those lines are in and if they're no where near the player, don't draw the lines.
* Another thing that gets called a lot and could therefore be quite consuming if not careful are events like [[onClientPlayerWeaponFire]] and [[onClientPlayerDamage]] so any scripts that use these should only be bound to the necessary elements (such as localPlayer instead of root) and run the simplest if statements for example if you wanted to handle a certain weapon being fired in a certain dimension it's better to check weapon first as that's a simple weaponID == x rather than getElementDimension(source) == y.
* Start checking variables since least aggravating. Example, first do simple checks: interior, dimension, distance, then check elementDatas, exports etc.

== Speed comparison between local and global variables ==

=== Slower ===

<syntaxhighlight lang="lua">

start = getTickCount()
a = 1
for i=1,10000000 do
a = 1
end
stop = getTickCount()
print("global", stop - start ) -- more than 500ms
</syntaxhighlight>
=== Faster ===
<syntaxhighlight lang="lua">
start = getTickCount()
local b = 1
for i=1,10000000 do
b = 1
end
stop = getTickCount()
print("local", stop - start ) -- less than 200ms
</syntaxhighlight>

== Speed comparison between structural and OOP scripting ==
=== Slower ===
<syntaxhighlight lang="lua">
start = getTickCount()
a = 1
for i=1,1000000 do
a = localPlayer.position
end
stop = getTickCount()
print("variable", stop - start ) -- more then 1500ms
</syntaxhighlight>
=== Faster ===
<syntaxhighlight lang="lua">
start = getTickCount()
b = nil
for i=1,1000000 do
b = getElementPosition(localPlayer)
end
stop = getTickCount()
print("structural", stop - start ) -- less then 200ms
</syntaxhighlight>

Template:Useful Classes

2020-09-21T15:47:05Z

CrosRoad95:

[[Category:Useful Classes]]
*[[Singleton]] » This class allows to restrict the instantiation of a specific class to one object.
*[[CThread]] » This class represents a simple coroutine manager which can be used to limit method calls / loop.
*[[Importer]] » This class make easy to use exported functions.
*[[Observable]] » Observable variables. Call function on variable value change.

Observable

2020-09-21T15:42:32Z

CrosRoad95: Created page with "{{Useful Class}} __NOTOC__ This class allows you to watch for variables changes. Call observable variable to push new state. Author: CrosRoad95 Contact discord: mtasa.com/di..."

{{Useful Class}}
__NOTOC__
This class allows you to watch for variables changes.

Call observable variable to push new state.

Author: CrosRoad95
Contact discord: mtasa.com/discord
==Requirements==

OOP turn on

==Code==
<syntaxhighlight lang="lua">
observable = {}

function observable:onChange(callback)
self.callback = callback
end

function observable:__tostring()
return self.value
end

function observable:__call(newState)
if(self.value == newState)then
return false
end
local oldValue = self.value;
self.value = newState;
if(self.callback)then
self.callback(oldValue, self.value)
end
return true;
end

function observable:create(defaultValue)
local t = { value = defaultValue, observators = {} }
setmetatable(t, self)
self.__index = self
return t
end

function watch(callback, ...)
for i,v in ipairs({...})do
v:onChange(function(old, new)
if(callback)then
callback(i, old, new)
end
end)
end
end
</syntaxhighlight>

==Example 1==
How it works
<syntaxhighlight lang="lua">
a = observable:create("asdf") -- "asdf" is a default value.
b = observable:create(10)

watch(function(index, prvValue, newValue) -- called every time observable value has change.
print("index",index, "change", prvValue, "=> ",newValue)
end, a, b) -- pass variables you want to watch

a(20) -- index 1 change asdf => 20
b(30) -- index 2 change 10 => 30
a("aaa") -- index 1 change 20 => aaa

print("value:", a) -- in this case it will print "aaa"
</syntaxhighlight>

==See Also==
{{Useful_Classes}}

Importer

2020-09-21T15:35:23Z

CrosRoad95:

{{Useful Class}}
__NOTOC__
This function allow to import functions from other scripts.
Author: CrosRoad95
Contact discord: mtasa.com/discord
==Requirements==

OOP turn on

==Code==
<syntaxhighlight lang="lua">
importer={}
importer.__index = importer
function importer:import(functionsToImport)
assert(functionsToImport:len()>0,"specify what you want to import")
local impr = {}
setmetatable(impr,importer)
impr.scripts=functionsToImport
return impr
end
function importer:from(script)
local res=getResourceFromName(script)
assert(res,"script doesnt exists")
local functions=res:getExportedFunctions()
assert(#functions>0,"script must contain exports")
local importThis={}
if(self.scripts=="*")then
importThis=functions
else
local tbsplit=split(self.scripts,",")
for i,v in ipairs(functions)do
for ii,vv in ipairs(tbsplit)do
if(string.find(v,vv))then
table.insert(importThis,v)
end
end
end
end
for i,v in ipairs(importThis)do
_G[v]=function(...)
return call(res,v,...)
end
end
end
function import(...)
return importer:import(...)
end
</syntaxhighlight>

==Example 1==
Import specified functions
<syntaxhighlight lang="lua">
import("function1,function2"):from("myScript") -- import functions "function1" and "function2" from script "myScript"
-- now "function1()" is same as "exports.myScript:function()"
function1("test")
</syntaxhighlight>

==Example 2==
Import functions which contain string
<syntaxhighlight lang="lua">
import("function,otherFunctions"):from("myScript") -- import functions contain "function" in name, in this example import "function1" and "function2" from script "myScript"
function1("test")
</syntaxhighlight>

==Example 3==
Import all functions
<syntaxhighlight lang="lua">
import("*"):from("myScript") -- import all functions, in this example import "function1" and "function2" from script "myScript"
function1("test")
</syntaxhighlight>

==See Also==
{{Useful_Classes}}

PhysicsCreateWorld

2020-09-18T11:55:47Z

CrosRoad95:

__NOTOC__

{{Note|Availiable only in custom fork of mta. see https://github.com/multitheftauto/mtasa-blue/pull/1246 }}

{{Client function}}
Creates physics world with default settings.

==Syntax==
<syntaxhighlight lang="lua">
physics physicsCreateWorld( [ float gravityX, float gravityY, float gravityZ ] )
</syntaxhighlight>

===Required Arguments===
*'''gravity:''' gravitation used for simulation. Default: 0,0, -9.81

===Returns===
*'''physics''' world used for simulation.

==Example==

<syntaxhighlight lang="lua">
physics = physicsCreateWorld()
</syntaxhighlight>

==See Also==

{{Client_physics_functions}}

GetMoonSize

2020-05-20T17:07:22Z

CrosRoad95:

__NOTOC__
{{Server client function}}
{{New feature/item|3.0132|1.3.1|5063|
This function returns the moon size.
{{Note|The function will return ''false'' server-side if moon size has not been set before the function is called.}}

}}

==Syntax==
<syntaxhighlight lang="lua">
int getMoonSize ()
</syntaxhighlight>

===Returns===
Returns a integer being the moon size that is currently set, depending on which side it is used.

==Example==
<section name="Server" class="server" show="true">
This example will tell the moon size to everyone when the resource is started.
<syntaxhighlight lang="lua">
function handleResourceStart( )
outputChatBox( string.format( "Server's moon size is set to %d", getMoonSize() ) )
end
addEventHandler( "onResourceStart", resourceRoot, handleResourceStart )</syntaxhighlight>
</section>

==Requirements==
{{Requirements|1.3.1-9.05063|1.3.1-9.05063}}

==See Also==
{{Client_world_functions}}

GetRainLevel

2020-05-20T17:06:05Z

CrosRoad95:

__NOTOC__
{{Server client function}}
This function is used to get the current rain level.
{{Note|The function will return ''false'' server-side if rain level has not been set before the function is called.}}
==Syntax==
<syntaxhighlight lang="lua">
float getRainLevel( )
</syntaxhighlight>

===Returns===
Returns the rain level as a number.

==Example==
<section name="Client" class="client" show="true">
'''Example:''' Sets the rain (So it can detect it) before returning it. (In this case, when resource starts.)
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(), function()
setRainLevel(math.random(5))
end)
function returnRain()
local rain = getRainlevel()
if(rain >= 1) then
outputChatBox("Looks like it's going to be a rainy day!",255,130,130,false)
else
outputChatBox("Surprisingly dry!",255,130,130,false)
end
end
addCommandHandler("rain", returnRain)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
'''Example:''' Sets the rain (So it can detect it) before returning it. (In this case, when resource starts.)
<syntaxhighlight lang="lua">
addEventHandler("onResourceStart", getResourceRootElement(), function()
setRainLevel(math.random(5))
end)

function returnRain(player)
local rain = getRainlevel()
if(rain >= 1) then
outputChatBox("Looks like it's going to be a rainy day!",player,255,130,130,false)
else
outputChatBox("Surprisingly dry!",player,255,130,130,false)
end
end
addCommandHandler("rain", returnRain)
</syntaxhighlight>
</section>

==See Also==
{{World functions}}

GetRainLevel

2020-05-20T17:05:51Z

CrosRoad95:

__NOTOC__
{{Server client function}}
This function is used to get the current rain level.

{{Note|The function will return ''false'' server-side if sun size has not been set before the function is called.}}
==Syntax==
<syntaxhighlight lang="lua">
float getRainLevel( )
</syntaxhighlight>

===Returns===
Returns the rain level as a number.

==Example==
<section name="Client" class="client" show="true">
'''Example:''' Sets the rain (So it can detect it) before returning it. (In this case, when resource starts.)
<syntaxhighlight lang="lua">
addEventHandler("onClientResourceStart", getResourceRootElement(), function()
setRainLevel(math.random(5))
end)
function returnRain()
local rain = getRainlevel()
if(rain >= 1) then
outputChatBox("Looks like it's going to be a rainy day!",255,130,130,false)
else
outputChatBox("Surprisingly dry!",255,130,130,false)
end
end
addCommandHandler("rain", returnRain)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
'''Example:''' Sets the rain (So it can detect it) before returning it. (In this case, when resource starts.)
<syntaxhighlight lang="lua">
addEventHandler("onResourceStart", getResourceRootElement(), function()
setRainLevel(math.random(5))
end)

function returnRain(player)
local rain = getRainlevel()
if(rain >= 1) then
outputChatBox("Looks like it's going to be a rainy day!",player,255,130,130,false)
else
outputChatBox("Surprisingly dry!",player,255,130,130,false)
end
end
addCommandHandler("rain", returnRain)
</syntaxhighlight>
</section>

==See Also==
{{World functions}}

GetSunSize

2020-05-20T17:04:45Z

CrosRoad95:

__NOTOC__
{{Server client function}}
This function is used to get the size of the sun.
{{Note|The function will return ''false'' server-side if sun size has not been set before the function is called.}}
==Syntax==
<syntaxhighlight lang="lua">
float getSunSize ( )
</syntaxhighlight>

===Returns===
Returns the size of the sun as a number, false if the size of the sun is at its default.

==Example==
This example lets any player get the size of the sun like /getsunsize
<syntaxhighlight lang="lua">
function commandGetSunSize(player, command)
local size = getSunSize()
if (size) then
outputChatBox("The current size of the sun is "..size..".", player, 0, 255, 0)
else
outputChatBox("The size of the sun is normal.", player, 0, 255, 0)
end
end
addCommandHandler("getsunsize", commandGetSunSize)
</syntaxhighlight>
==See Also==
{{World functions}}

GetWindVelocity

2020-05-20T16:53:43Z

CrosRoad95:

__NOTOC__
{{Server client function}}
This function gets the wind velocity in San Andreas.
{{Note|The function will return ''false'' server-side if wind velocity has not been set before the function is called.}}
==Syntax==
<syntaxhighlight lang="lua">
int, int, int getWindVelocity ( )
</syntaxhighlight>

===Returns===
*'''velocityX''': The velocity on the x-coordinate or false if the wind velocity is default.
*'''velocityY''': The velocity on the y-coordinate or nil if the wind velocity is default.
*'''velocityZ''': The velocity on the z-coordinate or nil if the wind velocity is default.

==Example==
This example returns the wind velocity to a player if they use the command 'getwindvelocity'.
<syntaxhighlight lang="lua">
function commandGetWindVelocity(player, command)
local vx, vy, vz = getWindVelocity()
if (vx) then
outputChatBox("Wind Velocity X:"..vx.." Y:"..vy.." Z:"..vz, player, 255, 255, 0)
else
outputChatBox("Wind velocity is default.", player, 255, 255, 0)
end
end
addCommandHandler("getwindvelocity", commandGetWindVelocity)
</syntaxhighlight>

==See Also==
{{Client_world_functions}}

User:CrosRoad95

2020-02-20T06:40:57Z

CrosRoad95:

List of functions i'm working on:

{{Client_physics_functions}}

Future ideas for physics:
# gear constraint
# wheels
# detailed raycast
# copying shape
# respawn point for rigid body, if will not activated for some time, got moved to respawn point
# attaching rigid body to mta object
# multimaterial triangle mesh
# options to build gta collision function:
## - what models should be created as rigid body, do they should have set respawn point?
## - reuse shapes, create new for duplicated models
## - don't create compound shape if not needed
# soft bodies
# drawing debug only for specified rigid body/static collision/shape
# debug mode to render only rigids, only static collision or both
# fast 3d line
# profiling
# quering physics element
# world size option to automatic get rid of rigid bodies which fall off world
# creating static or rigids collisions from objects created by createObject
# add rest of properties for everything
# improve current functions
## triangle mesh should accept `verteX, vertex, vertex, verteX, vertex, vertex` or {verteX, vertex, vertex, verteX, vertex, vertex,} or {{verteX, vertex, vertex}, {verteX, vertex, vertex}}
# multithreading physics simulation
# add missing shapes: btBox2dShape, btConvex2dShape, btEmptyShape, btGImpactCompoundShape, btGImpactMeshShape, btMinkowskiSumShape, CbtMultiSphereShape, CbtMultimaterialTriangleMeshShape, btPlaneShape, CbtScaledBvhTriangleMeshShape,
##

User:CrosRoad95

2020-02-20T06:23:29Z

CrosRoad95:

List of functions i'm working on:

{{Client_physics_functions}}

Future ideas for physics:
# gear constraint
# wheels
# detailed raycast
# copying shape
# respawn point for rigid body??
# attaching rigid body to mta object
# multimaterial triangle mesh
# options to build gta collision function:
## - what models should be created as rigid body, do they should have set respawn point?
## - reuse shapes, create new for duplicated models
## - don't create compound shape if not needed
# soft bodies
# drawing debug only for specified rigid body/static collision/shape
# debug mode to render only rigids, only static collision or both
# fast 3d line
# profiling
# quering physics element
# world size option to automatic get rid of rigid bodies which fall off world

Physics properties

2020-02-19T20:54:32Z

CrosRoad95: /* Physics properties */

===Physics properties===
used in
*[[physicsSetProperties]]
*[[physicsGetProperties]]

{|class="wikitable sortable"
|-
! Name || Support || Access || Parametrs || Description
|-
| mass || rigid-body || set, get || float mass || Changes mass of rigid body.
|-
| position || rigid-body, static-collision || set, get || float x, float y, float z || Sets/gets position.
|-
| position || constraint || get || float x, float y, float z || Returns avarge position of two rigids.
|-
| rotation || rigid-body, static-collision || set, get || float rx, float ry, float rz || Sets/gets rotation.
|-
| velocity || rigid-body || set, get || float velocityX, float velocityY, float velocityZ|| Sets/gets velocity.
|-
| angularvelocity || rigid-body || set, get || float velocityX, float velocityY, float velocityZ|| Sets/gets angular velocity.
|-
| sleepingthresholds || rigid-body || set, get || float velocity, float angularVelocity || Sets how slow rigid body have to move, to go sleep.
|-
| simulationenabled || physics-world || set, get || bool enabled = true || Enable/disable simulation.
|-
| simulationsubsteps || physics-world || set, get || int subSteps = 10 || Between 1 and 256, sets how long and how precise collision detection should be.
|-
| restitution || rigid-body || set, get || float value|| todo
|-
| scale || physics-shape, rigid-body, static-collision || set, get || float scaleX, float scaleY, float scaleZ || Sets/gets scale, if rigid of static collision as parametr, their shape scale got set/get. You can't scale per rigid/static collision
|-
| debugcolor || physics-shape, rigid-body, static-collision || set, get || color theColor / boolean false resets color || Changes debug color
|-
| filtermask || todo || set, get || todo || todo
|-
| filtergroup || todo || set, get || todo || todo
|-
| stiffness|| todo || set, get || todo || todo
|-
| size || shape|| set, get || float sizeX, float sizeY, float sizeZ || Changes size of "box" shape type.
|-
| radius || todo || set, get || todo || todo
|-
| height || todo || set, get || todo || todo
|-
| boundingbox || todo || get || todo || todo
|-
| boundingsphere || todo || get || todo || todo
|-
| gravity || physics-world || set, get || float gravityX, float gravityY, float gravityZ|| Changes gravity of the simulation
|-
| usecontinuous || physics-world || set, get || bool bEnabled || False by default, enable detection of rigid body which happened between two simulation steps. Cause increased simulation time, prevents small shapes fly through thick surfaces
|-
| motionthreshold || todo || set, get || todo || todo
|-
| sweptsphereradius || todo || set, get || todo || todo
|-
| pivota || todo || set, get || todo || todo
|-
| pivotb || todo || set, get || todo || todo
|-
| lowerlinlimit || todo || set, get || todo || todo
|-
| upperlinlimit || todo || set, get || todo || todo
|-
| loweranglimit || todo || set, get || todo || todo
|-
| upperanglimit || todo || set, get || todo || todo
|-
| breakingimpulsethreshold || todo || set, get || todo || todo
|-
| appliedimpulse || todo || set, get || todo || todo
|-
| jointfeedback || todo || set, get || todo || todo
|-
| constraintbroken || todo || set, get || todo || todo
|-
| triggercollisionevents || physics-world || set, get || bool bEnabled = false || Cause physics world starts to trigger collision events. Don't enable if you don't use them. Can cause spam.
|-
| triggerconstraintevents || physics-world || set, get || bool bEnabled = false || Cause physics world starts to trigger constraints events. Don't enable if you don't use them. Can cause spam.
|-
| rigidbodya || todo || set, get || todo || todo
|-
| rigidbodyb|| todo || set, get || todo || todo
|-
| sleep || todo || set, get || todo || todo
|-
| wantssleeping || todo || set, get || todo || todo
|-
| iscompound || todo || set, get || todo || todo
|-
| iscocave || todo || set, get || todo || todo
|-
| isconvex || todo || set, get || todo || todo
|-
| isconvex2d || todo || set, get || todo || todo
|-
| isinfinite || todo || set, get || todo || todo
|-
| isnonmoving || todo || set, get || todo || todo
|-
| ispolyhedral || todo || set, get || todo || todo
|-
| issoftbody || todo || set, get || todo || todo
|}

PhysicsIsElement

2020-02-19T19:16:14Z

CrosRoad95: Created page with "__NOTOC__ {{Client function}} Returns whatever physics-element exists ==Syntax== <syntaxhighlight lang="lua"> bool physicsIsElement(physics-element thePhysicsElement)..."

__NOTOC__
{{Client function}}
Returns whatever physics-element exists

==Syntax==
<syntaxhighlight lang="lua">
bool physicsIsElement(physics-element thePhysicsElement)
</syntaxhighlight>

===Required Arguments===
*'''thePhysicsElement:''' physics element: shape, constraint, rigid body, static collision

===Returns===
True if physics element exists

==Example==

if shape got destroyed, static collisions, rigid body and its constraints will destroyed too, this example prove it.
<syntaxhighlight lang="lua">
local shape = physicsCreateShape(physics, "box", 1)
local rb = physicsCreateRigidBody(shape)
local col = physicsCreateStaticCollision(shape)
local const = physicsCreateConstraint("pointtopoint", rb, 0,0,0)
iprint("isElement before", physicsIsElement(shape), physicsIsElement(rb), physicsIsElement(col), physicsIsElement(const)) -- true, true, true, true
physicsDestroy(shape)
iprint("isElement after", physicsIsElement(shape), physicsIsElement(rb), physicsIsElement(col), physicsIsElement(const)) -- false, false, false ,false
</syntaxhighlight>

==See Also==

{{Client_physics_functions}}

Template:Client physics functions

2020-02-19T19:13:50Z

CrosRoad95:

*[[physicsCreateWorld]]
*[[physicsDestroy]]
*[[physicsCreateShape]]
*[[physicsCreateShapeFromModel]]
*[[physicsCreateRigidBody]]
*[[physicsCreateStaticCollision]]
*[[physicsCreateConstraint]]
*[[physicsAddChildShape]]
*[[physicsRemoveChildShape]]
*[[physicsGetChildShapes]]
*[[physicsSetChildShapeOffsets]]
*[[physicsGetChildShapeOffsets]]
*[[physicsGetShapes]]
*[[physicsGetRigidBodies]]
*[[physicsGetStaticCollisions]]
*[[physicsGetConstraints]]
*[[physicsSetProperties]]
*[[physicsGetProperties]]
*[[physicsDrawDebug]]
*[[physicsSetDebugMode]]
*[[physicsBuildCollisionFromGTA]]
*[[physicsApplyVelocity]]
*[[physicsApplyVelocityForce]]
*[[physicsApplyAngularVelocity]]
*[[physicsApplyAngularVelocityForce]]
*[[physicsApplyDamping]]
*[[physicsRayCast]]
*[[physicsShapeCast]]
*[[physicsGetElementType]]
*[[physicsIsElement]]

PhysicsGetElementType

2020-02-19T19:11:58Z

CrosRoad95: /* Example */

__NOTOC__
{{Client function}}
Returns type of physics-element

==Syntax==
<syntaxhighlight lang="lua">
string physicsGetElementType(physics-element thePhysicsElement)
</syntaxhighlight>

===Required Arguments===
*'''thePhysicsElement:''' physics element: shape, constraint, rigid body, static collision

===Returns===
Name of physics element, "shape", "rigidbody", "staticcollision", "constraint"

==Example==

<syntaxhighlight lang="lua">
local shape = physicsCreateShape(physics, "box", 1)
local rb = physicsCreateRigidBody(shape)
local col = physicsCreateStaticCollision(shape)
local const = physicsCreateConstraint("pointtopoint", rb, 0,0,0)
iprint("shape: ",physicsGetElementType(shape)) -- shape
iprint("rigidbody: ",physicsGetElementType(rb)) -- rigidbody
iprint("staticcollision: ",physicsGetElementType(col)) -- staticcollision
iprint("constraint: ",physicsGetElementType(const)) -- constraint
iprint("invalid: ",physicsGetElementType(physics)) -- false
</syntaxhighlight>

==See Also==

{{Client_physics_functions}}

PhysicsGetElementType

2020-02-19T19:05:07Z

CrosRoad95: Created page with "__NOTOC__ {{Client function}} Returns type of physics-element ==Syntax== <syntaxhighlight lang="lua"> string physicsGetElementType(physics-element thePhysicsElement)..."

__NOTOC__
{{Client function}}
Returns type of physics-element

==Syntax==
<syntaxhighlight lang="lua">
string physicsGetElementType(physics-element thePhysicsElement)
</syntaxhighlight>

===Required Arguments===
*'''thePhysicsElement:''' physics element: shape, constraint, rigid body, static collision

===Returns===
Name of physics element, "shape", "rigidbody", "staticcollision", "constraint"

==Example==

<syntaxhighlight lang="lua">
local shape = physicsCreateShape(physics, "box", 1)
local rb = physicsCreateRigidBody(shape)
local col = physicsCreateStaticCollision(shape)
local const = physicsCreateConstraint("pointtopoint", rb, 0,0,0)
iprint("shape: ",physicsGetElementType(shape)) -- shape
iprint("rigidbody: ",physicsGetElementType(shape)) -- rigidbody
iprint("staticcollision: ",physicsGetElementType(col)) -- staticcollision
iprint("constraint: ",physicsGetElementType(const)) -- constraint
iprint("invalid: ",physicsGetElementType(physics)) -- false
</syntaxhighlight>

==See Also==

{{Client_physics_functions}}

Template:Client physics functions

2020-02-19T19:02:25Z

CrosRoad95:

Physics properties

2020-02-19T15:54:58Z

CrosRoad95: /* Physics properties */

===Physics properties===
used in
*[[physicsSetProperties]]
*[[physicsGetProperties]]

{|class="wikitable sortable"
|-
! Name || Support || Access || Parametrs || Description
|-
| mass || rigid-body || set, get || float mass || Changes mass of rigid body.
|-
| position || rigid-body, static-collision || set, get || float x, float y, float z || Sets/gets position.
|-
| position || constraint || get || float x, float y, float z || Returns avarge position of two rigids.
|-
| rotation || rigid-body, static-collision || set, get || float rx, float ry, float rz || Sets/gets rotation.
|-
| velocity || rigid-body || set, get || float velocityX, float velocityY, float velocityZ|| Sets/gets velocity.
|-
| angularvelocity || rigid-body || set, get || float velocityX, float velocityY, float velocityZ|| Sets/gets angular velocity.
|-
| sleepingthresholds || rigid-body || set, get || float velocity, float angularVelocity || Sets how slow rigid body have to move, to go sleep.
|-
| simulationenabled || physics-world || set, get || bool enabled = true || Enable/disable simulation.
|-
| restitution || rigid-body || set, get || float value|| todo
|-
| scale || physics-shape, rigid-body, static-collision || set, get || float scaleX, float scaleY, float scaleZ || Sets/gets scale
|-
| debugcolor || physics-shape, rigid-body, static-collision || set, get || color theColor / boolean false resets color || Changes debug color
|-
| filtermask || todo || set, get || todo || todo
|-
| filtergroup || todo || set, get || todo || todo
|-
| stiffness|| todo || set, get || todo || todo
|-
| size || shape|| set, get || float sizeX, float sizeY, float sizeZ || Changes size of "box" shape type.
|-
| radius || todo || set, get || todo || todo
|-
| height || todo || set, get || todo || todo
|-
| boundingbox || todo || get || todo || todo
|-
| boundingsphere || todo || get || todo || todo
|-
| gravity || physics-world || set, get || float gravityX, float gravityY, float gravityZ|| Changes gravity of the simulation
|-
| usecontinuous || physics-world || set, get || bool bEnabled || False by default, enable detection of rigid body which happened between two simulation steps. Cause increased simulation time, prevents small shapes fly through thick surfaces
|-
| motionthreshold || todo || set, get || todo || todo
|-
| sweptsphereradius || todo || set, get || todo || todo
|-
| pivota || todo || set, get || todo || todo
|-
| pivotb || todo || set, get || todo || todo
|-
| lowerlinlimit || todo || set, get || todo || todo
|-
| upperlinlimit || todo || set, get || todo || todo
|-
| loweranglimit || todo || set, get || todo || todo
|-
| upperanglimit || todo || set, get || todo || todo
|-
| breakingimpulsethreshold || todo || set, get || todo || todo
|-
| appliedimpulse || todo || set, get || todo || todo
|-
| jointfeedback || todo || set, get || todo || todo
|-
| constraintbroken || todo || set, get || todo || todo
|-
| triggercollisionevents || physics-world || set, get || bool bEnabled = false || Cause physics world starts to trigger collision events. Don't enable if you don't use them. Can cause spam.
|-
| triggerconstraintevents || physics-world || set, get || bool bEnabled = false || Cause physics world starts to trigger constraints events. Don't enable if you don't use them. Can cause spam.
|-
| rigidbodya || todo || set, get || todo || todo
|-
| rigidbodyb|| todo || set, get || todo || todo
|-
| sleep || todo || set, get || todo || todo
|-
| wantssleeping || todo || set, get || todo || todo
|-
| iscompound || todo || set, get || todo || todo
|-
| iscocave || todo || set, get || todo || todo
|-
| isconvex || todo || set, get || todo || todo
|-
| isconvex2d || todo || set, get || todo || todo
|-
| isinfinite || todo || set, get || todo || todo
|-
| isnonmoving || todo || set, get || todo || todo
|-
| ispolyhedral || todo || set, get || todo || todo
|-
| issoftbody || todo || set, get || todo || todo
|}

PhysicsBuildCollisionFromGTA

2020-02-19T15:17:58Z

CrosRoad95: Created page with "__NOTOC__ {{Client function}} Makes gta collision get copied into bullet physics collision world. Doesn't load areas thats are not streamed in ( don't have loaded collisions..."

__NOTOC__
{{Client function}}
Makes gta collision get copied into bullet physics collision world.
Doesn't load areas thats are not streamed in ( don't have loaded collisions )
==Syntax==
<syntaxhighlight lang="lua">
bool physicsBuildCollisionFromGTA( physics thePhysics, [float x, float y, float z, float radius ] )
</syntaxhighlight>

===Required Arguments===
*'''x, y, z, radius:''' area you want to load.

If position and radius passed, only this area got loaded, if not, flag got set to automatically scan all gta models every short period of time and load it for you.

===Returns===
True if success, false otherwise

==Example==

<syntaxhighlight lang="lua">
</syntaxhighlight>

==See Also==

{{Client_physics_functions}}

PhysicsCreateConstraint

2020-02-19T15:10:55Z

CrosRoad95: Created page with "__NOTOC__ {{Client function}} Creates connection between rigid body and other rigid body or specified position. ==Syntax== <syntaxhighlight lang="lua"> physics-constraint p..."

__NOTOC__
{{Client function}}
Creates connection between rigid body and other rigid body or specified position.

==Syntax==
<syntaxhighlight lang="lua">
physics-constraint physicsCreateConstraint(constraint-type theConstraintType [, disableCollisionsBetweenLinkedBodies = true], physics-rigid-body rigidBodyA [, physics-rigid-body rigidBodyB], mixed )
</syntaxhighlight>

===Required Arguments===
*'''theConstraintType:''' "pointtopoint", "hidge", "fixed", "slider", see [[Physics constraints]]
*'''disableCollisionsBetweenLinkedBodies:''' disable collision between two rigid bodies, useful when rigids are close to each other.
*'''rigidBodyA:''' first rigid body,
*'''rigidBodyB:''' second rigid body, optional, can be replaced with position in some cases.
*'''mixed:''' depends on constraint type
===Returns===
*'''physics''' world used for simulation.

==Example==

Spawns capsule and attach invisible line to the rigid body.
<syntaxhighlight lang="lua">
local capsule = physicsCreateShape(physics, "capsule", 0.5, 1.2)
local capsulerb = physicsCreateRigidBody(capsule );
physicsCreateConstraint("pointtopoint", capsulerb, 0,0,0)
</syntaxhighlight>

==See Also==

{{Client_physics_functions}}

PhysicsCreateShapeFromModel

2020-02-19T14:34:00Z

CrosRoad95: /* Example */

__NOTOC__
{{Client function}}
Creates shape from model in specific physics world. Model must be streamed in ( orignal gtasa models counts as stream in )
==Syntax==
<syntaxhighlight lang="lua">
physics-shape physicsCreateShapeFromModel(physics thePhysics, int model)
</syntaxhighlight>

===Required Arguments===
*'''thePhysics:''' Physics world.
*'''model:''' object model.

===Returns===
*'''shape''' compound shape made of triangle mesh, boxes and spheres.

==Example==

Spawns hay, tree, barn, hay stack and fence as rigid body near by 0,0,0 coords
<syntaxhighlight lang="lua">
function createRigidBodyFromModel(model, x, y, z)
local shape = physicsCreateShapeFromModel(physics, model)
if(shape)then
local rigid = physicsCreateRigidBody(shape)
physicsSetProperties(rigid, "position", x, y, z)
end
end

createRigidBodyFromModel(3276, 0,0,10)
createRigidBodyFromModel(672, 20,0,10)
createRigidBodyFromModel(12918, -20,0,10)
createRigidBodyFromModel(3374, 0,20,10)
createRigidBodyFromModel(12919, 0,-30,10)
</syntaxhighlight>

==See Also==

{{Client_physics_functions}}

PhysicsCreateShape

2020-02-18T21:30:53Z

CrosRoad95:

__NOTOC__
{{Client function}}
Creates physics shape used for static or dynamic collision detection

==Syntax==
<syntaxhighlight lang="lua">
physics-shape physicsCreateShape(physics thePhysics, shape-type theShapeType, mixed)

physics-shape physicsCreateShape(physics thePhysics, "box", float size)
physics-shape physicsCreateShape(physics thePhysics, "box", float sizeX, sizeY, sizeZ)
physics-shape physicsCreateShape(physics thePhysics, "sphere", float radius)
physics-shape physicsCreateShape(physics thePhysics, "capsule", float radius, float height)
physics-shape physicsCreateShape(physics thePhysics, "cone", float radius, float height)
physics-shape physicsCreateShape(physics thePhysics, "cylinder", float radius, float height)
physics-shape physicsCreateShape(physics thePhysics, "heightfieldterrain", int sizeX, int sizeY [, table heightData ] )
physics-shape physicsCreateShape(physics thePhysics, "compound", int initialChildCapacity = 0)
physics-shape physicsCreateShape(physics thePhysics, "trianglemesh", vector3 vertexA, vector3 vertexB, vector3 vertexC, ...)
physics-shape physicsCreateShape(physics thePhysics, "convexhull", vector3 pointA, vector3 pointB, vector3, pointC, ...)
</syntaxhighlight>

*'''heightfieldterrain:''' minimum size is 3x3, and maximum 8192x8192. By default terrain is flat, you can pass default height after size, each float represents height of next vertex.
*'''trianglemesh:''' each of three vectors creates single triangle, use n*3 vectors to create n triangles.
*'''compound:''' can contain up to 8192 child shapes.
*'''convexhull:''' require at least 3 points.

===Required Arguments===
*'''thePhysics:''' physics world
*'''theShapeType:''' shape, availiable types "box", "sphere", "capsule", "cone", "cylinder", "heightfieldterrain", "compound", "trianglemesh", "convexhull",

===Returns===
*'''physics-shape''' to use in future functions

==Example==

<syntaxhighlight lang="lua">
local terrainData = {
3,3,3,3,
3,0,0,3,
3,0,0,3,
3,3,3,3,
}
local terrainShape = physicsCreateShape(physics, "heightfieldterrain", 4,4, terrainData)
local terrain = physicsCreateStaticCollision(terrainShape)
physicsSetProperties(terrain, "position", 0,0,5)
physicsSetProperties(terrain, "scale", 5,5,1) -- in terrain, sets mesh density, now mesh has size 20x20units, one vertex every 5 units
</syntaxhighlight>

==See Also==

{{Client_physics_functions}}

PhysicsCreateShape

2020-02-18T20:41:10Z

CrosRoad95:

__NOTOC__
{{Client function}}
Creates physics shape used for static or dynamic collision detection

==Syntax==
<syntaxhighlight lang="lua">
physics-shape physicsCreateShape(physics thePhysics, shape-type theShapeType, mixed)

physics-shape physicsCreateShape(physics thePhysics, "box", float size)
physics-shape physicsCreateShape(physics thePhysics, "box", float sizeX, sizeY, sizeZ)
physics-shape physicsCreateShape(physics thePhysics, "sphere", float radius)
physics-shape physicsCreateShape(physics thePhysics, "capsule", float radius, float height)
physics-shape physicsCreateShape(physics thePhysics, "cone", float radius, float height)
physics-shape physicsCreateShape(physics thePhysics, "cylinder", float radius, float height)
physics-shape physicsCreateShape(physics thePhysics, "heightfieldterrain", int sizeX, int sizeY [, float height,float height, ... )
physics-shape physicsCreateShape(physics thePhysics, "compound", int initialChildCapacity = 0)
physics-shape physicsCreateShape(physics thePhysics, "trianglemesh", vector3 vertexA, vector3 vertexB, vector3 vertexC, ...)
physics-shape physicsCreateShape(physics thePhysics, "convexhull", vector3 pointA, vector3 pointB, vector3, pointC, ...)
</syntaxhighlight>

*'''heightfieldterrain:''' minimum size is 3x3, and maximum 8192x8192. By default terrain is flat, you can pass default height after size, each float represents height of next vertex.
*'''trianglemesh:''' each of three vectors creates single triangle, use n*3 vectors to create n triangles.
*'''compound:''' can contain up to 8192 child shapes.
*'''convexhull:''' require at least 3 points.

===Required Arguments===
*'''thePhysics:''' physics world
*'''theShapeType:''' shape, availiable types "box", "sphere", "capsule", "cone", "cylinder", "heightfieldterrain", "compound", "trianglemesh", "convexhull",

===Returns===
*'''physics-shape''' to use in future functions

==Example==

<syntaxhighlight lang="lua">

</syntaxhighlight>

==See Also==

{{Client_physics_functions}}

Physics debug mode

2020-02-18T17:34:35Z

CrosRoad95: /* Physics debug modes */

===Physics debug modes===
used in
*[[physicsSetDebugMode]]

{|class="wikitable sortable"
|-
! Name || Parametrs || Description
|-
| nodebug || bool || If set to true, disable all debug modes
|-
| drawwireframe || bool || enables/disables wireframe rendering
|-
| drawaabb|| bool || shows bounding boxes of rigid bodies and static collisions
|-
| drawfeaturestext || bool || todo, not implemented yet
|-
| drawcontactpoints || bool || draws little yellow lines in points of contact
|-
| nodeactivation || bool || cause all rigid bodies are all time activated
|-
| nohelptext || bool || todo, not implemented yet
|-
| drawtext || bool || todo, not implemented yet
|-
| profiletimings || bool || todo, not implemented yet
|-
| enablesatcomparison || bool || todo
|-
| disablebulletlcp || bool || todo
|-
| enableccd || bool || todo
|-
| drawconstraints || bool || todo
|-
| drawconstraintlimits || bool || todo
|-
| fastwireframe || bool || todo
|-
| drawnormals || bool || draws normals
|-
| drawframes || bool || todo
|-
| linewidth || float || changes width of debugging line
|}

Physics debug mode

2020-02-18T17:24:54Z

CrosRoad95: /* Physics debug modes */

===Physics debug modes===
used in
*[[physicsSetDebugMode]]

{|class="wikitable sortable"
|-
! Name || Parametrs || Description
|-
| nodebug || bool || If set to true, disable all debug modes
|-
| drawwireframe || bool || todo
|-
| drawaabb|| bool || todo
|-
| drawfeaturestext || bool || todo, not implemented yet
|-
| drawcontactpoints || bool || todo
|-
| nodeactivation || bool || cause all rigid bodies are all time activated
|-
| nohelptext || bool || todo
|-
| drawtext || bool || todo
|-
| profiletimings || bool || todo
|-
| enablesatcomparison || bool || todo
|-
| disablebulletlcp || bool || todo
|-
| enableccd || bool || todo
|-
| drawconstraints || bool || todo
|-
| drawconstraintlimits || bool || todo
|-
| fastwireframe || bool || todo
|-
| drawnormals || bool || draws normals
|-
| drawframes || bool || todo
|-
| linewidth || float || changes width of debugging line
|}