Multi Theft Auto: Wiki - New pages [en]

IsCursorOnElement

2026-04-05T15:19:18Z

Knower: Created page with "== Client-Side Function: isCursorOnElement == thumb '''Description:''' This function is used in GUI / DX to create interactive buttons or effects in a professional way. It allows you to make elements like buttons, rectangles, or any selectable area responsive to the player's cursor. You can also add many enhancements to make the appearance of the button or element look visually appealing and professional. --- === Function === <syntaxhighlight la..."

== Client-Side Function: isCursorOnElement ==

[[File:MTANeonX.png|thumb]]
'''Description:'''
This function is used in GUI / DX to create interactive buttons or effects in a professional way.
It allows you to make elements like buttons, rectangles, or any selectable area responsive to the player's cursor.
You can also add many enhancements to make the appearance of the button or element look visually appealing and professional.
---

=== Function ===
<syntaxhighlight lang="lua">

function isCursorOnElement( posX, posY, width, height )

if isCursorShowing( ) then

local mouseX, mouseY = getCursorPosition( )

local clientW, clientH = guiGetScreenSize( )

local mouseX, mouseY = mouseX * clientW, mouseY * clientH

if ( mouseX > posX and mouseX < ( posX + width ) and mouseY > posY and mouseY < ( posY + height ) ) then

return true

end

end

return false

end

</syntaxhighlight>

---

=== Example Usage ===
<syntaxhighlight lang="lua">
-- Example: Interactive button on screen

local SelectBut = 1 -- Stores the button selected by player
local x, y, w, h = 100, 100, 150, 50 -- Element position and size

if isCursorOnElement(x, y, w, h) then
-- Cursor is on the element → full alpha
dxDrawImage(x, y, w, h, "img.png", 0, 0, 0, tocolor(255, 254, 254, 255), false)
else
if SelectBut == 1 then
-- Cursor is not on the element but already selected → full alpha
dxDrawImage(x, y, w, h, "img.png", 0, 0, 0, tocolor(255, 254, 254, 255), false)
else
-- Cursor is not on the element and not selected → reduce alpha
dxDrawImage(x, y, w, h, "img.png", 0, 0, 0, tocolor(255, 254, 254, 50), false)
end
end
</syntaxhighlight>

---

===Explanation ===
* '''isCursorOnElement(posX, posY, width, height)''' Function to check cursor position relative to an element

---

=== Notes===
* This function is safe for Client-Side only and will not affect other players.
* GUI/DX Example can be adapted for multiple buttons or GUI elements easily.

IsResourceRunning

2026-04-02T02:03:14Z

Flox: /* Example check isResourceRunning(resName) */

__NOTOC__
{{Shared function}}

==Syntax==
*'''isResourceRunning''' You can insert this code example in your resources.

===Required Arguments===
*'''isResourceRunning:''' The value to check resources

==Example check isResourceRunning(resName)==
<section name="isResourceRunning" class="shared" show="true">
You can insert this code example in your resources.
<syntaxhighlight lang="lua">
function isResourceRunning(resName)
local res = getResourceFromName(resName)
return (res) and (getResourceState(res) == "running")
end

-- Example of inserting into system code:
--[[
if isResourceRunning("admin") then
--code
else
--alert
end

addCommandHandler('pos', function (commandName)
if isResourceRunning("admin") then
local x,y,z = getElementPosition(localPlayer)
outputChatBox( x ..', '.. y ..', '.. z, 255, 255, 255 )
else
outputChatBox("The resource is not running 'admin'.", 255, 0, 0)
end
end )
]]

</syntaxhighlight>
</section>

==See Also==
{{Resource_functions}}

EngineRestreamModel

2026-01-13T18:45:17Z

LamarDev: create engineRestreamModel page

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.7.0|25613|This function re-streams a specific model in the GTA world.}}

==Syntax==
<syntaxhighlight lang="lua">
bool engineRestreamModel ( int modelId )
</syntaxhighlight>

===Returns===
Returns ''true'' if the re-stream was successful, ''false'' otherwise.

==Example==
This function can be used after a model (or more) is loaded with [[engineImageLinkDFF]]:
<syntaxhighlight lang="lua">
addEventHandler ("onClientResourceStart", resourceRoot, function ()
engineRestreamModel (445)
end)
</syntaxhighlight>

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

EngineRestream

2026-01-13T18:42:23Z

LamarDev: create engineRestream page

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.7.0|25613|This function re-streams a specific group of models in the GTA world.}}

==Syntax==
<syntaxhighlight lang="lua">
bool engineRestream ( [ string restreamOption = "world" ] )
</syntaxhighlight>

===Optional Arguments===
*'''restreamOption:''' The specific group of models you want to re-stream. It can be: "world", "vehicles", "peds", "objects"

===Returns===
Returns ''true'' if the re-stream was successful, ''false'' otherwise.

==Example==
This function can be used after a model (or more) is loaded with [[engineImageLinkDFF]]:
<syntaxhighlight lang="lua">
addEventHandler ("onClientResourceStart", resourceRoot, function ()
engineRestream ("vehicles")
end)
</syntaxhighlight>

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

RU/Script security

2026-01-08T19:13:07Z

Flox: Created page with "==Внимание к клиентской памяти == Начнем с самых основ: * Вы должны знать, что все, что вы храните на стороне клиента, подвержено риску, в том числе и lua-файлы. Злоумышленники могут получить доступ к любым конфиденциальным (и/или) важным данным, которые хранятся ил..."

==Внимание к клиентской памяти ==

Начнем с самых основ:

* Вы должны знать, что все, что вы храните на стороне клиента, подвержено риску, в том числе и lua-файлы. Злоумышленники могут получить доступ к любым конфиденциальным (и/или) важным данным, которые хранятся или передаются на стороне клиента (ПК игрока).
* Для обеспечения безопасности конфиденциальных данных (и/или) логики Lua используйте серверную часть.
* Обратите внимание, что скрипты, помеченные как '''shared''', также действуют как '''client code''', что означает, что к ним применимо все вышесказанное. Например, определение:

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

Это то же самое, что делать:

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

==Дополнительный уровень защиты ==

Чтобы ''немного усложнить'' задачу для тех, у кого плохие намерения по отношению к вашему серверу, вы можете использовать атрибут cache (и/или [https://luac.mtasa.com / Lua compile (также известный как Luac) с дополнительной настройкой запутывания на уровне ''3''] - [https://wiki.multitheftauto.com/wiki/Lua_compilation_API API]), доступный в [https://wiki.multitheftauto.com/wiki/Meta.xml meta.xml ], а также о настройке встроенного AC в MTA путем переключения SD (Специальные средства обнаружения), смотрите: [https://wiki.multitheftauto.com/wiki/Anti-cheat_guide Руководство по борьбе с читерством].

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

* ''Для некоторых'' ''немного сложнее'', ''но не невозможно'', получить клиентский код, но при этом он отлично справляется с тем, что удерживает ''большинство'' пользователей от проверки ваших lua-файлов - тех, кто ищет возможные логические ошибки (баги) или отсутствующие / некорректные проверки на основе безопасности.
* Может использоваться как для ''клиентских (client)'', так и для ''общих (shared)'' скриптов (не влияет на Lua на стороне сервера).
* Не удаляет файлы Lua, которые были загружены ранее.

==Обнаружение бэкдоров и читерских программ и борьба с ними==
'''Для обеспечения минимального ущерба (или его отсутствия) от Lua-скриптов:'''
* Поддерживайте свой сервер в актуальном состоянии, вы можете [https://nightly.multitheftauto.com/ загружать последние сборки сервера с сайта MTA:SA nightly.] Информацию о конкретных сборках можно [https://buildinfo.multitheftauto.com/ найти здесь.]
* Поддерживайте свои ресурсы в актуальном состоянии, вы можете \ [https://github.com/multitheftauto/mtasa-resources загружать последние (по умолчанию) ресурсы из репозитория GitHub.] Они часто содержат последние исправления для системы безопасности, что может привести к тому, что ваш сервер будет защищен от атак или нет.
* Убедитесь в правильной настройке [https://wiki.multitheftauto.com/wiki/Access%20Control%20List ACL (Список контроля доступа)], который будет блокировать использование ресурсами определенных потенциально опасных функций.
* Нулевое доверие с предоставлением прав администратора для ресурсов (включая карты), поступающих из неизвестных источников.
* Перед запуском любого ресурса, которому вы не доверяете, проанализируйте его:
** [https://wiki.multitheftauto.com/wiki/Meta.xml meta.xml] на предмет возможных скрытых скриптов, скрывающихся под другими расширениями файлов.
** Это исходный код, на предмет вредоносной логики.
* Не запускайте и не продолжайте использовать скомпилированные ресурсы (скрипты), в легитимности которых вы не уверены.

'''Чтобы обеспечить минимальный ущерб при подключении мошенника к вашему серверу:'''
* При создании скриптов помните, что никогда не следует доверять данным, поступающим от клиента.
* При проверке скриптов на предмет возможных дыр в системе безопасности. Обратите внимание на любые данные, поступающие от клиента, которым вы доверяете.
* Могут быть отправлены любые данные, следовательно, серверные скрипты, которые взаимодействуют с клиентом, получая данные, отправленные игроками, должны проверить их перед дальнейшим использованием в последующих частях кода. В основном, это будет сделано либо с помощью [[setElementData]], либо с помощью [[triggerServerEvent]].
* Вам не следует полагаться только на игрока [https://wiki.multitheftauto.com/wiki/Serial серийный номер ], когда речь заходит о выполнении важных операций (авторегистрация/действия администратора). '''Не гарантируется, что серийные номера будут уникальными или не поддающимися подделке'''. Вот почему вам следует "оставить это позади" системы учетных записей, как '''важный фактор аутентификации''' (например, '''логин и пароль''').
* Логика на стороне сервера '''не может быть обойдена''' или '''изменена''' (если только сервер не взломан или если в коде есть ошибка, но это совсем другой сценарий) - "используйте это в своих интересах". В большинстве случаев вы сможете выполнить проверку безопасности без участия клиента.
* Используя концепцию ""'“, все параметры, включая источник, могут быть подделаны, и им не следует доверять. Глобальной переменной client можно доверять.”""" - дает вам надежную гарантию того, что игрок, на которого вы ссылаетесь (через ""client"") ""на самом деле""тот, кто действительно вызвал событие"". Такой подход защитит вас от ситуаций, когда мошенник может вызывать и обрабатывать, например, события администратора (например, кикнуть/забанить игрока), передавая фактический администратор ("'2-й"' аргумент в "'[[triggerServerEvent]]"'), или запускать события для других целей. игроки (как будто это они их вызвали, но на самом деле это было принудительно сделано читером) - как следствие использования неправильной переменной. Чтобы убедиться, что вы полностью поняли это, взгляните на примеры ниже:

<syntaxhighlight lang="lua">
--[[
НИКОГДА НЕ ДЕЛАЙТЕ ЭТОГО - ЭТО СОВЕРШЕННО НЕПРАВИЛЬНО И НЕБЕЗОПАСНО
ПРОБЛЕМА: ИСПОЛЬЗУЯ "source" В hasObjectPermissionTo, ВЫ ОСТАВЛЯЕТЕ ДВЕРЬ ОТКРЫТОЙ ДЛЯ МОШЕННИКОВ
]]

function onServerWrongAdminEvent(playerToBan)
if (not client) then -- "client" указывает на игрока, который инициировал событие, и должен использоваться в качестве меры безопасности (чтобы предотвратить подделку игрока).
return false -- если эта переменная в данный момент не существует (по неизвестной причине, или это сервер инициировал это событие), остановите выполнение кода
end

local defaultPermission = false -- не разрешайте действие по умолчанию, смотрите (defaultPermission): https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo
local canAdminBanPlayer = hasObjectPermissionTo(source, "function.banPlayer", defaultPermission) -- уязвимость кроется именно здесь...

if (not canAdminBanPlayer) then -- если у игрока нет прав доступа
return false -- не делайте этого
end

local validElement = isElement(playerToBan) -- проверяет, является ли аргумент, переданный от клиента, элементом

if (not validElement) then -- it is not
return false -- остановить обработку кода
end

local elementType = getElementType(playerToBan) -- это элемент, поэтому укажите его тип
local playerType = (elementType == "player") -- убедитесь, что это игрок

if (not playerType) then -- it's not a player
return false - остановись здесь
end

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

--[[
onServerCorrectAdminEvent ПОЛНОСТЬЮ ЗАЩИЩЕН, КАК И ДОЛЖНО БЫТЬ
ЗДЕСЬ НЕТ ПРОБЛЕМ: МЫ ИСПОЛЬЗОВАЛИ "клиент" В hasObjectPermissionTo, ЧТО ПОЗВОЛЯЕТ ЗАЩИТИТЬ ЕГО ОТ ПОДДЕЛКИ ИГРОКОМ, ВЫЗВАВШИМ СОБЫТИЕ
]]

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>

==Защита данных setElementData==

* Вам следует воздержаться от использования [[element data]] везде, его следует использовать только тогда, когда это действительно необходимо. Рекомендуется заменить его на [[triggerClientEvent]].
* Если вы все еще настаиваете на его использовании, рекомендуется установить для '''4-го''' аргумента в [[setElementData]] значение '''false''' (отключив синхронизацию для этих определенных данных) и использовать режим подписчика - [[addElementDataSubscriber]], как по соображениям безопасности, так и по соображениям производительности, описанным в [https://wiki.multitheftauto.com/wiki/Script_security#Securing_triggerServerEvent разделе "события".]
{{Важное примечание|Отключение синхронизации, однако, не обеспечивает полной защиты ключа данных. По умолчанию он по-прежнему уязвим, но в этом случае вы не оставляете его на виду. Использование [[getAllElementData]] или копание в оперативной памяти не выявит его, поскольку оно не будет синхронизировано с клиентом в первую очередь. Следовательно, его также необходимо добавить в античит.}}
* Все параметры, включая '''source''', могут быть подделаны, и им не следует доверять.
* Глобальной переменной '''client''' можно доверять.

<section name="Server" class="server" show="true">
Пример защиты данных базового элемента от обмана.
<syntaxhighlight lang="lua">
local function reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue) -- вспомогательная функция для логирования и отката изменений
local logClient = inspect(clientElement) -- подробный вид игрока, который инициировал синхронизацию данных элемента
local logSerial = getPlayerSerial(clientElement) or "N/A" -- серийник клиента, или "N/A", если по какой-то причине это невозможно
local logSource = tostring(sourceElement) -- элемент, который получил данные
local logOldValue = tostring(oldValue) -- старое значение
local logNewValue = tostring(newValue) -- новое значение
local logText = -- заполняем наш отчет данными
"=======================================\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 -- указываем, кто увидит этот лог в консоли, в данном случае каждый игрок, подключенный к серверу
local hadData = (oldValue ~= nil) -- проверяем, был ли у элемента такой данные раньше

if (hadData) then -- если у элемента ранее были такие данные
setElementData(sourceElement, dataKey, oldValue, true) -- откатываем изменения, это вызовет событие onElementDataChange, но не пройдет (остановится) на первом условии - потому что сервер (не клиент) принудительно изменил данные
else
removeElementData(sourceElement, dataKey) -- полностью удаляем его
end

outputConsole(logText, logVisibleTo) -- выводим это в консоль

return true -- все успешно
end

function onElementDataChangeBasicAC(dataKey, oldValue, newValue) -- сердце нашего античита, которое выполняет все магические меры безопасности
if (not client) then -- проверяем, идут ли данные от клиента
return false -- если нет, не идем дальше
end

local checkSpecialThing = (dataKey == "special_thing") -- сравниваем, совпадает ли dataKey с "special_thing"
local checkFlagWaving = (dataKey == "flag_waving") -- сравниваем, совпадает ли dataKey с "flag_waving"

if (checkSpecialThing) then -- если совпадает, проводим проверки безопасности
local invalidElement = (client ~= source) -- проверяем, отличается ли исходный элемент от игрока, изменившего данные

if (invalidElement) then -- если так и есть
reportAndRevertDataChange(client, source, dataKey, oldValue, newValue) -- откатываем изменение данных, потому что "special_thing" может быть установлен только для самого игрока
end
end

if (checkFlagWaving) then -- если совпадает, проводим проверки безопасности
local playerVehicle = getPedOccupiedVehicle(client) -- получаем текущий транспорт игрока
local invalidVehicle = (playerVehicle ~= source) -- проверяем, отличается ли исходный элемент от транспорта игрока

if (invalidVehicle) then -- если так и есть
reportAndRevertDataChange(client, source, dataKey, oldValue, newValue) -- откатываем изменение данных, потому что "flag_waving" может быть установлен только для собственного транспорта игрока
end
end
end
addEventHandler("onElementDataChange", root, onElementDataChangeBasicAC)
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
Пример расширенной защиты данных element от обмана.
<syntaxhighlight lang="lua">
--[[
Для максимальной безопасности установите punishPlayerOnDetect, punishmentBan, allowOnlyProtectedKeys в true (как настроено по умолчанию)
Если включен allowOnlyProtectedKeys, не забудьте добавить каждый ключ элемент данных на стороне клиента в таблицу protectedKeys - иначе возникнут ложные срабатывания

Структура таблицы античита (handleDataChange) и её параметры:

["keyName"] = { -- имя ключа, который будет защищен
onlyForPlayerHimself = true, -- включение этого (true) гарантирует, что этот ключ данных элемента может быть установлен только игроком, который его синхронизировал (игнорирует onlyForOwnPlayerVeh и allowForElements), используйте false/nil для отключения
onlyForOwnPlayerVeh = false, -- включение этого (true) гарантирует, что этот ключ данных элемента может быть установлен только на текущем транспорте игрока, который его синхронизировал (игнорирует allowForElements), используйте false/nil для отключения
allowForElements = { -- ограничить этот ключ для определенных типов элементов, установите false/nil или оставьте пустым, чтобы не проверять это (полный список типов элементов: https://wiki.multitheftauto.com/wiki/GetElementsByType)
["player"] = true,
["ped"] = true,
["vehicle"] = true,
["object"] = true,
},
allowedDataTypes = { -- ограничить этот ключ для определенных типов значений, установите false/nil или оставьте пустым, чтобы не проверять это
["string"] = true,
["number"] = true,
["table"] = true,
["boolean"] = true,
["nil"] = true,
},
allowedStringLength = {1, 32}, -- если значение является строкой, то её длина должна быть в пределах (мин-макс), установите false/nil, чтобы не проверять длину строки - учтите, что allowedDataTypes должен содержать ["string"] = true
allowedTableLength = {1, 64}, -- если значение является таблицей, то её длина должна быть в пределах (мин-макс), установите false/nil, чтобы не проверять длину таблицы - учтите, что allowedDataTypes должен содержать ["table"] = true
allowedNumberRange = {1, 128}, -- если значение является числом, то оно должно быть в пределах (мин-макс), установите false/nil, чтобы не проверять диапазон чисел - учтите, что allowedDataTypes должен содержать ["number"] = true
}
]]

local punishPlayerOnDetect = true -- должен ли игрок быть наказан при обнаружении (убедитесь, что ресурс, запускающий этот код, имеет права администратора)
local punishmentBan = true -- актуально только если punishPlayerOnDetect установлен в true; используйте true для бана или false для кика
local punishmentReason = "Altering element data" -- актуально только если punishPlayerOnDetect установлен в true; причина, которая будет показана наказанному игроку
local punishedBy = "Console" -- актуально только если punishPlayerOnDetect установлен в true; кто ответственен за наказание, также показывается наказанному игроку
local banByIP = false -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; бан по IP в настоящее время не рекомендуется (...)
local banByUsername = false -- имя пользователя сообщества - устаревшая вещь, поэтому установлено в false и должно оставаться таким
local banBySerial = true -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; (...) если есть серийный номер игрока, который можно использовать вместо этого
local banTime = 0 -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; время в секундах, 0 навсегда
local allowOnlyProtectedKeys = true -- запрещать (удалять с помощью removeElementData) любые данные элементов, кроме тех, что указаны в таблице protectedKeys; на случай, если кто-то захочет завалить сервер мусорными ключами, которые будут храниться в памяти до перезапуска сервера или ручного удаления - setElementData(source, key, nil) не удалит их; необходимо использовать removeElementData
local debugLevel = 4 -- этот уровень отладки позволяет скрыть префикс INFO: и использовать пользовательские цвета
local debugR = 255 -- сообщение отладки - красный цвет
local debugG = 127 -- сообщение отладки - зеленый цвет
local debugB = 0 -- сообщение отладки - синий цвет
local protectedKeys = {
["vehicleNumber"] = { -- мы хотим, чтобы vehicleNumber устанавливался только на транспорте, с четкими числами в диапазоне 1-100
allowForElements = {
["vehicle"] = true,
},
allowedDataTypes = {
["number"] = true,
},
allowedNumberRange = {1, 100},
},
["personalVehData"] = { -- мы хотим иметь возможность устанавливать personalVehData только на текущем транспорте, также это должна быть строка длиной от 1 до 24
onlyForOwnPlayerVeh = true,
allowedDataTypes = {
["string"] = true,
},
allowedStringLength = {1, 24},
},
-- выполнять проверки безопасности для ключей, хранящихся в этой таблице, удобным способом
}

local function reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- вспомогательная функция для логирования и отката изменений
local logClient = inspect(clientElement) -- подробный вид игрока, который инициировал синхронизацию данных элемента
local logSerial = getPlayerSerial(clientElement) or "N/A" -- серийник клиента, или "N/A", если по какой-то причине это невозможно
local logSource = inspect(sourceElement) -- подробный вид элемента, который получил данные
local logOldValue = inspect(oldValue) -- подробный вид старого значения
local logNewValue = inspect(newValue) -- подробный вид нового значения
local logText = -- заполняем наш отчет данными
"*\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) -- выводим это в отладку

if (forceRemove) then -- мы вообще не хотим, чтобы этот ключ данных элемента существовал
removeElementData(sourceElement, dataKey) -- удаляем его

return true -- возвращаем успех и останавливаемся здесь, дальнейшие проверки не нужны
end

setElementData(sourceElement, dataKey, oldValue, true) -- откатываем изменения, это вызовет событие onElementDataChange, но не пройдет (остановится) на первом условии - потому что сервер (не клиент) принудительно изменил данные

return true -- возвращаем успех
end

local function handleDataChange(clientElement, sourceElement, dataKey, oldValue, newValue) -- сердце нашего античита, которое выполняет все магические меры безопасности, возвращает true, если не было изменений от клиента (на основе данных из protectedKeys), иначе false
local protectedKey = protectedKeys[dataKey] -- проверяем, хранится ли измененный ключ в таблице protectedKeys

if (not protectedKey) then -- если его нет

if (allowOnlyProtectedKeys) then -- если мы не хотим мусорные ключи
local failReason = "Key isn't present in protectedKeys" -- причина, показанная в отчете
local forceRemove = true -- должен ли ключ быть полностью удален

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end

return true -- этот ключ не защищен, пропускаем его
end

local onlyForPlayerHimself = protectedKey.onlyForPlayerHimself -- если у ключа есть блокировка "только для себя"
local onlyForOwnPlayerVeh = protectedKey.onlyForOwnPlayerVeh -- если у ключа есть блокировка "свой транспорт"
local allowForElements = protectedKey.allowForElements -- если у ключа есть проверка типа элемента
local allowedDataTypes = protectedKey.allowedDataTypes -- если у ключа есть проверка разрешенного типа данных

if (onlyForPlayerHimself) then -- если блокировка "только для себя" активна
local matchingElement = (clientElement == sourceElement) -- проверяем, равен ли игрок, установивший данные, элементу, который получил данные

if (not matchingElement) then -- если не совпадает
local failReason = "Can only set on player himself" -- причина, показанная в отчете
local forceRemove = false -- должен ли ключ быть полностью удален

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end

if (onlyForOwnPlayerVeh) then -- если блокировка "свой транспорт" активна
local playerVehicle = getPedOccupiedVehicle(clientElement) -- получить текущий транспорт игрока, который установил данные
local matchingVehicle = (playerVehicle == sourceElement) -- проверяем, совпадает ли он с тем, который получил данные

if (not matchingVehicle) then -- если не совпадает
local failReason = "Can only set on player's own vehicle" -- причина, показанная в отчете
local forceRemove = false -- должен ли ключ быть полностью удален

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end

if (allowForElements) then -- проверяем, является ли оно одним из них
local elementType = getElementType(sourceElement) -- получить тип элемента, данные которого изменились
local matchingElementType = allowForElements[elementType] -- проверяем, разрешено ли это

if (not matchingElementType) then -- это не совпадает
local failReason = "Invalid element type" -- причина, показанная в отчете
local forceRemove = false -- должен ли ключ быть полностью удален

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end

if (allowedDataTypes) then -- если есть разрешенные типы данных
local valueType = type(newValue) -- получить тип данных значения
local matchingType = allowedDataTypes[valueType] -- проверяем, является ли оно одним из разрешенных

if (not matchingType) then -- если нет, тогда
local failReason = "Invalid data type" -- причина, показанная в отчете
local forceRemove = false -- должен ли ключ быть полностью удален

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end

local allowedStringLength = protectedKey.allowedStringLength -- если у ключа есть указанная проверка длины строки
local dataString = (valueType == "string") -- убеждаемся, что это строка

if (allowedStringLength and dataString) then -- если мы должны проверить длину строки
local minLength = allowedStringLength[1] -- получить минимальную длину
local maxLength = allowedStringLength[2] -- получить максимальную длину
local stringLength = utf8.len(newValue) -- получить длину строки данных
local matchingLength = (stringLength >= minLength) and (stringLength <= maxLength) -- сравниваем, подходит ли значение в промежуток

if (not matchingLength) then -- если не подходит
local failReason = "Invalid string length (must be between "..minLength.."-"..maxLength..")" -- причина, показанная в отчете
local forceRemove = false -- должен ли ключ быть полностью удален

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end

local allowedTableLength = protectedKey.allowedTableLength -- если у ключа есть проверка длины таблицы
local dataTable = (valueType == "table") -- убеждаемся, что это таблица

if (allowedTableLength and dataTable) then -- если мы должны проверить длину таблицы
local minLength = allowedTableLength[1] -- получить минимальную длину
local maxLength = allowedTableLength[2] -- получить максимальную длину
local minLengthAchieved = false -- переменная, которая проверяет 'была ли достигнута минимальная длина'
local maxLengthExceeded = false -- переменная, которая проверяет 'превысила ли длина разрешенный максимум'
local tableLength = 0 -- сохранить начальную длину таблицы

for _, _ in pairs(newValue) do -- проходим по всей таблице
tableLength = (tableLength + 1) -- добавляем + 1 для каждой записи таблицы
minLengthAchieved = (tableLength >= minLength) -- больше ли длина или по крайней мере такой минимум, который мы требуем
maxLengthExceeded = (tableLength > maxLength) -- превысила ли таблица максимальную длину?

if (maxLengthExceeded) then -- она больше, чем должна быть
break -- прерываем цикл (из-за того, что условие выше выполнено, нет смысла считать дальше и тратить процессор на таблицу, которая потенциально может иметь огромное количество записей)
end
end

local matchingLength = (minLengthAchieved and not maxLengthExceeded) -- проверяем, достигнута ли минимальная длина, и убеждаемся, что она не превышает максимальную

if (not matchingLength) then -- эта таблица не соответствует требованиям
local failReason = "Invalid table length (must be between "..minLength.."-"..maxLength..")" -- причина, показанная в отчете
local forceRemove = false -- должен ли ключ быть полностью удален

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end

local allowedNumberRange = protectedKey.allowedNumberRange -- если у ключа есть проверка разрешенного диапазона чисел
local dataNumber = (valueType == "number") -- убеждаемся, что это число

if (allowedNumberRange and dataNumber) then -- если мы должны проверить диапазон чисел
local minRange = allowedNumberRange[1] -- получить минимальный диапазон чисел
local maxRange = allowedNumberRange[2] -- получить максимальный диапазон чисел
local matchingRange = (newValue >= minRange) and (newValue <= maxRange) -- сравниваем, подходит ли значение в промежуток

if (not matchingRange) then -- если не подходит
local failReason = "Invalid number range (must be between "..minRange.."-"..maxRange..")" -- причина, показанная в отчете
local forceRemove = false -- должен ли ключ быть полностью удален

reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end
end

return true -- проверки безопасности пройдены, с этим ключом данных всё в порядке
end

function onElementDataChangeAdvancedAC(dataKey, oldValue, newValue) -- это событие использует handleDataChange, код был разделен для лучшей читаемости
if (not client) then -- проверяем, идут ли данные от клиента
return false -- если нет, не продолжаем
end

local approvedChange = handleDataChange(client, source, dataKey, oldValue, newValue) -- запускаем наши проверки безопасности

if (approvedChange) then -- всё круто и хорошо
return false -- нам не нужны дальнейшие действия
end

if (not punishPlayerOnDetect) then -- мы не хотим наказывать игрока по какой-то причине
return false -- так что останавливаемся здесь
end

if (punishmentBan) then -- если это бан
banPlayer(client, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- удаляем его присутствие с сервера
else -- иначе
kickPlayer(client, punishedBy, punishmentReason) -- просто кикаем игрока с сервера
end
end
addEventHandler("onElementDataChange", root, onElementDataChangeAdvancedAC)
</syntaxhighlight>
</section>

==Защита triggerServerEvent==
* Все параметры, включая "source", могут быть подделаны, и им не следует доверять.
* Глобальной переменной "client" можно доверять.
* "События" в стиле "Admin" должны подтверждать "права доступа" игрока (клиента) либо с помощью [https://wiki.multitheftauto.com/wiki/IsObjectInACLGroup isObjectInACLGroup], либо [https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo hasObjectPermissionTo].
* Не используйте для своего пользовательского события то же имя, что и для событий собственного сервера MTA (которые по умолчанию не запускаются удаленно), например: "onPlayerLogin"; это откроет дверь для манипуляций мошенников.
* Будьте в курсе, каким игрокам отправляется событие через [[triggerClientEvent]]. Как по соображениям безопасности, так и по соображениям производительности, события, подобные admin, должны приниматься только администраторами (чтобы предотвратить доступ к конфиденциальным данным), в то же время вы не должны отправлять каждое событие всем пользователям сервера (например, событие успешного входа в систему, которое скрывает панель входа для определенного игрока). [[triggerClientEvent]] позволяет вам указать получатель события в качестве первого (необязательного) аргумента. По умолчанию используется значение [[root]], что означает, что если вы его не укажете, оно будет отправлено всем, кто подключен к серверу, даже тем, кто все еще загружает серверный кэш (что приводит к "событию, инициированному сервером на стороне клиента, eventName, но событие не добавлено на стороне клиента"). Вы можете передать либо элемент игрока, либо таблицу с получателями:

<syntaxhighlight lang="lua">
local playersToReceiveEvent = {player1, player2, player3} -- каждый PlayerX является элементом игрока

triggerClientEvent(playersToReceiveEvent, ...) -- не забудьте заполнить последнюю часть аргументов
</syntaxhighlight>

----------
<section name="Server" class="server" show="true">
Пример функции защиты от мошенничества, разработанной для событий, используемых для проверки данных как для обычных, так и для административных событий, которые вызываются со стороны клиента.
<syntaxhighlight lang="lua">
--[[
Для максимальной безопасности установите punishPlayerOnDetect, punishmentBan в true (как настроено по умолчанию)

Структура таблицы античита (processServerEventData) и её параметры:

checkACLGroup = { -- проверить, принадлежит ли игрок, вызвавший событие, хотя бы к одной из групп ниже, установите false/nil, чтобы не проверять это
"Admin",
},
checkPermissions = { -- проверить, есть ли у игрока, вызвавшего событие, разрешение хотя бы на одно из нижеперечисленного, установите false/nil, чтобы не проверять это
"function.kickPlayer",
},
checkEventData = {
{
debugData = "source", -- дополнительные данные для отчета, показанные в сообщении отладки
eventData = source, -- данные, которые мы хотим проверить
equalTo = client, -- сравнить, совпадают ли eventData и equalTo
allowedElements = { -- ограничить eventData определенными типами элементов, установите false/nil или оставьте пустым, чтобы не проверять это (полный список типов элементов: https://wiki.multitheftauto.com/wiki/GetElementsByType)
["player"] = true,
["ped"] = true,
["vehicle"] = true,
["object"] = true,
},
allowedDataTypes = { -- ограничить eventData определенными типами значений, установите false/nil или оставьте пустым, чтобы не проверять это
["string"] = true,
["number"] = true,
["table"] = true,
["boolean"] = true,
["nil"] = true,
},
allowedStringLength = {1, 32}, -- если eventData является строкой, то её длина должна быть в пределах (мин-макс), установите false/nil, чтобы не проверять длину строки - учтите, что allowedDataTypes должен содержать ["string"] = true
allowedTableLength = {1, 64}, -- если eventData является таблицей, то её длина должна быть в пределах (мин-макс), установите false/nil, чтобы не проверять длину таблицы - учтите, что allowedDataTypes должен содержать ["table"] = true
allowedNumberRange = {1, 128}, -- если eventData является числом, то оно должно быть в пределах (мин-макс), установите false/nil, чтобы не проверять диапазон чисел - учтите, что allowedDataTypes должен содержать ["number"] = true
},
},
]]

local punishPlayerOnDetect = true -- должен ли игрок быть наказан при обнаружении (убедитесь, что ресурс, запускающий этот код, имеет права администратора)
local punishmentBan = true -- актуально только если punishPlayerOnDetect установлен в true; используйте true для бана или false для кика
local punishmentReason = "Altering server event data" -- актуально только если punishPlayerOnDetect установлен в true; причина, которая будет показана наказанному игроку
local punishedBy = "Console" -- актуально только если punishPlayerOnDetect установлен в true; кто ответственен за наказание, также показывается наказанному игроку
local banByIP = false -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; бан по IP в настоящее время не рекомендуется (...)
local banByUsername = false -- имя пользователя сообщества - устаревшая вещь, поэтому установлено в false и должно оставаться таким
local banBySerial = true -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; (...) если есть серийный номер игрока, который можно использовать вместо этого
local banTime = 0 -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; время в секундах, 0 навсегда
local debugLevel = 4 -- этот уровень отладки позволяет скрыть префикс INFO: и использовать пользовательские цвета
local debugR = 255 -- сообщение отладки - красный цвет
local debugG = 127 -- сообщение отладки - зеленый цвет
local debugB = 0 -- сообщение отладки - синий цвет

function processServerEventData(clientElement, sourceElement, serverEvent, securityChecks) -- сердце нашего античита, которое выполняет все магические меры безопасности, возвращает true, если не было изменений от клиента (на основе данных из securityChecks), иначе false
if (not securityChecks) then -- если мы не передали никаких проверок безопасности
return true -- нечего проверять, даем коду идти дальше
end

if (not clientElement) then -- если переменная client недоступна по какой-то причине (хотя это не должно произойти)
local failReason = "Client variable not present" -- причина, показанная в отчете
local skipPunishment = true -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end

local checkACLGroup = securityChecks.checkACLGroup -- если есть какие-либо группы ACL для проверки
local checkPermissions = securityChecks.checkPermissions -- если есть какие-либо разрешения для проверки
local checkEventData = securityChecks.checkEventData -- если есть какие-либо проверки данных

if (checkACLGroup) then -- проверим группы ACL игрока
local playerAccount = getPlayerAccount(clientElement) -- получить текущий аккаунт игрока
local guestAccount = isGuestAccount(playerAccount) -- если аккаунт гость (это значит, что игрок не вошел в систему)

if (guestAccount) then -- это так
local failReason = "Can't retrieve player login - guest account" -- причина, показанная в отчете
local skipPunishment = true -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end

local accountName = getAccountName(playerAccount) -- получить имя текущего аккаунта игрока
local aclString = "user."..accountName -- форматируем это для дальнейшего использования в функции isObjectInACLGroup

for groupID = 1, #checkACLGroup do -- перебираем таблицу заданных групп
local groupName = checkACLGroup[groupID] -- получить имя каждой группы
local aclGroup = aclGetGroup(groupName) -- проверить, существует ли такая группа

if (not aclGroup) then -- не существует
local failReason = "ACL group '"..groupName.."' is missing" -- причина, показанная в отчете
local skipPunishment = true -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end

local playerInACLGroup = isObjectInACLGroup(aclString, aclGroup) -- проверить, принадлежит ли игрок к группе

if (playerInACLGroup) then -- да, это так
return true -- значит, успех
end
end

local failReason = "Player doesn't belong to any given ACL group" -- причина, показанная в отчете
local skipPunishment = true -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end

if (checkPermissions) then -- проверить, есть ли у игрока хотя бы одно желаемое разрешение
local allowedByDefault = false -- есть ли у него доступ по умолчанию

for permissionID = 1, #checkPermissions do -- перебираем все разрешения
local permissionName = checkPermissions[permissionID] -- получить имя разрешения
local hasPermission = hasObjectPermissionTo(clientElement, permissionName, allowedByDefault) -- проверить, разрешено ли игроку выполнять определенное действие

if (hasPermission) then -- если у игрока есть доступ
return true -- одно доступно (и достаточно), сервер не станет проверять остальные (так как return также прерывает цикл)
end
end

local failReason = "Not enough permissions" -- причина, показанная в отчете
local skipPunishment = true -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end

if (checkEventData) then -- если есть какие-то данные для проверки

for dataID = 1, #checkEventData do -- перебираем каждые данные
local dataToCheck = checkEventData[dataID] -- получить каждый набор данных
local eventData = dataToCheck.eventData -- это то, что мы будем проверять
local equalTo = dataToCheck.equalTo -- мы хотим сравнить, совпадают ли eventData и equalTo
local allowedElements = dataToCheck.allowedElements -- проверить, является ли это элементом и принадлежит ли к определенным типам элементов
local allowedDataTypes = dataToCheck.allowedDataTypes -- ограничиваем ли мы данные определенным типом?
local debugData = dataToCheck.debugData -- дополнительные вспомогательные данные
local debugText = debugData and " ("..debugData..")" or "" -- если оно присутствует, красиво форматируем

if (equalTo) then -- проверка на равенство существует
local matchingData = (eventData == equalTo) -- сравнить, равны ли эти два значения

if (not matchingData) then -- они не равны
local failReason = "Data isn't equal @ argument "..dataID..debugText -- причина, показанная в отчете
local skipPunishment = false -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end

if (allowedElements) then -- мы проверяем, является ли это элементом и принадлежит ли хотя бы одному из списка
local validElement = isElement(eventData) -- проверить, является ли это фактическим элементом

if (not validElement) then -- это не так
local failReason = "Data isn't element @ argument "..dataID..debugText -- причина, показанная в отчете
local skipPunishment = false -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end

local elementType = getElementType(eventData) -- это элемент, поэтому мы хотим узнать его тип
local matchingElementType = allowedElements[elementType] -- проверить, разрешено ли это

if (not matchingElementType) then -- не разрешено
local failReason = "Invalid element type @ argument "..dataID..debugText -- причина, показанная в отчете
local skipPunishment = false -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end

if (allowedDataTypes) then -- проверим разрешенные типы данных
local dataType = type(eventData) -- получить тип данных
local matchingType = allowedDataTypes[dataType] -- проверить, разрешено ли это

if (not matchingType) then -- не разрешено
local failReason = "Invalid data type @ argument "..dataID..debugText -- причина, показанная в отчете
local skipPunishment = false -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end

local allowedStringLength = dataToCheck.allowedStringLength -- если данные имеют проверку длины строки
local dataString = (dataType == "string") -- убеждаемся, что это строка

if (allowedStringLength and dataString) then -- если мы должны проверить длину строки
local minLength = allowedStringLength[1] -- получить минимальную длину
local maxLength = allowedStringLength[2] -- получить максимальную длину
local stringLength = utf8.len(eventData) -- получить длину строки данных
local matchingLength = (stringLength >= minLength) and (stringLength <= maxLength) -- сравниваем, подходит ли значение в промежуток

if (not matchingLength) then -- если не подходит
local failReason = "Invalid string length (must be between "..minLength.."-"..maxLength..") @ argument "..dataID..debugText -- причина, показанная в отчете
local skipPunishment = false -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end

local allowedTableLength = dataToCheck.allowedTableLength -- если данные имеют проверку длины таблицы
local dataTable = (dataType == "table") -- убеждаемся, что это таблица

if (allowedTableLength and dataTable) then -- если мы должны проверить длину таблицы
local minLength = allowedTableLength[1] -- получить минимальную длину
local maxLength = allowedTableLength[2] -- получить максимальную длину
local minLengthAchieved = false -- переменная, которая проверяет 'была ли достигнута минимальная длина'
local maxLengthExceeded = false -- переменная, которая проверяет 'превысила ли длина разрешенный максимум'
local tableLength = 0 -- сохранить начальную длину таблицы

for _, _ in pairs(eventData) do -- проходим по всей таблице
tableLength = (tableLength + 1) -- добавляем + 1 для каждой записи таблицы
minLengthAchieved = (tableLength >= minLength) -- больше ли длина или по крайней мере такой минимум, который мы требуем
maxLengthExceeded = (tableLength > maxLength) -- превысила ли таблица максимальную длину?

if (maxLengthExceeded) then -- она больше, чем должна быть
break -- прерываем цикл (из-за того, что условие выше выполнено, нет смысла считать дальше и тратить процессор на таблицу, которая потенциально может иметь огромное количество записей)
end
end

local matchingLength = (minLengthAchieved and not maxLengthExceeded) -- проверяем, достигнута ли минимальная длина, и убеждаемся, что она не превышает максимальную

if (not matchingLength) then -- эта таблица не соответствует требованиям
local failReason = "Invalid table length (must be between "..minLength.."-"..maxLength..") @ argument "..dataID..debugText -- причина, показанная в отчете
local skipPunishment = false -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end

local allowedNumberRange = dataToCheck.allowedNumberRange -- если данные имеют проверку диапазона чисел
local dataNumber = (dataType == "number") -- убеждаемся, что это число

if (allowedNumberRange and dataNumber) then -- если мы должны проверить диапазон чисел
local minRange = allowedNumberRange[1] -- получить минимальный диапазон чисел
local maxRange = allowedNumberRange[2] -- получить максимальный диапазон чисел
local matchingRange = (eventData >= minRange) and (eventData <= maxRange) -- сравниваем, подходит ли значение в промежуток

if (not matchingRange) then -- если не подходит
local failReason = "Invalid number range (must be between "..minRange.."-"..maxRange..") @ argument "..dataID..debugText -- причина, показанная в отчете
local skipPunishment = false -- должен ли сервер пропустить наказание

reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока

return false -- вернуть неудачу
end
end
end
end
end

return true -- проверки безопасности пройдены, с этим вызовом события всё в порядке
end

function reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- вспомогательная функция для логирования и обработки инцидентов
local logClient = inspect(clientElement) -- подробный вид игрока, вызвавшего событие
local logSerial = getPlayerSerial(clientElement) or "N/A" -- серийник клиента, или "N/A", если по какой-то причине это невозможно
local logSource = inspect(sourceElement) -- подробный вид исходного элемента
local logText = -- заполняем наш отчет данными
"*\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) -- выводим это в отладку

if (not punishPlayerOnDetect or skipPunishment) then -- мы не хотим наказывать игрока по какой-то причине
return true -- останавливаемся здесь
end

if (punishmentBan) then -- если это бан
banPlayer(clientElement, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- удаляем его присутствие с сервера
else -- иначе
kickPlayer(clientElement, punishedBy, punishmentReason) -- просто кикаем игрока с сервера
end

return true -- всё готово, сообщаем об успехе
end

function onServerEvent(clientData)
--[[
Предположим, что это серверское событие (функция) вызывается следующим образом:

local dataToPass = 10

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

local shouldProcessServerCode = processServerEventData(
client, -- элемент клиента - ответственный за вызов события
source, -- исходный элемент - переданный в triggerServerEvent (в качестве 2-го аргумента)
eventName, -- имя события - в данном случае 'onServerEvent'
{
checkEventData = { -- мы хотим проверить всё, что приходит от клиента
{
eventData = source, -- первое на проверку, переменная source
equalTo = client, -- мы хотим проверить, совпадает ли это с игроком, вызвавшим событие
debugData = "source", -- вспомогательные данные, которые будут показаны в отчете отладки
},
{
eventData = clientData, -- давайте проверим данные, которые клиент прислал нам
allowedDataTypes = {
["number"] = true, -- мы хотим, чтобы это было только число
},
allowedNumberRange = {1, 100}, -- в диапазоне от 1 до 100
debugData = "clientData", -- если что-то пойдет не так, дадим серверу знать где (это появится в отчете отладки)
},
},
}
)

if (not shouldProcessServerCode) then -- что-то не так, зеленого света для выполнения кода за этим пределом нет
return false -- остановить выполнение кода
end

-- выполняем код как обычно
end
addEvent("onServerEvent", true)
addEventHandler("onServerEvent", root, onServerEvent)

function onServerAdminEvent(playerToBan)
--[[
Предположим, что это серверское событие администратора (функция) вызывается следующим образом:

local playerToBan = getPlayerFromName("playerToBan")

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

local shouldProcessServerCode = processServerEventData(
client, -- элемент клиента - ответственный за вызов события
source, -- исходный элемент - переданный в triggerServerEvent (в качестве 2-го аргумента)
eventName, -- имя события - в данном случае 'onServerAdminEvent'
{
checkACLGroup = { -- нам нужно проверить, принадлежит ли игрок, вызвавший событие, к группам ACL
"Admin", -- в данном случае группа администраторов
},
checkEventData = { -- мы хотим проверить всё, что приходит от клиента
{
eventData = source, -- первое на проверку, переменная source
equalTo = client, -- мы хотим проверить, совпадает ли это с игроком, вызвавшим событие
debugData = "source", -- вспомогательные данные, которые будут показаны в отчете отладки
},
{
eventData = playerToBan, -- давайте проверим данные, которые клиент прислал нам
allowedDataTypes = {
["player"] = true, -- мы хотим, чтобы это был игрок
},
debugData = "playerToBan", -- если что-то пойдет не так, дадим серверу знать где (это появится в отчете отладки)
},
},
}
)

if (not shouldProcessServerCode) then -- что-то не так, зеленого света для выполнения кода за этим пределом нет
return false -- остановить выполнение кода
end

-- выполняем код как обычно
end
addEvent("onServerAdminEvent", true)
addEventHandler("onServerAdminEvent", root, onServerAdminEvent)
</syntaxhighlight>
</section>

==Защита событий, относящихся только к серверу ==
* Очень важно отключить удаленный запуск''' в [https://wiki.multitheftauto.com/wiki/AddEvent addEvent], чтобы предотвратить вызов событий, относящихся только к серверу, со стороны клиента.
* '''События''' в стиле '''Admin''' должны подтверждать '''права доступа''' игрока, либо с помощью [https://wiki.multitheftauto.com/wiki/IsObjectInACLGroup isObjectInACLGroup], либо [https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo hasObjectPermissionTo].

----------
<section name="Server" class="server" show="true">
В этом примере показано, как вы должны создавать события только на стороне сервера.
<syntaxhighlight lang="lua">
function onServerSideOnlyEvent()
-- делаем какие-то вещи на стороне сервера
end
addEvent("onServerSideOnlyEvent", false) -- установите второй аргумент (allowRemoteTriger) в false, чтобы его нельзя было вызвать с клиента
addEventHandler("onServerSideOnlyEvent", root, onServerSideOnlyEvent) -- связываем наше событие с функцией onServerSideOnlyEvent
</syntaxhighlight>
</section>

==Защита снарядов и взрывных устройств ==
Этот раздел (и '''код''' - '''работа продолжается''') - '''используйте на свой страх и риск'''.
----------
<section name="Server" class="server" show="false">
Устройство для отслеживания боеприпасов к снарядам:
<syntaxhighlight lang="lua">
local playerProjectileAmmo = {} -- хранить здесь боезапас оружия игрока
local playerWeaponsToTrack = { -- отслеживать боезапас для определенных типов оружия игрока, в основном тех, которые создают снаряды; [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">
Манипулятор со снарядом:
<syntaxhighlight lang="lua">
local playerCreatedProjectiles = {} -- хранить количество легитимно созданных снарядов игрока; [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 -- сообщать ли о нарушениях в скрипте отладки - по умолчанию
local punishPlayerOnDetect = false -- должен ли игрок быть наказан при обнаружении; true - да, или false, чтобы ничего не делать (убедитесь, что ресурс, запускающий этот код, имеет права администратора)
local punishmentBan = true -- актуально только если punishPlayerOnDetect установлен в true; используйте true для бана или false для кика
local punishmentReason = "Projectile/explosion anti-cheat" -- актуально только если punishPlayerOnDetect установлен в true; причина, которая будет показана наказанному игроку
local punishedBy = "Console" -- актуально только если punishPlayerOnDetect установлен в true; кто ответственен за наказание, также показывается наказанному игроку
local banByIP = false -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; бан по IP в настоящее время не рекомендуется (...)
local banByUsername = false -- имя пользователя сообщества - устаревшая вещь, поэтому установлено в false и должно оставаться таким
local banBySerial = true -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; (...) если есть серийный номер игрока, который можно использовать вместо этого
local banTime = 0 -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; время в секундах, 0 навсегда
local debugMsgLevel = 4 -- этот уровень отладки позволяет скрыть префикс INFO: и использовать пользовательские цвета
local debugMsgR = 255 -- сообщение отладки - красный цвет
local debugMsgG = 127 -- сообщение отладки - зеленый цвет
local debugMsgB = 0 -- сообщение отладки - синий цвет

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 -- мы не хотим наказывать игрока по какой-то причине
return false -- так что останавливаемся здесь
end

if (punishmentBan) then -- если это бан
banPlayer(source, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- удаляем его присутствие с сервера
else -- иначе
kickPlayer(source, punishedBy, punishmentReason) -- просто кикаем игрока с сервера
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">
Обработчик взрывов:
<syntaxhighlight lang="lua">
local rocketInstantExplosionDistanceThreshold = 1.55 -- дистанция, ниже которой будет создан только взрыв (а не снаряд ракеты, следовательно, не вызывается onPlayerProjectileCreation); не меняйте это
local explosionTypes = { -- более конкретная информация о взрыве и разрешен ли он
[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 -- сообщать ли о нарушениях в скрипте отладки - по умолчанию
local punishPlayerOnDetect = false -- должен ли игрок быть наказан при обнаружении; true - да, или false, чтобы ничего не делать (убедитесь, что ресурс, запускающий этот код, имеет права администратора)
local punishmentBan = true -- актуально только если punishPlayerOnDetect установлен в true; используйте true для бана или false для кика
local punishmentReason = "Projectile/explosion anti-cheat" -- актуально только если punishPlayerOnDetect установлен в true; причина, которая будет показана наказанному игроку
local punishedBy = "Console" -- актуально только если punishPlayerOnDetect установлен в true; кто ответственен за наказание, также показывается наказанному игроку
local banByIP = false -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; бан по IP в настоящее время не рекомендуется (...)
local banByUsername = false -- имя пользователя сообщества - устаревшая вещь, поэтому установлено в false и должно оставаться таким
local banBySerial = true -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; (...) если есть серийный номер игрока, который можно использовать вместо этого
local banTime = 0 -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; время в секундах, 0 навсегда
local debugMsgLevel = 4 -- этот уровень отладки позволяет скрыть префикс INFO: и использовать пользовательские цвета
local debugMsgR = 255 -- сообщение отладки - красный цвет
local debugMsgG = 127 -- сообщение отладки - зеленый цвет
local debugMsgB = 0 -- сообщение отладки - синий цвет

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 -- мы не хотим наказывать игрока по какой-то причине
return false -- так что останавливаемся здесь
end

if (punishmentBan) then -- если это бан
banPlayer(source, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- удаляем его присутствие с сервера
else -- иначе
kickPlayer(source, punishedBy, punishmentReason) -- просто кикаем игрока с сервера
end
end
addEventHandler("onExplosion", root, onExplosionAntiCheat)
</syntaxhighlight>
</section>

==Обработка незарегистрированных событий==
Смотрите: [[onPlayerTriggerInvalidEvent]]

==Обработка нежелательных событий==
Смотрите: [[onPlayerTriggerEventThreshold]]

__NOTOC__
__NOEDITSECTION__
[[ru:Script security]]
[[en:Script security]]

RU/Forks

2026-01-02T20:15:14Z

Flox: Created page with "__NOTOC__ {{Note|Information on this page does not apply to the official builds of MTA.}} Multi Theft Auto - Это программное обеспечение с открытым исходным кодом, доступное бесплатно на [https://github.com/multitheftauto/mtasa-blue GitHub multitheftauto/mtasa-blue]. Любой может создать форк проекта, если будет соблюдать условия нашей лиценз..."

__NOTOC__ {{Note|Information on this page does not apply to the official builds of MTA.}}

Multi Theft Auto - Это программное обеспечение с открытым исходным кодом, доступное бесплатно на [https://github.com/multitheftauto/mtasa-blue GitHub multitheftauto/mtasa-blue].
Любой может создать форк проекта, если будет соблюдать условия нашей лицензии — Стандартной общественной лицензии GNU версии 3.

Вы можете ознакомиться с пояснениями к GNU GPL v3 здесь: [https://choosealicense.com/licenses/gpl-3.0/ choosealicense.com] и [https://tldrlegal.com/license/gnu-general-public-license-v3-(gpl-3) tldrlegal.com]. Приоритет [https://github.com/multitheftauto/mtasa-blue/blob/master/LICENSE license] отдается нашей лицензии, но обычно это означает, что вы должны:

* указать существенные изменения, внесенные в программное обеспечение
* раскрыть исходный код
* поделиться своим кодом под той же лицензией
* включить оригинальное уведомление об авторских правах

Если вы работаете над форком, мы просим вас указать ссылку на вашу домашнюю страницу и указать, где мы можем найти исходный код. Это позволяет нам быть в курсе событий, связанных с проектами, и даже вносить улучшения для подавляющего большинства игроков в MTA. Указывать имя в Discord не обязательно, но если вы обратитесь за помощью в разработке на наш GitHub, форум или в Discord, это поможет нам понять, из какого вы проекта и соблюдаете ли вы условия лицензии.

== Forks and anti-cheat==

(from https://wiki.multitheftauto.com/wiki/Anti-cheat_support_for_custom_builds)

=== '''// UPDATE (December 2022)''' ===
Теперь вы также можете использовать «полный античит для форков». Для получения дополнительной информации прочтите эту статью: '''[[Forks Full AC]]'''<br><br>

.. But otherwise

Пользовательские сборки MTA и форки столкнутся с некоторыми проблемами, связанными с античитом (AC). Из-за того, что многие форки и пользовательские сборки работают не так, как ожидает модуль античита, мы были вынуждены удалить множество расширенных средств обнаружения и защиты от античита, чтобы создать и предоставить отдельный модуль (тот, что с https://mirror-cdn.multitheftauto.com/bdata/netc.dll), который, проще говоря, является гораздо более слабым античитом, чем «настоящий» MTA. Таким образом, если вы не примете меры, ваш форк-проект может (и будет) легко заражён мошенниками. Этого можно избежать с помощью [[Forks Full AC]] (нажмите, чтобы прочитать статью). Но в стандартном сценарии вам поможет информация, представленная ниже.

Компоненты античита и неткода (netc.dll, net.dll, FairplayKD.sys), в отличие от самого MTA, имеют закрытый исходный код, поэтому без дополнительной информации вам будет сложно справиться с трудностями.

AC, как правило, не поддерживается в форках и в будущем может быть полностью исключён. Это означает, что вы, как правило, ''не можете'' полагаться на античит MTA в своём форке. '''Мы настоятельно рекомендуем вам написать и внедрить собственный античит.'''

Если вы не можете написать свой собственный AC, вот несколько шагов, которые помогут вам максимально эффективно использовать наш (не поддерживаемый) AC:

* Всегда используйте версию наших сетевых модулей (например, [https://mirror-cdn.multitheftauto.com/bdata/netc.dll netc.dll] и [https://mirror-cdn.multitheftauto.com/bdata/net.dll net.dll]), которая соответствует нашему коммиту в основной ветке, на которой основан ваш форк
** Если говорить конкретно, вы можете использовать последнюю версию модуля, совместимую с битовым потоком
** Вы можете загрузить эти модули, выполнив команду https://github.com/multitheftauto/mtasa-blue/blob/master/win-build.bat
* Никогда не блокируйте трафик MTA (клиент и сервер взаимодействуют с официальными серверами MTAHQ) в своём проекте
'''* Обязательно используйте тип сборки «нестабильный», а не «пользовательский», иначе 15 % функций AC для «bdata forks netc» снизятся до 1 %. Подробную информацию и правильную конфигурацию см. в документации по типу сборки по адресу [https://github.com/multitheftauto/mtasa-blue/blob/master/Shared/sdk/version.h mtasa-blue/Shared/sdk/version.h] '''

=== Функции AC отсутствуют в пользовательских сборках ===
* Не обнаруживаются изменения в разделе кода gta_sa
* Не обнаруживаются изменения в некоторых переменных gta_sa
* Не обнаруживаются изменения в памяти
* Не обнаруживаются различные методы внедрения Lua
* SetElementData не защищён от внешних изменений с помощью хаков
* Гораздо меньше эвристических методов защиты от читов и внутренних средств защиты
* Не гарантируется постоянное обновление всех исправленных методов и уязвимостей, на основе которых можно писать читы (иногда они выбираются случайным образом; это одна из причин, по которой рекомендуется обновлять netc.dll до последней доступной версии). Это самая большая (и самая важная) часть оригинального античита.
* Модули MTA не проверяются на предмет модификаций или удалённого перехвата/манипулирования
* и многое другое

Как правило, лучше всего работают системы обнаружения на основе сигнатур. Никаких эвристических методов, исправленных методов и исправленных уязвимостей. Системы обнаружения на основе сигнатур — самые слабые, и основная античит-система решает реальную проблему, а не полагается на сигнатуры. Обратите внимание, что в некоторых форках (например, в российской «MTA Province») античит-система MTA поддерживается ещё хуже, чем в большинстве других форков. Это связано с тем, что разработчики форков имеют возможность полностью блокировать или прерывать коммуникационный трафик клиента > MTAHQ (на что мы в значительной степени полагаемся, чтобы помочь форкам противодействовать мошенничеству, поскольку большинство обычных функций AC недоступны), или выполнять и изменять другие действия, которые с технической точки зрения приведут к тому, что функции AC не будут работать. работайте по назначению или немедленно выйдите из строя. Если вы не хотите, чтобы ваш форк был заражен читерами так же сильно, как "провинция MTA" и как они ее называют, "их клоны" (из провинции).. в дополнение к тому, что вы установили тип сборки «custom», тогда как он должен быть «unstable». Теперь, надеюсь, вы знаете, на что следует обратить внимание как разработчику форка. Кроме того, было бы неплохо, если бы это сообщение дошло до разработчиков форков с большим количеством читеров, таких как Province.

Кроме того, команда по борьбе с мошенничеством в MTA выполняет дополнительную работу вручную, чтобы пресекать мошенничество на форках, например, время от времени блокируя читеров из известных форков с помощью слишком простых методов обнаружения, прилагая все усилия (без каких-либо гарантий). Это всего лишь любезность со стороны MTA, которую мы проявляем, когда нам этого хочется, или, может быть, когда вы обращаетесь к нам... и на это нельзя полагаться.
<br />
Известно, что вышеупомянутые волны банов приводят к банам по причинам, которые выглядят одинаково и известны читерам как «БАН: RPBOX / NEXTRP / PROVINCE CHEAT» (в зависимости от названий форков, затронутых определенным читом). Поэтому, пожалуйста, не направляйте этих пользователей в MTA для обжалования банов.

[[Category:Development]]

SetVehicleDirtEnabled

2026-01-01T18:09:25Z

IManGaaX:

{{Useful Function}} __NOTOC__
<lowercasetitle>setVehicleDirtEnabled</lowercasetitle>
This function toggles a dirt removal [[shader]] effect on the specified [[vehicle]].

[[Image:SetVehicleDirtEnabled-false.png|thumb|320px|right|[[Image:SetVehicleDirtEnabled-true.png|320px|right]]]]

{{Note|This function applies or removes a custom [[shader]] that removes dirt [[texture]] from the [[vehicle]]'s surface. It also handles [[shader]] cleanup automatically when the [[vehicle]] is destroyed.}}

==Syntax==
<syntaxhighlight lang="lua">bool setVehicleDirtEnabled( element theVehicle, boolean enabledState )</syntaxhighlight>

===Required Arguments===
* '''theVehicle''': the vehicle element on which to toggle the dirt effect.
* '''enabledState''': set to false to remove dirt, true to show default dirt.

===Returns===
* '''true''' if the operation was successful (shader applied or removed, or already in the requested state).
* '''false''' if the operation failed (shader creation failure).

==Code==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local enabledVehicles = {}

local shaderCode = [[texture removeDirtyTexture;
technique TexReplace {
pass P0 {
Texture[0] = removeDirtyTexture;
}
}]]

function isVehicleDirtEnabled(theVehicle)
assert(isElement(theVehicle) and getElementType(theVehicle) == "vehicle", "Bad argument @ 'isVehicleDirtEnabled' [Expected vehicle element at argument 1, got "..(isElement(theVehicle) and getElementType(theVehicle) or type(theVehicle)).."]")

if isElement(enabledVehicles[theVehicle]) then
return false
end

return true
end

function setVehicleDirtEnabled(theVehicle, enabledState)
assert(isElement(theVehicle) and getElementType(theVehicle) == "vehicle", "Bad argument @ 'setVehicleDirtEnabled' [Expected vehicle element at argument 1, got "..(isElement(theVehicle) and getElementType(theVehicle) or type(theVehicle)).."]")
assert(type(enabledState) == "boolean", "Bad argument @ 'setVehicleDirtEnabled' [Expected boolean at argument 2, got "..(type(enabledState)).."]")

if not enabledState then
if not isElement(enabledVehicles[theVehicle]) then
enabledVehicles[theVehicle] = dxCreateShader(shaderCode, 0, 100, false, "vehicle")
if isElement(enabledVehicles[theVehicle]) then
engineApplyShaderToWorldTexture(enabledVehicles[theVehicle], "vehiclegrunge256", theVehicle)
else
return false
end
end
else
if isElement(enabledVehicles[theVehicle]) then
engineRemoveShaderFromWorldTexture(enabledVehicles[theVehicle], "vehiclegrunge256", theVehicle)
destroyElement(enabledVehicles[theVehicle])
enabledVehicles[theVehicle] = nil
end
end

return true
end

addEventHandler("onClientElementDestroy", root, function()
if getElementType(source) == "vehicle" then
setVehicleDirtEnabled(source, true)
end
end)
</syntaxhighlight>
</section>

'''Author:''' [[User:IManGaaX|Youssef Maged (iManGaaX)]]

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
--// Disable dirt on the localPlayer's vehicle
local theVeh = getPedOccupiedVehicle(localPlayer)
if theVeh then
setVehicleDirtEnabled(theVeh, false)
end

--// Show the dirt on a vehicle after 5 seconds
setTimer(function()
if theVeh then
setVehicleDirtEnabled(theVeh, true)
end
end, 5000, 1)

--// Also u can use 'isVehicleDirtEnabled' to check.
</syntaxhighlight>
</section>

==See Also==

{{Useful_Functions}}

IsPostFXEnabled

2025-12-03T11:08:22Z

O22:

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6|23644 |
Checks whether a specific PostFX effect is currently enabled.
}}

==Syntax==
<syntaxhighlight lang="lua">
bool isPostFXEnabled ( string fxType )
</syntaxhighlight>

===Required arguments===
*'''fxType''': An string of the PostFX. Possible values are:
**'''Gamma'''
**'''Brightness'''
**'''Contrast'''
**'''Saturation'''

===Returns===
Returns '''true''' if the selected type is enabled, otherwise '''false'''

==Example==
This example gets whether the gamma PostFX is enabled and displays it in the chat.
<syntaxhighlight lang="lua">
addCommandHandler("isGammaEnabled",
function()
local isEnabled = isPostFXEnabled("Gamma")
outputChatBox("Your gamma mode is: "..(isEnabled and "Enabled" or "Disabled"))
end, false, false
)
</syntaxhighlight>

==See Also==
{{Client_PostFX_functions}}

GetPostFXValue

2025-12-03T11:06:32Z

O22: Created page with "__NOTOC__ {{Client function}} {{New feature/item|3.0161|1.6|23644| Gets the current float value of the selected PostFX type. }} ==Syntax== <syntaxhighlight lang="lua"> float getPostFXValue ( string fxType ) </syntaxhighlight> ===Required arguments=== *'''fxType''': An string of the PostFX. Possible values are: **'''Gamma''' **'''Brightness''' **'''Contrast''' **'''Saturation''' ===Returns=== Returns the current value of the specified PostFX parameter. ==Example== T..."

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6|23644|
Gets the current float value of the selected PostFX type.
}}

==Syntax==
<syntaxhighlight lang="lua">
float getPostFXValue ( string fxType )
</syntaxhighlight>

===Required arguments===
*'''fxType''': An string of the PostFX. Possible values are:
**'''Gamma'''
**'''Brightness'''
**'''Contrast'''
**'''Saturation'''

===Returns===
Returns the current value of the specified PostFX parameter.

==Example==
This example gets the current gamma PostFX value and display it in the chat.
<syntaxhighlight lang="lua">
addCommandHandler("getGammaValue",
function()
local gammaValue = getPostFXValue("Gamma")
outputChatBox("Your gamma value is: "..tostring(gammaValue))
end, false, false
)
</syntaxhighlight>

==See Also==
{{Client_PostFX_functions}}

GetPostFXMode

2025-12-03T11:05:40Z

O22: Created page with "__NOTOC__ {{Client function}} {{New feature/item|3.0161|1.6|23644| Gets the current mode of PostFX. }} ==Syntax== <syntaxhighlight lang="lua"> int getPostFXMode ( ) </syntaxhighlight> ===Returns=== An integer for the current PostFX mode: * 0: Disabled * 1: Enabled in fullscreen mode * 2: Enabled in windowed/borderless mode ==Example== This example gets the current PostFX mode and displays it in the chat. <syntaxhighlight lang="lua"> local modes = { [0] = "Disabl..."

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6|23644|
Gets the current mode of PostFX.
}}

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

===Returns===
An integer for the current PostFX mode:
* 0: Disabled
* 1: Enabled in fullscreen mode
* 2: Enabled in windowed/borderless mode

==Example==
This example gets the current PostFX mode and displays it in the chat.
<syntaxhighlight lang="lua">
local modes = {
[0] = "Disabled",
[1] = "Enabled in fullscreen mode",
[2] = "Enabled in windowed/borderless mode"
}

addCommandHandler("getMyMode",
function()
local currentMode = getPostFXMode()
outputChatBox("Your PostFX mode is: "..modes[currentMode])
end, false, false
)
</syntaxhighlight>

==See Also==
{{Client_PostFX_functions}}

IsPlayerNameRandomized

2025-12-01T19:04:39Z

O22: Created page with "{{Useful Function}} __NOTOC__ Checks whether the given player name looks like an automatically-generated random nickname. ==Syntax== <syntaxhighlight lang="lua">bool isPlayerNameRandomized ( string name )</syntaxhighlight> ===Required Arguments=== * '''name''': The player name to check. ===Returns=== Returns '''true''' if the given name is an auto-generated random nickname, or '''false''' otherwise. ==Code== <section name="Shared" class="both" show="true"> <syntaxhig..."

{{Useful Function}}
__NOTOC__
Checks whether the given player name looks like an automatically-generated random nickname.

==Syntax==
<syntaxhighlight lang="lua">bool isPlayerNameRandomized ( string name )</syntaxhighlight>

===Required Arguments===
* '''name''': The player name to check.

===Returns===
Returns '''true''' if the given name is an auto-generated random nickname, or '''false''' otherwise.

==Code==
<section name="Shared" class="both" show="true">
<syntaxhighlight lang="lua">
local firstName, secondName = {
"Aback", "Abaft", "Abandoned", "Abashed", "Aberrant", "Abhorrent", "Abiding", "Abject", "Ablaze", "Able", "Abnormal",
"Aboard", "Aboriginal", "Abortive", "Abounding", "Abrasive", "Abrupt", "Absent", "Absorbed", "Absorbing", "Abstracted", "Absurd",
"Abundant", "Abusive", "Acceptable", "Accessible", "Accidental", "Accurate", "Acid", "Acidic", "Acoustic", "Acrid", "Actually",
"Adhoc", "Adamant", "Adaptable", "Addicted", "Adhesive", "Adjoining", "Adorable", "Afraid", "Aggressive", "Agonizing", "Agreeable",
"Ahead", "Ajar", "Alcoholic", "Alert", "Alike", "Alive", "Alleged", "Alluring", "Aloof", "Amazing", "Ambiguous",
"Ambitious", "Amuck", "Amused", "Amusing", "Ancient", "Angry", "Animated", "Annoyed", "Annoying", "Anxious", "Apathetic",
"Aquatic", "Aromatic", "Arrogant", "Ashamed", "Aspiring", "Assorted", "Attractive", "Auspicious", "Automatic", "Available", "Average",
"Awake", "Aware", "Awesome", "Awful", "Axiomatic", "Bad", "Barbarous", "Bashful", "Bawdy", "Beautiful", "Befitting",
"Beneficial", "Bent", "Berserk", "Best", "Better", "Bewildered", "Big", "Billowy", "Bite-sized", "Bitter", "Bizarre",
"Black", "Bloody", "Blue", "Blue-eyed", "Blushing", "Boiling", "Boorish", "Bored", "Boring", "Bouncy", "Boundless",
"Brainy", "Brash", "Brave", "Brawny", "Breakable", "Breezy", "Brief", "Bright", "Broad", "Broken", "Brown",
"Bumpy", "Burly", "Bustling", "Busy", "Cagey", "Callous", "Calm", "Capable", "Capricious", "Careful", "Careless",
"Caring", "Cautious", "Ceaseless", "Certain", "Changeable", "Charming", "Cheap", "Cheerful", "Chemical", "Chief", "Childlike",
"Chilly", "Chivalrous", "Chubby", "Chunky", "Clammy", "Classy", "Clean", "Clear", "Clever", "Cloistered", "Cloudy",
"Closed", "Clumsy", "Cluttered", "Coherent", "Cold", "Colorful", "Colossal", "Combative", "Common", "Complete", "Complex",
"Concerned", "Condemned", "Confused", "Conscious", "Cooing", "Cool", "Courageous", "Cowardly", "Crabby", "Craven", "Crazy",
"Creepy", "Crooked", "Crowded", "Cruel", "Cuddly", "Cultured", "Cumbersome", "Curious", "Curly", "Curved", "Curvy",
"Cut", "Cute", "Cynical", "Daffy", "Daily", "Damaged", "Damaging", "Damp", "Dangerous", "Dapper", "Dark",
"Dashing", "Dazzling", "Dead", "Deadpan", "Deafening", "Dear", "Debonair", "Decisive", "Decorous", "Deep", "Deeply",
"Defeated", "Defective", "Defiant", "Delicate", "Delicious", "Delightful", "Demonic", "Delirious", "Dependent", "Depressed", "Deranged",
"Deserted", "Detailed", "Determined", "Devilish", "Didactic", "Different", "Difficult", "Diligent", "Direful", "Dirty", "Disastrous",
"Discreet", "Disgusted", "Disgusting", "Distinct", "Disturbed", "Divergent", "Dizzy", "Doubtful", "Drab", "Draconian", "Dramatic",
"Dreary", "Drunk", "Dry", "Dull", "Dusty", "Dynamic", "Eager", "Early", "Earthy", "Easy", "Eatable",
"Economic", "Educated", "Efficient", "Eight", "Elastic", "Elated", "Elderly", "Electric", "Elegant", "Elfin", "Elite",
"Eminent", "Empty", "Enchanted", "Enchanting", "Endurable", "Energetic", "Enormous", "Envious", "Equable", "Equal", "Erect",
"Erratic", "Ethereal", "Evanescent", "Evasive", "Even", "Excellent", "Excited", "Exciting", "Exclusive", "Exotic", "Expensive",
"Exuberant", "Exultant", "Fabulous", "Faded", "Faint", "Fair", "Faithful", "Fallacious", "False", "Familiar", "Famous",
"Fanatical", "Fancy", "Fantastic", "Far", "Far-flung", "Fascinated", "Fast", "Fat", "Faulty", "Fearful", "Fearless",
"Feeble", "Feigned", "Female", "Fertile", "Festive", "Few", "Fierce", "Filthy", "Fine", "Finicky", "First",
"Five", "Fixed", "Flagrant", "Flaky", "Flashy", "Flat", "Flawless", "Flimsy", "Flippant", "Flowery", "Fluffy",
"Fluttering", "Foamy", "Foolish", "Foregoing", "Forgetful", "Fortunate", "Four", "Frail", "Fragile", "Frantic", "Free",
"Freezing", "Frequent", "Fresh", "Fretful", "Friendly", "Frightened", "Full", "Fumbling", "Functional", "Funny", "Furry",
"Furtive", "Future", "Futuristic", "Fuzzy", "Gabby", "Gainful", "Gamy", "Gaping", "Garrulous", "Gaudy", "General",
"Gentle", "Giant", "Giddy", "Gifted", "Gigantic", "Glamorous", "Gleaming", "Glib", "Glistening", "Glorious", "Glossy",
"Godly", "Good", "Goofy", "Gorgeous", "Graceful", "Grandiose", "Grateful", "Gratis", "Gray", "Greasy", "Great",
"Greedy", "Green", "Grey", "Grieving", "Groovy", "Grotesque", "Grouchy", "Grubby", "Gruesome", "Grumpy", "Guarded",
"Guiltless", "Gullible", "Gusty", "Guttural", "Habitual", "Half", "Hallowed", "Halting", "Handsome", "Handsomely", "Handy",
"Hanging", "Hapless", "Happy", "Hard", "Harmonious", "Harsh", "Hateful", "Heady", "Healthy", "Heavenly", "Heavy",
"Hellish", "Helpful", "Helpless", "Hesitant", "Hideous", "High", "Hilarious", "Hissing", "Historical", "Holistic", "Hollow",
"Homeless", "Homely", "Honorable", "Horrible", "Hospitable", "Hot", "Huge", "Hulking", "Humdrum", "Humorous", "Hungry",
"Hurried", "Hurt", "Hushed", "Husky", "Hypnotic", "Hysterical", "Icky", "Icy", "Idiotic", "Ignorant", "Ill",
"Illegal", "Ill-fated", "Imaginary", "Immense", "Imminent", "Impartial", "Imperfect", "Impolite", "Important", "Imported", "Impossible",
"Incredible", "Infamous", "Innate", "Innocent", "Insidious", "Internal", "Invincible", "Irate", "Irritating", "Itchy", "Jaded",
"Jagged", "Jazzy", "Jealous", "Jittery", "Jobless", "Jolly", "Joyous", "Judicious", "Juicy", "Jumbled", "Jumpy",
"Juvenile", "Kaput", "Keen", "Kind", "Kindly", "Knotty", "Knowing", "Known", "Labored", "Lacking", "Lame",
"Lamentable", "Languid", "Large", "Last", "Late", "Laughable", "Lavish", "Lazy", "Lean", "Learned", "Left",
"Legal", "Lethal", "Level", "Lewd", "Light", "Like", "Likeable", "Limping", "Literate", "Little", "Lively",
"Living", "Lonely", "Long", "Longing", "Long-term", "Loose", "Lopsided", "Loud", "Loutish", "Lovely", "Loving",
"Low", "Lowly", "Lucky", "Ludicrous", "Lumpy", "Lush", "Luxuriant", "Lying", "Lyrical", "Macabre", "Macho",
"Maddening", "Madly", "Magenta", "Magical", "Majestic", "Makeshift", "Male", "Malicious", "Mammoth", "Maniacal", "Many",
"Marked", "Massive", "Married", "Marvelous", "Material", "Mature", "Mean", "Measly", "Meaty", "Medical", "Meek",
"Mellow", "Melodic", "Melted", "Merciful", "Mere", "Messy", "Mighty", "Military", "Milky", "Mindless", "Miniature",
"Minor", "Miscreant", "Misty", "Mixed", "Moaning", "Modern", "Moldy", "Momentous", "Motionless", "Muddled", "Mundane",
"Murky", "Mushy", "Mute", "Mysterious", "Naive", "Nappy", "Narrow", "Nasty", "Natural", "Naughty", "Nauseating",
"Near", "Neat", "Nebulous", "Necessary", "Needless", "Needy", "Neighborly", "Nervous", "New", "Next", "Nice",
"Nifty", "Nimble", "Nine", "Nippy", "Noiseless", "Noisy", "Nonchalant", "Nonstop", "Normal", "Nostalgic", "Nosy",
"Noxious", "Null", "Numberless", "Numerous", "Nutritious", "Nutty", "Oafish", "Obedient", "Obeisant", "Obese", "Obnoxious",
"Obscene", "Obsequious", "Observant", "Obsolete", "Obtainable", "Oceanic", "Odd", "Offbeat", "Old", "Omniscient", "One",
"Onerous", "Open", "Opposite", "Optimal", "Orange", "Ordinary", "Organic", "Ossified", "Outgoing", "Outrageous", "Oval",
"Overjoyed", "Overrated", "Overt", "Painful", "Pale", "Paltry", "Panicky", "Panoramic", "Parallel", "Parched", "Past",
"Pastoral", "Pathetic", "Peaceful", "Penitent", "Perfect", "Periodic", "Perpetual", "Petite", "Phobic", "Physical", "Picayune",
"Pink", "Piquant", "Placid", "Plain", "Plant", "Plastic", "Plausible", "Pleasant", "Plucky", "Pointless", "Poised",
"Polite", "Political", "Poor", "Possessive", "Possible", "Powerful", "Precious", "Premium", "Present", "Pretty", "Previous",
"Pricey", "Prickly", "Private", "Probable", "Productive", "Profuse", "Protective", "Proud", "Psychotic", "Public", "Puffy",
"Pumped", "Puny", "Purple", "Purring", "Pushy", "Puzzled", "Puzzling", "Quack", "Quaint", "Quick", "Quickest",
"Quiet", "Quirky", "Quixotic", "Quizzical", "Rabid", "Racial", "Ragged", "Rainy", "Rampant", "Rapid", "Rare",
"Raspy", "Ratty", "Ready", "Real", "Rebel", "Receptive", "Recondite", "Red", "Redundant", "Reflective", "Regular",
"Relieved", "Remarkable", "Repulsive", "Resolute", "Resonant", "Rhetorical", "Rich", "Right", "Righteous", "Rightful", "Rigid",
"Ripe", "Ritzy", "Roasted", "Robust", "Romantic", "Roomy", "Rotten", "Rough", "Round", "Royal", "Ruddy",
"Rude", "Rural", "Rustic", "Ruthless", "Sable", "Sad", "Safe", "Salty", "Same", "Sassy", "Satisfying",
"Savory", "Scandalous", "Scarce", "Scared", "Scary", "Scattered", "Scientific", "Scrawny", "Screeching", "Second", "Secret",
"Secretive", "Sedate", "Seemly", "Selective", "Selfish", "Separate", "Serious", "Shaggy", "Shaky", "Shallow", "Sharp",
"Shiny", "Shivering", "Shocking", "Short", "Shrill", "Shut", "Shy", "Sick", "Silent", "Silky", "Silly",
"Simple", "Simplistic", "Sincere", "Six", "Skillful", "Skinny", "Sleepy", "Slim", "Slimy", "Slippery", "Sloppy",
"Slow", "Small", "Smart", "Smelly", "Smiling", "Smoggy", "Smooth", "Sneaky", "Snobbish", "Snotty", "Soft",
"Soggy", "Solid", "Somber", "Sordid", "Sore", "Sour", "Sparkling", "Special", "Spicy", "Spiffy", "Spiky",
"Spiritual", "Spiteful", "Splendid", "Spooky", "Spotless", "Spotted", "Spotty", "Spurious", "Squalid", "Square", "Squealing",
"Squeamish", "Staking", "Stale", "Standing", "Statuesque", "Steadfast", "Steady", "Stealthy", "Steep", "Sticky", "Stiff",
"Stingy", "Stormy", "Straight", "Strange", "Striped", "Strong", "Stupendous", "Stupid", "Sturdy", "Subdued", "Subsequent",
"Successful", "Succinct", "Sudden", "Sulky", "Super", "Superb", "Supreme", "Swanky", "Sweet", "Sweltering", "Swift",
"Synonymous", "Taboo", "Tacit", "Tacky", "Talented", "Tall", "Tame", "Tan", "Tangible", "Tangy", "Tart",
"Tasteful", "Tasteless", "Tasty", "Tawdry", "Tearful", "Tedious", "Teeny", "Teeny-tiny", "Telling", "Temporary", "Ten",
"Tender", "Tense", "Tenuous", "Terrible", "Terrific", "Tested", "Testy", "Thankful", "Thick", "Thin", "Thinkable",
"Third", "Thirsty", "Thoughtful", "Three", "Thundering", "Tidy", "Tight", "Tiny", "Tired", "Tiresome", "Toothsome",
"Torpid", "Tough", "Towering", "Tranquil", "Trashy", "Tremendous", "Tricky", "Trite", "Troubled", "Truculent", "True",
"Truthful", "Two", "Typical", "Ubiquitous", "Ugliest", "Ugly", "Ultra", "Unable", "Unadvised", "Unarmed", "Unbecoming",
"Unbiased", "Uncovered", "Understood", "Unequal", "Unequaled", "Uneven", "Unhealthy", "Unique", "Unkempt", "Unknown", "Unnatural",
"Unruly", "Unsightly", "Unsuitable", "Untidy", "Unused", "Unusual", "Unwieldy", "Unwritten", "Upbeat", "Uppity", "Upset",
"Uptight", "Used", "Useful", "Useless", "Utopian", "Utter", "Uttermost", "Vacuous", "Vagabond", "Vague", "Valuable",
"Various", "Vast", "Vengeful", "Venomous", "Verdant", "Versed", "Victorious", "Vigorous", "Violent", "Violet", "Vivacious",
"Voiceless", "Volatile", "Voracious", "Vulgar", "Wacky", "Waggish", "Waiting", "Wakeful", "Wandering", "Wanting", "Warlike",
"Warm", "Wary", "Wasteful", "Watery", "Weak", "Wealthy", "Weary", "Well-made", "Well-off", "Well-to-do", "Wet",
"Whimsical", "Whispering", "White", "Whole", "Wholesale", "Wicked", "Wide", "Wide-eyed", "Wiggly", "Wild", "Willing",
"Windy", "Wiry", "Wise", "Wistful", "Witty", "Woebegone", "Womanly", "Wonderful", "Wooden", "Woozy", "Workable",
"Worried", "Worthless", "Wrathful", "Wretched", "Wrong", "Wry",
}, {
"Aardvark", "Buffalo", "Alligator", "Ant", "Anteater", "Antelope", "Ape", "Armadillo", "Donkey", "Baboon", "Badger",
"Barracuda", "Bat", "Bear", "Beaver", "Bee", "Bison", "Boar", "Bush", "Butterfly", "Camel", "Calf",
"Cat", "Kitten", "Cattle", "Chamois", "Cheetah", "Chicken", "Chick", "Chimpanzee", "Infant", "Empress", "Troop",
"Cobra", "Cockroach", "Cormorant", "Cougar", "Coyote", "Crab", "Crane", "Crocodile", "Crow", "Deer", "Dog",
"Dogfish", "Dolphin", "Dove", "Dragonfly", "Duck", "Dugong", "Eagle", "Eaglet", "Echidna", "Eel", "Eland",
"Elephant", "Elk", "Falcon", "Ferret", "Finch", "Fly", "Fox", "Frog", "Gaur", "Gazelle", "Gerbil",
"Giant", "Giraffe", "Gnu", "Goat", "Goose", "Gorilla", "Guanaco", "Guinea", "Guineapig", "Gull", "Hamster",
"Hare", "Hawk", "Hedgehog", "Heron", "Hornet", "Horse", "Human", "Hyena", "Iguana", "Jackal", "Jaguar",
"Jellyfish", "Kangaroo", "Koala", "Komodo", "Kouprey", "Kudu", "Lark", "Lemur", "Leopard", "Lion", "Llama",
"Loris", "Louse", "Lobster", "Lyrebird", "Magpie", "Mallard", "Manatee", "Meerkat", "Mink", "Mole", "Monkey",
"Moose", "Mouse", "Mosquito", "Mule", "Okapi", "Oryx", "Ostrich", "Otter", "Owl", "Ox", "Oyster",
"Panther", "Partridge", "Peafowl", "Pelican", "Penguin", "Pig", "Pigeon", "Pony", "Porcupine", "Quelea", "Rabbit",
"Bunny", "Raccoon", "Rail", "Ram", "Rat", "Raven", "Reindeer", "Rhino", "Salamander", "Sealion", "Seal",
"Seahorse", "Seastar", "Shark", "Sheep", "Shrew", "Skunk", "Snail", "Snake", "Spider", "Squid", "Squirrel",
"Stinkbug", "Swan", "Tapir", "Tarsier", "Tiger", "Toad", "Turkey", "Turtle", "Vicuna", "Walrus", "Wasp",
"Weasel", "Whale", "Wolf", "Worm", "Yak", "Zebra", "Hat", "Cap", "Beret", "Astrakhan", "Beanie",
"Hardhat", "Pillbox", "Monkeycap", "Operahat", "Bonnet", "Bowler", "Coonskin", "Fedora", "Derby", "Montero", "Cowboyhat",
"Sombrero", "Yarmulke", "Skullcap", "Tam", "Sunbonnet", "Toque", "Tophat", "Babushka", "Balaclava", "Turban", "Diadem",
"Earmuffs", "Visor", "Scarf", "Veil", "Warbonnet", "Pithhelmet", "Hood", "Miter", "Butter", "Icecream", "Cakebatter",
"Coffee", "Tea", "Soda", "Beer", "Wine", "Cappuccino", "Jell-o", "Nougats", "Lambchops", "Steaks", "Chowder",
"Fishsoup", "Spaghetti", "Sushi", "Fondue", "Crabslegs", "Shrimp", "Onions", "Bratwurst", "Kielbasa", "Hotdog", "Hamburger",
"Herbs", "Grains", "Legumes", "Zampone", "Casserole", "Beans", "Seeds", "Stew", "Cereal", "Polenta", "Pudding",
"Pasta", "Macaroni", "Ravioli", "Wafer", "Crackers", "Cookies", "Sandwich", "Gyro", "Wrap", "Omelet", "Popcorn",
"Walnuts", "Nuts", "Almonds", "Pizza", "Mousse", "Brulee", "Cakes", "Pancake", "Waffles", "Toast", "Candy",
"Pie", "Senator", "Governor", "Councilman", "Detective", "Sleuth", "Musician", "Maestro", "Conductor", "Composer", "Singer",
"Architect", "Physician", "Manager", "Usher", "Painter", "Model", "Designer", "Guest", "Attorney", "Lawyer", "Judge",
"Mayor", "Therapist", "Teacher", "Principal", "Professor", "Orator", "Man", "Woman", "Teen", "Child", "Mother",
"Father", "Sister", "Brother", "Uncle", "Aunt", "Son", "Daughter", "In-laws", "Boy", "Girl", "Nurse",
"Sibling", "Settler", "Pioneer", "Waiter", "Hostess", "Host", "Cashier", "Attendant", "Publisher", "Witch", "Warlock",
"Ghost", "Knight", "Prince", "Princess", "Maiden", "Godmother", "Fairy", "Petal", "Sepal", "Stamen", "Pineboughs",
"Bud", "Branch", "Blossom", "Fruit", "Bloom", "Tree", "Maple", "Elm", "Oak", "Palm", "Baobab",
"Mangrove", "Cyprus", "Pine", "Dogwood", "Alder", "Flowers", "Rose", "Tulip", "Cyclamen", "Lily", "Carnations",
"Wisteria", "Flytrap", "Hoe", "Weeds", "Plants", "Canes", "Palms", "Apple", "Lemon", "Orange", "Grapefruit",
"Tangerine", "Peach", "Tomato", "Banana", "Vegetables", "Artichokes", "Leeks", "Lettuce", "Eggplants", "Zucchini", "Squash",
"Pumpkin", "Cabbage", "Pepper", "Onion", "Garlic", "Poison", "Venom", "Fire", "Ship", "Ferryboat", "Oceanliner",
"Oars", "Sails", "Dinghy", "Yacht", "Canoe", "Catamaran", "Gondola", "Boat", "Battleship", "Clipper", "Dhow",
"Flatboat", "Houseboat", "Galleon", "Frigate", "Hydrofoil", "Junk", "Ketch", "Yawl", "Submarine", "Schooner", "Scow",
"Flatbed", "Suv", "Van", "Caboose", "Train", "Bullet", "Metro", "Subway", "Cart", "Taxi", "Car",
"Racingcar", "Buggy", "Dunebuggy", "Dragster", "Motorcycle", "Gokart", "Limo", "Stretch", "Wagon", "Trolley", "Tram",
"Bus", "Parachute", "Tractor", "Trailer", "Golfkart", "Jeep", "Bigrig", "Bulldozer", "Dumptruck", "Towtruck", "Engine",
"Fireengine", "Policecar", "Tank", "Locomotive", "Ocean", "Oasis", "Sea", "Lake", "Saltlake", "Seafoam", "Waves",
"Bubbles", "Current", "Waterbasin", "Bridge", "Harbor", "Pond", "Wharf", "Pier", "Dock", "Port", "Shore",
"Beach", "Sandbar", "Coast", "River", "Brook", "Rivulet", "Puddle", "Waterfall", "Cascades", "Canal", "Channel",
"Stream", "Creek", "Marsh", "Bog", "Swamp", "Bayou", "Estuary", "Whirlpool", "Eddy", "Geyser", "Well",
"Monsoon", "Hurricane", "Typhoon", "Air", "Snow", "Rain", "Sleet", "Storm", "Hail", "Blizzard", "Wind",
"Breeze", "Gale", "Whirlwind", "Maelstrom", "Duststorm", "Cloudburst", "Tornado", "Twister", "Clouds", "Fog", "Peasoup",
"Floods", "Flashflood", "Acidrain", "Tremors", "Lightning", "Avalanche", "Eclipse", "Alpenglow", "Tsunami", "Waterspout", "Smog",
"Aneroid", "Barometer", "Radiosonde", "Station", "Map", "Chalice", "Bijou", "Candelabra", "Menorah", "Curio", "Figurine",
"Music-box", "Objetd'art", "Trinket", "Trims", "Windchimes", "Birdcage", "Birdbath", "Cans", "Urn", "Bucket", "Arrow",
"Bow", "Sword", "Dart", "Epee", "Dagger", "Hatchet", "Pickax", "Dolls", "Broom", "Mop", "Pail",
"Squeegee", "Caddy", "Telephone", "Pipe", "Paints", "Brushes", "Easel", "Canvas", "Trunk", "Hook", "Gun",
"Glue", "Tissue", "Toilet", "Kleenex", "Papertowel", "Ropes", "Rubber", "Coil", "Toys", "Dogleash", "Balloon",
"Vases", "Planters", "Pen", "Pad", "Typewriter", "Computer", "Laptop", "Netbook", "Stylus", "Pencil", "Desk",
"Backpack", "Shoerack", "Notebook", "Vellum", "Chalk", "Badge", "Saddle", "Spurs", "Paper", "Rollbook", "Guestbook",
"Pot", "Plate", "Dishes", "Fork", "Spoons", "Knives", "Knife", "Samovar", "Sky", "Forest", "Heaven",
"Hell", "Earth", "Sun", "Star", "Planet", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus",
"Neptune", "Ceres", "Pluto", "Haumea", "Makemake", "Eris", "Outerspace", "Town", "Village", "City", "Country",
"Farm", "Suburb", "Roads", "Streets", "Blocks", "Zoo", "Park", "Museum", "Cemetery", "Tunnels", "Caves",
"Churches", "Temples", "Mall", "Dresser", "Armoire", "Chiffonier", "Credenza", "Console", "Bookcase", "Buffet", "Armchair",
"Recliner", "Easychair", "Bench", "Banquette", "Chair", "Couch", "Davenport", "Sofa", "Ottoman", "Deckchair", "Loveseat",
"Highseat", "Divan", "Inglenook", "Pew", "Throne", "Sectional", "Stool", "Pottychair", "Workbench", "Nighttable", "Bed",
"Daybed", "Bassinet", "Crib", "Cradle", "Cot", "Futon", "Hammock", "Tatamimat", "Waterbed", "Trundlebed", "Hassock",
"Hatrack", "Stepstool", "Footrest", "Footstool", "Tripod", "Mirror", "Nightlight", "Torchiere", "Sunlamp", "Spotlight", "Ceilingfan",
"Cupboard", "Cardtable", "Hutch", "Locker", "Wetbar", "Vanity", "Rack", "Hopechest", "Sculpture", "Painting", "Eye",
"Pupil", "Iris", "Retina", "Eyeball", "Eyelids", "Eyelashes", "Eyebrows", "Lap", "Waist", "Belly", "Tummy",
"Rearend", "Crotch", "Abdomen", "Beard", "Mustache", "Sideburns", "Fingernail", "Hand", "Forearm", "Arm", "Knuckles",
"Thumb", "Wrist", "Elbow", "Leg", "Toes", "Knee", "Ankle", "Shin", "Thigh", "Hip", "Breast",
"Chest", "Torso", "Tongue", "Lips", "Gums", "Mouth", "Teeth", "Bones", "Spine", "Throat", "Lungs",
"Kidneys", "Intestines", "Colon", "Spleen", "Glands", "Blood", "Head", "Skull", "Brain", "Muscle", "Hair",
"Xylophone", "Clavier", "Virginal", "Lute", "Drum", "Frenchhorn", "Piano", "Violin", "Cello", "Guitar", "Flute",
"Tuba", "Harp", "Mariachi", "Orchestra", "Oboe", "Bassoon", "Woodwinds", "Brass", "Viola", "Kettledrum", "Peyotedrum",
"Tambourine", "Tambour", "Saxophone", "Marimba", "Maracas", "Shofar", "Cymbals", "Kazoo", "Dulcimer", "Accordion", "Lyre",
"Fiddle", "Banjo", "Balalaika", "Sitar", "Ukulele", "Zither", "Bagpipes", "Piccolo", "Clarinet", "Cornet", "Panpipe",
"Tuningfork", "Metronome", "Castanets", "Woofer", "Sniper", "Marksman", "Cleaner", "Pyro", "Attacker", "Mechanic", "Janitor",
"Scrubber", "Garbageman", "Technician", "Ninja", "Medic", "Spy", "Assassin", "Gunman", "Triggerman", "Butcher", "Killer",
"Dodger", "Booger", "Engineer", "Doctor", "Surgeon", "Fighter", "Shooter", "Gunner", "Soldier", "Officer", "Veteran",
"Scout", "Mercenary", "Commando", "Cadet", "Guard", "Warrior", "Trooper", "Gambler", "Specialist", "Shaper", "Finisher",
"Gladiator", "Boxer", "Wrestler", "Warlord", "Rival", "Armory", "Agent", "Rebel", "Brawler", "Bruiser", "Bully",
"Champion", "Hero", "Battler", "Combatant", "Fencer", "Swordsman", "Expert", "Gangster", "Gangsta", "Bandit", "Hoodlum",
"Mobster", "Robber", "Thief", "Burglar", "Pirate", "Thug", "Hitman", "Hitperson", "Dealer", "Desperado", "Criminal",
"Crook", "Hijacker", "Carjacker", "Villain", "Convict", "Fugitive", "Mug", "Outlaw", "Ruffian", "Cutthroat", "Devil",
"Murderer", "Psycho", "Punk", "ASBO", "Offender", "Drifter", "Rioter", "Goon", "Roughneck", "Brute", "Hacker",
"Cabbie", "Wheeler", "Driver", "Rider", "Cyclist", "Cowboy", "Operative", "Carrier", "Transporter", "Trucker", "Wheelman",
"Vampire", "Parasite", "Tramp", "Bum", "Hobo", "Hitchhiker", "Deadbeat", "Acrobat",
}

function isPlayerNameRandomized(name)
if type(name) ~= "string" then
return false
end

local prefix, num = name:match("^(.-)(%d+)$")
if not prefix or not num then
return false
end

if not tonumber(num) or tonumber(num) < 0 or tonumber(num) > 100 then
return false
end

for _, first in ipairs(firstName) do
if prefix:sub(1, #first) == first then
local rest = prefix:sub(#first + 1)

for _, second in ipairs(secondName) do
if rest == second then
return true
end
end
end
end

return false
end
</syntaxhighlight>
</section>

==Example==
The example shows how to use function.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addEventHandler("onPlayerConnect", root,
function(playerNick)
if isPlayerNameRandomized(playerNick) then
cancelEvent(true, "Newbie players are not allowed!")
end
end
)
</syntaxhighlight>
</section>

<br>
Author: [https://wiki.multitheftauto.com/wiki/User:O22 omar-o22]
<br>
Idea from: [https://github.com/multitheftauto/mtasa-blue/issues/2103 Issue#2103]
==See Also==
{{Useful_Functions}}

PT-BR/OnPlayerLogin

2025-10-23T01:31:50Z

Lettify:

__NOTOC__
{{PT-BR/Server event}}
Este evento é acionado quando um jogador se conecta em sua conta dentro do jogo.

==Parâmetros==
<syntaxhighlight lang="lua">
account thePreviousAccount, account theCurrentAccount
</syntaxhighlight>

*'''thePreviousAccount''': A [[account|conta]] que o jogador se conectou anteriormente.
*'''theCurrentAccount''': A [[account|conta]] que o jogador se conectou agora.

==Source==
O [[event system#Event source|source]] deste evento é o [[Elemento/Player|elemento jogador]] que se conectou em sua conta.

==Efeito do cancelamento==
Se este evento é [[cancelEvent|cancelado]], o jogador não se conectará em sua conta.

==Exemplo==
Este exemplo apenas exibe ao console do jogador que um jogador que estava conectado em uma conta, se conectou em outra:
<syntaxhighlight lang="lua">
addEventHandler("onPlayerLogin", root,
function()
outputChatBox(getPlayerName(source).." has logged in!", root)
end
)
</syntaxhighlight>
Este exemplo permite apenas que seriais inseridos manualmente consigam acessar as determinadas contas.
<syntaxhighlight lang="lua">
Firewall =
{
-- [ 'accountName' ] = 'playerSerial',
[ '3ash8' ] = '9C9F3B55D9D7BB7135FF274D3BF444E4',
[ 'test5' ] = '1D6F76CF8D7193792D13789849498452',
}

addEventHandler ( 'onPlayerLogin', getRootElement ( ),
function ( _, theCurrentAccount )
local Serial = Firewall[getAccountName(theCurrentAccount)]
if Serial and Serial ~= getPlayerSerial ( source ) then
outputChatBox( "Sorry, you're not allowed to access this account.", source)
cancelEvent( true )
end
end
)
</syntaxhighlight>

{{See also/Server event|Player events}}

[[ru:onPlayerLogin]]
[[pt-br:onPlayerLogin]]

Astrath:createTab

2025-10-22T20:23:32Z

Sybellex:

= DxTab:new =

{{Client function}}
{{FuncDef|element DxTab:new ( element parent, string text, table color, table hoverColor, table activeColor, table tabColor )}}

'''Description:'''
Creates a new tab element inside a `DxTabPanel`. Tabs are linked to a panel and their positions are automatically managed according to the panel layout. Only usable with a valid `DxTabPanel` parent.

'''Parameters:'''
* parent (element) – A `DxTabPanel` element where this tab will be attached (required).
* text (string) – The text to display on the tab (optional, default: 'tab').
* color (table / tocolor) – The main color of the tab (optional, defaults to parent's color).
* hoverColor (table / tocolor) – Color when hovering (optional, defaults to parent's hoverColor).
* activeColor (table / tocolor) – Color when tab is active (optional, defaults to parent's activeColor).
* tabColor (table / tocolor) – Base color for inactive tabs (optional, defaults to parent's tabColor).

'''Returns:'''
: Returns the newly created `DxTab` element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the tab and removes it from the parent panel.
|-
| Ath:setVisible(boolean) || Shows or hides the tab and triggers reordering in the panel.
|-
| Ath:setEnabled(boolean) || Enables or disables the tab.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effects for this tab.
|-
| Ath:setColor(r, g, b, a, type) || Sets the tab's color. Type can be 'mainColor', 'hoverColor', 'tabColor', 'activeColor'.
|}

'''Example:'''
<syntaxhighlight lang="lua">
-- Crear un tab panel
local tabPanel = DxTabPanel:new(100, 100, 400, 300)
tabPanel:setVisible(true)

-- Agregar tabs
local tab1 = DxTab:new(tabPanel, "Tab 1")
local tab2 = DxTab:new(tabPanel, "Tab 2", tocolor(200,0,0,255))

-- Establecer tab seleccionado
tabPanel:setSelected(tab1)

</syntaxhighlight>

'''See also:'''
* [[DxTabPanel:new]] – The panel container required for tabs
* [[onClientRender]] – Event used to draw DX elements each frame
* [[adjustAlpha]] – Function used internally to adjust tab opacity

Astrath:createTabPanel

2025-10-22T20:19:50Z

Sybellex: Created page with "= DxTabPanel:new = {{Client function}} {{FuncDef|element DxTabPanel:new ( float posX, float posY, float width, float height, element parent, boolean relative, table color, table tabColor, table activeColor, table hoverColor, string font, float fontsize, string style, string tabStyle )}} '''Description:''' Creates a new tab panel DX element. A tab panel can hold multiple tabs and manage their selection and hover states. Automatically adjusts child tab positions and size..."

= DxTabPanel:new =

{{Client function}}
{{FuncDef|element DxTabPanel:new ( float posX, float posY, float width, float height, element parent, boolean relative, table color, table tabColor, table activeColor, table hoverColor, string font, float fontsize, string style, string tabStyle )}}

'''Description:'''
Creates a new tab panel DX element. A tab panel can hold multiple tabs and manage their selection and hover states. Automatically adjusts child tab positions and sizes.

'''Parameters:'''
* posX, posY (float) – Position of the tab panel on screen.
* width, height (float) – Dimensions of the tab panel.
* parent (element) – Parent DX element to attach this panel to (optional).
* relative (boolean) – Position relative to parent (optional).
* color (table / tocolor) – Main background color of the panel (optional, default: dark grey).
* tabColor (table / tocolor) – Default color for tabs (optional).
* activeColor (table / tocolor) – Color for the active tab (optional).
* hoverColor (table / tocolor) – Hover color for tabs (optional).
* font (string) – Font used for tab text (optional, default: "default-bold").
* fontsize (float) – Font size for tab text (optional, default: 1).
* style (string) – DX style used for the panel (optional).
* tabStyle (string) – DX style used for tabs (optional).

'''Returns:'''
: Returns the newly created DxTabPanel element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the tab panel and all child tabs and elements.
|-
| Ath:setVisible(boolean) || Shows or hides the tab panel.
|-
| Ath:setEnabled(boolean) || Enables or disables the tab panel for interaction.
|-
| Ath:addTab(text) || Adds a new tab with the given text to the panel.
|-
| Ath:getSelected() || Returns the currently selected tab element.
|-
| Ath:setSelected(tabElement) || Sets a specific tab as selected.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect for tabs.
|-
| Ath:setColor(r, g, b, a, type) || Sets colors for the panel or tabs. Type can be 'mainColor', 'hoverColor', 'tabColor', 'activeColor'.
|}

'''Example:'''
<syntaxhighlight lang="lua">
local tabPanel = DxTabPanel:new(100, 100, 400, 300)
tabPanel:setVisible(true)
tabPanel:addTab("Tab 1")
tabPanel:addTab("Tab 2")
tabPanel:draw()
</syntaxhighlight>

'''See also:'''
* [[DxTab:new]] – Page for individual tab elements
* [[DxWindow:new]] – For window parent reference
* [[onClientRender]] – Event to render DX elements

Astrath:createShape

2025-10-22T20:17:10Z

Sybellex: Created page with "= DxShape:new = {{Client function}} {{FuncDef|element DxShape:new ( float posX, float posY, float width, float height, element parent, boolean relative, table color )}} '''Description:''' Creates a new DX-based shape element. Shapes can have custom colors, hover effects, and rounded corners. Each shape instance is automatically registered in the DX library. '''Parameters:''' * posX, posY (float) – Position on screen. * width, height (float) – Size of the shape. *..."

= DxShape:new =

{{Client function}}
{{FuncDef|element DxShape:new ( float posX, float posY, float width, float height, element parent, boolean relative, table color )}}

'''Description:'''
Creates a new DX-based shape element. Shapes can have custom colors, hover effects, and rounded corners. Each shape instance is automatically registered in the DX library.

'''Parameters:'''
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the shape.
* parent (element) – Parent DX element to attach this shape to (optional).
* relative (boolean) – Position relative to parent (optional).
* color (table / tocolor) – Main color of the shape (optional, default: grey).

'''Returns:'''
: Returns the newly created DxShape element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the shape and all its child elements.
|-
| Ath:setVisible(boolean) || Shows or hides the shape.
|-
| Ath:setEnabled(boolean) || Enables or disables the shape for interaction.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets main or hover color of the shape.
|}

'''Example:'''
<syntaxhighlight lang="lua">
local myShape = DxShape:new(100, 100, 200, 150)
myShape:setVisible(true)
myShape:setHoverable(true)
myShape:setColor(150, 150, 150, 255, "mainColor")
myShape:draw()
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxWindow:new]] – Page for window element reference
* [[DxLabel:new]] – Page for label element reference
* [[onClientRender]] – Event used to render DX elements

Astrath:createRadio

2025-10-22T20:15:27Z

Sybellex: Created page with "= DxRadio:new = {{Client function}} {{FuncDef|element DxRadio:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, string key, string font, float fontsize )}} '''Description:''' Creates a new DX-based radio button element. Radio buttons are single-select controls grouped by a key, allowing only one selection per group. Each radio instance is automatically registered in the DX library. '''Parameters:''' * text (string)..."

= DxRadio:new =

{{Client function}}
{{FuncDef|element DxRadio:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, string key, string font, float fontsize )}}

'''Description:'''
Creates a new DX-based radio button element. Radio buttons are single-select controls grouped by a key, allowing only one selection per group. Each radio instance is automatically registered in the DX library.

'''Parameters:'''
* text (string) – Label text for the radio button (optional, default: "radiobutton").
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the radio button.
* parent (element) – Parent DX element to attach this radio button to (optional).
* relative (boolean) – Position relative to parent (optional).
* key (string) – Group key to identify radio button group (optional, default: "Default").
* font (string) – Font used for text (optional, default: "default-bold").
* fontsize (float) – Font size multiplier (optional, default: 1).

'''Returns:'''
: Returns the newly created DxRadio element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the radio element and all its child elements.
|-
| Ath:setVisible(boolean) || Shows or hides the radio button.
|-
| Ath:setEnabled(boolean) || Enables or disables the radio button for interaction.
|-
| Ath:setSelected() || Selects this radio button and deselects others in the same group.
|-
| Ath:getSelected() || Returns whether this radio button is selected.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets main, hover, or selected color of the radio button.
|}

'''Example:'''
<syntaxhighlight lang="lua">
local myRadio = DxRadio:new("Option 1", 100, 100, 150, 30)

myRadio:setVisible(true)
myRadio:setHoverable(true)
myRadio:setColor(200, 200, 200, 200, "mainColor")
myRadio:setColor(30, 30, 30, 255, "selectColor")
myRadio:setSelected()
myRadio:draw()
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxWindow:new]] – Page for window element reference
* [[DxLabel:new]] – Page for label element reference
* [[onClientRender]] – Event used to render DX elements

Astrath:createMemo

2025-10-22T20:14:10Z

Sybellex: Created page with "= DxMemo:new = {{Client function}} {{FuncDef|element DxMemo:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, string font, float fontsize )}} '''Description:''' Creates a new DX-based memo element. Memos are multi-line text boxes that support scrolling, cursor positioning, text input, custom fonts, colors, and read-only mode. Each memo instance is automatically registered in the DX library. '''Parameters:''' * text..."

= DxMemo:new =

{{Client function}}
{{FuncDef|element DxMemo:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, string font, float fontsize )}}

'''Description:'''
Creates a new DX-based memo element. Memos are multi-line text boxes that support scrolling, cursor positioning, text input, custom fonts, colors, and read-only mode. Each memo instance is automatically registered in the DX library.

'''Parameters:'''
* text (string) – Initial text content for the memo (optional).
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the memo.
* parent (element) – Parent DX element to attach this memo to (optional).
* relative (boolean) – Position relative to parent (optional).
* font (string) – Font used for the text (optional, default: "default-bold").
* fontsize (float) – Font size multiplier (optional, default: 1).

'''Returns:'''
: Returns the newly created DxMemo element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the memo element and all its child elements.
|-
| Ath:setVisible(boolean) || Shows or hides the memo.
|-
| Ath:setEnabled(boolean) || Enables or disables the memo for interaction.
|-
| Ath:setText(string) || Sets the memo text.
|-
| Ath:getText() || Returns the current memo text.
|-
| Ath:clear() || Clears all text and resets the cursor.
|-
| Ath:setReadOnly(boolean) || Enables or disables read-only mode.
|-
| Ath:getReadOnly() || Returns whether the memo is read-only.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets the main or hover background color.
|}

'''Example:'''
<syntaxhighlight lang="lua">
local myMemo = DxMemo:new("Hello World", 100, 100, 300, 200)

myMemo:setVisible(true)
myMemo:setReadOnly(false)
myMemo:setHoverable(true)
myMemo:setColor(255, 255, 255, 255, "mainColor")
myMemo:setText("Welcome to MTA DX Memo")
myMemo:draw()
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxWindow:new]] – Page for window element reference
* [[DxLabel:new]] – Page for label element reference
* [[onClientRender]] – Event used to render DX elements

Astrath:createLabel

2025-10-22T20:12:06Z

Sybellex: Created page with "= DxLabel:new = {{Client function}} {{FuncDef|element DxLabel:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, string font, float fontsize, string horizontalAlign, string verticalAlign )}} '''Description:''' Creates a new DX-based label element. Labels display text, support parent-relative positioning, custom fonts, colors, alignment, and optional hover effects. Each label instance is automatically registered in th..."

= DxLabel:new =

{{Client function}}
{{FuncDef|element DxLabel:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, string font, float fontsize, string horizontalAlign, string verticalAlign )}}

'''Description:'''
Creates a new DX-based label element. Labels display text, support parent-relative positioning, custom fonts, colors, alignment, and optional hover effects. Each label instance is automatically registered in the DX library.

'''Parameters:'''
* text (string) – Text to display in the label.
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the label.
* parent (element) – Parent DX element to attach this label to (optional).
* relative (boolean) – Position relative to parent (optional).
* font (string) – Font used for the text (optional, default: "default-bold").
* fontsize (float) – Font size multiplier (optional, default: 1).
* horizontalAlign (string) – Horizontal alignment ("left", "center", "right", optional, default: "center").
* verticalAlign (string) – Vertical alignment ("top", "center", "bottom", optional, default: "center").

'''Returns:'''
: Returns the newly created DxLabel element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the label element and all its child elements.
|-
| Ath:setVisible(boolean) || Shows or hides the label.
|-
| Ath:setEnabled(boolean) || Enables or disables the label for interaction.
|-
| Ath:setText(string) || Sets the label text.
|-
| Ath:getText() || Returns the current label text.
|-
| Ath:setFont(string) || Changes the label font.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets the main or hover text color.
|-
| Ath:setHorizontalAlign(string) || Sets horizontal alignment of the text.
|-
| Ath:setVerticalAlign(string) || Sets vertical alignment of the text.
|}

'''Example:'''
<syntaxhighlight lang="lua">
local myLabel = DxLabel:new("Hello World", 100, 100, 200, 50)

myLabel:setVisible(true)
myLabel:setHoverable(true)
myLabel:setText("Welcome")
myLabel:setColor(255, 200, 0, 255, "mainColor")
myLabel:setHorizontalAlign("center")
myLabel:setVerticalAlign("center")
myLabel:draw()
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxWindow:new]] – Page for window element reference
* [[DxButton:new]] – Page for button element reference
* [[onClientRender]] – Event used to render DX elements

Astrath:createImage

2025-10-22T19:59:06Z

Sybellex:

= DxImage:new =

{{Client function}}
{{FuncDef|element DxImage:new ( string path, float posX, float posY, float width, float height, element parent, boolean relative )}}

'''Description:'''
Creates a new DX-based image element. Images can be attached to parent elements, support transparency, custom styles, and optional parent-relative positioning. Each image instance is automatically registered in the DX library.

'''Parameters:'''
* path (string) – Path to the image file. Must exist.
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the image.
* parent (element) – Parent DX element to attach this image to (optional).
* relative (boolean) – Position relative to parent (optional).

'''Returns:'''
: Returns the newly created DxImage element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the image element and all its child elements.
|-
| Ath:setVisible(boolean) || Shows or hides the image.
|-
| Ath:setEnabled(boolean) || Enables or disables the image for interaction.
|-
| Ath:setAlpha(number) || Sets the image transparency (0–255).
|}

'''Example:'''
<syntaxhighlight lang="lua">
local myImage = DxImage:new("images/logo.png", 100, 100, 200, 150)

myImage:setVisible(true)
myImage:setAlpha(200)
myImage:setPath("images/new_logo.png")
myImage:draw()
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxWindow:new]] – Page for window element reference
* [[DxLabel:new]] – Page for label element reference
* [[onClientRender]] – Event used to render DX elements

Astrath:createHidden

2025-10-22T19:56:22Z

Sybellex: Created page with "= DxHidden:new = {{Client function}} {{FuncDef|element DxHidden:new ( float posX, float posY, float width, float height, element parent, boolean relative )}} '''Description:''' Creates a hidden DX element. Hidden elements are not drawn and can be used as containers or invisible parents for other DX elements. They can store position and size information and manage child elements. '''Parameters:''' * posX, posY (float) – Position on screen. * width, height (float)..."

= DxHidden:new =

{{Client function}} {{FuncDef|element DxHidden:new ( float posX, float posY, float width, float height, element parent, boolean relative )}}

'''Description:'''
Creates a hidden DX element. Hidden elements are not drawn and can be used as containers or invisible parents for other DX elements. They can store position and size information and manage child elements.

'''Parameters:'''
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the hidden element.
* parent (element) – Parent DX element to attach this hidden element to (optional).
* relative (boolean) – Position relative to parent (optional).

'''Returns:'''
: Returns the newly created DxHidden element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the hidden element and all its child elements.
|-
| Ath:setVisible(boolean) || Sets the visibility state of the hidden element (mostly for management, as hidden elements are not drawn).
|-
| Ath:setEnabled(boolean) || Enables or disables the element for internal logic or child interaction.
|}

'''Example:'''
<syntaxhighlight lang="lua">
-- Create a hidden element at position 100x100 with size 200x200
local hidden = DxHidden:new(100, 100, 200, 200)

-- Set it invisible (default, but can be toggled)
hidden:setVisible(false)

-- Enable it for internal logic
hidden:setEnabled(true)

-- Use as parent for other DX elements
local btn = DxButton:new("Click Me", 10, 10, 100, 40, hidden)
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxWindow:new]] – Example of visible container element
* [[DxButton:new]] – Example of child element

Astrath:createGridList

2025-10-22T19:52:02Z

Sybellex:

= DxEdit:new =
{{Client function}} {{FuncDef|element DxGridlist:new ( float posX, float posY, float width, float height, element parent, boolean relative, table columnSize, string font, float fontSize, table color, table headColor, table hoverColor, table activeColor, table scrollColor, table scrollBGColor )}}

'''Description:'''
Creates a new DX-based gridlist element. Gridlists display rows and columns of data, support scrolling, hover effects, row selection, and customizable colors and fonts. Each gridlist instance is automatically registered in the DX library.

'''Parameters:'''
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the gridlist.
* parent (element) – Parent DX element to attach this gridlist to (optional).
* relative (boolean) – Position relative to parent (optional).
* columnSize (table / number / 'auto') – Width of columns, can be 'auto' to divide evenly.
* font (string) – Font used for text (optional, default: "default-bold").
* fontSize (float) – Font size multiplier (optional, default: 1).
* color, headColor, hoverColor, activeColor (table / tocolor) – Main, header, hover, and active row colors (optional).
* scrollColor, scrollBGColor (table / tocolor) – Scrollbar colors (optional).

'''Returns:'''
: Returns the newly created DxGridlist element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the gridlist and all its child elements.
|-
| Ath:setVisible(boolean) || Shows or hides the gridlist.
|-
| Ath:setEnabled(boolean) || Enables or disables the gridlist for interaction.
|-
| Ath:addColumn(title, textAlign, columnSize) || Adds a new column with optional alignment and width.
|-
| Ath:addRow(...) || Adds a new row with the given items.
|-
| Ath:clear() || Clears all rows from the gridlist.
|-
| Ath:setColumnTitle(idOrName, newTitle) || Changes the title of a column by ID or name.
|-
| Ath:setItemText(columnID, rowID, text) || Sets the text of a specific cell.
|-
| Ath:getItemText(columnID, rowID) || Returns the text of a specific cell.
|-
| Ath:getColumnCount() || Returns the total number of columns.
|-
| Ath:getRowCount() || Returns the total number of rows.
|-
| Ath:removeColumn(columnID) || Removes a column by its ID.
|-
| Ath:removeRow(rowID) || Removes a row by its ID.
|-
| Ath:getRowText(columnID, rowID) || Returns the text of a cell at a given row and column.
|-
| Ath:getSelectedRowID() || Returns the currently selected row ID.
|-
| Ath:getSelectedRowItem() || Returns all items in the currently selected row.
|-
| Ath:setSelectedRowID(id) || Sets the selected row by ID.
|-
| Ath:addChildDxElement(element) || Adds a child element to the gridlist.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets colors for main, hover, header, active, or scroll elements.
|}

'''Example:'''
<syntaxhighlight lang="lua">
-- Create a gridlist at position 200x150 with size 400x300
local myGrid = DxGridlist:new(200, 150, 400, 300)

-- Add columns
myGrid:addColumn("ID", "center", 0.1)
myGrid:addColumn("Name", "left", 0.45)
myGrid:addColumn("Score", "right", 0.45)

-- Add rows
myGrid:addRow(1, "Alice", 95)
myGrid:addRow(2, "Bob", 88)
myGrid:addRow(3, "Charlie", 76)

-- Set selected row
myGrid:setSelectedRowID(2)

-- Change main color
myGrid:setColor(50, 50, 50, 255, "mainColor")
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxButton:new]] – Page for button element reference
* [[DxCombobox:new]] – Page for combobox element reference
* [[onClientRender]] – Event used to render DX elements

Astrath:createEditBox

2025-10-22T19:48:22Z

Sybellex: Created page with "= DxEdit:new / Astrath:createEditBox = {{Client function}} {{FuncDef|element DxEdit:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, string font, float fontsize, string placeholder )}} '''Description:''' Creates a new DX-based edit box element. Edit boxes allow text input with options for read-only mode, numeric-only input, hover effects, and color customization. Each edit box instance is automatically registered i..."

= DxEdit:new / Astrath:createEditBox =

{{Client function}}
{{FuncDef|element DxEdit:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, string font, float fontsize, string placeholder )}}

'''Description:'''
Creates a new DX-based edit box element. Edit boxes allow text input with options for read-only mode, numeric-only input, hover effects, and color customization. Each edit box instance is automatically registered in the DX library.

'''Parameters:'''
* text (string) – Initial text for the edit box (optional).
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the edit box.
* parent (element) – Parent DX element to attach this edit box to (optional).
* relative (boolean) – Position relative to parent (optional).
* font (string) – Font used for the text (optional, default: "default-bold").
* fontsize (float) – Font size multiplier (optional, default: 1).
* placeholder (string) – Placeholder text when the edit box is empty (optional).

'''Returns:'''
: Returns the newly created DxEdit element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the edit box and all its child elements.
|-
| Ath:clear() || Clears all text and resets the cursor.
|-
| Ath:setVisible(boolean) || Shows or hides the edit box.
|-
| Ath:setEnabled(boolean) || Enables or disables the edit box for interaction.
|-
| Ath:setReadOnly(boolean) || Enables or disables read-only mode.
|-
| Ath:setNumericOnly(boolean) || Enables numeric-only input.
|-
| Ath:getReadOnly() || Returns whether the edit box is in read-only mode.
|-
| Ath:setText(string) || Sets the text of the edit box.
|-
| Ath:getText() || Returns the current text of the edit box.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets the main background or hover color of the edit box.
|}

'''Example:'''
<syntaxhighlight lang="lua">
-- Create an edit box at position 400x200 with size 200x25
local myEdit = DxEdit:new("", 400, 200, 200, 25)

-- Set placeholder text
myEdit.placeholder = "Enter your name..."

-- Enable numeric only
myEdit:setNumericOnly(true)

-- Show edit box and enable hover
myEdit:setVisible(true)
myEdit:setHoverable(true)

-- Set background color to light grey
myEdit:setColor(200, 200, 200, 255, "mainColor")
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxButton:new]] – Page for button element reference
* [[DxCheckbox:new]] – Page for checkbox element reference
* [[DxCombobox:new]] – Page for combobox element reference
* [[onClientRender]] – Event used to render DX elements

Astrath:createComboBox

2025-10-22T19:43:32Z

Sybellex: /* DxCombobox:new / Astrath:createCombobox */

= DxCombobox:new =

{{Client function}}
{{FuncDef|element DxCombobox:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, string desc, number maxItems, table color, string font, float fontSize, table scrollColor, table scrollBGColor )}}

'''Description:'''
Creates a new DX-based combobox element. Comboboxes allow selecting from a list of items, support scrolling, hover effects, and color customization. Each combobox instance is automatically registered in the DX library.

'''Parameters:'''
* text (string) – The default text displayed on the combobox.
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the combobox.
* parent (element) – Parent DX element to attach this combobox to (optional).
* relative (boolean) – Position relative to parent (optional).
* desc (string) – Default placeholder text when no item is selected (optional).
* maxItems (number) – Maximum number of items displayed at once (optional, default: 10).
* color (table / tocolor) – Base color for bar, button, and body (optional).
* font (string) – Font used for text (optional, default: "default-bold").
* fontSize (float) – Font size multiplier (optional, default: 1).
* scrollColor, scrollBGColor (table / tocolor) – Scrollbar colors (optional).

'''Returns:'''
: Returns the newly created DxCombobox element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the combobox and all its child elements.
|-
| Ath:setVisible(boolean) || Shows or hides the combobox.
|-
| Ath:setEnabled(boolean) || Enables or disables the combobox for interaction.
|-
| Ath:setText(string) || Sets the text displayed on the combobox.
|-
| Ath:addItem(string) || Adds a new item to the combobox list.
|-
| Ath:removeItem(number) || Removes an item from the list by its index.
|-
| Ath:clear() || Removes all items from the combobox.
|-
| Ath:setItemText(number, string) || Updates the text of an item at a given index.
|-
| Ath:getItemText(number) || Returns the text of an item by index.
|-
| Ath:setSelected(number) || Sets the selected item by index.
|-
| Ath:getSelected() || Returns the index of the currently selected item.
|-
| Ath:getItemCount() || Returns the total number of items in the combobox.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets the color of bar, button, body, or hover.
|}

'''Example:'''
<syntaxhighlight lang="lua">
-- Create a combobox at position 400x200 with size 150x25
local myCombo = DxCombobox:new("Select Item", 400, 200, 150, 25)

-- Add items
myCombo:addItem("Option 1")
myCombo:addItem("Option 2")
myCombo:addItem("Option 3")

-- Show combobox and enable hover
myCombo:setVisible(true)
myCombo:setHoverable(true)

-- Select second item
myCombo:setSelected(2)

-- Change bar color
myCombo:setColor(255, 255, 255, 255, "barColor")
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxButton:new]] – Page for button element reference
* [[DxCheckbox:new]] – Page for checkbox element reference
* [[onClientRender]] – Event used to render DX elements

Astrath:createCheckBox

2025-10-22T19:40:13Z

Sybellex: /* DxCheckbox:new / Astrath:createCheckbox */

= DxCheckbox:new =

{{Client function}}
{{FuncDef|element DxCheckbox:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, string font, float fontsize )}}

'''Description:'''
Creates a new DX-based checkbox element. Checkboxes can be attached to parent elements, support hover effects, custom colors, and selection state. Each checkbox instance is automatically registered in the DX library.

'''Parameters:'''
* text (string) – The label text of the checkbox. Defaults to "radio".
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the checkbox.
* parent (element) – Parent DX element to attach this checkbox to (optional).
* relative (boolean) – Position relative to parent (optional).
* font (string) – Font used for text (optional, default: "default-bold").
* fontsize (float) – Font size multiplier (optional, default: 1).

'''Returns:'''
: Returns the newly created DxCheckbox element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the checkbox and all its child elements.
|-
| Ath:setVisible(boolean) || Shows or hides the checkbox.
|-
| Ath:setEnabled(boolean) || Enables or disables the checkbox for interaction.
|-
| Ath:isSelected() || Returns whether the checkbox is currently selected.
|-
| Ath:setSelected(boolean) || Sets the checkbox selection state.
|-
| Ath:getSelected() || Returns the current selection state.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets the main, hover, or select color of the checkbox.
|}

'''Example:'''
<syntaxhighlight lang="lua">
-- Create a checkbox at position 300x400 with size 20x20
local myCheckbox = DxCheckbox:new("Accept Terms", 300, 400, 20, 20)

-- Show the checkbox and enable hover effect
myCheckbox:setVisible(true)
myCheckbox:setHoverable(true)

-- Set selection state
myCheckbox:setSelected(true)

-- Change colors
myCheckbox:setColor(255, 255, 255, 255, "mainColor")
myCheckbox:setColor(0, 255, 0, 200, "hoverColor")
myCheckbox:setColor(0, 200, 0, 255, "selectColor")
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxButton:new]] – Page for button element reference
* [[onClientRender]] – Event used to render DX elements

Astrath:createButton

2025-10-22T19:33:36Z

Sybellex: /* DxButton:new */

= DxButton:new =

{{Client function}}
{{FuncDef|element DxButton:new ( string text, float posX, float posY, float width, float height, element parent, boolean relative, table color, string font, float fontsize, string description, boolean isIcon, float iconWidth, float iconHeight )}}

'''Description:'''
Creates a new DX-based button element. Buttons can be attached to parent elements, support hover effects, custom colors, icons, fonts, and descriptions. Each button instance is automatically registered in the DX library.

'''Parameters:'''
* text (string) – The button label text. Defaults to "Button".
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the button.
* parent (element) – Parent DX element to attach this button to (optional).
* relative (boolean) – Position relative to parent (optional).
* color (table / tocolor) – Main background color (optional).
* font (string) – Font used for text (optional, default: "default-bold").
* fontsize (float) – Font size multiplier (optional, default: 1).
* description (string) – Optional description text.
* isIcon (boolean) – If true, the button will display an icon instead of text.
* iconWidth, iconHeight (float) – Size of the icon relative to the button (optional).

'''Returns:'''
: Returns the newly created DxButton element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the button and all its child elements.
|-
| Ath:setVisible(boolean) || Shows or hides the button.
|-
| Ath:setEnabled(boolean) || Enables or disables the button for interaction.
|-
| Ath:setText(string) || Sets the button text.
|-
| Ath:getText() || Returns the current button text.
|-
| Ath:setDescription(string) || Sets the button description.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets the main or hover color of the button.
|}

'''Example:'''
<syntaxhighlight lang="lua">
-- Create a button at position 200x300 with size 150x50
local myButton = DxButton:new("Click Me", 200, 300, 150, 50)

-- Show the button and enable hover effect
myButton:setVisible(true)
myButton:setHoverable(true)

-- Change text and color
myButton:setText("Press Me")
myButton:setColor(255, 0, 0, 255, "mainColor")
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxWindow:new]] – Page for window element reference
* [[DxLabel:new]] – Page for label element reference
* [[onClientRender]] – Event used to render DX elements

Astrath:createWindow

2025-10-22T18:49:37Z

Sybellex:

= DxWindow:new=

{{Client function}}
{{FuncDef|element DxWindow:new ( string title, float posX, float posY, float width, float height, table color, element parent, boolean relative, boolean header, float headerSize, table headerColor, string font, float fontsize )}}

'''Description:'''
Creates a new DX-based window element. The window can contain child DX elements, supports customization of colors, fonts, header, and can be attached to a parent element. Each window instance is automatically registered in the DX library for rendering and management.

'''Parameters:'''
* title (string) – The title text displayed on the window. Defaults to "New window" if not provided.
* posX (float) – X position on screen.
* posY (float) – Y position on screen.
* width (float) – Width of the window.
* height (float) – Height of the window.
* color (table / tocolor) – Main background color in RGBA. Optional.
* parent (element) – Parent DX element to attach this window to. Optional.
* relative (boolean) – If true, position will be calculated relative to parent. Optional.
* header (boolean) – If true, the window will display a header. Optional.
* headerSize (float) – Relative size of the header. Defaults to 5% of height.
* headerColor (table / tocolor) – Header color in RGBA. Defaults to tocolor(91, 57, 219, 255).
* font (string) – Font used for title text. Defaults to "default-bold".
* fontsize (float) – Font size multiplier. Defaults to 1.

'''Returns:'''
: Returns the newly created DX window element (DxWindow instance).

== Methods ==
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the window and all its child elements.
|-
| Ath:setTitle(title) || Sets a new title for the window.
|-
| Ath:setMovable(boolean) || Enables or disables window movement.
|-
| Ath:setVisible(boolean) || Shows or hides the window.
|-
| Ath:setEnabled(boolean) || Enables or disables window for interaction.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets the main or hover color of the window.
|}

'''Example:'''
<syntaxhighlight lang="lua">
-- Create a window at position 200x200 with size 300x200
local myWindow = DxWindow:new(
"My Window", 200, 200, 300, 200, tocolor(50, 50, 50, 255), nil, false, true, 0.05, nil, "default-bold", 1
)

-- Show window and enable hover
myWindow:setVisible(true)
myWindow:setHoverable(true)
</syntaxhighlight>

'''See also:'''
* [[DxButton:new]] – For creating buttons inside windows
* [[DxLabel:new]] – For adding text labels
* [[onClientRender]] – Event used to draw DX elements
* [[Astrath]] – Main library page

Astrath

2025-10-15T15:59:02Z

Sybellex:

= Astrath =

''Astrath'' is a DirectX framework for MTA:SA developed by '''Magath'''.
It provides tools to create custom interfaces, animations, and other DX-based visuals.

== Client Functions ==
* [[Astrath:createWindow]] – Creates a new DX-based window element
* [[Astrath:createButton]] – Creates a DX-based button element
* [[Astrath:createCheckBox]] – Creates a DX-based checkbox element
* [[Astrath:createComboBox]] – Creates a DX-based combobox element
* [[Astrath:createEditBox]] – Creates a DX-based editbox element
* [[Astrath:createGridList]] – Creates a DX-based gridlist element
* [[Astrath:createHidden]] – Creates a hidden DX element (used as a parent container)
* [[Astrath:createImage]] – Draws a DX-based image
* [[Astrath:createLabel]] – Creates a DX-based label element
* [[Astrath:createMemo]] – Creates a DX-based multi-line text element
* [[Astrath:createRadio]] – Creates a DX-based radio button element
* [[Astrath:createShape]] – Creates a drawable rectangle element (can be used as parent)
* [[Astrath:createTab]] – Creates a DX-based tab element
* [[Astrath:createTabPanel]] – Creates a container for tabs

== See Also ==
* [[dxDrawImage]]
* [[dxDrawText]]
* [[onClientRender]]

GetClosestPoint

2025-10-13T18:30:05Z

IManGaaX:

{{Useful Function}} __NOTOC__
<lowercasetitle></lowercasetitle>
This function finds the closest point from a given element to a list of points in 2D space.

[[Image:GetClosestPoint2.png|thumb|256px|right|[[Image:GetClosestPoint.png|256px|right]]The difference between code No. 1 and code No. 2. The example in the image and below uses code No. 1.]]

{{Note|The example in the image and below uses code No. 1.}}

==Syntax==
<syntaxhighlight lang="lua">float, float, float getClosestPoint( element theElement, table thePoints )</syntaxhighlight>

===Required Arguments===
* '''theElement''': the element whose position is used as the reference.
* '''thePoints''': a table containing coordinates in the form {x, y, z}.

===Returns===
* Returns three ''float''s indicating the position of the element, ''x'', ''y'' and ''z'' respectively of the closest point.

==Code (1)==
<section name="Shared" class="both" show="true">
<syntaxhighlight lang="lua">
function getClosestPoint(element, points)
local ex, ey, ez = getElementPosition(element)
local closestDist = math.huge
local closestPoint = nil

for _, p in ipairs(points) do
local dx, dy = p[1] - ex, p[2] - ey
local dist = dx*dx + dy*dy

if dist < closestDist then
closestDist = dist
closestPoint = p
end
end

return unpack(closestPoint)
end
</syntaxhighlight>
</section>

==Code (2)==
<section name="Shared" class="both" show="true">
<syntaxhighlight lang="lua">
function getClosestPoint(element, points)
local ex, ey, ez = getElementPosition(element)
local closestDist = math.huge
local closestPoint = nil

for i = 1, #points - 1 do
local x1, y1, z1 = unpack(points[i])
local x2, y2, z2 = unpack(points[i + 1])

local t = ((ex - x1) * (x2 - x1) + (ey - y1) * (y2 - y1)) / ((x2 - x1)^2 + (y2 - y1)^2)
t = math.max(0, math.min(1, t))

local px, py = x1 + t * (x2 - x1), y1 + t * (y2 - y1)
local dist = (ex - px)^2 + (ey - py)^2
if dist < closestDist then
closestDist = dist
closestPoint = {px, py, z1 + t * (z2 - z1)}
end
end

return unpack(closestPoint)
end
</syntaxhighlight>
</section>

'''Author:''' [[User:IManGaaX|Youssef Maged (iManGaaX)]]

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local lanePoints = {
{2469.95850, -1675.36279, 14},
{2489.37866, -1653.80859, 14},
{2508.62891, -1662.11462, 14},
}

local xyz = {getClosestPoint(localPlayer, lanePoints)} --// Code (1), See the images above
outputChatBox("Closest Lane Point: "..table.concat(xyz, ", "))
</syntaxhighlight>
</section>

==See Also==

{{Useful_Functions}}

BR-PT/setElementPosition

2025-09-05T23:59:06Z

Lettify: Lettify moved page BR-PT/setElementPosition to PT-BR/setElementPosition: Wrongly titled during creation

__NOTOC__
{{BR/Funcao compartilhada}}
Esta função define a posição de um elemento para as coordenadas especificadas.
{{BR/Warning|Não use essa função para ''spawnar'' um [[Elemento/Player|jogador]]. Isso vai causar problemas com outras funções, como [[warpPedIntoVehicle]]. Em vez disso, use [[spawnPlayer]].}}

==Sintaxe==
<syntaxhighlight lang="lua">
bool setElementPosition ( element theElement, float x, float y, float z [, bool warp = true ] )
</syntaxhighlight>
{{BR/OOP||[[PT-BR/Elemento|elemento]]:setPosition|position|getElementPosition}}

===Argumentos Necessários===
*'''theElement:''' Um [[PT-BR/Elemento|elemento]] válido para ser movido.
*'''x:''' A coordenada '''X''' de destino.
*'''y:''' A coordenada '''Y''' de destino.
*'''z:''' A coordenada '''Z''' de destino.

===Argumentos Opcionais===
*'''warp:''' teletransporta o jogador, resetando qualquer animação que esteja rodando. Definindo esse argumento com ''false'', a animação permanecerá.

===Retorno===
Retorna ''true'' se foi executado com sucesso, caso contrário retorna ''false''.

==Exemplo==
<section name="Server" class="server" show="true">
Este exemplo permite que os administradores teletransportem 5 jogadores aleatórios para si mesmos
<syntaxhighlight lang="lua">
function randomPlayersToLocation(p)
if not isPlayerStaff(p) then return end

local playersOnline = getElementsByType("player")
local amount = #playersOnline

if amount == 0 then return end

for index = 1,(amount > 5 and 5 or amount) do
local player = playersOnline[index]
setElementPosition(player, getElementPosition(p))
end
end
addCommandHandler("randomtp", randomPlayersToLocation)
addCommandHandler("playershere", randomPlayersToLocation)

-- Utilitário
local staffACLs = {
aclGetGroup("Admin"),
aclGetGroup("Moderator")
}

function isPlayerStaff(p)
if isElement(p) and getElementType(p) == "player" and not isGuestAccount(getPlayerAccount(p)) then
local object = getAccountName(getPlayerAccount(p))

for _, group in ipairs(staffACLs) do
if isObjectInACLGroup("user." .. object, group) then
return true
end
end
end
return false
end
</syntaxhighlight>
</section>

Se você quiser colocar um veículo ou jogador fora da água ou simular o comportamento de redefinição de posição caso CJ fique muito abaixo do solo, será necessário recuperar uma coordenada recomendada no solo para colocar o elemento. Dê uma olhada [https://forum.mtasa.com/topic/132891-important-helprespawn-vehicle/?do=findComment&comment=1003198 nesse posto do Fórum do MTA] para os passos na direção certa.

==Problemas==
{{Issues|
{{Issue|539|Alterar a posição do jogador quando ele/ela tiver um jetpack removerá o jetpack e o bug quando a skin for alterada}}
{{Issue|529|Jogador cai da bicicleta quando ela é teletransportada por setElementPosition}}
}}

==Veja também==
{{Element functions}}

[[hu:setElementPosition]]
[[ru:setElementPosition]]

GetColorName

2025-09-05T11:13:36Z

IManGaaX:

{{Useful Function}} __NOTOC__
<lowercasetitle></lowercasetitle>
This function retrieves the nearest color name for a given RGB value using an online API.

{{Note|This function requires an active internet connection and fetches the color name from an external API asynchronously. The result is returned via a callback function.}}

==Syntax==
<syntaxhighlight lang="lua">getColorName( int r, int g, int b, function callback(name) )</syntaxhighlight>

===Required Arguments===
* '''r''': Red component (0-255) of the color.
* '''g''': Green component (0-255) of the color.
* '''b''': Blue component (0-255) of the color.
* '''callback''': A function that will receive the color name as a string.

===Returns===
* Does not return a value directly.
* Calls the 'callback' function with the color name when the API responds.
* Possible callback values:
* 'Error' if the request failed.
* 'Unknown' if the API did not return a valid name.
* Color name string, e.g., 'Dark Orange'.

==Code==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function getColorName(r, g, b, callback)
local url = string.format("https://www.thecolorapi.com/id?rgb=rgb(%d,%d,%d)", r, g, b)
fetchRemote(url, function(data, errno)
if errno == 0 then
local result = fromJSON(data)
if result and result.name and result.name.value then
callback(tostring(result.name.value))
else
callback("Unknown")
end
else
callback("Error")
end
end, "", true)
end
</syntaxhighlight>
</section>

'''Author:''' [[User:IManGaaX|Youssef Maged (iManGaaX)]]

==Examples==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
getColorName(255, 127, 0, function(name)
outputChatBox("Color Name: "..name)
end)
</syntaxhighlight>
<syntaxhighlight lang="lua">
local imangaax = getPlayerFromName("iManGaaX")
local r, g, b = getVehicleColor(getPedOccupiedVehicle(imangaax))
getColorName(r, g, b, function(name)
outputChatBox("Your Vehicle Color Name: "..name, imangaax)
end)
</syntaxhighlight>
<syntaxhighlight lang="lua">
-- If a player owns a vehicle and you want to retrieve detailed information about the vehicle, such as its color name
</syntaxhighlight>
</section>

==See Also==

{{Useful_Functions}}

Table.flatten

2025-09-05T10:12:32Z

IManGaaX:

{{Useful Function}} __NOTOC__
<lowercasetitle></lowercasetitle>
This function converts a nested table into a flattened table with concatenated keys.

{{Note|This function recursively traverses all nested subtables and creates a new table where keys represent the original hierarchy using dot notation.}}

==Syntax==
<syntaxhighlight lang="lua">table table.flatten( table t, [ string prefix = "" ] )</syntaxhighlight>

===Required Arguments===
* '''t''': the nested table to flatten.

===Optional Arguments===
{{OptionalArg}}
* '''prefix''': a string to prepend to all keys (used internally for recursion).

===Returns===
* A new table where all nested keys are flattened using dot notation.

==Code==
<section name="Shared" class="both" show="true">
<syntaxhighlight lang="lua">
function table.flatten(t, prefix)
local flat = {}
prefix = prefix or ""
for k,v in pairs(t) do
local key = prefix .. k
if type(v) == "table" then
local sub = table.flatten(v, key..".")
for sk, sv in pairs(sub) do
flat[sk] = sv
end
else
flat[key] = v
end
end
return flat
end
</syntaxhighlight>
</section>

'''Author:''' [[User:IManGaaX|Youssef Maged (iManGaaX)]]

==Example==
<section name="Shared" class="both" show="true">
<syntaxhighlight lang="lua">
local nestedData = {
player = {
stats = {
hp = 100,
mp = 50
},
level = 5
}
}

local flatData = table.flatten(nestedData)
for k, v in pairs(flatData) do
outputChatBox(k .. " = " .. tostring(v))
end
-- Output:
-- player.stats.hp = 100
-- player.stats.mp = 50
-- player.level = 5
</syntaxhighlight>
</section>

==See Also==

{{Useful_Functions}}

GetServerAveragePing

2025-09-03T00:31:08Z

O22:

{{Useful Function}}
__NOTOC__
This function gets average players ping.

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

===Returns===
Returns the average players ping as integer.
<br>
Returns '''0''' if no players are online.

==Code==
<section name="Shared" class="both" show="true">
<syntaxhighlight lang="lua">
function getAveragePing()
local players = getElementsByType("player")
if #players == 0 then
return 0
end

local totalPing = 0
for _, player in ipairs(players) do
totalPing = totalPing + getPlayerPing(player)
end

return math.floor(totalPing / #players)
end
</syntaxhighlight>
</section>

==Example==
The example shows how to use function.
<section name="Shared" class="both" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("avgping", function()
local avg = getAveragePing()
if avg > 0 then
print("Average Ping: " .. avg .. " ms")
else
print("No players online.")
end
end)
</syntaxhighlight>
</section>

<br>
Author: [https://wiki.multitheftauto.com/wiki/User:O22 omar-o22]
==See Also==
{{Useful_Functions}}

DgsGIFGetSize

2025-08-23T22:59:08Z

Lettify: Created page with "__NOTOC__ {{Client function}} Returns the dimensions (width and height) of a GIF element created using dgsCreateGIF. The values correspond to the original size extracted from the GIF file during loading. ==Syntax== <syntaxhighlight lang="lua"> int int dgsGIFGetSize( element gif ) </syntaxhighlight> ===Required Arguments=== *'''gif: ''' The '''dgs-dxgif''' type element you want to get the size of. ===Returns=== Returns two integers corresponding to ''width'' an..."

__NOTOC__
{{Client function}}

Returns the dimensions (width and height) of a GIF element created using [[dgsCreateGIF]]. The values correspond to the original size extracted from the GIF file during loading.

==Syntax==
<syntaxhighlight lang="lua">
int int dgsGIFGetSize( element gif )
</syntaxhighlight>

===Required Arguments===
*'''gif: ''' The '''dgs-dxgif''' type element you want to get the size of.

===Returns===
Returns two integers corresponding to ''width'' and ''height''

==Example==
<syntaxhighlight lang="lua">
-- This script should be executed on the client-side

-- Import the DGS functions to use them from another resource
local DGS = exports.dgs

-- 1. Load the GIF from a file within your resource
local myAnimatedGif = DGS.dgsCreateGIF("files/loading.gif")

-- 2. Check if the GIF was loaded successfully before proceeding
if myAnimatedGif then
-- 3. Use dgsGIFGetSize to get the width and height of the loaded GIF
local width, height = DGS.dgsGIFGetSize(myAnimatedGif)

-- 4. Display the dimensions in the chat to confirm the result
outputChatBox(string.format("The loaded GIF has the dimensions: %d width by %d height.", width, height))

-- 5. Practical example: Create a DGS image in the center of the screen
-- using the 'width' and 'height' we just obtained so the size is perfect.
local screenW, screenH = guiGetScreenSize()
local posX = screenW / 2 - width / 2
local posY = screenH / 2 - height / 2

local gifImage = DGS.dgsCreateImage(posX, posY, width, height, myAnimatedGif, false)

-- Start the GIF's animation
DGS.dgsGIFPlay(myAnimatedGif)
else
-- Inform the user if the GIF was not found or if an error occurred during loading
outputChatBox("Error: Could not load the GIF file.", 255, 0, 0)
end

</syntaxhighlight>

==See Also==
{{DGS_Plugin/Gif}}

DgsCreateGIF

2025-08-23T10:27:29Z

Thisdp:

__NOTOC__
{{Client function}}

This function creates a GIF interface plugin.

==Syntax==
<syntaxhighlight lang="lua">
element dgsCreateGIF( string pathOrRaw )
</syntaxhighlight>

===Required Arguments===
*'''pathOrRaw: ''' A string representing the path to your GIF file, or the raw GIF data

===Returns===
Returns a dgs-dxgif element (DGS Plugin Type)[ dgs-dxgif (Element Type) ] if succeed, ''false'' otherwise

==Example==
<syntaxhighlight lang="lua">
DGS = exports.dgs --get exported functions from dgs

local gif = DGS:dgsCreateGIF("test.gif")
DGS:dgsGIFPlay(gif,1) --Play GIF with Speed 1x
image = DGS:dgsCreateImage(500,500,200,200,gif,false)

</syntaxhighlight>

==See Also==
{{DGS_Plugin/Gif}}

OnPedWeaponReload

2025-08-17T21:15:59Z

-ffs-PLASMA:

__NOTOC__
{{Server event}}
{{Added feature/item|1.6.1|1.6.0|22909|Event has been added.}}

This event is triggered when a ped reloads his weapons.

==Parameters==
<syntaxhighlight lang="lua">
int weapon, int clip, int ammo
</syntaxhighlight>

*'''weapon''': an [[int]] representing the [[weapon]] that has been reloaded.
*'''clip''': an [[int]] representing the [[weapon]] clip size.
*'''ammo''': an [[int]] representing the [[weapon]] ammo.

==Source==
The [[event system#Event source|source]] of this event is the [[ped]] that reloaded his weapon.

==Example==
This example outputs a line to the chat box whenever a ped reloads weapons.
<syntaxhighlight lang="lua">
function weaponReload(iWeaponID, iClip, iAmmo)
outputChatBox("A ped reloaded "..getWeaponNameFromID(iWeaponID)..", clip: "..iClip..", ammo: "..iAmmo.."!");
end
addEventHandler("onPedWeaponReload", root, weaponReload);
</syntaxhighlight>

{{See also/Server event|Ped events}}

AR/getDiscordRichPresenceUserID

2025-08-06T01:39:16Z

O22: Created page with "__NOTOC__ {{Client function}} {{Important Note|ستُعيد الدالة معرف المستخدم بشكل صحيح إذا كان المستخدم قد منح الموافقة مسبقًا ومتصل بتطبيق Rich Presence.}} {{New feature/item|3.0161|1.6.0|22342| تُعيد الدالة معرف مستخدم Discord الخاص بالعميل. }} ==التركيب== <syntaxhighlight lang="lua"> string getDiscordRichPresenceUserID() </syntaxhighlight> ===الق..."

__NOTOC__
{{Client function}}
{{Important Note|ستُعيد الدالة معرف المستخدم بشكل صحيح إذا كان المستخدم قد منح الموافقة مسبقًا ومتصل بتطبيق Rich Presence.}}
{{New feature/item|3.0161|1.6.0|22342|
تُعيد الدالة معرف مستخدم Discord الخاص بالعميل.
}}

==التركيب==
<syntaxhighlight lang="lua">
string getDiscordRichPresenceUserID()
</syntaxhighlight>

===القيم المرجعة===
ستعيد سلسلة فارغة ("") إذا لم يمنح المستخدم الموافقة أو قام بتعطيل خيار تزامن Rich Presence. وإلا، ستعيد المعرف كسلسلة نصية.

==مثال==
يعرض هذا المثال معرف المستخدم الخاص به في الدردشة إذا كان قد منح الإذن بمشاركة البيانات. وإلا، سيظهر له رسالة مناسبة.
<syntaxhighlight lang="lua">
addCommandHandler("getmyuserid",
function ()
if isDiscordRichPresenceConnected() then
local id = getDiscordRichPresenceUserID()
if id == "" then
outputChatBox("لم تسمح بمشاركة بيانات Discord! قم بمنح الإذن في الإعدادات!")
else
outputChatBox("معرف Discord الخاص بك: "..id)
end
end
end
)
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:IsDiscordRichPresenceConnected]]
[[de:isDiscordRichPresenceConnected]]
[[hu:isDiscordRichPresenceConnected]]
[[pl:isDiscordRichPresenceConnected]]
[[ro:isDiscordRichPresenceConnected]]
[[ru:IsDiscordRichPresenceConnected]]
[[PT-BR:IsDiscordRichPresenceConnected]]

AR/setDiscordRichPresenceEndTime

2025-08-06T01:33:46Z

O22: Created page with "__NOTOC__ {{Client function}} {{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام setDiscordApplicationID}} {{New feature/item|3.0161|1.6.0|22276| تقوم هذه الدالة بتعيين الوقت المتبقي في Discord Rich Presence. }} ==التركيب== <syntaxhighlight lang="lua"> bool setDiscordRichPresenceEndTime(int seconds) </syntaxhighlight> {{OOP||..."

__NOTOC__
{{Client function}}
{{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام [[AR/setDiscordApplicationID|setDiscordApplicationID]]}}
{{New feature/item|3.0161|1.6.0|22276|
تقوم هذه الدالة بتعيين الوقت المتبقي في Discord Rich Presence.
}}

==التركيب==
<syntaxhighlight lang="lua">
bool setDiscordRichPresenceEndTime(int seconds)
</syntaxhighlight>
{{OOP||[[DiscordRPC]]:setEndTime}}

===المعطيات المطلوبة===
*'''seconds''': عدد صحيح يُمثّل عدد الثواني المتبقية. إذا كانت القيمة 0 أو أقل من وقت البدء ([[AR/setDiscordRichPresenceStartTime|setDiscordRichPresenceStartTime]]) فلن يتم عرض المؤقت.

===القيم المرجعة===
تعيد الدالة ''true'' إذا نجحت العملية، و ''false'' خلاف ذلك.

==مثال==
يعرض هذا المثال كيفية تغيير مؤقت الوقت المتبقي في تطبيق Discord Rich Presence.
<syntaxhighlight lang="lua">
local app_id = "معرّف_تطبيقك_الخاص"
if setDiscordApplicationID(app_id) then
setDiscordRichPresenceState("داخل اللعبة")
setDiscordRichPresenceStartTime(1)
setDiscordRichPresenceEndTime(60) -- دقيقة واحدة متبقية
end
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:SetDiscordRichPresenceDetails]]
[[de:setDiscordRichPresenceDetails]]
[[hu:setDiscordRichPresenceDetails]]
[[pl:setDiscordRichPresenceDetails]]
[[ro:setDiscordRichPresenceDetails]]
[[ru:SetDiscordRichPresenceDetails]]
[[PT-BR:SetDiscordRichPresenceDetails]]

AR/setDiscordRichPresenceStartTime

2025-08-06T01:30:38Z

O22: Created page with "__NOTOC__ {{Client function}} {{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام setDiscordApplicationID}} {{New feature/item|3.0161|1.6.0|22276| تقوم هذه الدالة بتعيين الوقت المنقضي في Discord Rich Presence. }} ==التركيب== <syntaxhighlight lang="lua"> bool setDiscordRichPresenceStartTime(int seconds) </syntaxhighlight> {{OOP..."

__NOTOC__
{{Client function}}
{{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام [[AR/setDiscordApplicationID|setDiscordApplicationID]]}}
{{New feature/item|3.0161|1.6.0|22276|
تقوم هذه الدالة بتعيين الوقت المنقضي في Discord Rich Presence.
}}

==التركيب==
<syntaxhighlight lang="lua">
bool setDiscordRichPresenceStartTime(int seconds)
</syntaxhighlight>
{{OOP||[[DiscordRPC]]:setStartTime}}

===المعطيات المطلوبة===
*'''seconds''': عدد صحيح يُمثّل عدد الثواني المنقضية. إذا كانت القيمة 0، فلن يتم عرض المؤقت.

===القيم المرجعة===
تعيد الدالة ''true'' إذا نجحت العملية، و ''false'' خلاف ذلك.

==مثال==
يعرض هذا المثال كيفية تغيير مؤقت الوقت المنقضي في تطبيق Discord Rich Presence.
<syntaxhighlight lang="lua">
local app_id = "معرّف_تطبيقك_الخاص"
if setDiscordApplicationID(app_id) then
setDiscordRichPresenceState("داخل اللعبة")
setDiscordRichPresenceStartTime(1)
end
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:SetDiscordRichPresenceDetails]]
[[de:setDiscordRichPresenceDetails]]
[[hu:setDiscordRichPresenceDetails]]
[[pl:setDiscordRichPresenceDetails]]
[[ro:setDiscordRichPresenceDetails]]
[[ru:SetDiscordRichPresenceDetails]]
[[PT-BR:SetDiscordRichPresenceDetails]]

AR/setDiscordRichPresencePartySize

2025-08-06T01:27:04Z

O22: Created page with "__NOTOC__ {{Client function}} {{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام setDiscordApplicationID}} {{Note|لكي يتم عرض حجم المجموعة، يجب تعيين الحالة باستخدام setDiscordRichPresenceState}} {{New feature/item|3.0161|1.6.0|22276| تقوم هذه الدالة بتعيين حجم المج..."

__NOTOC__
{{Client function}}
{{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام [[AR/setDiscordApplicationID|setDiscordApplicationID]]}}
{{Note|لكي يتم عرض حجم المجموعة، يجب تعيين الحالة باستخدام [[AR/setDiscordRichPresenceState|setDiscordRichPresenceState]]}}
{{New feature/item|3.0161|1.6.0|22276|
تقوم هذه الدالة بتعيين حجم المجموعة في Discord Rich Presence.
}}

==التركيب==
<syntaxhighlight lang="lua">
bool setDiscordRichPresencePartySize(int size, int max)
</syntaxhighlight>
{{OOP||[[DiscordRPC]]:setPartySize}}

===المعطيات المطلوبة===
*'''size''': عدد صحيح يمثل حجم المجموعة الحالي.
*'''max''': عدد صحيح يمثل الحد الأقصى لحجم المجموعة.

'''إذا كانت القيمتان 0، فلن يتم عرض حجم المجموعة.'''

===القيم المرجعة===
تعيد الدالة ''true'' إذا نجحت العملية، و ''false'' خلاف ذلك.

==مثال==
يعرض هذا المثال كيفية تغيير حجم المجموعة (Party Size) في تطبيق Discord Rich Presence.
<syntaxhighlight lang="lua">
local app_id = "معرّف_تطبيقك_الخاص"
if setDiscordApplicationID(app_id) then
setDiscordRichPresenceState("داخل اللعبة")
setDiscordRichPresencePartySize(1, 32)
end
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:SetDiscordRichPresenceDetails]]
[[de:setDiscordRichPresenceDetails]]
[[hu:setDiscordRichPresenceDetails]]
[[pl:setDiscordRichPresenceDetails]]
[[ro:setDiscordRichPresenceDetails]]
[[ru:SetDiscordRichPresenceDetails]]
[[PT-BR:SetDiscordRichPresenceDetails]]

AR/setDiscordRichPresenceState

2025-08-06T00:14:56Z

O22: Created page with "__NOTOC__ {{Client function}} {{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام setDiscordApplicationID}} {{New feature/item|3.0161|1.6.0|22270| تقوم هذه الدالة بتعيين الحالة لتطبيق Discord Rich Presence. }} ==التركيب== <syntaxhighlight lang="lua"> bool setDiscordRichPresenceState(string state) </syntaxhighlight> {{OOP||Disc..."

__NOTOC__
{{Client function}}
{{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام [[AR/setDiscordApplicationID|setDiscordApplicationID]]}}
{{New feature/item|3.0161|1.6.0|22270|
تقوم هذه الدالة بتعيين الحالة لتطبيق Discord Rich Presence.
}}

==التركيب==
<syntaxhighlight lang="lua">
bool setDiscordRichPresenceState(string state)
</syntaxhighlight>
{{OOP||[[DiscordRPC]]:setState}}

===المعطيات المطلوبة===
*'''state''': سلسلة نصية تحتوي على نص الحالة.

===القيم المرجعة===
تعيد الدالة ''true'' إذا نجحت العملية، و ''false'' خلاف ذلك.

==مثال==
يعرض هذا المثال كيفية تعيين الحالة في تطبيق Discord Rich Presence.
<syntaxhighlight lang="lua">
local app_id = "معرّف_تطبيقك_الخاص"
if setDiscordApplicationID(app_id) then
setDiscordRichPresenceState("في انتظار في الردهة")
end
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:SetDiscordRichPresenceState]]
[[de:setDiscordRichPresenceState]]
[[hu:setDiscordRichPresenceState]]
[[pl:setDiscordRichPresenceState]]
[[ro:setDiscordRichPresenceState]]
[[ru:SetDiscordRichPresenceState]]
[[PT-BR:SetDiscordRichPresenceState]]

AR/setDiscordRichPresenceSmallAsset

2025-08-06T00:11:02Z

O22: /* Syntax */

__NOTOC__
{{Client function}}
{{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام [[AR/setDiscordApplicationID|setDiscordApplicationID]]}}
{{New feature/item|3.0161|1.6.0|22270|
باستخدام هذه الدالة، يمكنك تعيين صورة الأصل الصغيرة (small asset) للتطبيق.
الحد الأقصى لحجم الصور هو ''1024 x1024''، والحد الأدنى هو ''512 x512''.
}}

==التركيب==
<syntaxhighlight lang="lua">
bool setDiscordRichPresenceSmallAsset(string assetImage, string text)
</syntaxhighlight>
{{OOP||[[DiscordRPC]]:setSmallAsset}}

===المعطيات المطلوبة===
*'''assetImage''': سلسلة نصية تحتوي على مفتاح الصورة التي قمت برفعها في قائمة الأصول الخاصة بتطبيقك.
*'''text''': سلسلة نصية تُعرض عندما يقوم أحدهم بتحويم الماوس فوق الصورة الكبيرة في Discord.

===القيم المرجعة===
تعيد الدالة ''true'' إذا نجحت العملية، و ''false'' خلاف ذلك.

==مثال==
المثال يقوم بتعيين الصورة الكبيرة إلى my_small_logo.
<syntaxhighlight lang="lua">
addCommandHandler("setsmalllogo",
function ()
if isDiscordRichPresenceConnected() then
setDiscordRichPresenceSmallAsset("my_small_logo", "!هذا هو شعاري الصغير")
end
end
)
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:SetDiscordRichPresenceAsset]]
[[de:setDiscordRichPresenceAsset]]
[[hu:setDiscordRichPresenceAsset]]
[[pl:setDiscordRichPresenceAsset]]
[[ro:setDiscordRichPresenceAsset]]
[[ru:SetDiscordRichPresenceAsset]]
[[PT-BR:SetDiscordRichPresenceAsset]]

AR/setDiscordRichPresenceDetails

2025-08-06T00:01:52Z

O22: Created page with "__NOTOC__ {{Client function}} {{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام setDiscordApplicationID}} {{New feature/item|3.0161|1.6.0|22270| تقوم هذه الدالة بتعيين نص التفاصيل في Discord Rich Presence. }} ==التركيب== <syntaxhighlight lang="lua"> bool setDiscordRichPresenceDetails(string details) </syntaxhighlight> {{OOP||[..."

__NOTOC__
{{Client function}}
{{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام [[AR/setDiscordApplicationID|setDiscordApplicationID]]}}
{{New feature/item|3.0161|1.6.0|22270|
تقوم هذه الدالة بتعيين نص التفاصيل في Discord Rich Presence.
}}

==التركيب==
<syntaxhighlight lang="lua">
bool setDiscordRichPresenceDetails(string details)
</syntaxhighlight>
{{OOP||[[DiscordRPC]]:setDetails}}

===القيم المطلوبة===
*'''details''': سلسلة نصية تحتوي على نص التفاصيل.

===القيم المرجعة===
تعيد الدالة ''true'' إذا نجحت العملية، و ''false'' خلاف ذلك.

==مثال==
يعرض هذا المثال كيفية تغيير الحالة والتفاصيل في تطبيق Discord Rich Presence.
<syntaxhighlight lang="lua">
local app_id = "معرّف_تطبيقك_الخاص"
if setDiscordApplicationID(app_id) then
local name = getPlayerName(localPlayer)
setDiscordRichPresenceState("داخل اللعبة")
setDiscordRichPresenceDetails("حالياً باسم "..name)
end
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:SetDiscordRichPresenceDetails]]
[[de:setDiscordRichPresenceDetails]]
[[hu:setDiscordRichPresenceDetails]]
[[pl:setDiscordRichPresenceDetails]]
[[ro:setDiscordRichPresenceDetails]]
[[ru:SetDiscordRichPresenceDetails]]
[[PT-BR:SetDiscordRichPresenceDetails]]

AR/setDiscordRichPresenceButton

2025-08-05T23:55:28Z

O22: Created page with "__NOTOC__ {{Client function}} {{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام setDiscordApplicationID}} {{New feature/item|3.0161|1.6.0|22270| تقوم هذه الدالة بتعيين زر مخصص يمكن من خلاله الوصول إلى موقع ويب على Discord. }} ==التركيب== <syntaxhighlight lang="lua"> bool setDiscordRichPresenceButton(int..."

__NOTOC__
{{Client function}}
{{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام [[AR/setDiscordApplicationID|setDiscordApplicationID]]}}
{{New feature/item|3.0161|1.6.0|22270|
تقوم هذه الدالة بتعيين زر مخصص يمكن من خلاله الوصول إلى موقع ويب على Discord.
}}

==التركيب==
<syntaxhighlight lang="lua">
bool setDiscordRichPresenceButton(int index, string text, string url)
</syntaxhighlight>
{{OOP||[[DiscordRPC]]:setButton}}

===المعطيات المطلوبة===
*'''index''': رقم صحيح (int) يُمثّل ترتيب الزر (القيم الممكنة: 1 أو 2)
*'''text''': سلسلة نصية تحتوي على عنوان الزر
*'''url''': سلسلة نصية تحتوي على رابط الزر (يعمل فقط مع '''https://''' أو '''mtasa://''')

===القيم المرجعة===
تعيد الدالة ''true'' إذا نجحت العملية، و ''false'' خلاف ذلك.

==مثال==
يعرض هذا المثال كيفية إنشاء زرين مخصصين في تطبيق Discord Rich Presence الخاص بنا.
<syntaxhighlight lang="lua">
local app_id = "معرف_تطبيقك_الخاص"
if setDiscordApplicationID(app_id) then
setDiscordRichPresenceButton(1, "الاتصال بالسيرفر", "mtasa://youraddressip")
setDiscordRichPresenceButton(2, "الصفحة الرئيسية لـ MTA", "https://mtasa.com")
end
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:SetDiscordRichPresenceButton]]
[[de:setDiscordRichPresenceButton]]
[[hu:setDiscordRichPresenceButton]]
[[pl:setDiscordRichPresenceButton]]
[[ro:setDiscordRichPresenceButton]]
[[ru:SetDiscordRichPresenceButton]]
[[PT-BR:SetDiscordRichPresenceButton]]

AR/setDiscordRichPresenceAsset

2025-08-05T23:50:08Z

O22: Created page with "__NOTOC__ {{Client function}} {{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام setDiscordApplicationID}} {{New feature/item|3.0161|1.6.0|22270| باستخدام هذه الدالة يمكنك تعيين صورة الأصل الكبيرة (large image asset) للتطبيق. الحد الأقصى لحجم الصور هو ''1024 x1024''، والحد الأدنى هو..."

__NOTOC__
{{Client function}}
{{Important Note|لاستخدام هذه الدالة، يجب عليك إعداد تطبيقك الخاص باستخدام [[AR/setDiscordApplicationID|setDiscordApplicationID]]}}
{{New feature/item|3.0161|1.6.0|22270|
باستخدام هذه الدالة يمكنك تعيين صورة الأصل الكبيرة (large image asset) للتطبيق.
الحد الأقصى لحجم الصور هو ''1024 x1024''، والحد الأدنى هو ''512 x512''.
}}

==التركيب==
<syntaxhighlight lang="lua">
bool setDiscordRichPresenceAsset(string assetImage, string text)
</syntaxhighlight>
{{OOP||[[DiscordRPC]]:setAsset}}

===المعطيات المطلوبة===
*'''assetImage''': سلسلة نصية تحتوي على مفتاح الصورة التي قمت برفعها في قائمة الأصول الخاصة بتطبيقك.
*'''text''': سلسلة نصية تُعرض عندما يقوم أحدهم بتحويم الماوس فوق الصورة الكبيرة في Discord.

===القيم المرجعة===
تعيد الدالة ''true'' إذا نجحت العملية، و ''false'' خلاف ذلك.

==مثال==
المثال يقوم بتعيين الصورة الكبيرة إلى my_logo.
<syntaxhighlight lang="lua">
addCommandHandler("setlogo",
function ()
if isDiscordRichPresenceConnected() then
setDiscordRichPresenceAsset("my_logo", "هذا هو شعاري!")
end
end
)
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:SetDiscordRichPresenceAsset]]
[[de:setDiscordRichPresenceAsset]]
[[hu:setDiscordRichPresenceAsset]]
[[pl:setDiscordRichPresenceAsset]]
[[ro:setDiscordRichPresenceAsset]]
[[ru:SetDiscordRichPresenceAsset]]
[[PT-BR:SetDiscordRichPresenceAsset]]

AR/setDiscordApplicationID

2025-08-05T23:44:25Z

O22: Created page with "__NOTOC__ {{Client function}} {{Important Note|لإعادة ضبط معرف التطبيق، يرجى استخدام resetDiscordRichPresenceData}} {{Important Note|لكي تعمل الدالة بشكل صحيح، يجب أن يكون لدى المستخدم إعداد الخصوصية/الحالة مفعل في Discord.}} {{New feature/item|3.0161|1.6.0|22270| تتيح هذه الدالة تعيين تطبيقك الخاص للاست..."

__NOTOC__
{{Client function}}
{{Important Note|لإعادة ضبط معرف التطبيق، يرجى استخدام [[AR/resetDiscordRichPresenceData|resetDiscordRichPresenceData]]}}
{{Important Note|لكي تعمل الدالة بشكل صحيح، يجب أن يكون لدى المستخدم إعداد الخصوصية/الحالة مفعل في Discord.}}
{{New feature/item|3.0161|1.6.0|22270|
تتيح هذه الدالة تعيين تطبيقك الخاص للاستخدام في Rich Presence.
يمكنك إنشاء تطبيقك الخاص '''[https://discord.com/developers/applications هنا]'''
}}

==التركيب==
<syntaxhighlight lang="lua">
bool setDiscordApplicationID(string applicationID)
</syntaxhighlight>
{{OOP||[[DiscordRPC]]:setApplication}}

===المعطيات المطلوبة===
*'''applicationID''': سلسلة نصية تمثل معرف تطبيق Discord الخاص بك.
===القيم المرجعة===
تعيد الدالة ''true'' إذا نجحت العملية، و ''false'' إذا قام العميل بتعطيل خاصية Rich Presence.

==مثال==
هذا المثال يعرض ما إذا تم إعداد التطبيق بنجاح ويعيّن صورة مخصصة (custom asset).
<syntaxhighlight lang="lua">
local app_id = "معرف_التطبيق_الخاص_بك"
if setDiscordApplicationID(app_id) then
setDiscordRichPresenceAsset("asset_name_from_application")
outputChatBox("رائع، نحن الآن نستخدم تطبيقنا الخاص!")
end
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:setDiscordApplicationID]]
[[de:setDiscordApplicationID]]
[[hu:setDiscordApplicationID]]
[[pl:setDiscordApplicationID]]
[[ro:setDiscordApplicationID]]
[[ru:SetDiscordApplicationID]]
[[PT-BR:SetDiscordApplicationID]]

AR/resetDiscordRichPresenceData

2025-08-05T23:05:16Z

O22: /* Syntax */

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6.0|22270|
تعيد هذه الوظيفة إعدادات Discord Rich Presence إلى الوضع الافتراضي.
}}

==التركيب==
<syntaxhighlight lang="lua">
bool resetDiscordRichPresenceData()
</syntaxhighlight>

===القيم المرجعة===
ترجع الدالة ''true'' إذا نجحت العملية، و ''false'' إذا فشلت.

==مثال==
يعرض هذا المثال كيفية إعادة ضبط Discord Rich Presence بعد استخدام تطبيق مخصص.
<syntaxhighlight lang="lua">
setDiscordApplicationID("you_application_key")
setDiscordRichPresenceAsset("asset_logo", "Name of Asset")
if resetDiscordRichPresenceData() then -- نقوم بإعادة الضبط إلى الوضع الافتراضي باستخدام تطبيق MTA.
outputChatBox("تمت إعادة Discord Rich Presence إلى الوضع الافتراضي.")
end
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:ResetDiscordRichPresenceData]]
[[de:resetDiscordRichPresenceData]]
[[hu:resetDiscordRichPresenceData]]
[[pl:resetDiscordRichPresenceData]]
[[ro:resetDiscordRichPresenceData]]
[[ru:ResetDiscordRichPresenceData]]
[[PT-BR:ResetDiscordRichPresenceData]]

AR/isDiscordRichPresenceConnected

2025-08-05T23:02:08Z

O22:

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6.0|22270|
تتحقق الوظيفة مما إذا كان العميل لديه Discord Rich Presence مفعل.
}}

==التركيب==
<syntaxhighlight lang="lua">
bool isDiscordRichPresenceConnected()
</syntaxhighlight>
{{OOP||[[DiscordRPC]]:isConnected}}

===القيم المرجعة===
ترجع الدالة ''true'' إذا كانت خاصية Discord Rich Presence مفعّلة على العميل، و ''false'' إذا كانت غير مفعّلة.

==مثال==
يعرض هذا المثال إذا ما كان العميل قد فعّل خاصية Discord Rich Presence.
<syntaxhighlight lang="lua">
addCommandHandler("checkdiscord",
function ()
if isDiscordRichPresenceConnected() then
outputChatBox("أنت تستخدم Discord Rich Presence، هذا رائع!")
end
end
)
</syntaxhighlight>

==انظر ايضاً==
{{AR/Client_Discord_functions}}

[[en:IsDiscordRichPresenceConnected]]
[[de:isDiscordRichPresenceConnected]]
[[hu:isDiscordRichPresenceConnected]]
[[pl:isDiscordRichPresenceConnected]]
[[ro:isDiscordRichPresenceConnected]]
[[ru:IsDiscordRichPresenceConnected]]
[[PT-BR:IsDiscordRichPresenceConnected]]

ToggleAllVehicleControls

2025-08-05T10:55:36Z

Abolfazl: Created page with "Toggles all vehicle controls for a player based on the provided boolean method (true to enable, false to disable). ==Syntax== <syntaxhighlight lang="lua">toggleAllVehicleControls(player, method)</syntaxhighlight> ===Required Arguments=== *'''player:''' The player whose vehicle controls will be toggled. *'''method:''' A boolean indicating whether to enable (true) or disable (false) the controls. ===Returns=== Returns false if the method is not a b..."

Toggles all vehicle controls for a player based on the provided boolean method (true to enable, false to disable).
==Syntax==
<syntaxhighlight lang="lua">toggleAllVehicleControls(player, method)</syntaxhighlight>

===Required Arguments===
*'''player:''' The [[Player|player]] whose vehicle controls will be toggled.
*'''method:''' A [[Boolean|boolean]] indicating whether to enable (true) or disable (false) the controls.

===Returns===
Returns false if the method is not a boolean value, otherwise it returns true.

==Code==
<section name="Server and Client Side Script" class="both" show="true">
<syntaxhighlight lang="lua">
local vehicleControls = {
"vehicle_fire", "vehicle_secondary_fire", "vehicle_left", "vehicle_right",
"steer_forward", "steer_back", "accelerate", "brake_reverse", "radio_next", "radio_previous", "radio_user_track_skip", "horn", "sub_mission",
"handbrake", "vehicle_look_left", "vehicle_look_right", "vehicle_look_behind", "vehicle_mouse_look", "special_control_left", "special_control_right",
"special_control_down", "special_control_up"
}

function toggleAllVehicleControls(player, method)
if type(method) ~= "boolean" then return false end
for index, control in ipairs(vehicleControls) do
toggleControl(player, control, method)
end
end
</syntaxhighlight>
</section>

==Example 1==
This example toggles player's vehicle controls off when it entered an Andromeda.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addEventHandler("onPlayerVehicleEnter", root, function(vehicle)
if getElementModel(vehicle) == 592 then
toggleAllVehicleControls(source, false)
end
end)
</syntaxhighlight>
</section>

'''Author:''' [[User:Abolfazl|Abolfazl]]

Changes in 1.7

2025-08-04T07:32:45Z

O22:

<pageclass class="#4286f4" subcaption="Next release"></pageclass>
{{Changelogs}}
__NOTOC__
'''This changelog is partial and needs updating. It is updated progressively to keep the page always up to date.'''

* GitHub commit log: https://github.com/multitheftauto/mtasa-blue/compare/1.6.0...master
* GitHub milestone: https://github.com/multitheftauto/mtasa-blue/milestone/10
* Resources GitHub commit log: https://github.com/multitheftauto/mtasa-resources/compare/1.6.0...master
* Release announcement on forums: TBA

== Important notice to Windows 7 and 8.x users ==
If you are using Windows 7 or 8.x, please upgrade your system to Windows 10 or 11 as soon as possible. Windows 7 and 8.x are no longer supported by Microsoft (since January 2020 and January 2023 respectively) and most software (including Google Chrome and Steam) which means you are running an insecure system. Multi Theft Auto will also eventually drop Windows 7 and 8.x support sometime in the future, so it would be a good idea to start looking at upgrade options right now. Thank you!

'''CEF in MTA is no longer updated for Windows 7 or 8.x. This is because CEF no longer supports those versions of Windows. This is bad for security, so please upgrade to Windows 10+ and MTA to 1.6+'''

== 4 Deprecations ==
These changes will take effect in this version and scripts may need to be manually upgraded when updating:
* Changed [[base64Encode]] and [[base64Decode]] to throw a warning on use, please upgrade to [[encodeString]] and [[decodeString]] instead ([https://github.com/multitheftauto/mtasa-blue/commit/30a83b0af164fb6920a2a60e089d08a6f5622f7d 30a83b0] by '''Nico834''')
* Changed [[setHelicopterRotorSpeed]] and [[getHelicopterRotorSpeed]] to throw a warning on use, please upgrade to [[setVehicleRotorSpeed]] and [[getVehicleRotorSpeed]] instead ([https://github.com/multitheftauto/mtasa-blue/commit/82000c34830b51ace2d14e39f3b487feb1aac1da 82000c3] by '''FileEX''')
* Changes [[setPedOnFire]] and [[isPedOnFire]] to throw a warning on use, please upgrade to [[setElementOnFire]] and [[isElementOnFire]] instead ([https://github.com/multitheftauto/mtasa-blue/commit/7ad96e2e78fe41f8924d3f105b1683f7363c6fcb 7ad96e2] by '''FileEX''')
* Changes [[removeAllGameBuildings]] and [[restoreAllGameBuildings]] to throw a warning on use, please upgrade to [[removeGameWorld]] and [[restoreGameWorld]] instead ([https://github.com/multitheftauto/mtasa-blue/commit/d7adae68791ce237704acc06bf794b5fbda96f95#diff-93c130ddb85da32121129a437ac5b28ba16fa17f6e3506e4cddfb7bc3d8eb9fbR180 d7adae6] by '''TheNormalnij''')

== Notable Changes ==
* Support for Discord Rich Presence ([https://github.com/multitheftauto/mtasa-blue/commit/fdaa3aca3e233c7aba69d0fd5f85e78288a4401a fdaa3ac], [https://github.com/multitheftauto/mtasa-blue/commit/ef26810df4542283fee8edcc165bc9be22f2ca98 ef26810], [https://github.com/multitheftauto/mtasa-blue/commit/acfbd40df1ff1432ea1d6663c005d43fce22899c acfbd40] by '''znjvder''', '''tederis''', '''patrikjuvonen''' and '''Deihim007''')
* Added support for [[Building]]'s ([https://github.com/multitheftauto/mtasa-blue/commit/81242edb9295efbf4bf8b198b12d577a0877aec2 81242ed], [https://github.com/multitheftauto/mtasa-blue/commit/eb6b18a5d49a7f0f34bdbf42b15f933e42876cf8 eb6b18a] by '''TheNormalnij''')
* Added the ability to generate a nickname ([https://github.com/multitheftauto/mtasa-blue/commit/12c50eee66898771244074a3a44818dab36a7ac3 12c50ee] by '''Nico834''')
* Added ''meta.xml'' loading files pattern ([https://github.com/multitheftauto/mtasa-blue/commit/90e2737d0a5eb12f34d2fd3c1f270bedf34cda35 90e2737] by '''W3lac3''')
* Added world properties (time cycle and weather related features) with new functions: [[setWorldProperty]], [[getWorldProperty]], [[resetWorldProperty]] ([https://github.com/multitheftauto/mtasa-blue/commit/a75f1e9a03e74f7c9d4ae9e5aef8433af84d5ea2 a75f1e9] by '''Samr46''')
* Added file-system related functions (list files and folders in directories) ([https://github.com/multitheftauto/mtasa-blue/commit/74781c6295b5b6dc81cd95d4cfab7900d88d7524 74781c6] by '''Tracer''')
* Added the ability to change the color and size of the target arrow in the checkpoint marker ([https://github.com/multitheftauto/mtasa-blue/commit/071378ec4326408a9520c79c96befca995d097f6 071378e] by '''FileEX''')
* Added the ability to change the alpha of checkpoint and arrow marker ([https://github.com/multitheftauto/mtasa-blue/commit/7988852cf3af9e78f662d76544dc00db408b5c87 7988852] by '''FileEX''')
* Fixed weapon issues when using the jetpack ([https://github.com/multitheftauto/mtasa-blue/commit/180fbc0b5fdba95450e7a519f78f7588849349bf 180fbc0], [https://github.com/multitheftauto/mtasa-blue/commit/a68c2c4232c28c6ba5595a814b89be976c4fa9c3 a68c2c4] by '''FileEX''')
* Fixed vehicle windows not being visible from the inside when the lights are on ([https://github.com/multitheftauto/mtasa-blue/commit/934c1d6cfef19902cc391c896bbe2f80ba5a4f70 934c1d6] by '''FileEX''')
* Fixed old [[setElementModel]] memory leak ([https://github.com/multitheftauto/mtasa-blue/commit/4e7afa2586c6992a75ac5312378c1096d87148ae 4e7afa2] by '''tederis''')
* Enabled WebGL (GPU Acceleration) in CEF ([https://github.com/multitheftauto/mtasa-blue/commit/026301168d2cd8239650a4f0aa33ff0be6d752dc 0263011] by '''TFP-dev''')
* Refactored '''Quick Connect button''' ([https://github.com/multitheftauto/mtasa-blue/commit/5b59e2236b30ec696ac1c05f8bb4e509ec06c0f7 5b59e22] by '''Fernando-A-Rocha''')
* Added setting to save camera photos in documents folder ([https://github.com/multitheftauto/mtasa-blue/commit/3419b9b7a20e3d1893d673a2a07ee1a0efda1bd5 3419b9b] by '''ffsPLASMA''')
* Added HUD customization ([https://github.com/multitheftauto/mtasa-blue/commit/5ea0e0fb23b21750207b23191db92562cf9b822c 5ea0e0f] by '''FileEX''')
* Added sync peds/players animations for new players ([https://github.com/multitheftauto/mtasa-blue/commit/b32eafc70816ece8ad995d98d380d8f6e9950475 b32eafc] by '''FileEX''')
* From now on, animation progress is preserved even after a restream; the animation will not start from the beginning. ([https://github.com/multitheftauto/mtasa-blue/commit/ad0d6bfdd7bf56b78f7c8c1b9a60597ef9b6dca3 ad0d6bf] by '''FileEX''')
* Added ability to replace CJ clothing models ([https://github.com/multitheftauto/mtasa-blue/commit/6b823653ecf68e181de91392d5d8931488f90f20 6b82365] by '''W3lac3''')
* New MTA splash window ([https://github.com/multitheftauto/mtasa-blue/commit/215173eeb1e015c0381ce94f95429c36ab1b4430 215173e] by '''botder''')
* Fixed multiple damage instances in certain areas during explosions ([https://github.com/multitheftauto/mtasa-blue/commit/3bce4080ec66a993096f9e7fb039cc7d5d0d8175 3bce408] by '''FileEX''')
* From now on, before disconnecting from the server using the main menu, you will be asked to confirm if you really want to do it ([https://github.com/multitheftauto/mtasa-blue/commit/6aa763fb79701c57402fccca9ae6c0f396fb8f3c 6aa763f] by '''tonievalue''')

== Statistics ==
<section show="true">
These are some statistics since the [[Changes in 1.6.0|previous release]].
* This is the '''28<sup>th</sup>''' 1.x.x release
* '''{{date difference|2023|06|16}}''' days
* '''39''' new functions
* '''12''' new events
* '''4''' deprecations
* '''50+''' bug fixes and changes
* '''734''' commits ([https://github.com/multitheftauto/mtasa-blue/compare/1.6.0...master mtasa-blue]) ([https://github.com/multitheftauto/mtasa-resources/compare/1.6.0...master mtasa-resources])
* '''78''' new open GitHub issues ([https://github.com/multitheftauto/mtasa-blue/issues?q=is%3Aopen+is%3Aissue+created%3A2023-06-16..2024-10-01 see list])
* '''29''' resolved GitHub issues ([https://github.com/multitheftauto/mtasa-blue/issues?q=is%3Aclosed+is%3Aissue+milestone%3A%221.6.1%22 see list])
* '''28''' closed GitHub issues ([https://github.com/multitheftauto/mtasa-blue/issues?q=is%3Aclosed+is%3Aissue+closed%3A2023-06-16..2024-10-01+no%3Amilestone+-label%3Ainvalid see list])
* '''30''' new open GitHub pull requests ([https://github.com/multitheftauto/mtasa-blue/pulls?q=is%3Aopen+is%3Apr+created%3A2023-06-16..2024-10-01 see list])
* '''81''' merged GitHub pull requests ([https://github.com/multitheftauto/mtasa-blue/pulls?q=is%3Apr+is%3Amerged+milestone%3A%221.6.1%22 see list])
* '''26''' closed GitHub pull requests ([https://github.com/multitheftauto/mtasa-blue/pulls?q=is%3Apr+is%3Aunmerged+closed%3A2023-06-16..2024-10-01 see list])
* '''2+''' contributors of which '''0+''' are new ([https://github.com/multitheftauto/mtasa-blue/graphs/contributors?from=2023-06-16&to=2024-10-01&type=c see list])
* '''100+''' total contributors ([https://github.com/multitheftauto/mtasa-blue/graphs/contributors see list])
* '''3''' vendor updates

<sub>'''Note:''' Last update to these statistics was made {{date difference human friendly|2024|04|04}}.</sub>
</section>

== 86 New Features ==
=== Shared ===
* Added new ''special world properties'' to [[setWorldSpecialPropertyEnabled]] function
:* Added '''fireballdestruct''' special world property ([https://github.com/multitheftauto/mtasa-blue/commit/938b306add48245e578ba6036f1a77521e277194 938b306] by '''samr46''')
:* Added '''roadsignstext''' special world property ([https://github.com/multitheftauto/mtasa-blue/commit/4a746eca1b5a546a19344a76573a5108ff9d79e6 4a746ec] by '''FileEX''')
:* Added '''extendedwatercannons''' special world property ([https://github.com/multitheftauto/mtasa-blue/commit/13a53959f52c978b416c00b428938f82818b2312 13a5395] by '''FileEX''')
:* Added '''tunnelweatherblend''' special world property ([https://github.com/multitheftauto/mtasa-blue/commit/9a0790ec7fab1efb7817eead371744fcd47da5c5 9a0790e] by ''''gta191977649''')
:* Added '''ignorefirestate''' special world proeprty ([https://github.com/multitheftauto/mtasa-blue/commit/46f3580fbd8ea5cf48c14cf8fee0bd6eb6691854 46f3580] by '''FileEX''')
:* Added '''flyingcomponents''' special world property ([https://github.com/multitheftauto/mtasa-blue/commit/5ee641436821ae8a59484ac721a4ec929d5cc152 5ee6414] by '''FileEX''')
:* Added '''vehicleburnexplosions''' special world property ([https://github.com/multitheftauto/mtasa-blue/commit/88d303c0bbcc0ed4fee958df2d16ace562ce0108 88d303c] by '''samr46''')
:* Added '''vehicle_engine_autostart''' special world property ([https://github.com/multitheftauto/mtasa-blue/commit/8b3f3440f8bc485f90d466a3fe6f3e5819de9c2f 8b3f344] by '''samr46''')

* Added new ''glitches'' to [[setGlitchEnabled]] function
:* Added '''vehicle_rapid_stop''' glitch ([https://github.com/multitheftauto/mtasa-blue/commit/3f5801e65d8a51d112b686485d4a2491151c3311 3f5801e], [https://github.com/multitheftauto/mtasa-blue/commit/ef792d6af62443f97014621334c7188dddb4ef29 ef792d6] by '''samr46''' and '''Merlin''')

* New '''file''' functions
:* Added [[fileGetContents]] ([https://github.com/multitheftauto/mtasa-blue/commit/22930d854ce67d84a4a3b65a61b98a9ffd3f9e38 22930d8] by '''botder''')
:* Added [[fileGetHash]] ([https://github.com/multitheftauto/mtasa-blue/commit/94f944f508b99b5d7e84fbb0be07a483e10517a9 94f944f] by '''botder''')

* New and updated [[object]] functions
:* '''[Updated]''' Added [[isObjectMoving]] to server-side ([https://github.com/multitheftauto/mtasa-blue/commit/7c939adb892c08836462a78cd9b987884cdb49ee 7c939ad] by '''FileEX''')
:* '''[Updated]''' Added [[breakObject]] to server-side ([https://github.com/multitheftauto/mtasa-blue/commit/aa1a7853f46fc796a94f38b7df2a5293fb941ba2 aa1a785] by '''FileEX''')
:* '''[Updated]''' Added [[respawnObject]] and [[toggleObjectRespawn]] to server-side ([https://github.com/multitheftauto/mtasa-blue/commit/9d65bb673c4df16def27e97a4af74d3b0c7eedc9 9d65bb6] by '''FileEX''')
:* '''[New]''' Added [[isObjectRespawnable]] ([https://github.com/multitheftauto/mtasa-blue/commit/9d65bb673c4df16def27e97a4af74d3b0c7eedc9 9d65bb6] by '''FileEX''')

* New '''file-path''' functions
:* Added [[pathListDir]], [[pathIsFile]] and [[pathIsDirectory]] ([https://github.com/multitheftauto/mtasa-blue/commit/74781c6295b5b6dc81cd95d4cfab7900d88d7524 74781c6] by '''Tracer''')

* New [[marker]] functions
:* Added [[setMarkerTargetArrowProperties]] and [[getMarkerTargetArrowProperties]] ([https://github.com/multitheftauto/mtasa-blue/commit/071378ec4326408a9520c79c96befca995d097f6 071378e] by '''FileEX''')

* New [[timer]] functions
:* Added [[setTimerPaused]] and [[isTimerPaused]] ([https://github.com/multitheftauto/mtasa-blue/commit/69aa420f21fde3ac56e3d3bbc62ef0f060295c0a 69aa420] by '''jvstns''')

* New and updated '''world''' functions
:* '''[New]''' Added [[resetWorldProperties]] ([https://github.com/multitheftauto/mtasa-blue/commit/6df889e78328b80f8e4bdc02f8761472cf87c54c 6df889e] by '''FileEX''')
:* '''[Updated]''' Added [[isWorldSpecialPropertyEnabled]] and [[setWorldSpecialPropertyEnabled]] also to server-side ([https://github.com/multitheftauto/mtasa-blue/commit/938b306add48245e578ba6036f1a77521e277194 938b306] by '''samr46''')

* New and updated [[vehicle]] functions
:* '''[New]''' Added [[spawnVehicleFlyingComponent]] ([https://github.com/multitheftauto/mtasa-blue/commit/9f54cfcd7a584f413db731052ebed921acfc71ea 9f54cfc] by '''FileEX''')
:* '''[Upated]''' Added [[setVehicleNitroActivated]] to server-side ([https://github.com/multitheftauto/mtasa-blue/commit/e9e5819c394987de2b9a5d581c4df9fd47057d9d#diff-49b4b89bf4463f38e70a325131b4da66457d783b1401dde0ffbad723624f8612R130 e9e5819] by '''Proxy-99''')
:* '''[Updated]''' Added [[addVehicleSirens]] and [[removeVehicleSirens]] to client-side ([https://github.com/multitheftauto/mtasa-blue/commit/682cdca3c37248a9e725b461ba322db413653f25 682cdca] by '''Proxy-99''')

* Updated [[player]] functions
:* Added [[getPlayerScriptDebugLevel]] to client-side ([https://github.com/multitheftauto/mtasa-blue/commit/8403da54ecfd20d6b9740fb79d90ac936d316112 8403da5] by '''Nico834''')

* Updated [[ped]] functions
:* Added [[isPedReloadingWeapon]] to server-side ([https://github.com/multitheftauto/mtasa-blue/commit/e71f4828b46bb69b9622a11d0f700a79f986ee9b e71f482] by '''Nico834''')

* New [[element]] functions
:* Added [[setElementOnFire]] and [[isElementOnFire]] ([https://github.com/multitheftauto/mtasa-blue/commit/7ad96e2e78fe41f8924d3f105b1683f7363c6fcb 7ad96e2] by '''FileEX''')

=== Client ===
====Functions====
* New '''engine''' functions
:* Added '''streaming''' functions ([https://github.com/multitheftauto/mtasa-blue/commit/7ffc31243c1dbca8ed5e7b0f8c05da239aa918bd 7ffc312], [https://github.com/multitheftauto/mtasa-blue/commit/6c86ebbf0801c45d5e0bcbb9d9f2e8fd55525b15 6c86ebb], [https://github.com/multitheftauto/mtasa-blue/commit/3c44dc5dcde0a5f98ff470ce9bc64443d47de807 3c44dc5] by '''Pirulax''')
::* [[engineStreamingSetMemorySize]]
::* [[engineStreamingGetMemorySize]]
::* [[engineStreamingRestoreMemorySize]]
::* [[engineStreamingSetBufferSize]]
::* [[engineStreamingGetBufferSize]]
::* [[engineStreamingRestoreBufferSize]]
::* [[engineStreamingSetModelCacheLimits]]
:* Added '''model-streaming''' functions ([https://github.com/multitheftauto/mtasa-blue/commit/008eaa7e36ae74bbab7c5bc9861d8f0f890eb945 008eaa7] by '''TheNormalnij''')
::* [[engineStreamingRequestModel]]
::* [[engineStreamingReleaseModel]]
::* [[engineStreamingGetModelLoadState]]
:* Added new '''TXD''' functions ([https://github.com/multitheftauto/mtasa-blue/commit/3e9a3735a8022a0acabaa3041c8a3f8d91e547b7 3e9a373] by '''TheNormalnij''')
::* [[engineSetModelTXDID]]
::* [[engineResetModelTXDID]]
:* Added '''pools''' functions ([https://github.com/multitheftauto/mtasa-blue/commit/bdf12215d1f6e73d87f5cb0881049aa224b46b65 bdf1221] by '''TheNormalnij''')
::* [[engineGetPoolCapacity]]
::* [[engineSetPoolCapacity]]
::* [[engineGetPoolDefaultCapacity]]
::* [[engineGetPoolUsedCapacity]]
:* Added [[enginePreloadWorldArea]] ([https://github.com/multitheftauto/mtasa-blue/commit/5b72fb9d3c9e6813cdf56e53d1a1e72958abd3cf 5b72fb9] by '''MegadreamsBE''')

* New functions for '''Discord RPC''' ([https://github.com/multitheftauto/mtasa-blue/commit/fdaa3aca3e233c7aba69d0fd5f85e78288a4401a fdaa3ac], [https://github.com/multitheftauto/mtasa-blue/commit/ef26810df4542283fee8edcc165bc9be22f2ca98 ef26810], [https://github.com/multitheftauto/mtasa-blue/commit/acfbd40df1ff1432ea1d6663c005d43fce22899c acfbd40] by '''znjvder''', '''tederis''', '''patrikjuvonen''' and '''Deihim007''')
:* [[setDiscordApplicationID]]
:* [[setDiscordRichPresenceDetails]]
:* [[setDiscordRichPresenceState]]
:* [[setDiscordRichPresenceAsset]]
:* [[setDiscordRichPresenceSmallAsset]]
:* [[setDiscordRichPresenceButton]]
:* [[resetDiscordRichPresenceData]]
:* [[isDiscordRichPresenceConnected]]
:* [[setDiscordRichPresencePartySize]]
:* [[setDiscordRichPresenceStartTime]]
:* [[setDiscordRichPresenceEndTime]]
:* [[getDiscordRichPresenceUserID]]

* New [[building]] functions ([https://github.com/multitheftauto/mtasa-blue/commit/81242edb9295efbf4bf8b198b12d577a0877aec2 81242ed], [https://github.com/multitheftauto/mtasa-blue/commit/eb6b18a5d49a7f0f34bdbf42b15f933e42876cf8 eb6b18a] by '''TheNormalnij''')
:* [[createBuilding]]
:* '''[Deprecated]''' [[removeAllGameBuildings]]
:* '''[Deprecated]''' [[restoreAllGameBuildings]]

* New '''world''' functions
:* Added [[processLineAgainstMesh]] ([https://github.com/multitheftauto/mtasa-blue/commit/acb80a3945d0d5e0230b8a41394a3fe3e70b8d0b acb80a3] by '''Pirulax''')
:* Added '''volumetric shadows''' functions ([https://github.com/multitheftauto/mtasa-blue/commit/6c93a49c4c2381f4ce84df195d98d36372a47d37 6c93a49] by '''Proxy-99''')
:::* [[setVolumetricShadowsEnabled]]
:::* [[isVolumetricShadowsEnabled]]
:::* [[resetVolumetricShadows]]
:* Added [[testSphereAgainstWorld]] ([https://github.com/multitheftauto/mtasa-blue/commit/aa90aa5f31e59df455af33b49e3eee5e4f107bfd aa90aa5] by '''FileEX''')
:* Added [[removeGameWorld]] and [[restoreGameWorld]] ([https://github.com/multitheftauto/mtasa-blue/commit/d7adae68791ce237704acc06bf794b5fbda96f95 d7adae6] by '''TheNormalnij''')

* New '''drawing''' functions
:* Added [[dxDrawModel3D]] ([https://github.com/multitheftauto/mtasa-blue/commit/f886a359dd4a680c080da7f132db0527116b5d7a f886a35], [https://github.com/multitheftauto/mtasa-blue/commit/04ef14bbf2182b356155f28d4ed972b0f293632f 04ef14b] by '''CrosRoad95''' and '''tederis''')

* New '''effects/fx''' functions
:* Added [[fxCreateParticle]] ([https://github.com/multitheftauto/mtasa-blue/commit/8f2730d2e260c3319cb51101c6aedb45e22bbd89 8f2730d] by '''FileEX''')

* New [[ped]] functions
:* Added [[resetPedVoice]] ([https://github.com/multitheftauto/mtasa-blue/commit/18986a4542db5eb72f6d0dfffb80cb8bb6eb1442 18986a4] by '''Tracer''')
:* Added new animation features ([https://github.com/multitheftauto/mtasa-blue/commit/aa0591c6f7b529a27b4ed8667e1dc70e68bd9386 aa0591c] by '''Tracer''')
::* [[getPedAnimationProgress]]
::* [[getPedAnimationSpeed]]
::* [[getPedAnimationLength]]
:* Added [[killPedTask]] ([https://github.com/multitheftauto/mtasa-blue/commit/e4a502bc7619dc3913c70d169f6105ecfb0633ff e4a502b] by '''Proxy-99''')
:* Added ped shadow features ([https://github.com/multitheftauto/mtasa-blue/commit/26d18288730fd3a7a854152da60c9acd18ab6c6f 26d1828] by '''Proxy-99''')
::* [[setDynamicPedShadowsEnabled]]
::* [[isDynamicPedShadowsEnabled]]
::* [[resetDynamicPedShadows]]
:* Added [[playPedVoiceLine]] ([https://github.com/multitheftauto/mtasa-blue/commit/7067ac1a73bb0b8c5a1f37794504a00e9703332e 7067ac1] by '''FileEX''')

* New [[player]] functions
:* Added [[isPlayerCrosshairVisible]] ([https://github.com/multitheftauto/mtasa-blue/commit/03e851a2f5ff2d917ba3c7a1c7577fdb5b8d2a6f 03e851a], [https://github.com/multitheftauto/mtasa-blue/commit/5f21c32fb0725140d6d03476e08de330d429b55a 5f21c32] by '''FileEX''')
:* New '''HUD''' functions ([https://github.com/multitheftauto/mtasa-blue/commit/5ea0e0fb23b21750207b23191db92562cf9b822c 5ea0e0f] by '''FileEX''')
::* [[setPlayerHudComponentProperty]]
::* [[getPlayerHudComponentProperty]]
::* [[resetPlayerHudComponentProperty]]

* New [[vehicle]] functions
:* Added [[setVehicleWheelsRotation]] ([https://github.com/multitheftauto/mtasa-blue/commit/aeb113d269fffee7d9ac435ce87b51e905e9efa6 aeb113d] by '''gta191977649''')
:* Added [[getVehicleEntryPoints]] ([https://github.com/multitheftauto/mtasa-blue/commit/bf588c163cd5bc134771e3842a6585212f06307f bf588c1] by '''MegadreamsBE''')
:* Added [[setVehicleSmokeTrailEnabled]] and [[isVehicleSmokeTrailEnabled]] for planes ([https://github.com/multitheftauto/mtasa-blue/commit/a5dfc5223358127299511b618ab29da08ff23030 a5dfc52] by '''Proxy-99''')
:* Added [[setVehicleRotorState]] and [[getVehicleRotorState]] for planes and helicopters ([https://github.com/multitheftauto/mtasa-blue/commit/c7644f2773c37c4e3d40b00807f2e962daca83b6#diff-9a175949acc865a4deea435d73c2082716ab68c6811ef1a657783f3d420dc00fR165 c7644f2] by '''FileEX''')
:* Added '''vehicle audio''' functions: ([https://github.com/multitheftauto/mtasa-blue/commit/53ee579670ef4ecec28f44627ff99321bba48cbd 53ee579] by '''TheNormalnij''')
::* [[setVehicleModelAudioSetting]]
::* [[getVehicleModelAudioSettings]]
::* [[resetVehicleModelAudioSettings]]
::* [[setVehicleAudioSetting]]
::* [[getVehicleAudioSettings]]
::* [[resetVehicleAudioSettings]]

* New '''camera''' functions ([https://github.com/multitheftauto/mtasa-blue/commit/40ec398bb15e775d1552286eb86fe7aa0dffefa4 40ec398], [https://github.com/multitheftauto/mtasa-blue/commit/d9c2793de2a9f0782ec59cf0ef9907abf935d421 d9c2793] by '''Tracer''')
:* [[shakeCamera]]
:* [[resetShakeCamera]]

* New '''game-time''' functions ([https://github.com/multitheftauto/mtasa-blue/commit/b8b7ce555e2f0f0dd74425ac7c91786374513bee b8b7ce5] by '''Proxy-99''')
:* [[setTimeFrozen]]
:* [[isTimeFrozen]]
:* [[resetTimeFrozen]]

* New [[element]] functions
:* Added [[setElementBoneQuaternion]] and [[getElementBoneQuaternion]] ([https://github.com/multitheftauto/mtasa-blue/commit/10098b0984bf5d5955ea1764e28f616c8a60714f 10098b0] by '''gownosatana''')
:* Added [[setElementLighting]] ([https://github.com/multitheftauto/mtasa-blue/commit/90fd98a6381991cfa926a9a65b9b934d0343e2b1 90fd98a] by '''FileEX''')

* New [[browser]] functions
:* Added [[isBrowserGPUEnabled]] ([https://github.com/multitheftauto/mtasa-blue/commit/bfdfdb5f44726df85626e6e3e06c2a319c0c8962 bfdfdb5] by '''Lpsd''')

* New '''weapons''' functions
:* Added [[setWeaponRenderEnabled]] & [[isWeaponRenderEnabled]] ([https://github.com/multitheftauto/mtasa-blue/commit/efed59b7dc7b076219f1c8a868ef8aa028582127 efed59b] by '''FileEX''')

====Events====
* Added [[onClientCoreCommand]] ([https://github.com/multitheftauto/mtasa-blue/commit/b2cf02943924c4972d2a695cdbfd7c9873fc3cbb b2cf029] by '''Pieter-Dewachter''')

* Added [[onClientBrowserConsoleMessage]] ([https://github.com/multitheftauto/mtasa-blue/pull/3676 #3676], [https://github.com/multitheftauto/mtasa-blue/commit/d296a653c5ce2ecfd4f7150d74391b703b773baf d296a65] by '''gownosatana''' and '''Tracer''')

=== Server ===
====Functions====
* New [[ACL]] functions
:* Added [[aclObjectGetGroups]] ([https://github.com/multitheftauto/mtasa-blue/commit/cf46bd8487bdb2d0cafdab1f43936357f670fe10 cf46bd8] by '''Tracer''')

* New '''acl-account''' functions
:* Added [[getAccountType]] ([https://github.com/multitheftauto/mtasa-blue/commit/545f54b6ae0bfc721abba12402ad3787ed9ae811 545f54b] by '''Tracer''')
:* Added [[setAccountSerial]] ([https://github.com/multitheftauto/mtasa-blue/commit/a0c2e410f225ebd245a7c5b8031812cf94360097 a0c2e41] by '''camargo2019''')

* New [[vehicle]] functions
:* Added new vehicle respawn functions ([https://github.com/multitheftauto/mtasa-blue/commit/1ff7137fd4477626d7ef4abfb1c696872cdf0eab 1ff7137], [https://github.com/multitheftauto/mtasa-blue/commit/d93287de761e568400b3b555a277e4ead6546ca3 d93287d] by '''Tracer''')
::* [[isVehicleRespawnable]]
::* [[getVehicleRespawnDelay]]
::* [[getVehicleIdleRespawnDelay]]

* Added [[createBuilding]] to server-side also ([https://github.com/multitheftauto/mtasa-blue/commit/6e221298f4998c576ebf5a783cd0761b89117a7a 6e22129] by '''TheNormalnij''')

* Security improvements for element-data system ([https://github.com/multitheftauto/mtasa-blue/commit/750d09adb9fd35f4c1b7786966b7ca292e35c200 750d09a] by '''TheNormalnij''')
:* Added [[onPlayerChangesProtectedData]] event
:* Added '''elementdata_whitelisted''' tag to the '''mtaserver.conf'''
:* Added '''clientChangesPolicy''' argument to the [[setElementData]].

* Added new [[Server_mtaserver.conf|mta_server.conf]] tags:

:* Added [[Server_mtaserver.conf#vehicle_contact_sync_radius#vehicle_contact_sync_radius|vehicle_contact_sync_radius]] tag ([https://github.com/multitheftauto/mtasa-blue/commit/e3338c2fbbdb500c4ce28dc0677ceadef1f1ca4c e3338c2] by '''MegadreamsBE''')
:* Added [[Server_mtaserver.conf#vehicle_contact_sync_radius#check_duplicate_serials|check_duplicate_serials]] tag ([https://github.com/multitheftauto/mtasa-blue/commit/e094942b75117a49cae8c35d6508f37d0cf511fe e094942] by '''Nico834''')
:* Added [[Server_mtaserver.conf#vehicle_contact_sync_radius#elementdata_whitelisted|elementdata_whitelisted]] tag [https://github.com/multitheftauto/mtasa-blue/commit/750d09adb9fd35f4c1b7786966b7ca292e35c200 750d09a] by '''TheNormalnij''')

====Events====
* Added [[onExplosion]] event ([https://github.com/multitheftauto/mtasa-blue/commit/9edffc4997579583407e8c2910264b344cf626a3 9edffc4] by '''botder''')
* Added [[onPlayerProjectileCreation]] and [[onPlayerDetonateSatchels]] events ([https://github.com/multitheftauto/mtasa-blue/commit/bc404021f66228fb00f1f136a606425da6075daa bc40402] by '''Zangomangu''')
* Added [[onPlayerTriggerEventThreshold]] event ([https://github.com/multitheftauto/mtasa-blue/commit/eae47fe2f432d9053c425fd515ea27f963c254ec eae47fe] by '''Lpsd''')
* Added [[onResourceStateChange]] ([https://github.com/multitheftauto/mtasa-blue/commit/cfe9cd9d0006580e7e70dc9e93672e3d1d3b9836 cfe9cd9] by '''Tracer''')
* Added [[onPlayerTeamChange]] ([https://github.com/multitheftauto/mtasa-blue/commit/c4e18c618db299ea05f5395c798f2a7d6515f5ea c4e18c6] by '''esmail9900''')
* Added [[onAccountCreate]] and [[onAccountRemove]] ([https://github.com/multitheftauto/mtasa-blue/commit/545f54b6ae0bfc721abba12402ad3787ed9ae811 545f54b] by '''Tracer''')
* Added [[onPlayerTriggerInvalidEvent]] ([https://github.com/multitheftauto/mtasa-blue/commit/5b4122d35f725e4d258b408253c93e7cbd2ec783 5b4122d] by '''Lpsd''')
* Added [[onPlayerChangesWorldSpecialProperty]] event ([https://github.com/multitheftauto/mtasa-blue/commit/bbf511d4c5a94fc42d4ead201446fcef8ae430ec bbf511d] by '''Nico834''')
* Added [[onPlayerChangesProtectedData]] event ([https://github.com/multitheftauto/mtasa-blue/commit/750d09adb9fd35f4c1b7786966b7ca292e35c200 750d09a] by '''TheNormalnij''')
* Added [[onShutdown]] ([https://github.com/multitheftauto/mtasa-blue/commit/aa20c7d279ac92f1f98c54e79fda7fe00de64e50 aa20c7d] by '''FileEX''')
* Added [[onPedWeaponReload]] and [[onPlayerWeaponReload]] ([https://github.com/multitheftauto/mtasa-blue/commit/e71f4828b46bb69b9622a11d0f700a79f986ee9b e71f482] by '''Nico834''')
* Added [[onPlayerTeleport]] ([https://github.com/multitheftauto/mtasa-blue/commit/4000ea4edb37d2d2caeb60a5977f7a38c8a22f06 a38e6ac] by '''imfelipedev''')
* Added [[onAccountNameChange]] ([https://github.com/multitheftauto/mtasa-blue/commit/078d46b13164c940f3a713039e1a1be6d52c6c76 078d46b] by '''Davis22d''')

== 77 Changes and Bug Fixes ==
=== Shared ===
* Fixed random toggle of world special properties ([https://github.com/multitheftauto/mtasa-blue/commit/bf95b1d16e31f36899350e2acac4bb8adfad5cdd bf95b1d] by '''samr46''')
* Many debugscript fixes
:* Fixed [[onClientDebugMessage]]/[[onDebugMessage]] recognizing level 4 as 0 ([https://github.com/multitheftauto/mtasa-blue/commit/783971efbdfcae622dbc03fd7647c337c2a3a306 783971e] by '''Tracer''')
:* Fixed outputDebugString level 4 colors ([https://github.com/multitheftauto/mtasa-blue/commit/5d4d7df3b8ff703cf954f3af394c811c489dcb18 5d4d7df] by '''MegadreamsBE''')
:* Fixed [[outputDebugString]] level 4 not being logged ([https://github.com/multitheftauto/mtasa-blue/commit/1951a5e62d35b2cf4ec292d294f8c818b8463418 1951a5e] by '''MegadreamsBE''')
:* Fixed outputDebugString with level 4 not showing ([https://github.com/multitheftauto/mtasa-blue/commit/b459973f8ad00aff79042a338a70700a21b426dc b459973] by '''srslyyyy''')

* Ped sync improvements ([https://github.com/multitheftauto/mtasa-blue/commit/f5b599c9f45777f924f7980cadb2d3cc6431d8b8 f5b599c] by '''tederis''')
* Fixed "Using setElementHealth on a dead ped makes it invincible" ([https://github.com/multitheftauto/mtasa-blue/commit/836888379dc3e434752ad20c10a8d7d33ffc65a2 8368883] by '''FileEX''')
* Fixed setting player model resets their current weapon slot ([https://github.com/multitheftauto/mtasa-blue/commit/f7ce562b645cb05a18658df62d093b753b881bb9 f7ce562] by '''FileEX''')
* Fixed a bug where ''"arrow"'' and ''"checkpoint"'' markers ignored the alpha color ([https://github.com/multitheftauto/mtasa-blue/commit/7988852cf3af9e78f662d76544dc00db408b5c87 7988852] by '''FileEX''')
* Fixed the goggle effect resetting after changing skin ([https://github.com/multitheftauto/mtasa-blue/commit/1dd291409f791891b54ccf6b1d1cebe08cff13c0 1dd2914] by '''Proxy-99''')
* Fixed satchels detaching after changing skin ([https://github.com/multitheftauto/mtasa-blue/commit/d93dbf2ca598bf3508364bc7c6337d82c3d9ccb2 d93dbf2] by '''FileEX''')
* Added '''resourceName''' global variable and added current resource as default argument for [[getResourceName]] ([https://github.com/multitheftauto/mtasa-blue/commit/49fb6c68a27ad85e5abcd563f4c4f8c568305fdb 49fb6c6] by '''Nico834''')
* Added new parameters '''animGroup''' & '''animID''' for wasted events [[onPlayerWasted]], [[onPedWasted]], [[onClientPlayerWasted]] ([https://github.com/multitheftauto/mtasa-blue/commit/ecd6ed98ca129e7f45bda14384a503bee09495a7 ecd6ed9] by '''Nico834''' and '''G-Moris''')
* Added optional '''ignoreAlphaLimits''' argument for [[createMarker]] to maintain backward compatibility after adding the ability to change alpha for arrow and checkpoint markers ([https://github.com/multitheftauto/mtasa-blue/commit/121048cb9a14c28dcefca9bf2d4e955ef920a087 121048c] by '''FileEX''')
* Added optional '''property''' argument for [[getVehicleHandling]] ([https://github.com/multitheftauto/mtasa-blue/commit/a08e38d6507fdc1c051c2b84727c83dd9c418649 a08e38d] by '''XJMLN''')
* Fixed health value issues ([https://github.com/multitheftauto/mtasa-blue/commit/612f9a6715059baa43182e891258d9c3ceb19591 612f9a6] by '''Tracer''')
* Fixed [[getTimerDetails]] negative remaining duration ([https://github.com/multitheftauto/mtasa-blue/commit/1c6cab5a94c8c6ff5cf9b1fc0c9bc04808c922f8 1c6cab5] by '''jvstns''')
* Fixed changing [[setElementCollisionsEnabled]] doesn't update contact element ([https://github.com/multitheftauto/mtasa-blue/commit/71c683f547aac34e876601d24c881227fe3ca05f 71c683f] by '''FileEX''')
* Removed ability to skip [[addDebugHook]] ([https://github.com/multitheftauto/mtasa-blue/commit/2fecd74fdd453efdcbdddfd8f3fa3c092640cf9f 2fecd74] by '''PlatinMTA''')
* Fixed hydraulics stopping working after using [[setVehicleHandling]] ([https://github.com/multitheftauto/mtasa-blue/commit/f96836397a075585d4d112eb7d0240f1abf361d4 f968363] by '''FileEX''')
* Fixed helicopter rotor unaffected by vehicle alpha ([https://github.com/multitheftauto/mtasa-blue/commit/55d39225254c0b9961c1423b0d5695beff20072b 55d3922] by '''FileEX''')
* Add '''spawnFlyingComponent & breakGlass''' arguments for [[setVehiclePanelState]] ([https://github.com/multitheftauto/mtasa-blue/commit/5b69d700c848e36b2f427bbc6ba5b2c905592783 5b69d70] by '''FileEX''')
* Fixed armor synchronization ([https://github.com/multitheftauto/mtasa-blue/commit/583e675da976fbf90f45804ad834d8fe33c779a1 583e675] by '''Nico834''')
* Fixed jetpack disappearing after changing position and coming back after changing skin ([https://github.com/multitheftauto/mtasa-blue/commit/de26a9e98519350f0486290ce886595068c02470 de26a9e] by '''FileEX''')
* Added support for '''ZLIB''' compression to [[encodeString]] & [[decodeString]]. ([https://github.com/multitheftauto/mtasa-blue/commit/6230161f8d0c83b60aec3f4afa5be88dd213b88b 6230161] by '''samr46''')
* Fixed a bug where hex color codes were included in the chat message length. ([https://github.com/multitheftauto/mtasa-blue/commit/9a0b1d59233f7001e991262b4df9d1c17850dc08 9a0b1d5] by '''shadylua''')

=== Client ===
* Update d3dcompiler_47.dll from CEF ([https://github.com/multitheftauto/mtasa-blue/commit/75a1a298113721343090a06d60394f63f64df9ca 75a1a29] and [https://github.com/multitheftauto/mtasa-blue/commit/6d8fd8cc2fe7377318583f70abf58dcdb7d09cb0 6d8fd8c] by '''patrikjuvonen''')
* Updated translations from Crowdin ([https://github.com/multitheftauto/mtasa-blue/commit/29baf29a0143706eb08ef76c4743a452a7f83600 29baf29] by '''patrikjuvonen''')
:* Added Azerbaijani to client languages
* Resolved cursor being invisible with main menu open in certain scenarios ([https://github.com/multitheftauto/mtasa-blue/commit/bb1f675e6fee0ca3967f05afb5d2592dec9459b2 bb1f675] by '''Lpsd''')
* Partially fixed screen flickering on high memory usage ([https://github.com/multitheftauto/mtasa-blue/commit/1a886460a9fab1041cfba38078ae544b0fa51240 1a88646] by '''Zangomangu''')
* Added ''texture hit info'' parameter to [[processLineOfSight]] ([https://github.com/multitheftauto/mtasa-blue/commit/86f3344d1371a9783c2c7b755b895160a03ff6cd 86f3344] by '''Pirulax''')
* Fixed CStreamingSA::GetUnusedStreamHandle ([https://github.com/multitheftauto/mtasa-blue/commit/38624a4c2d18f4b60064d49069d3bcd81fbb4385 38624a4] by '''tederis''')
* IMG count extension ([https://github.com/multitheftauto/mtasa-blue/commit/1a60f6094b6660d29cabae780e6fbea5f5f1abf2 1a60f60] by '''tederis''')
* Fixed a desync state after aborted carjacking ([https://github.com/multitheftauto/mtasa-blue/commit/3f510fcdc7722cdfcb2e09ea43990b56aa43162b 3f510fc] by '''Zangomangu''')
* Allowed allocating clump models ([https://github.com/multitheftauto/mtasa-blue/commit/428561f1ebab49b8370ef0f022510cd67e98ab59 428561f] by '''TheNormalnij''')
* Fixed crash in CEF init ([https://github.com/multitheftauto/mtasa-blue/commit/c782826c955dfbdbaa67852a245e1c601d6b9f2c c782826] by '''TheNormalnij''')
* Fixed "Changing vehicle model from doorless or "doorful" causes doors to fall off" ([https://github.com/multitheftauto/mtasa-blue/commit/d6659dae263e2883d9e479ca271f0e9c8e622f95 d6659da] by '''FileEX''')
* Fixed "Wheel visibility when using setVehicleWheelStates" ([https://github.com/multitheftauto/mtasa-blue/commit/51c9257a427957642932a216bd76cb7de59fea1b 51c9257] by '''FileEX''')
* Added new world special property ''burnflippedcars'' ([https://github.com/multitheftauto/mtasa-blue/commit/938b306add48245e578ba6036f1a77521e277194 938b306] by '''samr46''')
* Streaming buffer restore and fixes ([https://github.com/multitheftauto/mtasa-blue/commit/6c86ebbf0801c45d5e0bcbb9d9f2e8fd55525b15 6c86ebb] by '''Pirulax''')
* Fixed Unicode file path passed in CClientIMG ([https://github.com/multitheftauto/mtasa-blue/commit/c57f07bfad8b02953dbe7b2b6e9b9de08ba88226 c57f07b] by '''TheNormalnij''')
* Added new world special property ''fireballdestruct'' ([https://github.com/multitheftauto/mtasa-blue/commit/219ad73d600140724eefcf5ca4040ac417cdee12 219ad73] by '''samr46''')
* Fixed "Hide question box when hiding main menu" ([https://github.com/multitheftauto/mtasa-blue/commit/4beff0447f093c66594a5f32ad5e52c7d7188ce9 4beff04] by '''XJMLN''')
* Fixed engineFreeModel regression ([https://github.com/multitheftauto/mtasa-blue/commit/b52500e92fb2591c092a6e66121471f098a2e044 b52500e] by '''TheNormalnij''')
* Fixed assert when model info is missing ([https://github.com/multitheftauto/mtasa-blue/commit/d431e5e16120b63beafbfe69110da601d12a76bb d431e5e] by '''TheNormalnij''')
* Fixed engineFreeModel crashes ([https://github.com/multitheftauto/mtasa-blue/commit/c289c22fb9a13730b7fd793752d84adbf2b928ee c289c22] by '''TheNormalnij''')
* Filtered URLs in requestBrowserDomains with incorrect symbols ([https://github.com/multitheftauto/mtasa-blue/commit/74bbb068acc6757ff0e04d0c63b999236e51ce63 74bbb06] by '''TheNormalnij''')
* Fixed issues with ped shaders ([https://github.com/multitheftauto/mtasa-blue/commit/3bc1e6d98ab13a9e7db95cc616b4645dc761889b 3bc1e6d] by '''Merlin''')
* Fixed 3D primitives disappearing ([https://github.com/multitheftauto/mtasa-blue/commit/04a1e2ba9157e4a1a91297f91554b72a87bf0ed4 04a1e2b] by '''tederis''')
* Fixed [[svgSetSize]] issues ([https://github.com/multitheftauto/mtasa-blue/commit/721c2b6d0f0c4ab016be079f1d4e28dec0123a6d 721c2b6] by '''Nico834''')
* Fixed the marker flickering issue during water cannon effects ([https://github.com/multitheftauto/mtasa-blue/commit/e83f700ee24904c0411b4dad3e695b3c3e30d9e4 e83f700] by '''Merlin''')
* Fixed buildings removal ([https://github.com/multitheftauto/mtasa-blue/commit/1b40db7cb5b63966ee97d0cbe79190360e1d32a0 1b40db7] by '''tederis''')
* Fixed crashes caused by [[createBuilding]] with [[engineRequestModel]] ([https://github.com/multitheftauto/mtasa-blue/commit/6245a68f3d97fc222d78fbc66b67f422a13710bf 6245a68] by '''TheNormalnij''')
* Fixed wrong getModelMatrix result for buildings ([https://github.com/multitheftauto/mtasa-blue/commit/f691946bc2d3dac75bd27d31886cd6b66d55811d f691946] by '''TheNormalnij''')
* Fixed crashes for ''timed-object'' in [[engineRequestModel]] ([https://github.com/multitheftauto/mtasa-blue/commit/229389a4bd1c4c02010ba27ce26a428b41b68560 229389a] by '''TheNormalnij''')
* Fixed incorrect colors for 3D draws ([https://github.com/multitheftauto/mtasa-blue/commit/1f2c6e75fb71b01f0053f151e766a232ed33692b 1f2c6e7] by '''Nico834''')
* Add missing definition GuiGridList::getColumnWidth ([https://github.com/multitheftauto/mtasa-blue/commit/b34b1d5362291bcf00c7a0a0b694f60e1dccb363 b34b1d5] by '''Lpsd''')
* Fixed [[resetPedVoice]] not working at all ([https://github.com/multitheftauto/mtasa-blue/commit/3d8bd504f009fc2aa66e1dc9d35427a889ccd6aa 3d8bd50] by '''Tracer''')
* Added LOD support for buildings ([https://github.com/multitheftauto/mtasa-blue/commit/77ab3e64a3c6dacdcee02a223b67aec6c5b97ec2 77ab3e6] by '''TheNormalnij''')
* Added render stages for 3D primitives (new ''stage'' parameter) ([https://github.com/multitheftauto/mtasa-blue/commit/841447684c2d1992656555f81d73da52b2ce5c4f 8414476] by '''tederis''')
* Added disable option for [[engineSetModelPhysicalPropertiesGroup]] ([https://github.com/multitheftauto/mtasa-blue/commit/b6216cad058582b0feb34e98e94531d4acbf7c5b b6216ca] by '''TheNormalnij''')
* Fixed return correct value for stuntDistance parameter ([https://github.com/multitheftauto/mtasa-blue/commit/1f464d61c8c5f1400faa5472ccb67d2436d52903 1f464d6] by '''XJMLN''')
* Fixed [[engineRestoreModelPhysicalPropertiesGroup]] restores incorrect group ([https://github.com/multitheftauto/mtasa-blue/commit/291dfb4bc9bd72307a4ba4b42ffcbfc03ded4e38 291dfb4] by '''TheNormalnij''')
* Fixed OGG sound files can't be played as RAW data ([https://github.com/multitheftauto/mtasa-blue/commit/2764b7983c4e1bde20b894ebcfef5f230b149030 2764b79] by '''FileEX''')
* Implement [[getElementBoundingBox]] for buildings ([https://github.com/multitheftauto/mtasa-blue/commit/7b228daea3e0dc22d808abcf0eb568d99efcf63d 7b228da] by '''TheNormalnij''')
* Fixed streaming size check after [[engineAddImage]] ([https://github.com/multitheftauto/mtasa-blue/commit/5cdc04d6d61f40e89a5da3d27ae9575f4a419a08 5cdc04d] by '''TheNormalnij''')
* Fixed [[removeWorldModel]] crash ([https://github.com/multitheftauto/mtasa-blue/commit/ae98b04753b54208961759b295bef44f0ffafe43 ae98b04] by '''TheNormalnij''')
* Fixed crash when using [[extinguishFire]] in [[onClientVehicleDamage]] event ([https://github.com/multitheftauto/mtasa-blue/commit/d6ae4e9e24b0b7de704a3cbeec25dfd661b4a3fc d6ae4e9] by '''FileEX''')
* Fixed weapon models being invisible when using the jetpack with [[setJetpackWeaponEnabled]] ([https://github.com/multitheftauto/mtasa-blue/commit/a68c2c4232c28c6ba5595a814b89be976c4fa9c3 a68c2c4] by '''FileEX''')
* Fixed animations validation to avoid crashes ([https://github.com/multitheftauto/mtasa-blue/commit/27a24b551d86c6fbf9ee308603f24b011e941399 27a24b5] by '''G-Moris''')
* Fixed a bug where the "attacker" parameter is always nil in the [[onClientObjectBreak]] event if the object is glass ([https://github.com/multitheftauto/mtasa-blue/commit/dca5e2065af4a0195526541f9a8285db0401616e dca5e20] by '''FileEX''')
* Fixed a bug where the [[onClientObjectBreak]] event was not triggered if the glass was broken by an explosion ([https://github.com/multitheftauto/mtasa-blue/commit/dca5e2065af4a0195526541f9a8285db0401616e dca5e20] by '''FileEX''')
* Fixed a bug that prevented players from switching weapons with an active jetpack ([https://github.com/multitheftauto/mtasa-blue/commit/180fbc0b5fdba95450e7a519f78f7588849349bf 180fbc0] by '''FileEX''')
* Fixed a bug where hitElement in the [[onClientVehicleCollision]] event was always nil for projectiles ([https://github.com/multitheftauto/mtasa-blue/commit/43cc7b3e34eb4680120eb8ebf40d31d845850df2 43cc7b3] by '''FileEX''')
* Fixed a bug where hydra flares did not work with [[createProjectile]] ([https://github.com/multitheftauto/mtasa-blue/commit/2bdac16d1d868f396786fbfdcfa2595004e1fff5 2bdac16] by '''FileEX''')
* Fixed inconsistent extra component names ([https://github.com/multitheftauto/mtasa-blue/commit/d4f884935626c638dca0f7f45c71cfb22c4e2d72 d4f8849] by '''FileEX''')
* Fixed a bug where after changing the key in the bind settings, only the key for the "down" status changed, while the "up" key remained unchanged.([https://github.com/multitheftauto/mtasa-blue/commit/3ebefc37951e24cbfb25035d99045d67571b5324 3ebefc3] by '''FileEX''')
* Maked frame graph scale accordingly to resolution ([https://github.com/multitheftauto/mtasa-blue/commit/e431474c676a253004a26d86fc9e1a6100d329d4 e431474] by '''ffsPLASMA''')
* Fixed old [[setElementModel]] memory leak ([https://github.com/multitheftauto/mtasa-blue/commit/4e7afa2586c6992a75ac5312378c1096d87148ae 4e7afa2] by '''tederis''')
* Fixed [[getObjectProperty]] returns invalid ''air_ressistance'' property ([https://github.com/multitheftauto/mtasa-blue/commit/b51e1116283e9ec453881d3c48229b96c6198d5a b51e111] by '''FileEX''')
* Fixed missing states in [[getPedControlState]] ([https://github.com/multitheftauto/mtasa-blue/commit/3333a115f1a14f00378161681aeba609b4e993c0 3333a11] by '''FileEX''')
* Fixed for randomly bright objects after weapon change ([https://github.com/multitheftauto/mtasa-blue/commit/9b9120c73ec97bf1b2f24703889a62fc19326f1f 9b9120c] by '''FileEX''')
* Fixed some small problems with Device Selection Dialog ([https://github.com/multitheftauto/mtasa-blue/commit/6f90880bee4d9169d4eda5f6afc63f4ed1bf652f 6f90880] by '''forkerer''')
* Allow dynamic models to be created as buildings ([https://github.com/multitheftauto/mtasa-blue/commit/642438ec1302daba50b6f6069844e96cbaa31818 642438e] by '''TheNormalnij''')
* Fixed crash when disconnecting from server after creating projectiles ([https://github.com/multitheftauto/mtasa-blue/commit/9ab6104d9c1ec246fde29ae6bf303ae5848bbbe1 9ab6104] by '''TheNormalnij''')
* Allow client peds to enter/exit client vehicles ([https://github.com/multitheftauto/mtasa-blue/pull/3678 #3678], [https://github.com/multitheftauto/mtasa-blue/commit/67beec77b06897552dc2c756c15283bfdc19b143 67beec7] by '''gownosatana''' and '''Tracer''')
* Use immersive dark mode on game window ([https://github.com/multitheftauto/mtasa-blue/commit/fd9520498919ae191c718c49b2a5c742bbbf8239 fd95204] by '''FileEX''')
* Added damageable objects support for [[engineRequestModel]] ([https://github.com/multitheftauto/mtasa-blue/commit/21593b9239765343ad5a4975c9f8424e571a036d 21593b9] by '''TheNormalnij''')
* Fixed crash with [[setElementHealth]] in [[onClientPedDamage]] event ([https://github.com/multitheftauto/mtasa-blue/commit/2d3397df56827f7c218689873f8b4741ea9af44e 2d3397d] by '''FileEX''')
* Fixed [[setPedControlState]] is aborted when ped created/player join ([https://github.com/multitheftauto/mtasa-blue/commit/8117ebcb95d3e3c35c400ee073a6ebab81e3f9fb 8117ebc] by '''FileEX''')
* Added '''buildings''' support to [[engineApplyShaderToWorldTexture]] ([https://github.com/multitheftauto/mtasa-blue/commit/fe1dd063170aef6a866bc241c305278a73200fdd fe1dd06] by '''TheNormalnij''')
* Fixed unintended behavior for ped control states ([https://github.com/multitheftauto/mtasa-blue/commit/a38e6acaf5c0fd83b5627660439f36d380cd26e6 a38e6ac] by '''Nico834''')
* Fixed SVG colors bug ([https://github.com/multitheftauto/mtasa-blue/commit/04f297b7b1aecb3753c8fbfa19fa9627abf422b4 04f297b] by '''TheNormalnij''')
* Fixed "CEF Launcher" process remaining after closing MTA ([https://github.com/multitheftauto/mtasa-blue/commit/a6c00278a5329e3b2b870b298d78565b14a7bed2 a6c0027] by '''botder''')
* Removed ''login'' cmd from chat history ([https://github.com/multitheftauto/mtasa-blue/commit/4639aea8a5544bfa4460bfcc8bba1d5b032e931a 4639aea] by '''PlatinMTA''')
* Fixed in-game updater dialog incorrectly showing 0% progress ([https://github.com/multitheftauto/mtasa-blue/commit/40d9ac11a9864d4f26c9eb1979e3a30ec0624061 40d9ac1] by '''Dutchman101''')
* Fixed invalid references counter to TXD after [[engineSetModelTXDID]] (top 1 crash according to players crash stats) ([https://github.com/multitheftauto/mtasa-blue/commit/1b7e9e82997fb4ac2eec5722d9134299902a16e6 1b7e9e8] by '''TheNormalnij''')
* Fixed server cache memory leak on connecting to another server ([https://github.com/multitheftauto/mtasa-blue/commit/e3476592fc46dc28f9da98f525797ae94ebf3ec3 e347659] by '''Lpsd''')
* Added the ability to set CPU affinity (CPU 0) in the '''advanced''' tab in the settings ([https://github.com/multitheftauto/mtasa-blue/commit/d04c92b24e7b85f6015fa93192ddda06e9023c85 d04c92b] by '''FileEX''')
* Fixed crash in ''CClientDisplayManager'' (top 2 crash according to players crash stats) ([https://github.com/multitheftauto/mtasa-blue/commit/0df0a4b40f7aea7c16473d0844a03fcece888420 0df0a4b] by '''Lpsd''')
* Set main menu FPS limit to current display refresh rate ([https://github.com/multitheftauto/mtasa-blue/commit/acbcc8e03ba8ac677a9c2c8182fb6f24868cae46 acbcc8e] by '''samr46''')
* [[setSoundEffectParameter]] and [[getSoundEffectParameters]] can be now used also on players! ([https://github.com/multitheftauto/mtasa-blue/commit/20851ecf7d69cc42fc00a62446a87d7e99c1e19d 20851ec] by '''tederis''')
* Fixed elements sometimes being visible from other dimensions in the current dimension ([https://github.com/multitheftauto/mtasa-blue/commit/9af03b3263a5a320e2f92140f6caa6c94b9fe9a5 9af03b3], [https://github.com/multitheftauto/mtasa-blue/commit/1dff560099459bc1b8248ef50643886158b0d731 1dff560] by '''FileEX''' & '''tederis''')
* Fixed bug "Copying text from CEF Browser shows Chinese characters in console" ([https://github.com/multitheftauto/mtasa-blue/commit/892beb0457b461d5afd5d91e86763181bdb972d3 892beb0] by '''ColombuxMaximus''')
* Fixed a bug where hidden vehicle components became visible after changing the variant or handling ([https://github.com/multitheftauto/mtasa-blue/commit/1d81347ee7e2614cd94e4b1807947d2c98b3305f 1d81347] by '''ColombuxMaximus''')
* Fixed persian characters in main menu & CEGUI ([https://github.com/multitheftauto/mtasa-blue/commit/efb2edfa853aa9a95f39ed9a843c3230b2e627cf efb2edf] by '''tzwer''')
* Added new movement states to [[getPedMoveState]] and fixed incorrect returning of "fall" ([https://github.com/multitheftauto/mtasa-blue/commit/c43c1b98b8ec0b7253d98c65b405ead482a765d8 c43c1b9], [https://github.com/multitheftauto/mtasa-blue/commit/797331fadbca4367f6cfd43633e48af44a99a115 797331f] by '''FileEX''')
* Fixed a bug where friendly fire did not prevent fire damage ([https://github.com/multitheftauto/mtasa-blue/commit/9c4397707dd2a94d8a6124d6b502d39793f0d2ba 9c43977] by '''FileEX''')
* Fixed [[engineReplaceModel]] memory leak & potential crash ([https://github.com/multitheftauto/mtasa-blue/commit/1dbbfd025c5ff791f31e1ef4f255514198f88d0c 1dbbfd0] by '''FileEX''')
* Fixed '''ALT + F4''' not working ([https://github.com/multitheftauto/mtasa-blue/commit/93963a98f24fdb5e8374baaddaa6d99260be967e 93963a9] by '''lopezloo''')
* Fixed [[setPedOnFire]] doesn't cancel '''TASK_SIMPLE_PLAYER_ON_FIRE''' ([https://github.com/multitheftauto/mtasa-blue/commit/2a2f31bccd9d90adfc2b03f1f63248b9d016c725 2a2f31b] by '''FileEX''')
* Fixed crash related to buildings ([https://github.com/multitheftauto/mtasa-blue/commit/4bcded5c89caffd005b266021d3c1bbd83a554cb 4bcded5] by '''tederis''')
* Fixed client freeze in some locations on the map ([https://github.com/multitheftauto/mtasa-blue/commit/3a376e479201b30b27488a5a674d7d816397e79a 3a376e4] by '''tederis''')
* Added disconnect warning when using quick connect while connected to server ([https://github.com/multitheftauto/mtasa-blue/commit/be395665c0f5094793b923e9f4fb94056ccff961 be39566] by '''omar-o22''')
* Added missing trashcan in help section ([https://github.com/multitheftauto/mtasa-blue/commit/853a7d54a25bc09ee421ac837f22201882ece1b7 853a7d5] by '''omar-o22''')
* Fixed [[getElementsWithinRange]] not working with building element type ([https://github.com/multitheftauto/mtasa-blue/commit/5ad35b46004f4e758348a1a0c0b1024d4becb3c4 5ad35b4], [https://github.com/multitheftauto/mtasa-blue/commit/24bd2187c099a60881cabb001fbb6bb326044c81 24bd218] by '''PlatinMTA''' and '''omar-o22''')
* Fixed [[getElementDistanceFromCentreOfMassToBaseOfModel]] not working with building element type ([https://github.com/multitheftauto/mtasa-blue/commit/20d36cd3ef687108acf99f97b02965fa5dd6003b 20d36cd] by '''omar-o22''')
* Added ability to remove all domains from whitelist and blacklist ([https://github.com/multitheftauto/mtasa-blue/commit/280b6cd9917eb8e624fa037f3783eb958123a7a2 280b6cd] by '''omar-o22''')

=== Server ===
* Fixed bullet sync check in CBulletsyncPacket by verifying total ammo instead of clip ammo ([https://github.com/multitheftauto/mtasa-blue/commit/ca06762413833e1c7f8d17970334607763414a45 ca06762] by '''shadylua''')
* Check deprecated account name length on [[banPlayer]] to fix all players getting kicked ([https://github.com/multitheftauto/mtasa-blue/commit/b5e2332ca5857f3e984467ca0cb8163ec998ea06 b5e2332] by '''patrikjuvonen''')
* Fixed a crash in CHandlingManager ([https://github.com/multitheftauto/mtasa-blue/commit/b6867a0d2ed0b4ab12a4461c3f1ca7d667bdedbc b6867a0] by '''Olya-Marinova''')
* Removed min-version lua function from old MTA versions ([https://github.com/multitheftauto/mtasa-blue/commit/222b2720c93f29977fffb722f8d42ea3fb5f790d 222b272] by '''Olya-Marinova''')
* Disallow loadstring by default ([https://github.com/multitheftauto/mtasa-blue/commit/89e2d375d12deb026ee91fedc5e1ced04dc9a723 89e2d37] by '''srslyyyy''')
* Added valid values for 'donotbroadcastlan' setting ([https://github.com/multitheftauto/mtasa-blue/commit/f8d4422ad75c0d7f21894f9f868aa37ec6993a35 f8d4422] by '''Dark-Dragon''')
* Fixed "ped revives when syncer changes" ([https://github.com/multitheftauto/mtasa-blue/commit/af604ae7dfec742661206fb809f149140ce3a960 af604ae] by '''Zangomangu''')
* Fixed files not unloading after renaming ([https://github.com/multitheftauto/mtasa-blue/commit/2846e2794af1d9d441b7b988f49af521bd765fb0 2846e27] by '''W3lac3''')
* Added ability to limit client triggered events via [[triggerServerEvent]] ([https://github.com/multitheftauto/mtasa-blue/commit/eae47fe2f432d9053c425fd515ea27f963c254ec eae47fe] by '''Lpsd''')
* Added FileExists check to CMainConfig::AddMissingSettings ([https://github.com/multitheftauto/mtasa-blue/commit/1ebaa28e0381fb114b946f2f5a4d4bc5834ebd03 1ebaa28] by '''Lpsd''')
* Added server side weapon related checks ([https://github.com/multitheftauto/mtasa-blue/commit/86448ea52c7ee13e554a907c424aa3c891e51e31 86448ea] by '''NanoBob''')
* Added [[dbConnect]] option for MySQL ''"use_ssl=0"'' ([https://github.com/multitheftauto/mtasa-blue/commit/e6476767a9b6848467f0d123830dd2f90bd4442d e647676] by '''Lpsd''')
* Added ''content'' parameter to [[onPlayerPrivateMessage]] event ([https://github.com/multitheftauto/mtasa-blue/commit/79f8ed6a374d62e5cf1ec707b2ba25e3a959f509 79f8ed6] by '''FileEX''')
* Fix ability to move server-side vehicles that are far away from the player. New parameter can be set in the [[Server_mtaserver.conf#vehicle_contact_sync_radius|mtaserver.conf]] ([https://github.com/multitheftauto/mtasa-blue/commit/e3338c2fbbdb500c4ce28dc0677ceadef1f1ca4c e3338c2] by '''MegadreamsBE''')
* Added ''sync'' parameter for vehicles ([https://github.com/multitheftauto/mtasa-blue/commit/f88d31306d3c7fadfbc1542c85922612fd00b131 f88d313] by '''znvjder''')
* Fixed server-side pickup collision size ([https://github.com/multitheftauto/mtasa-blue/commit/49d97513e1eb2e0c96c5aa5a1d542d14131edd76 49d9751] by '''Proxy-99''')
* Fixed ''CSimBulletsyncPacket'' crash ([https://github.com/multitheftauto/mtasa-blue/commit/ee8bc92907a112a5584844329dbb07cc82326ad1 ee8bc92] by '''G-Moris''')
* Fixed onVehicleExit doesn't trigger if pulled out ([https://github.com/multitheftauto/mtasa-blue/commit/af4f7facca73bb68238437e6eff3504bd6f1cfe0 af4f7fa] by '''Proxy-99''')
* Fixed arguments in [[setPedAnimation]] being ignored when nil was passed ([https://github.com/multitheftauto/mtasa-blue/commit/f6f544e6b54054a06497fdf94cd077b862af8055 f6f544e] by '''FileEX''')
* Fixed Sirens not removed correctly ([https://github.com/multitheftauto/mtasa-blue/commit/9e419620069ec8ad5828c50295c1901685166cf9 9e41962] by '''Proxy-99''')
* Fixed a bug where [[setPedWeaponSlot]] did not update data in [[getPedWeapon]] and [[getPedWeaponSlot]] ([https://github.com/multitheftauto/mtasa-blue/commit/9615523faf84f584179412fb8e0cc04f9f4ee48f 9615523] by '''FileEX''')
* Added '''player''' parameter to [[onVehicleExplode]] ([https://github.com/multitheftauto/mtasa-blue/commit/1ec1f5be69d3ef99bd2e26fd3d008a7cecd0a5ad 1ec1f5b] by '''FileEX''')
* Excluded '''meta.xml''' from glob patterns for security reasons ([https://github.com/multitheftauto/mtasa-blue/commit/78f6d669adc97c51a825250dd4dbf1a4a4a0ff15 78f6d66] by '''FileEX''')
* Fixed the bug where changing a vehicle to one with a different number of seats caused passengers to experience network trouble ([https://github.com/multitheftauto/mtasa-blue/commit/1fcd732ca9031060602c8e2425e40ce602d35253 1fcd732] by '''FileEX''')
* Glob patterns added to meta.xml for HTML files ([https://github.com/multitheftauto/mtasa-blue/commit/7e6b4d02ec113b7ce3a6fd9937a6e8ad0a1ad9cb 7e6b4d0] by '''FileEX''')
* Fixed console not maintaining position & size when GUI skin changed ([https://github.com/multitheftauto/mtasa-blue/commit/30d8e6dbfe75db47cf396aa909f43c24c4dbe127] by '''NanoBob''')
* Added '''includeCustom''' argument for [[getValidPedModels]] clientside ([https://github.com/multitheftauto/mtasa-blue/commit/889567a7a0ecb8a8b8d938826d2395ef9f43a76b] by '''Fernando-A-Rocha''')
* Fixed '''min_mta_version''' tag for server ([https://github.com/multitheftauto/mtasa-blue/commit/8c0a01bac62ecc3e9510133dee9f8d6700065f03 8c0a01b] by '''Fernando-A-Rocha''')
* Allowed user to pass multiple resource names to start/stop/restart ([https://github.com/multitheftauto/mtasa-blue/commit/6f5fb9c65ee93a5c1692b0d3516a483dcea48f08 6f5fb9c] by '''botder''')
* Added sync peds/players animations for new players ([https://github.com/multitheftauto/mtasa-blue/commit/b32eafc70816ece8ad995d98d380d8f6e9950475 b32eafc] by '''FileEX''')
* Optimized processing big files by server ([https://github.com/multitheftauto/mtasa-blue/commit/cb90339aad461d3ee8c1008f2da10934afc38a4c cb90339] by '''AlexTMjugador''')
* Separate icon for ''mta-server.exe'' ([https://github.com/multitheftauto/mtasa-blue/commit/6cb9d3edf9686749e524f136985cefb53772898e 6cb9d3e] by '''Nico834''')
* Fixed a bug that caused warnings in debugscript when using depracated function names as variable names ([https://github.com/multitheftauto/mtasa-blue/commit/f23e39521b7e35ad5389e467360fbc525c099887 f23e395] by '''YelehaUwU''')
* [[onVehicleExplode]] can now be cancelled! ([https://github.com/multitheftauto/mtasa-blue/commit/fcb5b038981066f561f3792c2ae3d97d76d9d0fe fcb5b03] by '''Nico834''')
* Added '''eventName''' parameter to [[onPlayerTriggerEventThreshold]] ([https://github.com/multitheftauto/mtasa-blue/commit/76d7764c7ec408b77eb7b12379e88882e014527f 76d7764] by '''ColombuxMaximus''')

=== More Technical Changes and Bug Fixes ===
<section show="true">
:* Updated CLuaFunctionParser.h ([https://github.com/multitheftauto/mtasa-blue/commit/55647f4023c78a846870f7c96069fab411cff5c5 55647f4] by '''Xenius97''')
:* Fixed build after above update ([https://github.com/multitheftauto/mtasa-blue/commit/9dcc651d42ae78b7b04257e7612c5b594cb0fffd 9dcc651] by '''Pirulax''')
:* Fixed std::unordered_map<std::string, std::string> parsing ([https://github.com/multitheftauto/mtasa-blue/commit/005592417b42de63c3d8ba9c572a81cdc8f96164 0055924] by '''tederis''')
:* Addendum to [https://github.com/multitheftauto/mtasa-blue/pull/3251 #3251] ([https://github.com/multitheftauto/mtasa-blue/commit/9544a34a28d3b4e766d7d07a44d63a8fe45dc506 9544a34] by '''Lpsd''')
:* Fixes for [https://github.com/multitheftauto/mtasa-blue/pull/3251 #3251] ([https://github.com/multitheftauto/mtasa-blue/commit/07013d24766a6259f4115bd0349a86f790dbf5d0 07013d2] by '''Lpsd''')
:* Fixed SetStreamingBufferSize possibly accessing memory out-of-bounds ([https://github.com/multitheftauto/mtasa-blue/commit/e08b84fbfe6ad0431605b31c2ba5a50a8f116dc9 e08b84f] by '''Pirulax''')
:* Added a check to verify itemList validity ([https://github.com/multitheftauto/mtasa-blue/commit/668073787fa6b952d0f1520e8ccae0999dbdba13 6680737] by '''R4ven47''')
:* Various code clean ups and refactors
::* Removed COffsetsMP and EU addresses ([https://github.com/multitheftauto/mtasa-blue/commit/52b0115a2d9157b7a153b5f24316ff6fd053e79b 52b0115] by '''Merlin''')
::* Removed COffsets and EU addresses ([https://github.com/multitheftauto/mtasa-blue/commit/959141de324126245d2b5ebf029c924302ff64e9 959141d] by '''Merlin''')
::* Clean ups ''multiplayer_sa'' code ([https://github.com/multitheftauto/mtasa-blue/commit/38982043978dd1ec72230569a6d534792e7c18bd 3898204] by '''CrosRoad95''')
::* Removed old easter-egg & debug code ([https://github.com/multitheftauto/mtasa-blue/commit/b26f80c3d72d628d63807529b408be4b61a5be60 b26f80c], [https://github.com/multitheftauto/mtasa-blue/commit/530212f34fc44e95599ca5e39e608583ecdbb5cc 530212f] by '''botder''' and '''Merlin''')
::* Refactored entity hierarchy  ([https://github.com/multitheftauto/mtasa-blue/commit/fdaced046a9421a39de87b81eaf0f7de7c234c4b fdaced0] by '''Tracer''')
::* Removed unused symbol from ''CConsole'' class ([https://github.com/multitheftauto/mtasa-blue/commit/4fe9084a2e5c5eeed4b0a9a30a07607c812e923b 4fe9084] by '''Nico834''')
::* Refactored ''CLuaBlipDefs'' ([https://github.com/multitheftauto/mtasa-blue/commit/d05d09be8b9bd1327e37631411fa1e3b16c4dbb7 d05d09b], [https://github.com/multitheftauto/mtasa-blue/commit/c278c12debfd346377354017992543fc7cf6397b c278c12] by '''FileEX''')
::* Refactored ''CLuaTeamDefs'' ([https://github.com/multitheftauto/mtasa-blue/commit/74ffa1d0138ab3d848b0e081ca265f18ae6c7bd8 74ffa1d], [https://github.com/multitheftauto/mtasa-blue/commit/f37bbada1381370eeadabd4f4dde2a024ec48f5f f37bbad] by '''Nico834''')
::* Removed dead ''CAnimManagerSA'' code ([https://github.com/multitheftauto/mtasa-blue/commit/d18d7d35fb50fdeea3f70ad688a5857b29867185 d18d7d3] by '''G-Moris''')
::* Refactored class hierarchy and removed VTBL hacks ([https://github.com/multitheftauto/mtasa-blue/commit/61d1caffb5bfa9c620c08d43280150906dd172d5 61d1caf] by '''TheNormalnij''')
::* Refactored ''CWeaponSA'' and ''CPedSA'' classes ([https://github.com/multitheftauto/mtasa-blue/commit/a3b7c8519d0d167c66e70c8c7ed5d2f810b7ae39 a3b7c85], [https://github.com/multitheftauto/mtasa-blue/commit/2526a7dd6cde545e600792dcac3ab1b8ece0edec 2526a7d] by '''FileEX''')
::* Cleaning up client Common.h and moving enums to separate files ([https://github.com/multitheftauto/mtasa-blue/commit/1e56571479217f787b6444d48770f8aa69f14387 1e56571] by '''FileEX''')
:* Addd Comments to Frame Rate Fixes in CMultiplayerSA_FrameRateFixes.cpp ([https://github.com/multitheftauto/mtasa-blue/commit/e4e6d1b5a9609cb093a191db405c61339d4280d2 e4e6d1b] by '''Merlin''')
:* Fixed build after CEF update ([https://github.com/multitheftauto/mtasa-blue/commit/9980252446a6869609b1afa1ae1168282a99cb17 9980252] by '''TheNormalnij''')
:* Bump chromedriver from 114.0.2 to 119.0.1 in /utils/localization/generate-images ([https://github.com/multitheftauto/mtasa-blue/commit/5d8d3756d98b0272687b87c30adca2961eee86c8 5d8d375])
:* Bump axios from 1.4.0 to 1.6.1 in /utils/localization/generate-images ([https://github.com/multitheftauto/mtasa-blue/commit/ba018013085058905aa789c4fa3f39c4ed32fc69 ba01801])
:* Fixed file lock after img:destroy ([https://github.com/multitheftauto/mtasa-blue/commit/c2ccfd2c648a2d3f33ead2169262c30533f79bac c2ccfd2] by '''TheNormalnij''')
</section>
:* Bump follow-redirects from 1.15.2 to 1.15.6 in /utils/localization/generate-images ([https://github.com/multitheftauto/mtasa-blue/commit/437dbcd8024c5217c22ef0e38719f93f33f47ce5 437dbcd])
:* Fix permission check in File.create method ([https://github.com/multitheftauto/mtasa-blue/commit/92144a4d7383af09dfa05b7bcd3db09fa487e6fd 92144a4] by '''theSarrum''')
:* mbedTLS fix for cURL 8.8.0 ([https://github.com/multitheftauto/mtasa-blue/commit/4f7e0d87ec04e44d2e47f5b869c2d7c765817c0f 4f7e0d8] by '''Lpsd''')
:* Discord RPC Tweaks ([https://github.com/multitheftauto/mtasa-blue/commit/8ef351eabe46fd50da096247d8b6fc74508cb911 8ef351e] by '''theSarrum''')
:* Fixed small overhead in argument parser for strings ([https://github.com/multitheftauto/mtasa-blue/commit/d20582d770dfd2a1677d9981005b3b6d28fb8e4e d20582d] by '''TheNormalnij''')
:* Bump ws from 8.13.0 to 8.17.1 in /utils/localization/generate-images ([https://github.com/multitheftauto/mtasa-blue/commit/cc172fcae7654ead0d3530a4819c71f76205a175 cc172fc])
:* Generic exception type for argument parser instead of std::invalid_argument ([https://github.com/multitheftauto/mtasa-blue/commit/2043acfdb210a8f1158501e2fbb431b625bbf74d 2043acf] by '''tederis''')
:* Added comments for hooks in CMultiplayerSA_CrashFixHacks.cpp ([https://github.com/multitheftauto/mtasa-blue/commit/0327cb1bef9b234451f8a22ece9c6c70fdc9adb0 0327cb1] by '''FileEX''')
:* Optimization handling ([https://github.com/multitheftauto/mtasa-blue/commit/e3a8bd96d4eccb30e439ba8bd4a2029d01586154 e3a8bd9], [https://github.com/multitheftauto/mtasa-blue/commit/5ac6c8adad9c9ffd4a1c299c7cd548713e485bd6 5ac6c8a] by '''G-Moris''')
:* Added ability to use varargs in ArgumentParser functions ([https://github.com/multitheftauto/mtasa-blue/commit/8c2f95a5ffade0e7fb212b62282e69d7f433d36f 8c2f95a] by '''Tracer''')
:* Fixed google-breakpad in newer GCC versions ([https://github.com/multitheftauto/mtasa-blue/commit/5508c7e4058ad9d29cacc9964f8e84df2c60d14f 5508c7e] by '''Tracer''')
:* Validate serial on player join ([https://github.com/multitheftauto/mtasa-blue/commit/84437e49e6ebca758e1e87d93e7846f9aa99a673 84437e4] by '''Fernando-A-Rocha''')
:* Extract TXD class ([https://github.com/multitheftauto/mtasa-blue/commit/733683d70dc037fdcbb256fb17d86e93b fedd239] by '''TheNormalnij''')
:* Fixed a bug with desynchronization of the values of some fields of the ''CTickRateSettings'' structure ([https://github.com/multitheftauto/mtasa-blue/commit/af5b6968e0a28dbde7d92f3828dead0f1a936eec af5b696], [https://github.com/multitheftauto/mtasa-blue/commit/514a3b36d09906f09bb32e900c39dc09b1c29d10 514a3b3] by '''nweb''')
:* Fixed ''MinClientReqCheck'' and improve resource upgrade ([https://github.com/multitheftauto/mtasa-blue/commit/f0954109c0644c551ae3ec1df4474d1857e4bed8 f095410] by '''Fernando-A-Rocha''')
:* Refactored and improved player map (F11) ([https://github.com/multitheftauto/mtasa-blue/commit/2c5cf3226a573637b91d8b255d57113b7043dc28 2c5cf32] by '''Fernando-A-Rocha''')
:* Fixed ''CVector'' optional arguments ([https://github.com/multitheftauto/mtasa-blue/commit/6a70cf7def14db86980a499d0fdf4c63565915e1 6a70cf7] by '''Tracer''')
:* Fixed memory overwriting by ''EnumToString'' & ''StringToEnum'' ([https://github.com/multitheftauto/mtasa-blue/commit/3ab068ba213abca718ace47ac3bb8df9e4b1c3fc 3ab068b] by '''FileEX''')
:* Allow using ''std::variant'' with several pointers ([https://github.com/multitheftauto/mtasa-blue/commit/9d776c8bfc2680fc28857fc0a5dc4a4e40d4c3bf 9d776c8] by '''tederis''')
:* Fixed argument parser not distinguishing arrays from maps ([https://github.com/multitheftauto/mtasa-blue/commit/d4388a2452f4427bd56c3d93b80d4ea74c05b6e5 d4388a2] by '''FileEX''')
:* Fixed crash with nested arrays/maps in new argument parser ([https://github.com/multitheftauto/mtasa-blue/commit/ca877d33471fabbe970cf03d9d6d9b3413b6daa1 ca877d3] by '''tederis''')

== 13 Vendor Updates ==
=== Client ===
* Updated libpng to 1.6.50 ([https://github.com/multitheftauto/mtasa-blue/commit/c24b39d41fd768337c3d336a944588d53dfaba44] by '''Nico834''')
* Updatee CEF to 127.3.5+g114ea2a+chromium-127.0.6533.120 ([https://github.com/multitheftauto/mtasa-blue/commit/bca4dff8dc490328000d7653a9166704d859b7e5 bca4dff] by '''Dutchman101''')
* Updated Unifont to 15.1.05 ([https://github.com/multitheftauto/mtasa-blue/commit/02115a5c00e2480bbb3b829b655869e7436de955 02115a5] by '''Dutchman101''')

=== Server ===
* Updated cURL to 8.14.1 ([https://github.com/multitheftauto/mtasa-blue/commit/7c27c20da7503c68234cde0b726f10a3dcdf85e3] by '''Nico834''')
* Updated MySQL to 8.4.0 & OpenSSL to 3.3.1 ([https://github.com/multitheftauto/mtasa-blue/commit/a44d673bb8731506418fdbaa6690b339a98d82c1 a44d673] by '''botder''')
* Updated SQLite to 3.46.0 ([https://github.com/multitheftauto/mtasa-blue/commit/30e31af2ca1ae96e03386670a9df6db70336b968 30e31af] by '''Dutchman101''')

=== Shared ===
* Updated mbedTLS to 3.6.4 ([https://github.com/multitheftauto/mtasa-blue/commit/45955dad5471f49e2784e37cbafd1b92196abe96] by '''Nico834''')
* Updated 7-Zip Standalone plugins to 24.07 (24.7.0.0) ([https://github.com/multitheftauto/mtasa-blue/commit/9b979b2d5c7f4b885046a85d9895e58416563890 9b979b2] by '''Dutchman101''')
* Updated freetype to freetype-37cefe3 (freetype/freetype@37cefe3) ([https://github.com/multitheftauto/mtasa-blue/commit/89e022cb8586aba5bdacd7b56c7d45c9b7b95f97 89e022c] by '''Dutchman101''')
* Updated nvapi from r550 to r555 ([https://github.com/multitheftauto/mtasa-blue/commit/5fdcada80a18af530381b04f54c3c69b6988f479 5fdcada] by '''Dutchman101''')
* Updated unrar to 7.0.9 ([https://github.com/multitheftauto/mtasa-blue/commit/ab9461be5777427261bc3a330acb4c0f5cdc2c8b ab9461b] by '''Dutchman101''')
* Updated FreeType to 2.13.2 ([https://github.com/multitheftauto/mtasa-blue/commit/a783e994264d4e954489e31459505c53759ca7f1 a783e99] by '''Dutchman101''')
* Updated zlib from 1.2.13 to 1.3 ([https://github.com/multitheftauto/mtasa-blue/commit/0f37ac0b18845e9f035d0ca45bbb41b9cd1aa979 0f37ac0] by '''Dutchman101''')

== Resources ==
=== 46+ Changes and Bug Fixes ===

'''admin'''
:* Removed execute code functionality for safety reasons ([https://github.com/multitheftauto/mtasa-resources/commit/507a04937524997410e450a6d4292974fa801bf8 507a049] by '''srslyyyy''')
:* Updated skins.xml ([https://github.com/multitheftauto/mtasa-resources/commit/b5306484a789cc59b05f4182505ac07df3d90e07 b530648] by '''shadylua''')
:* Fixed warnings ([https://github.com/multitheftauto/mtasa-resources/commit/d7b02022fa8168fc300dd562118100265cf0688b d7b0202] by '''jlillis''')
:* Making the admin window focused ([https://github.com/multitheftauto/mtasa-resources/commit/33f7cc938d243687fa36fa300ec588b2d057d02c 33f7cc9] by '''Proxy-99''')
:* Resource settings button is only displayed if there are settings ([https://github.com/multitheftauto/mtasa-resources/commit/0224ef52c699f27bd6e0e6364fbc81ecd0ec345f 0224ef5] by '''T-MaxWiese-T''')
:* Fixed nil index error and removed invalid characters causing syntax errors ([https://github.com/multitheftauto/mtasa-resources/commit/79857393ddb42f52ee05cf5758d5fdc8c2ff845c 7985739] by '''rad3sh''')
:* Allow disabling/enabling default reporting system ([https://github.com/multitheftauto/mtasa-resources/commit/0dbb83df7d3e9a20a2c897612db778bf4e395c92 0dbb83d] by '''Viude''')
:* Updated clientcheckban setting to ban serial instead of IP ([https://github.com/multitheftauto/mtasa-resources/commit/fa5beb96e10d9f30d9565ca212fe901f88e413a5 fa5beb9] by '''Viude''')
:* Fixed that double clicking on a resource without setting opened the GUI settings window ([https://github.com/multitheftauto/mtasa-resources/commit/82d5b835b503594101a99041498501e19a433a79 82d5b83] by '''T-MaxWiese-T''')
:* Fixed gridlist bug in weapons/vehicles ([https://github.com/multitheftauto/mtasa-resources/commit/6ba5a88b8a5da4a9df67f20347056754ea5a2c87 6ba5a88] by '''omar-o22''')

'''admin2'''
:* Forward-ported permissions widget from admin1 and minor fixes ([https://github.com/multitheftauto/mtasa-resources/commit/25dcc4c655de26de0a2d0eb1b55ef7f3b3f6725e 25dcc4c] by '''Dark-Dragon''')
:* Fixed /report message viewer widget and minor fixes ([https://github.com/multitheftauto/mtasa-resources/commit/6dbdf2cf90d0e447879bea86942e01caf949b8f5 6dbdf2c] by '''Dark-Dragon''')
:* Refactored bans functionality ([https://github.com/multitheftauto/mtasa-resources/commit/d8c35b0a38a295d119054c4328a892c4e26be358 d8c35b0] by '''jlillis''')
:* Fixed messagebox not showing ([https://github.com/multitheftauto/mtasa-resources/commit/5afe0247e6ca44c5754a2d9a6a0af7bc8b57f967 5afe024] by '''FileEX''')
:* Added missing glitches and world properties ([https://github.com/multitheftauto/mtasa-resources/commit/6856aa075c8e5674379c2a89f355d8b167ab6fdb 6856aa0] by '''FileEX''')
:* Added content for "Users" sub-tab in the "Rights" tab ([https://github.com/multitheftauto/mtasa-resources/commit/3f8ecca953cc3dfa84e4d1b38b6b4c41f323688b 3f8ecca] by '''FileEX''')
:* Removed execute code functionality for safety reasons ([https://github.com/multitheftauto/mtasa-resources/commit/c4bc73a2b088b98116ece27065cc7f5a1dced15b c4bc73a] by '''jlillis''')
:* Replaced checkboxes with a gridlist for glitches and special world properties ([https://github.com/multitheftauto/mtasa-resources/commit/1dcb2953757c6741c93b9c63db33c032183047bc 1dcb295] by '''FileEX''')
:* Added ability to change server configuration settings ([https://github.com/multitheftauto/mtasa-resources/commit/118d58e383f631f111fe3f2463480182235c71d1 118d58e] by '''FileEX''')
:* Added content for "Resources" sub-tab in the "Rights" tab ([https://github.com/multitheftauto/mtasa-resources/commit/f16577e24ca9125eac5f2e96621077ad0d213b69 f16577e] by '''FileEX''')
:* Making the admin window focused ([https://github.com/multitheftauto/mtasa-resources/commit/33f7cc938d243687fa36fa300ec588b2d057d02c 33f7cc9] by '''Proxy-99''')
:* Fixed panel bind bug after reconnect ([https://github.com/multitheftauto/mtasa-resources/commit/c96bdd5297cf180f947596c1eded8929b4982e6c c96bdd5] by '''ricksterhd123''')
:* Added the new world special ([https://github.com/multitheftauto/mtasa-resources/commit/08ef1d07ee44540d1f74737e4871288568222331 08ef1d0] by '''omar-o22''')
:* Updated add ban GUI style ([https://github.com/multitheftauto/mtasa-resources/commit/52aec17bda8b63be70f02385400cf649952ac3ea 52aec17] by '''omar-o22''')

'''chatmanager'''
:* Added a new resource for chat handling and management ([https://github.com/multitheftauto/mtasa-resources/commit/4e45cb75a8780b0c191031091a4fcd2d76442aa7 4e45cb7], [https://github.com/multitheftauto/mtasa-resources/commit/3f0f0d09a640178e01de71fa9e9b2caa9c21bcfa 3f0f0d0] by '''omar-o22''' and '''srslyyyy''')

'''defaultstats'''
:* Don't re-apply stats on every respawn ([https://github.com/multitheftauto/mtasa-resources/commit/9fde199ec5025052468df0255bf5c5011ef29718 9fde199] by '''Dutchman101''')
:* Fixed issue where defaultstats did not set player stats correctly ([https://github.com/multitheftauto/mtasa-resources/commit/567d10c552305dae3f57d5c422a34c25f22fdc12 567d10c] by '''MittellBuurman''')

'''editor'''
:* Various fixes for local spawned or invalid elements ([https://github.com/multitheftauto/mtasa-resources/commit/4e3c57941cd789cff8d9ce240e99edca871a345d 4e3c579] by '''chris1384''')
:* Various bug fixes and improvements ([https://github.com/multitheftauto/mtasa-resources/commit/4674fa9c6dbff7a1073fb949cac44588c65df3fb 4674fa9] by '''IIYAMA12''')
:* Fixed rotation issues ([https://github.com/multitheftauto/mtasa-resources/commit/679c01b93132050548a86dba25ead7feaf9d5a1f 679c01b] by '''Nico834''')
:* Toggleable rotation mechanic and improve threshold ([https://github.com/multitheftauto/mtasa-resources/commit/83e2c79cbd959aa54c55d4220a5b4d38747e8353 83e2c79] by '''chris1384''')
:* Added missing objects and collisions ([https://github.com/multitheftauto/mtasa-resources/commit/4e83755d51345c0dc8e2e0f2ddf61588bf854641 4e83755] by '''THEGizmoOfficial''')

'''edf'''
:* Fixed massive lag after stopping ''editor'' resource ([https://github.com/multitheftauto/mtasa-resources/commit/4674fa9c6dbff7a1073fb949cac44588c65df3fb 4674fa9] by '''IIYAMA12''')

'''editor_main'''
:* Improvements ([https://github.com/multitheftauto/mtasa-resources/commit/5bf553f85cb9c53027814fe666268cb24ed66b2e 5bf553f], [https://github.com/multitheftauto/mtasa-resources/commit/e9b75fd615922c7d70f4e435a05fa933dcb9d2a5 e9b75fd] by '''q8X''')
:* Add xmlns namespace when saving map ([https://github.com/multitheftauto/mtasa-resources/commit/23fa3f38f71c2f3d28780df1b3ce163ab2eaae84 23fa3f3] by '''omar-o22''')

'''editor_gui'''
:* Fixed test panel issues ([https://github.com/multitheftauto/mtasa-resources/commit/e558c846e8b0589997f342f431b36fdc371da000 e558c84] by '''chris1384''')

'''fallout'''
:* Refactor & many improvements ([https://github.com/multitheftauto/mtasa-resources/commit/c733b69a735d004235ba61b1201ac1412acc6482 c733b69] by '''IIYAMA12''')

'''freeroam'''
:* Updated skins.xml ([https://github.com/multitheftauto/mtasa-resources/commit/cacbe40a805402dec3a62180b987d4b777817ea6 cacbe40] by '''shadylua''')
:* Added Walk styles ([https://github.com/multitheftauto/mtasa-resources/commit/4a18d7585a2fa45eaed18d4b4796744a235a23c5 4a18d75] by '''shadylua''')
:* Security improvements ([https://github.com/multitheftauto/mtasa-resources/commit/2ec92132036d0dc073279dda3c88d71f578d651f 2ec9213] by '''IIYAMA12''')
:* Fixed freezetime flickering ([https://github.com/multitheftauto/mtasa-resources/commit/b40f27be0274b641c2cddd4c75a6f86f73ea4941 b40f27b], [https://github.com/multitheftauto/mtasa-resources/commit/817aa1ea9130fbccb1a23b7410309af2f8a21ddc 817aa1e] by '''ricksterhd123''' and '''jlillis''')
:* Fixed map key bind interferes with race editor help ([https://github.com/multitheftauto/mtasa-resources/commit/e62bc5471433b347b16c15709d469209cf202390 e62bc54] by '''MittellBuurman''')
:* Fixed player blips staying visible after closing spawn map with F1 ([https://github.com/multitheftauto/mtasa-resources/commit/aaf2dd7ed7a0b6b6c6609a4ee5d8319101e8a674 1a5031c] by '''omar-o22''')

'''hedit'''
:* Added German localization [[File:Flag_de.png|x14px]] ([https://github.com/multitheftauto/mtasa-resources/pull/568/commits/c58df8666fbccfb0be73f27c52aa680dae2f0c1a bc33634] by '''shadylua''')
:* Added Brazilian Portuguese localization [[File:Flag_br.png|x14px]] ([https://github.com/multitheftauto/mtasa-resources/commit/d1b85d7dda45293ce497cf03f21eea2f59100b89 d1b85d7] by '''ricksterhd123''')
:* Added Hungarian localization [[File:Flag_hu.png|x18px]] ([https://github.com/multitheftauto/mtasa-resources/commit/53050dd0bf73a164969480c9277fc3c6b0601b7e 53050dd] by '''Nico834''')
:* Updated Turkish localization [[File:Tr.gif]] ([https://github.com/multitheftauto/mtasa-resources/commit/3044d00a796488870556b19b088ac505c332952c 3044d00] by '''mahlukat5''')
:* Updated Spanish localization [[File:Flag_es.png|x18px]] ([https://github.com/multitheftauto/mtasa-resources/commit/b74c2393cc15e403d4588ebb671659c16cc36269 b74c239] by '''kxndrick0''')

'''internetradio'''
:* Fixed that the GUI window of the resource "internetradio" collides with the GUI window of the resource "helpmanager" ([https://github.com/multitheftauto/mtasa-resources/commit/313f3dde6b7cdb389f11f1a62a6d3e8c093c159f 313f3dd] by '''T-MaxWiese-T''')
:* Improvements ([https://github.com/multitheftauto/mtasa-resources/commit/a3c9e17cf6b85374b5f9b5881937aee97da94745 a3c9e17] by '''srslyyyy''')
:* Added attaching to vehicles ([https://github.com/multitheftauto/mtasa-resources/commit/3dd5cbd32f092337707277fbecc5ee54988e07fc 3dd5cbd] by '''ds1-e''')
:* Added admin commands ([https://github.com/multitheftauto/mtasa-resources/commit/5c160212e190f74461d65fac1668cda07a2d0b11 https://github.com/multitheftauto/mtasa-resources/commit/5c160212e190f74461d65fac1668cda07a2d0b11] by '''ds1-e''')
:* Added ability to show speaker owner ([https://github.com/multitheftauto/mtasa-resources/commit/6189fc1eefce29c8467c5a1093eaa8bfd8ed97f0 6189fc1] by '''ds1-e''')
:* Fixed playSound3D and track name showing in other dimensions ([https://github.com/multitheftauto/mtasa-resources/commit/d4c04db009cdd68913fdb47bbc73acd91e63f981 d4c04db] by '''mateo-14'''
:* Added ability to edit the volume ([https://github.com/multitheftauto/mtasa-resources/commit/73ecb610fdc096926291e8c24c56eea7c43bb4d6 73ecb61], [https://github.com/multitheftauto/mtasa-resources/commit/254700cffdf5c6b054e8f6e17afb4b7342593a85 254700c] by '''omar-o22''' and '''srslyyyy''')

'''ip2c'''
:* Added missing fetchRemote aclrequest ([https://github.com/multitheftauto/mtasa-resources/commit/e1364c3ebcc956dbf7f61e2d89741837776edec2 e1364c3] by '''Fernando-A-Rocha''')
:* Added backed up file and .gitignore to ignore the real one (auto-updated) ([https://github.com/multitheftauto/mtasa-resources/commit/e182291a53c3c76a2cf45834ba313aa9d18c16f4 e182291] by '''Fernando-A-Rocha''')

'''ipb'''
:* Replaced the onClientResource start event with the onPlayerResourceStart event ([https://github.com/multitheftauto/mtasa-resources/commit/cca3a05adf7fc940b913453a5fad5d5f3c8e3518 cca3a05] by '''srslyyyy''')

'''parachute'''
:* Fixed warnings about min_mta_version ([https://github.com/multitheftauto/mtasa-resources/commit/b4119cca4665d63a3043f14c1624ce9c96700b96 b4119cc] by '''NetroX1993''')

'''playerblips'''
:* Fixed that the resource "playercolors" should be activated for teams ([https://github.com/multitheftauto/mtasa-resources/commit/2cd28db5fa891f361c5af07a491532378a820b83 2cd28db] by '''T-MaxWiese-T''')
:* Real-time update of settings ([https://github.com/multitheftauto/mtasa-resources/commit/9505b181fe7fc2bab53142746f73bc64a8fd984d 9505b18] by '''Nico834''')
:* Improved debug messages ([https://github.com/multitheftauto/mtasa-resources/commit/4084e5d369907d3ededd1b2eb19c916983680154 4084e5d] by '''T-MaxWiese-T''')
:* Fixed that when a player changed or joined teams the color of the blip was not updated ([https://github.com/multitheftauto/mtasa-resources/commit/ff80005f114a3d010624f7d54510ffde47dddb00 ff80005] by '''T-MaxWiese-T''')

'''playercolors'''
:* Player nametag color should revert to team color when the resource is stopped ([https://github.com/multitheftauto/mtasa-resources/commit/d45d2d0cd963186639d76ab1cb27ef6a042cd0bd d45d2d0] by '''T-MaxWiese-T''')
:* Fixed chat messages sent twice ([https://github.com/multitheftauto/mtasa-resources/commit/0547cf72514a7dc7efc987f47903c35b310a3b22 0547cf7] by '''Fernando-A-Rocha''')

'''performancebrowser'''
:* Fixed player names not being reinitialized on change ([https://github.com/multitheftauto/mtasa-resources/commit/3e0166dc7fa9c11c596a7958b02423b6aeff8410 3e0166d] by '''YelehaUwU''')

'''runcode'''
:* Added aclrequest for loadstring function ([https://github.com/multitheftauto/mtasa-resources/commit/c40b8095f054b6e87b46e1d53d9b6ec77cf943c7 c40b809] by '''IIYAMA12 ''')

'''scoreboard'''
:* Replaced drawing arrow from path to texture ([https://github.com/multitheftauto/mtasa-resources/commit/128f26952810804df6acb233ca9476853caa1286 128f269] by '''srslyyyy''')

'''speedometer'''
:* Display at resource start ([https://github.com/multitheftauto/mtasa-resources/commit/31a5ac4013c3633647178e695474da6632eb38b8 31a5ac4] by '''Nico834''')
:* Preventing pointer overflow ([https://github.com/multitheftauto/mtasa-resources/commit/8689cdc247a3fd16125524aac04eb054c398084c 8689cdc] by '''Nico834''')

'''superman'''
:* Fixes and improvements ([https://github.com/multitheftauto/mtasa-resources/commit/2b3bc102225b2f1c3144cffe290175e9a2c71728 2b3bc10], [https://github.com/multitheftauto/mtasa-resources/commit/e1c06c3c2581c16a6e05401381263a47dd6ac5f0 e1c06c3], [https://github.com/multitheftauto/mtasa-resources/commit/1e4319d180be0f482d42f2f32fbf2c1e5cd440cc 1e4319d] by '''ds1-e''')
:* Fixed a bug where you couldn't move after death while Superman is active ([https://github.com/multitheftauto/mtasa-resources/commit/715ee57664287083f7ecb299f534bc3093f796a0 715ee57] by '''omar-o22''')

'''votemanager'''
:* Fixed lint error ([https://github.com/multitheftauto/mtasa-resources/commit/c8630075317123e510645464a3bf56ebb244573b c863007] by '''Dark-Dragon''')

'''mapfixes'''
:* A new resource has been added that fixes many holes and bugs in the default map ([https://github.com/multitheftauto/mtasa-resources/commit/23f6bd94370440af5ed79a47bda1ff0caf92fa8e 23f6bd9] by '''Fernando-A-Rocha''')

'''gps'''
:* Added export functions for custom logic ([https://github.com/multitheftauto/mtasa-resources/commit/537d92d11b357cf9e795a7bb3ec87c13fa62c7bc 537d92d] by '''T-MaxWiese-T''')

'''deathmatch'''
:* Improvements and update ([https://github.com/multitheftauto/mtasa-resources/commit/a01ec8a86e636ca61f25a03d4ee30bd898754cbd a01ec8a], [https://github.com/multitheftauto/mtasa-resources/commit/b94ffddfd5b230544d54e5eca8c9c5d87dc69128 b94ffdd] by '''jlillis'''

'''race'''
:* Fixed automatic nextid assignment breaking ([https://github.com/multitheftauto/mtasa-resources/commit/2c695a9e793825a8cafd2ee3be490d2d8e9ad318 2c695a9] by '''lotsofs''')

'''voice_local'''
:* Improvements ([https://github.com/multitheftauto/mtasa-resources/commit/53cf63d83169018e0de9f45ecb565958855d717d 53cf63d] by '''Fernando-A-Rocha''')

'''Others / Uncategorized'''
:* Refactor of resources meta.xml ([https://github.com/multitheftauto/mtasa-resources/commit/6713b07a459739c06112ac3e608776f3f0696144 6713b07] by '''Fernando-A-Rocha''')

== Extra information ==
''More detailed information available on our GitHub repositories:
* [https://github.com/multitheftauto/mtasa-blue MTA:SA Blue]
* [https://github.com/multitheftauto/mtasa-resources MTA:SA Official Resources]

[[Category:Changelog]]
[[Category:Incomplete]]

SetAccountSerial

2025-07-26T08:00:16Z

Mohab:

{{server function}}
__NOTOC__
{{New feature/item|3.0161|1.6.0|23232|This function sets the serial number for a specified player account. It allows administrators to update or assign a new [[serial]] to registered accounts.}}

==Syntax==
<syntaxhighlight lang="lua">
bool setAccountSerial ( account theAccount, string serial )
</syntaxhighlight>
{{OOP||[[account]]:setSerial|serial|}}
===Required Arguments===
*'''theAccount:''' The account element to set the serial for
*'''serial:''' A valid 32-character hexadecimal string representing the new serial number

===Returns===
Returns ''true'' if the serial was successfully set, ''false'' otherwise.

==Example==

<syntaxhighlight lang="lua">
-- Simple example: Set a serial for a player's account
local player = getPlayerFromName("John")
local account = getPlayerAccount(player)
local newSerial = "A1B2C3D4E5F6789012345678901234AB"

if setAccountSerial(account, newSerial) then
outputChatBox("Serial updated successfully!")
else
outputChatBox("Failed to update serial!")
end
</syntaxhighlight>

<syntaxhighlight lang="lua">
-- Advanced example: Administrative command system
function changePlayerSerial(player, newSerial)
local account = getPlayerAccount(player)
if account and not isGuestAccount(account) then
if setAccountSerial(account, newSerial) then
outputChatBox("Serial number updated successfully!", player, 0, 255, 0)
return true
else
outputChatBox("Failed to update serial number. Invalid format!", player, 255, 0, 0)
return false
end
else
outputChatBox("You must be logged into a registered account.", player, 255, 0, 0)
return false
end
end

-- Command to set a player's account serial
addCommandHandler("setserial", function(player, cmd, targetPlayer, newSerial)
if not targetPlayer or not newSerial then
outputChatBox("Usage: /setserial <player> <32-char-hex-serial>", player)
return
end

local target = getPlayerFromName(targetPlayer)
if target then
if string.len(newSerial) == 32 and string.match(newSerial, "^[A-Fa-f0-9]+$") then
changePlayerSerial(target, newSerial)
else
outputChatBox("Serial must be 32 hexadecimal characters!", player, 255, 0, 0)
end
else
outputChatBox("Player not found!", player, 255, 0, 0)
end
end)
</syntaxhighlight>

==See Also==
*[[getAccountSerial]]
*[[getAccountsBySerial]]
*[[addAccount]]
*[[removeAccount]]
*[[isGuestAccount]]
*[[getPlayerAccount]]
{{Account functions}}

ResetVehicleAudioSettings

2025-07-25T17:51:13Z

Mohab:

{{client function}}
__NOTOC__
{{New feature/item|3.0161|1.6.0|23140|This function resets the audio properties of a specific vehicle instance back to its model's default settings. Any custom audio settings that were applied to the vehicle using [[setVehicleAudioSetting]] will be removed, restoring the original sound characteristics.}}

==Syntax==
<syntaxhighlight lang="lua">
bool resetVehicleAudioSettings ( vehicle theVehicle )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle:''' The vehicle element to reset audio settings for

===Returns===
Returns ''true'' if the vehicle audio settings were successfully reset, ''false'' otherwise.

{{Note|This function only affects the specific vehicle instance, not the vehicle model's default settings. After calling this function, the vehicle will use the default audio settings for its model.}}

==Example==

<syntaxhighlight lang="lua">
-- Reset audio settings for the player's current vehicle
local player = getLocalPlayer()
local vehicle = getPedOccupiedVehicle(player)

if vehicle then
local success = resetVehicleAudioSettings(vehicle)
if success then
outputChatBox("Vehicle audio settings have been reset to default.")
else
outputChatBox("Failed to reset vehicle audio settings.")
end
else
outputChatBox("You must be in a vehicle to use this command.")
end
</syntaxhighlight>

==See Also==
*[[getVehicleAudioSettings]]
*[[setVehicleAudioSetting]]
*[[getVehicleModelAudioSettings]]
*[[setVehicleModelAudioSetting]]
*[[resetVehicleModelAudioSettings]]
{{Client vehicle functions}}