https://wiki.multitheftauto.com/api.php?action=feedcontributions&feedformat=atom&user=FloxMulti Theft Auto: Wiki - User contributions [en]2026-04-10T03:42:04ZUser contributionsMediaWiki 1.39.3https://wiki.multitheftauto.com/index.php?title=GetVehicleComponentPosition&diff=82790GetVehicleComponentPosition2026-04-03T20:06:56Z<p>Flox: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Client function}}<br />
This function gets the component position of a [[vehicle]]. The vehicle must be streamed in.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
float, float, float getVehicleComponentPosition ( vehicle theVehicle, string theComponent [, string base = "root" ] )<br />
</syntaxhighlight><br />
{{OOP||[[vehicle]]:getComponentPosition||setVehicleComponentPosition}}<br />
<br />
===Required Arguments=== <br />
*'''theVehicle:''' The [[vehicle]] you wish to get component position of.<br />
*'''theComponent:''' A [[Vehicle_Components|vehicle component]] (this is the frame name from the model file of the component you wish to modify)<br />
<br />
===Optional Arguments=== <br />
{{New feature/item|3.0141|1.4.0|7013|<br />
*'''base:''' A string representing what the returned position is relative to. It can be one of the following values:<br />
**'''parent:''' The position is relative to the parent component.<br />
**'''root:''' The position is relative to the root component.<br />
**'''world:''' The position is a world position.<br />
}}<br />
<br />
===Returns=== <br />
Returns three ''floats'' indicating the position of the component, ''x'', ''y'' and ''z'' respectively.<br />
<br />
==Example==<br />
<section class="client" show="true" name="This example gets the name and the position of the components and outputs it in the chat."><br />
<syntaxhighlight lang="lua"><br />
addCommandHandler("vcp", -- short for 'vehicle component position'<br />
function()<br />
local theVeh = getPedOccupiedVehicle(localPlayer)<br />
local getComponent = getVehicleComponents(theVeh) -- returns table with all the components of the vehicle<br />
if (theVeh) then<br />
for k in pairs (getComponent) do<br />
local x, y, z = getVehicleComponentPosition(theVeh, k)<br />
outputChatBox("Position of "..k.." is"..x.." "..y.." "..z)<br />
end<br />
end<br />
end<br />
)<br />
</syntaxhighlight><br />
</section><br />
<br />
<br />
<section class="client" show="true" name="This example shows every components name in 3D(Only for streamedin vehicles)"><br />
<syntaxhighlight lang="lua"><br />
local showComponents = false<br />
<br />
bindKey("F5", "down", function() showComponents = not showComponents end)<br />
<br />
addEventHandler("onClientRender", root, function()<br />
if not showComponents then return end<br />
<br />
for _, veh in pairs(getElementsByType("vehicle", root, true)) do<br />
for compname in pairs(getVehicleComponents(veh)) do<br />
local x, y = getScreenFromWorldPosition(getVehicleComponentPosition(veh, compname, "world"))<br />
<br />
if x then<br />
dxDrawText(compname, x, y, 0, 0)<br />
end<br />
end <br />
end<br />
end)<br />
</syntaxhighlight><br />
Rectify the warning code and render it.<br />
<syntaxhighlight lang="lua"><br />
local showComponents = false<br />
<br />
bindKey("F5", "down", function() showComponents = not showComponents end)<br />
<br />
addEventHandler("onClientRender", root, function()<br />
if not showComponents then return end<br />
local playerVeh = getPedOccupiedVehicle(localPlayer) <br />
if not playerVeh then return end -- If we're not in the car, we don't do anything<br />
-- We only check the components of your machine<br />
local components = getVehicleComponents(playerVeh)<br />
if components then<br />
for compname in pairs(components) do<br />
local px, py, pz = getVehicleComponentPosition(playerVeh, compname, "world")<br />
if px then<br />
local sx, sy = getScreenFromWorldPosition(px, py, pz)<br />
if sx then<br />
local text = string.format("%s\n[%.2f, %.2f, %.2f]", compname, px, py, pz)<br />
dxDrawText(text, sx, sy, sx, sy, tocolor(255, 255, 0, 255), 0.8, "default-bold", "center", "bottom")<br />
end<br />
end<br />
end <br />
end<br />
end)<br />
</syntaxhighlight><br />
</section><br />
<br />
==Changelog==<br />
{{ChangelogHeader}}<br />
{{ChangelogItem|1.4.0-9.07013|Added '''base''' argument}}<br />
<br />
==See Also==<br />
{{Client_vehicle_functions}}</div>Floxhttps://wiki.multitheftauto.com/index.php?title=GetVehicleComponentPosition&diff=82789GetVehicleComponentPosition2026-04-03T19:55:00Z<p>Flox: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Client function}}<br />
This function gets the component position of a [[vehicle]]. The vehicle must be streamed in.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
float, float, float getVehicleComponentPosition ( vehicle theVehicle, string theComponent [, string base = "root" ] )<br />
</syntaxhighlight><br />
{{OOP||[[vehicle]]:getComponentPosition||setVehicleComponentPosition}}<br />
<br />
===Required Arguments=== <br />
*'''theVehicle:''' The [[vehicle]] you wish to get component position of.<br />
*'''theComponent:''' A [[Vehicle_Components|vehicle component]] (this is the frame name from the model file of the component you wish to modify)<br />
<br />
===Optional Arguments=== <br />
{{New feature/item|3.0141|1.4.0|7013|<br />
*'''base:''' A string representing what the returned position is relative to. It can be one of the following values:<br />
**'''parent:''' The position is relative to the parent component.<br />
**'''root:''' The position is relative to the root component.<br />
**'''world:''' The position is a world position.<br />
}}<br />
<br />
===Returns=== <br />
Returns three ''floats'' indicating the position of the component, ''x'', ''y'' and ''z'' respectively.<br />
<br />
==Example==<br />
<section class="client" show="true" name="This example gets the name and the position of the components and outputs it in the chat."><br />
<syntaxhighlight lang="lua"><br />
addCommandHandler("vcp", -- short for 'vehicle component position'<br />
function()<br />
local theVeh = getPedOccupiedVehicle(localPlayer)<br />
local getComponent = getVehicleComponents(theVeh) -- returns table with all the components of the vehicle<br />
if (theVeh) then<br />
for k in pairs (getComponent) do<br />
local x, y, z = getVehicleComponentPosition(theVeh, k)<br />
outputChatBox("Position of "..k.." is"..x.." "..y.." "..z)<br />
end<br />
end<br />
end<br />
)<br />
</syntaxhighlight><br />
</section><br />
<br />
<br />
<section class="client" show="true" name="This example shows every components name in 3D(Only for streamedin vehicles)"><br />
<syntaxhighlight lang="lua"><br />
local showComponents = false<br />
<br />
bindKey("F5", "down", function() showComponents = not showComponents end)<br />
<br />
addEventHandler("onClientRender", root, function()<br />
if not showComponents then return end<br />
<br />
for _, veh in pairs(getElementsByType("vehicle", root, true)) do<br />
for compname in pairs(getVehicleComponents(veh)) do<br />
local x, y = getScreenFromWorldPosition(getVehicleComponentPosition(veh, compname, "world"))<br />
<br />
if x then<br />
dxDrawText(compname, x, y, 0, 0)<br />
end<br />
end <br />
end<br />
end)<br />
</syntaxhighlight><br />
Fix warning code<br />
<syntaxhighlight lang="lua"><br />
local showComponents = false<br />
<br />
bindKey("F5", "down", function() showComponents = not showComponents end)<br />
<br />
addEventHandler("onClientRender", root, function()<br />
if not showComponents then return end<br />
<br />
local playerVeh = getPedOccupiedVehicle(localPlayer)<br />
if not playerVeh then return end -- If we're not in the car, we don't do anything<br />
<br />
-- We only check the components of your machine<br />
local components = getVehicleComponents(playerVeh)<br />
if components then<br />
for compname in pairs(components) do<br />
local px, py, pz = getVehicleComponentPosition(playerVeh, compname, "world")<br />
if px then<br />
local sx, sy = getScreenFromWorldPosition(px, py, pz)<br />
if sx then<br />
dxDrawText(compname, sx, sy, 0, 0)<br />
end<br />
end<br />
end <br />
end<br />
end)<br />
</syntaxhighlight><br />
</section><br />
<br />
==Changelog==<br />
{{ChangelogHeader}}<br />
{{ChangelogItem|1.4.0-9.07013|Added '''base''' argument}}<br />
<br />
==See Also==<br />
{{Client_vehicle_functions}}</div>Floxhttps://wiki.multitheftauto.com/index.php?title=IsResourceRunning&diff=82788IsResourceRunning2026-04-02T03:41:55Z<p>Flox: /* Example check isResourceRunning(resName) */</p>
<hr />
<div>__NOTOC__ <br />
{{Shared function}}<br />
<br />
==Syntax== <br />
*'''isResourceRunning''' You can insert this code example in your resources.<br />
<br />
===Required Arguments=== <br />
*'''isResourceRunning:''' The value to check resources<br />
<br />
==Example check isResourceRunning(resName)==<br />
<section name="isResourceRunning" class="shared" show="true"><br />
You can insert this code example in your resources.<br />
<syntaxhighlight lang="lua"><br />
function isResourceRunning(resName)<br />
local res = getResourceFromName(resName)<br />
return (res) and (getResourceState(res) == "running")<br />
end<br />
<br />
-- Example of inserting into system code:<br />
--[[<br />
if isResourceRunning("admin") then<br />
--code<br />
else<br />
--alert<br />
end<br />
<br />
addCommandHandler('pos', function (commandName)<br />
if isResourceRunning("admin") then<br />
local x,y,z = getElementPosition(localPlayer)<br />
outputChatBox( x ..', '.. y ..', '.. z, 255, 255, 255 )<br />
else<br />
outputChatBox("The resource is not running 'admin'.", 255, 0, 0)<br />
end<br />
end )<br />
]]<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Resource_functions}}</div>Floxhttps://wiki.multitheftauto.com/index.php?title=DbConnect&diff=82787DbConnect2026-04-02T03:23:30Z<p>Flox: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function opens a connection to a database and returns an element that can be used with [[dbQuery]]. To disconnect use [[destroyElement]].<br />
{{Note|Connecting and disconnecting many times can have a performance impact on the server. For optimal performance it is recommended that you use dbConnect only once when the resource starts, and share the connection element with the whole script.}}<br />
{{Note|In MySQL 8.0 and later, you can choose between '''`caching_sha2_password`''', '''`sha256_password`''', or '''`mysql_native_password`''' for password management.<br />
* If you opt for '''`caching_sha2_password`''' or '''`sha256_password`''', SSL is not mandatory but recommended for secure authentication.<br />
* If you choose '''`mysql_native_password`''', you can set it as the default authentication plugin:<br />
** In the '''`mysqld.cnf`''' configuration file, by adding or modifying the following line: '''<nowiki>default-authentication-plugin=mysql_native_password</nowiki>'''<br />
** Using SQL queries (e.g., ALTER USER).<br />
** In PHPMyAdmin (via the user settings page).<br />
Please note that starting with MySQL 9.0, '''`mysql_native_password`''' will no longer be available, and only '''`caching_sha2_password`''' and '''`sha256_password`''' will be supported.<br />
}}<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
element dbConnect ( string databaseType, string host [, string username = "", string password = "", string options = "" ] )<br />
</syntaxhighlight><br />
{{OOP||[[Connection]]}}<br />
===Required Arguments===<br />
*'''databaseType:''' The type of database. This can be either ''sqlite'' or ''mysql''<br />
*'''host:''' The target to connect to. The format of this depends on the database type.<br />
** For SQLite it is a [[filepath]] to a SQLite database file. If the filepath starts with ":/" then the server's global databases directory is used. The file will be created if it does not exist.<br />
** For MySQL it is a list of key=value pairs separated by semicolons. Supported keys are:<br />
*** '''dbname''': Name of the database to use e.g. ''dbname=test''<br />
*** '''host''': Host address e.g. ''host=127.0.0.1''<br />
*** '''port''': Host port e.g. ''port=3306'' (optional, defaults to standard MySQL port if not used)<br />
*** '''unix_socket''': Unix socket or named pipe to use (optional)<br />
***'''charset''': Communicate with the server using a character which is different from the default e.g. ''charset<nowiki>=</nowiki>utf8'' (optional)<br />
<br />
===Optional Arguments===<br />
*'''username:''' Usually required for MySQL, ignored by SQLite <br />
*'''password:''' Usually required for MySQL, ignored by SQLite <br />
*'''options :''' List of key=value pairs separated by semicolons. Supported keys are:<br />
**'''share''' which can be set to 0 or 1. (Default value for SQLite is "share=1", for MySQL is "share=0"). When set to 1, the connection is shared and will be used by other calls to dbConnect with the same host string. This is usually a good thing for SQLite connections, but not so good for MySQL unless care is taken.<br />
**'''batch''' which can be set to 0 or 1. (Default is "batch=1"). When set to 1, queries called in the same frame are automatically batched together which can significantly speed up inserts/updates. The downside is you lose control of the feature that is used to achieve batching (For SQLite it is transactions, for MySQL it is autocommit mode). Therefore, if you use transactions, lock tables or control autocommit yourself, you may want to disable this feature.<br />
**'''autoreconnect''' which can be set to 0 or 1. (Default value "autoreconnect=1"). When set to 1, dropped connections will automatically be reconnected. Note that session variables (incl. SET NAMES), user variables, table locks and temporary tables will be reset because of the reconnection. So if you use these fancy features, you will need to turn autoreconnect off and cope with dropped connections some other way.<br />
**'''log''' which can be set to 0 or 1. (Default value "log<nowiki>=</nowiki>1"). When set to 0, activity from this connection will not be recorded in the [[Server_Commands#debugdb|database debug log file]].<br />
**'''tag''' (Default value "tag<nowiki>=</nowiki>script"). A string which helps identify activity from this connection in the [[Server_Commands#debugdb|database debug log file]].<br />
**'''suppress''' A comma separated list of error codes to ignore. (eg. "suppress<nowiki>=</nowiki>1062,1169").<br />
**'''multi_statements''' Enable multiple statements (separated by a semi-colon) in one query. Use [[dbPrepareString]] when building a multiple statement query to reduce SQL injection risks.<br />
**'''queue''' Name of the queue to use. (Default value for SQLite is "sqlite", for MySQL default is the host string from the '''host''' argument). Asynchronous database queries in the same queue are processed in order, one at a time. Any name can be used.<br />
**'''use_ssl''' which can be set to 0 or 1. (Default value is 0), ignored by SQLite<br />
**{{New feature/item|3.0161|1.6.0|22497|'''get_server_public_key''' which can be set to 0 or 1. (Default value is 1), ignored by SQLite. When set to 1, this enables the client to request from the server the public key required for RSA key pair-based password exchange. This option applies to clients that authenticate with the <code>caching_sha2_password</code> authentication plugin.}}<br />
<br />
===Returns===<br />
Returns a database connection element unless there are problems, in which case it return ''false''.<br />
<br />
==Remarks==<br />
Under certain platforms, for example on Unix-based OSes like Linux, using this function could fail with a debug warning containing "[Could not connect]" accompanied by a prior debug error explaining the problem. In that case you should check the [[Server Manual]] to see if you have missed any recommended (best-effort) steps for server set-up.<br />
<br />
==Example==<br />
This example opens a connection to a SQLite database file in the current resource<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in another resource<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":resname/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in the global databases directory<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in a sub directory of the global databases directory<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":/example/sub/dir/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a MySQL database called 'frank' at server ip 1.2.3.4 using utf8 character set and allows the connection to be shared. Note that changing the database or other connection dependent settings affect all connections that are shared.<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "mysql", "dbname=frank;host=1.2.3.4;charset=utf8", "username", "password", "share=1" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database is disallows sharing of the connection<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db", "", "", "share=0" )<br />
</syntaxhighlight><br />
<br />
This example output debug message, if the connection with SQLite database was established or not<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db" )<br />
<br />
if test_db then<br />
outputDebugString( "Connection with database was successfully established." )<br />
else<br />
outputDebugString( "Connection with database couldn't be established." )<br />
end<br />
</syntaxhighlight><br />
<br />
The folowing example shows how you could approach a common resource for database operations with exported functions ('''query''' and '''execute'''):<br />
<br />
<syntaxhighlight lang="lua"><br />
function connect()<br />
DBConnection = dbConnect( "mysql", "dbname=DBNAME;host=HOST;charset=utf8", "USERNAME", "PASSWORD" )<br />
if (not DBConnection) then<br />
outputDebugString("Error: Failed to establish connection to the MySQL database server")<br />
else<br />
outputDebugString("Success: Connected to the MySQL database server")<br />
end<br />
end<br />
<br />
addEventHandler("onResourceStart",resourceRoot, connect)<br />
<br />
function query(...)<br />
local queryHandle = dbQuery(DBConnection, ...)<br />
if (not queryHandle) then<br />
return nil<br />
end<br />
local rows = dbPoll(queryHandle, -1)<br />
return rows<br />
end<br />
<br />
function execute(...)<br />
local queryHandle = dbQuery(DBConnection, ...)<br />
local result, numRows = dbPoll(queryHandle, -1)<br />
return numRows<br />
end<br />
<br />
function getDBConnection()<br />
return DBConnection<br />
end<br />
</syntaxhighlight><br />
<br />
The following example illustrates an exemplary approach to utilizing a common resource for database operations, employing exported functions such as '''dbQuery''', '''dbExec''', '''dbQueryAsync''', '''dbPrepareString''', and '''dbQueryAsyncMultiple.''':<br />
<syntaxhighlight lang="lua"><br />
--[[<br />
<br />
```meta.xml```<br />
<export function="dbQueryAsync" type="server" /><br />
<export function="dbQuery" type="server" /><br />
<export function="dbExec" type="server" /><br />
<export function="getTableName" type="server" /><br />
<export function="dbPrepareString" type="server" /><br />
<export function="dbQueryAsyncMultiple" type="server" /><br />
<br />
```meta.xml end```<br />
]]<br />
--[[<br />
example exported: = <br />
exports.nameres:dbQuery(-1, "test", "SELECT ID FROM ?? WHERE ID = ?", 1)<br />
<br />
exports.nameres:dbExec("test", "UPDATE ?? SET test= ? WHERE ID = ?;", '0', 1)<br />
exports.nameres:dbExec("test", "CREATE TABLE IF NOT EXISTS ?? (`ID` INT UNSIGNED NOT NULL PRIMARY KEY, `test` TEXT) COLLATE=utf8_unicode_ci;")<br />
<br />
exports.nameres:dbExec("test", "INSERT INTO ?? (`ID`, `test`) VALUES (?, ?);", '1', '1')<br />
<br />
function onPlayerQuit()<br />
exports.nameres:dbQueryAsync("onPlayerQuitCallback", {}, "test", "SELECT ID FROM ?? WHERE owner = ?", getAccountName(getPlayerAccount(source)))<br />
end<br />
function onPlayerQuitCallback(result, args)<br />
for _, row in ipairs(result) do<br />
destroyVehicle(vehiclesByID[row.ID])<br />
end<br />
end<br />
addEventHandler("onPlayerQuit", root, onPlayerQuit)<br />
<br />
addEvent("dbCallback", false)<br />
addEventHandler("dbCallback", resourceRoot, function(queryResult, callbackFunctionName, callbackArguments)<br />
_G[callbackFunctionName](queryResult, callbackArguments)<br />
end)<br />
]]<br />
<br />
host = "IPHost" --"127.0.0.1" -- "localhost"<br />
--unix_socket = "/var/run/mysqld/mysqld.sock"<br />
dbname = "namedb"<br />
user = "rootname"<br />
password = "pass"<br />
<br />
local unix_socket, host = unix_socket, host<br />
local dbname, user, password = dbname, user, password<br />
local mainDB<br />
<br />
function connect()<br />
local startTick = getTickCount()<br />
mainDB = dbConnect("mysql", (unix_socket and "unix_socket="..unix_socket or "host="..host)..";dbname="..dbname, user, password)<br />
if (mainDB) then<br />
outputDebugString("[MYSQL] Connection: "..getTickCount()-startTick.." ms.")<br />
else<br />
outputDebugString("[MYSQL][ERROR] Connection failed!", 1)<br />
setTimer(connect, 5000, 1)<br />
end<br />
end<br />
connect()<br />
<br />
<br />
_dbQuery = dbQuery<br />
function dbQuery(timeout, tableName, query, ...)<br />
local result, errorCode, errorMessage = dbPoll(_dbQuery(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...), timeout)<br />
if (not result) then<br />
outputDebugString (string.format("[MYSQL][ERROR] dbQuery error on %s (table `%s`)", query, tableName), 1) <br />
end<br />
return result, errorCode, errorMessage<br />
end<br />
<br />
<br />
function dbQueryAsync(callbackFunctionName, callbackArguments, tableName, query, ...)<br />
local extraData = {<br />
sourceResourceRoot,<br />
callbackFunctionName,<br />
callbackArguments,<br />
}<br />
return _dbQuery(dbCallback, extraData, mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
function dbCallback(queryHandle, srcResRoot, callbackFunctionName, callbackArguments)<br />
local result, errorCode, errorMessage = dbPoll(queryHandle, 0)<br />
if (not result) then<br />
outputDebugString (string.format("[MYSQL][ERROR] dbCallback error %i (%s)", errorCode, errorMessage), 1) <br />
end<br />
triggerEvent("dbCallback", srcResRoot, result, callbackFunctionName, callbackArguments)<br />
end<br />
<br />
<br />
_dbExec = dbExec<br />
function dbExec(tableName, query, ...)<br />
-- We should also check if our database has fallen off, but unfortunately...<br />
return _dbExec(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
<br />
<br />
function getTableName(tableName)<br />
return getResourceName(sourceResource).."_"..tableName<br />
end<br />
<br />
<br />
_dbPrepareString = dbPrepareString<br />
function dbPrepareString(tableName, query, ...)<br />
return _dbPrepareString(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
<br />
<br />
local multipleQueryTable = {}<br />
function dbQueryAsyncMultiple(callbackFunctionName, callbackArguments, ...)<br />
local queries = {...}<br />
local packID = generateID()<br />
while (multipleQueryTable[packID]) do<br />
packID = generateID()<br />
end<br />
<br />
multipleQueryTable[packID] = {<br />
sourceResourceRoot = sourceResourceRoot,<br />
callbackFunctionName = callbackFunctionName,<br />
callbackArguments = callbackArguments,<br />
numberOfQueries = #queries,<br />
replies = {},<br />
}<br />
<br />
for queryNumber, query in ipairs(queries) do<br />
local extraData = {<br />
packID,<br />
queryNumber,<br />
}<br />
_dbQuery(multipleQueryCallback, extraData, mainDB, query.query, getResourceName(sourceResource).."_"..query.tableName, unpack(query))<br />
end<br />
end<br />
<br />
function multipleQueryCallback(queryHandle, packID, queryNumber)<br />
local result, errorCode, errorMessage = dbPoll(queryHandle, 0)<br />
if (not result) then<br />
outputDebugString(string.format("[MYSQL][ERROR] multipleQueryCallback error %i (%s)", errorCode, errorMessage), 1) <br />
end<br />
<br />
local queryTable = multipleQueryTable[packID]<br />
queryTable.replies[queryNumber] = {<br />
result = result,<br />
errorCode = errorCode,<br />
errorMessage = errorMessage,<br />
}<br />
<br />
if (#queryTable.replies == queryTable.numberOfQueries) then<br />
triggerEvent("dbCallback", queryTable.sourceResourceRoot, queryTable.replies, queryTable.callbackFunctionName, queryTable.callbackArguments)<br />
multipleQueryTable[packID] = nil<br />
end<br />
end<br />
<br />
--[[<br />
dbQueryAsyncMultiple(string callbackFunctionName, table callbackArguments, ...)<br />
Where there is an ellipsis, there is a table of this kind for each request:<br />
{<br />
string tableName,<br />
string query,<br />
arguments separated by commas<br />
}<br />
<br />
--The results will be displayed in a table, preserving the order of the executed queries. The table will look like this:<br />
{<br />
{<br />
table result,<br />
number errorCode,<br />
string errorMessage,<br />
},<br />
}<br />
]]<br />
<br />
-- Generating a string of characters<br />
local symbols = {}<br />
for _, range in ipairs({{48, 57}, {65, 90}, {97, 122}}) do -- numbers/lowercase chars/uppercase chars<br />
for i = range[1], range[2] do<br />
table.insert(symbols, string.char(i))<br />
end<br />
end<br />
local symbolCount = #symbols<br />
function generateID()<br />
local str = ""<br />
for i = 1, 8 do<br />
str = str..symbols[math.random(1, symbolCount)]<br />
end<br />
return str<br />
end<br />
</syntaxhighlight><br />
<br />
==Changelog==<br />
{{ChangelogHeader}}<br />
{{ChangelogItem|1.3.1-9.04817|Added options 'log', 'tag' and 'suppress'}}<br />
{{ChangelogItem|1.3.5-9.06386|Added option 'charset'}}<br />
{{ChangelogItem|1.5.2-9.07972|Added option 'multi_statements'}}<br />
{{ChangelogItem|1.5.4-9.11138|Added option 'queue'}}<br />
{{ChangelogItem|1.6.0-9.22396|Added option 'use_ssl'}}<br />
{{ChangelogItem|1.6.0-9.22497|Added option 'get_server_public_key'}}<br />
<br />
==See Also==<br />
{{SQL_functions}}<br />
<br />
[[ru:dbConnect]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=DbConnect&diff=82786DbConnect2026-04-02T03:22:54Z<p>Flox: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function opens a connection to a database and returns an element that can be used with [[dbQuery]]. To disconnect use [[destroyElement]].<br />
{{Note|Connecting and disconnecting many times can have a performance impact on the server. For optimal performance it is recommended that you use dbConnect only once when the resource starts, and share the connection element with the whole script.}}<br />
{{Note|In MySQL 8.0 and later, you can choose between '''`caching_sha2_password`''', '''`sha256_password`''', or '''`mysql_native_password`''' for password management.<br />
* If you opt for '''`caching_sha2_password`''' or '''`sha256_password`''', SSL is not mandatory but recommended for secure authentication.<br />
* If you choose '''`mysql_native_password`''', you can set it as the default authentication plugin:<br />
** In the '''`mysqld.cnf`''' configuration file, by adding or modifying the following line: '''<nowiki>default-authentication-plugin=mysql_native_password</nowiki>'''<br />
** Using SQL queries (e.g., ALTER USER).<br />
** In PHPMyAdmin (via the user settings page).<br />
Please note that starting with MySQL 9.0, '''`mysql_native_password`''' will no longer be available, and only '''`caching_sha2_password`''' and '''`sha256_password`''' will be supported.<br />
}}<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
element dbConnect ( string databaseType, string host [, string username = "", string password = "", string options = "" ] )<br />
</syntaxhighlight><br />
{{OOP||[[Connection]]}}<br />
===Required Arguments===<br />
*'''databaseType:''' The type of database. This can be either ''sqlite'' or ''mysql''<br />
*'''host:''' The target to connect to. The format of this depends on the database type.<br />
** For SQLite it is a [[filepath]] to a SQLite database file. If the filepath starts with ":/" then the server's global databases directory is used. The file will be created if it does not exist.<br />
** For MySQL it is a list of key=value pairs separated by semicolons. Supported keys are:<br />
*** '''dbname''': Name of the database to use e.g. ''dbname=test''<br />
*** '''host''': Host address e.g. ''host=127.0.0.1''<br />
*** '''port''': Host port e.g. ''port=3306'' (optional, defaults to standard MySQL port if not used)<br />
*** '''unix_socket''': Unix socket or named pipe to use (optional)<br />
***'''charset''': Communicate with the server using a character which is different from the default e.g. ''charset<nowiki>=</nowiki>utf8'' (optional)<br />
<br />
===Optional Arguments===<br />
*'''username:''' Usually required for MySQL, ignored by SQLite <br />
*'''password:''' Usually required for MySQL, ignored by SQLite <br />
*'''options :''' List of key=value pairs separated by semicolons. Supported keys are:<br />
**'''share''' which can be set to 0 or 1. (Default value for SQLite is "share=1", for MySQL is "share=0"). When set to 1, the connection is shared and will be used by other calls to dbConnect with the same host string. This is usually a good thing for SQLite connections, but not so good for MySQL unless care is taken.<br />
**'''batch''' which can be set to 0 or 1. (Default is "batch=1"). When set to 1, queries called in the same frame are automatically batched together which can significantly speed up inserts/updates. The downside is you lose control of the feature that is used to achieve batching (For SQLite it is transactions, for MySQL it is autocommit mode). Therefore, if you use transactions, lock tables or control autocommit yourself, you may want to disable this feature.<br />
**'''autoreconnect''' which can be set to 0 or 1. (Default value "autoreconnect=1"). When set to 1, dropped connections will automatically be reconnected. Note that session variables (incl. SET NAMES), user variables, table locks and temporary tables will be reset because of the reconnection. So if you use these fancy features, you will need to turn autoreconnect off and cope with dropped connections some other way.<br />
**'''log''' which can be set to 0 or 1. (Default value "log<nowiki>=</nowiki>1"). When set to 0, activity from this connection will not be recorded in the [[Server_Commands#debugdb|database debug log file]].<br />
**'''tag''' (Default value "tag<nowiki>=</nowiki>script"). A string which helps identify activity from this connection in the [[Server_Commands#debugdb|database debug log file]].<br />
**'''suppress''' A comma separated list of error codes to ignore. (eg. "suppress<nowiki>=</nowiki>1062,1169").<br />
**'''multi_statements''' Enable multiple statements (separated by a semi-colon) in one query. Use [[dbPrepareString]] when building a multiple statement query to reduce SQL injection risks.<br />
**'''queue''' Name of the queue to use. (Default value for SQLite is "sqlite", for MySQL default is the host string from the '''host''' argument). Asynchronous database queries in the same queue are processed in order, one at a time. Any name can be used.<br />
**'''use_ssl''' which can be set to 0 or 1. (Default value is 0), ignored by SQLite<br />
**{{New feature/item|3.0161|1.6.0|22497|'''get_server_public_key''' which can be set to 0 or 1. (Default value is 1), ignored by SQLite. When set to 1, this enables the client to request from the server the public key required for RSA key pair-based password exchange. This option applies to clients that authenticate with the <code>caching_sha2_password</code> authentication plugin.}}<br />
<br />
===Returns===<br />
Returns a database connection element unless there are problems, in which case it return ''false''.<br />
<br />
==Remarks==<br />
Under certain platforms, for example on Unix-based OSes like Linux, using this function could fail with a debug warning containing "[Could not connect]" accompanied by a prior debug error explaining the problem. In that case you should check the [[Server Manual]] to see if you have missed any recommended (best-effort) steps for server set-up.<br />
<br />
==Example==<br />
This example opens a connection to a SQLite database file in the current resource<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in another resource<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":resname/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in the global databases directory<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in a sub directory of the global databases directory<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":/example/sub/dir/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a MySQL database called 'frank' at server ip 1.2.3.4 using utf8 character set and allows the connection to be shared. Note that changing the database or other connection dependent settings affect all connections that are shared.<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "mysql", "dbname=frank;host=1.2.3.4;charset=utf8", "username", "password", "share=1" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database is disallows sharing of the connection<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db", "", "", "share=0" )<br />
</syntaxhighlight><br />
<br />
This example output debug message, if the connection with SQLite database was established or not<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db" )<br />
<br />
if test_db then<br />
outputDebugString( "Connection with database was successfully established." )<br />
else<br />
outputDebugString( "Connection with database couldn't be established." )<br />
end<br />
</syntaxhighlight><br />
<br />
The folowing example shows how you could approach a common resource for database operations with exported functions ('''query''' and '''execute'''):<br />
<br />
<syntaxhighlight lang="lua"><br />
function connect()<br />
DBConnection = dbConnect( "mysql", "dbname=DBNAME;host=HOST;charset=utf8", "USERNAME", "PASSWORD" )<br />
if (not DBConnection) then<br />
outputDebugString("Error: Failed to establish connection to the MySQL database server")<br />
else<br />
outputDebugString("Success: Connected to the MySQL database server")<br />
end<br />
end<br />
<br />
addEventHandler("onResourceStart",resourceRoot, connect)<br />
<br />
function query(...)<br />
local queryHandle = dbQuery(DBConnection, ...)<br />
if (not queryHandle) then<br />
return nil<br />
end<br />
local rows = dbPoll(queryHandle, -1)<br />
return rows<br />
end<br />
<br />
function execute(...)<br />
local queryHandle = dbQuery(DBConnection, ...)<br />
local result, numRows = dbPoll(queryHandle, -1)<br />
return numRows<br />
end<br />
<br />
function getDBConnection()<br />
return DBConnection<br />
end<br />
</syntaxhighlight><br />
<br />
The following example illustrates an exemplary approach to utilizing a common resource for database operations, employing exported functions such as '''dbQuery''', '''dbExec''', '''dbQueryAsync''', '''dbPrepareString''', and '''dbQueryAsyncMultiple.''':<br />
<syntaxhighlight lang="lua"><br />
--[[<br />
<br />
```meta.xml```<br />
<export function="dbQueryAsync" type="server" /><br />
<export function="dbQuery" type="server" /><br />
<export function="dbExec" type="server" /><br />
<export function="getTableName" type="server" /><br />
<export function="dbPrepareString" type="server" /><br />
<export function="dbQueryAsyncMultiple" type="server" /><br />
<br />
```meta.xml end```<br />
]]<br />
--[[<br />
example exported: = <br />
exports.nameres:dbQuery(-1, "test", "SELECT ID FROM ?? WHERE ID = ?", 1)<br />
<br />
exports.nameres:dbExec("test", "UPDATE ?? SET test= ? WHERE ID = ?;", '0', 1)<br />
exports.nameres:dbExec("test", "CREATE TABLE IF NOT EXISTS ?? (`ID` INT UNSIGNED NOT NULL PRIMARY KEY, `test` TEXT) COLLATE=utf8_unicode_ci;")<br />
<br />
exports.nameres:dbExec("test", "INSERT INTO ?? (`ID`, `test`) VALUES (?, ?);", '1', '1')<br />
<br />
function onPlayerQuit()<br />
exports.nameres:dbQueryAsync("onPlayerQuitCallback", {}, "test", "SELECT ID FROM ?? WHERE owner = ?", getAccountName(getPlayerAccount(source)))<br />
end<br />
function onPlayerQuitCallback(result, args)<br />
for _, row in ipairs(result) do<br />
destroyVehicle(vehiclesByID[row.ID])<br />
end<br />
end<br />
addEventHandler("onPlayerQuit", root, onPlayerQuit)<br />
<br />
addEvent("dbCallback", false)<br />
addEventHandler("dbCallback", resourceRoot, function(queryResult, callbackFunctionName, callbackArguments)<br />
_G[callbackFunctionName](queryResult, callbackArguments)<br />
end)<br />
]]<br />
<br />
host = "IPHost" --"127.0.0.1" -- "localhost"<br />
--unix_socket = "/var/run/mysqld/mysqld.sock"<br />
dbname = "namedb"<br />
user = "rootname"<br />
password = "pass"<br />
<br />
local unix_socket, host = unix_socket, host<br />
local dbname, user, password = dbname, user, password<br />
local mainDB<br />
<br />
function connect()<br />
local startTick = getTickCount()<br />
mainDB = dbConnect("mysql", (unix_socket and "unix_socket="..unix_socket or "host="..host)..";dbname="..dbname, user, password)<br />
if (mainDB) then<br />
outputDebugString("[MYSQL] Connection: "..getTickCount()-startTick.." ms.")<br />
else<br />
outputDebugString("[MYSQL][ERROR] Connection failed!", 1)<br />
setTimer(connect, 5000, 1)<br />
end<br />
end<br />
connect()<br />
<br />
<br />
_dbQuery = dbQuery<br />
function dbQuery(timeout, tableName, query, ...)<br />
local result, errorCode, errorMessage = dbPoll(_dbQuery(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...), timeout)<br />
if (not result) then<br />
outputDebugString (string.format("[MYSQL][ERROR] dbQuery error on %s (table `%s`)", query, tableName), 1) <br />
end<br />
return result, errorCode, errorMessage<br />
end<br />
<br />
<br />
function dbQueryAsync(callbackFunctionName, callbackArguments, tableName, query, ...)<br />
local extraData = {<br />
sourceResourceRoot,<br />
callbackFunctionName,<br />
callbackArguments,<br />
}<br />
return _dbQuery(dbCallback, extraData, mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
function dbCallback(queryHandle, srcResRoot, callbackFunctionName, callbackArguments)<br />
local result, errorCode, errorMessage = dbPoll(queryHandle, 0)<br />
if (not result) then<br />
outputDebugString (string.format("[MYSQL][ERROR] dbCallback error %i (%s)", errorCode, errorMessage), 1) <br />
end<br />
triggerEvent("dbCallback", srcResRoot, result, callbackFunctionName, callbackArguments)<br />
end<br />
<br />
<br />
_dbExec = dbExec<br />
function dbExec(tableName, query, ...)<br />
-- We should also check if our database has fallen off, but unfortunately...<br />
return _dbExec(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
<br />
<br />
function getTableName(tableName)<br />
return getResourceName(sourceResource).."_"..tableName<br />
end<br />
<br />
<br />
_dbPrepareString = dbPrepareString<br />
function dbPrepareString(tableName, query, ...)<br />
return _dbPrepareString(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
<br />
<br />
local multipleQueryTable = {}<br />
function dbQueryAsyncMultiple(callbackFunctionName, callbackArguments, ...)<br />
local queries = {...}<br />
local packID = generateID()<br />
while (multipleQueryTable[packID]) do<br />
packID = generateID()<br />
end<br />
<br />
multipleQueryTable[packID] = {<br />
sourceResourceRoot = sourceResourceRoot,<br />
callbackFunctionName = callbackFunctionName,<br />
callbackArguments = callbackArguments,<br />
numberOfQueries = #queries,<br />
replies = {},<br />
}<br />
<br />
for queryNumber, query in ipairs(queries) do<br />
local extraData = {<br />
packID,<br />
queryNumber,<br />
}<br />
_dbQuery(multipleQueryCallback, extraData, mainDB, query.query, getResourceName(sourceResource).."_"..query.tableName, unpack(query))<br />
end<br />
end<br />
<br />
function multipleQueryCallback(queryHandle, packID, queryNumber)<br />
local result, errorCode, errorMessage = dbPoll(queryHandle, 0)<br />
if (not result) then<br />
outputDebugString(string.format("[MYSQL][ERROR] multipleQueryCallback error %i (%s)", errorCode, errorMessage), 1) <br />
end<br />
<br />
local queryTable = multipleQueryTable[packID]<br />
queryTable.replies[queryNumber] = {<br />
result = result,<br />
errorCode = errorCode,<br />
errorMessage = errorMessage,<br />
}<br />
<br />
if (#queryTable.replies == queryTable.numberOfQueries) then<br />
triggerEvent("dbCallback", queryTable.sourceResourceRoot, queryTable.replies, queryTable.callbackFunctionName, queryTable.callbackArguments)<br />
multipleQueryTable[packID] = nil<br />
end<br />
end<br />
<br />
--[[<br />
dbQueryAsyncMultiple(string callbackFunctionName, table callbackArguments, ...)<br />
Where there is an ellipsis, there is a table of this kind for each request:<br />
{<br />
string tableName,<br />
string query,<br />
аргументы через запятую<br />
}<br />
<br />
--The results will be displayed in a table, preserving the order of the executed queries. The table will look like this:<br />
{<br />
{<br />
table result,<br />
number errorCode,<br />
string errorMessage,<br />
},<br />
}<br />
]]<br />
<br />
-- Generating a string of characters<br />
local symbols = {}<br />
for _, range in ipairs({{48, 57}, {65, 90}, {97, 122}}) do -- numbers/lowercase chars/uppercase chars<br />
for i = range[1], range[2] do<br />
table.insert(symbols, string.char(i))<br />
end<br />
end<br />
local symbolCount = #symbols<br />
function generateID()<br />
local str = ""<br />
for i = 1, 8 do<br />
str = str..symbols[math.random(1, symbolCount)]<br />
end<br />
return str<br />
end<br />
</syntaxhighlight><br />
<br />
==Changelog==<br />
{{ChangelogHeader}}<br />
{{ChangelogItem|1.3.1-9.04817|Added options 'log', 'tag' and 'suppress'}}<br />
{{ChangelogItem|1.3.5-9.06386|Added option 'charset'}}<br />
{{ChangelogItem|1.5.2-9.07972|Added option 'multi_statements'}}<br />
{{ChangelogItem|1.5.4-9.11138|Added option 'queue'}}<br />
{{ChangelogItem|1.6.0-9.22396|Added option 'use_ssl'}}<br />
{{ChangelogItem|1.6.0-9.22497|Added option 'get_server_public_key'}}<br />
<br />
==See Also==<br />
{{SQL_functions}}<br />
<br />
[[ru:dbConnect]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=DbConnect&diff=82785DbConnect2026-04-02T03:20:09Z<p>Flox: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function opens a connection to a database and returns an element that can be used with [[dbQuery]]. To disconnect use [[destroyElement]].<br />
{{Note|Connecting and disconnecting many times can have a performance impact on the server. For optimal performance it is recommended that you use dbConnect only once when the resource starts, and share the connection element with the whole script.}}<br />
{{Note|In MySQL 8.0 and later, you can choose between '''`caching_sha2_password`''', '''`sha256_password`''', or '''`mysql_native_password`''' for password management.<br />
* If you opt for '''`caching_sha2_password`''' or '''`sha256_password`''', SSL is not mandatory but recommended for secure authentication.<br />
* If you choose '''`mysql_native_password`''', you can set it as the default authentication plugin:<br />
** In the '''`mysqld.cnf`''' configuration file, by adding or modifying the following line: '''<nowiki>default-authentication-plugin=mysql_native_password</nowiki>'''<br />
** Using SQL queries (e.g., ALTER USER).<br />
** In PHPMyAdmin (via the user settings page).<br />
Please note that starting with MySQL 9.0, '''`mysql_native_password`''' will no longer be available, and only '''`caching_sha2_password`''' and '''`sha256_password`''' will be supported.<br />
}}<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
element dbConnect ( string databaseType, string host [, string username = "", string password = "", string options = "" ] )<br />
</syntaxhighlight><br />
{{OOP||[[Connection]]}}<br />
===Required Arguments===<br />
*'''databaseType:''' The type of database. This can be either ''sqlite'' or ''mysql''<br />
*'''host:''' The target to connect to. The format of this depends on the database type.<br />
** For SQLite it is a [[filepath]] to a SQLite database file. If the filepath starts with ":/" then the server's global databases directory is used. The file will be created if it does not exist.<br />
** For MySQL it is a list of key=value pairs separated by semicolons. Supported keys are:<br />
*** '''dbname''': Name of the database to use e.g. ''dbname=test''<br />
*** '''host''': Host address e.g. ''host=127.0.0.1''<br />
*** '''port''': Host port e.g. ''port=3306'' (optional, defaults to standard MySQL port if not used)<br />
*** '''unix_socket''': Unix socket or named pipe to use (optional)<br />
***'''charset''': Communicate with the server using a character which is different from the default e.g. ''charset<nowiki>=</nowiki>utf8'' (optional)<br />
<br />
===Optional Arguments===<br />
*'''username:''' Usually required for MySQL, ignored by SQLite <br />
*'''password:''' Usually required for MySQL, ignored by SQLite <br />
*'''options :''' List of key=value pairs separated by semicolons. Supported keys are:<br />
**'''share''' which can be set to 0 or 1. (Default value for SQLite is "share=1", for MySQL is "share=0"). When set to 1, the connection is shared and will be used by other calls to dbConnect with the same host string. This is usually a good thing for SQLite connections, but not so good for MySQL unless care is taken.<br />
**'''batch''' which can be set to 0 or 1. (Default is "batch=1"). When set to 1, queries called in the same frame are automatically batched together which can significantly speed up inserts/updates. The downside is you lose control of the feature that is used to achieve batching (For SQLite it is transactions, for MySQL it is autocommit mode). Therefore, if you use transactions, lock tables or control autocommit yourself, you may want to disable this feature.<br />
**'''autoreconnect''' which can be set to 0 or 1. (Default value "autoreconnect=1"). When set to 1, dropped connections will automatically be reconnected. Note that session variables (incl. SET NAMES), user variables, table locks and temporary tables will be reset because of the reconnection. So if you use these fancy features, you will need to turn autoreconnect off and cope with dropped connections some other way.<br />
**'''log''' which can be set to 0 or 1. (Default value "log<nowiki>=</nowiki>1"). When set to 0, activity from this connection will not be recorded in the [[Server_Commands#debugdb|database debug log file]].<br />
**'''tag''' (Default value "tag<nowiki>=</nowiki>script"). A string which helps identify activity from this connection in the [[Server_Commands#debugdb|database debug log file]].<br />
**'''suppress''' A comma separated list of error codes to ignore. (eg. "suppress<nowiki>=</nowiki>1062,1169").<br />
**'''multi_statements''' Enable multiple statements (separated by a semi-colon) in one query. Use [[dbPrepareString]] when building a multiple statement query to reduce SQL injection risks.<br />
**'''queue''' Name of the queue to use. (Default value for SQLite is "sqlite", for MySQL default is the host string from the '''host''' argument). Asynchronous database queries in the same queue are processed in order, one at a time. Any name can be used.<br />
**'''use_ssl''' which can be set to 0 or 1. (Default value is 0), ignored by SQLite<br />
**{{New feature/item|3.0161|1.6.0|22497|'''get_server_public_key''' which can be set to 0 or 1. (Default value is 1), ignored by SQLite. When set to 1, this enables the client to request from the server the public key required for RSA key pair-based password exchange. This option applies to clients that authenticate with the <code>caching_sha2_password</code> authentication plugin.}}<br />
<br />
===Returns===<br />
Returns a database connection element unless there are problems, in which case it return ''false''.<br />
<br />
==Remarks==<br />
Under certain platforms, for example on Unix-based OSes like Linux, using this function could fail with a debug warning containing "[Could not connect]" accompanied by a prior debug error explaining the problem. In that case you should check the [[Server Manual]] to see if you have missed any recommended (best-effort) steps for server set-up.<br />
<br />
==Example==<br />
This example opens a connection to a SQLite database file in the current resource<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in another resource<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":resname/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in the global databases directory<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in a sub directory of the global databases directory<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":/example/sub/dir/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a MySQL database called 'frank' at server ip 1.2.3.4 using utf8 character set and allows the connection to be shared. Note that changing the database or other connection dependent settings affect all connections that are shared.<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "mysql", "dbname=frank;host=1.2.3.4;charset=utf8", "username", "password", "share=1" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database is disallows sharing of the connection<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db", "", "", "share=0" )<br />
</syntaxhighlight><br />
<br />
This example output debug message, if the connection with SQLite database was established or not<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db" )<br />
<br />
if test_db then<br />
outputDebugString( "Connection with database was successfully established." )<br />
else<br />
outputDebugString( "Connection with database couldn't be established." )<br />
end<br />
</syntaxhighlight><br />
<br />
The folowing example shows how you could approach a common resource for database operations with exported functions ('''query''' and '''execute'''):<br />
<br />
<syntaxhighlight lang="lua"><br />
function connect()<br />
DBConnection = dbConnect( "mysql", "dbname=DBNAME;host=HOST;charset=utf8", "USERNAME", "PASSWORD" )<br />
if (not DBConnection) then<br />
outputDebugString("Error: Failed to establish connection to the MySQL database server")<br />
else<br />
outputDebugString("Success: Connected to the MySQL database server")<br />
end<br />
end<br />
<br />
addEventHandler("onResourceStart",resourceRoot, connect)<br />
<br />
function query(...)<br />
local queryHandle = dbQuery(DBConnection, ...)<br />
if (not queryHandle) then<br />
return nil<br />
end<br />
local rows = dbPoll(queryHandle, -1)<br />
return rows<br />
end<br />
<br />
function execute(...)<br />
local queryHandle = dbQuery(DBConnection, ...)<br />
local result, numRows = dbPoll(queryHandle, -1)<br />
return numRows<br />
end<br />
<br />
function getDBConnection()<br />
return DBConnection<br />
end<br />
</syntaxhighlight><br />
<br />
The following example illustrates an exemplary approach to utilizing a common resource for database operations, employing exported functions such as '''dbQuery''', '''dbExec''', '''dbQueryAsync''', '''dbPrepareString''', and '''dbQueryAsyncMultiple.''':<br />
<syntaxhighlight lang="lua"><br />
--[[<br />
<br />
```meta.xml```<br />
<export function="dbQueryAsync" type="server" /><br />
<export function="dbQuery" type="server" /><br />
<export function="dbExec" type="server" /><br />
<export function="getTableName" type="server" /><br />
<export function="dbPrepareString" type="server" /><br />
<export function="dbQueryAsyncMultiple" type="server" /><br />
<br />
```meta.xml end```<br />
]]<br />
--[[<br />
example exported: = <br />
exports.nameres:dbQuery(-1, "test", "SELECT ID FROM ?? WHERE ID = ?", 1)<br />
<br />
exports.nameres:dbExec("test", "UPDATE ?? SET test= ? WHERE ID = ?;", '0', 1)<br />
exports.nameres:dbExec("test", "CREATE TABLE IF NOT EXISTS ?? (`ID` INT UNSIGNED NOT NULL PRIMARY KEY, `test` TEXT) COLLATE=utf8_unicode_ci;")<br />
<br />
exports.nameres:dbExec("test", "INSERT INTO ?? (`ID`, `test`) VALUES (?, ?);", '1', '1')<br />
]]<br />
<br />
host = "IPHost" --"127.0.0.1" -- "localhost"<br />
--unix_socket = "/var/run/mysqld/mysqld.sock"<br />
dbname = "namedb"<br />
user = "rootname"<br />
password = "pass"<br />
<br />
local unix_socket, host = unix_socket, host<br />
local dbname, user, password = dbname, user, password<br />
local mainDB<br />
<br />
function connect()<br />
local startTick = getTickCount()<br />
mainDB = dbConnect("mysql", (unix_socket and "unix_socket="..unix_socket or "host="..host)..";dbname="..dbname, user, password)<br />
if (mainDB) then<br />
outputDebugString("[MYSQL] Connection: "..getTickCount()-startTick.." ms.")<br />
else<br />
outputDebugString("[MYSQL][ERROR] Connection failed!", 1)<br />
setTimer(connect, 5000, 1)<br />
end<br />
end<br />
connect()<br />
<br />
<br />
_dbQuery = dbQuery<br />
function dbQuery(timeout, tableName, query, ...)<br />
local result, errorCode, errorMessage = dbPoll(_dbQuery(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...), timeout)<br />
if (not result) then<br />
outputDebugString (string.format("[MYSQL][ERROR] dbQuery error on %s (table `%s`)", query, tableName), 1) <br />
end<br />
return result, errorCode, errorMessage<br />
end<br />
<br />
<br />
function dbQueryAsync(callbackFunctionName, callbackArguments, tableName, query, ...)<br />
local extraData = {<br />
sourceResourceRoot,<br />
callbackFunctionName,<br />
callbackArguments,<br />
}<br />
return _dbQuery(dbCallback, extraData, mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
function dbCallback(queryHandle, srcResRoot, callbackFunctionName, callbackArguments)<br />
local result, errorCode, errorMessage = dbPoll(queryHandle, 0)<br />
if (not result) then<br />
outputDebugString (string.format("[MYSQL][ERROR] dbCallback error %i (%s)", errorCode, errorMessage), 1) <br />
end<br />
triggerEvent("dbCallback", srcResRoot, result, callbackFunctionName, callbackArguments)<br />
end<br />
<br />
<br />
_dbExec = dbExec<br />
function dbExec(tableName, query, ...)<br />
-- We should also check if our database has fallen off, but unfortunately...<br />
return _dbExec(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
<br />
<br />
function getTableName(tableName)<br />
return getResourceName(sourceResource).."_"..tableName<br />
end<br />
<br />
<br />
_dbPrepareString = dbPrepareString<br />
function dbPrepareString(tableName, query, ...)<br />
return _dbPrepareString(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
<br />
<br />
local multipleQueryTable = {}<br />
function dbQueryAsyncMultiple(callbackFunctionName, callbackArguments, ...)<br />
local queries = {...}<br />
local packID = generateID()<br />
while (multipleQueryTable[packID]) do<br />
packID = generateID()<br />
end<br />
<br />
multipleQueryTable[packID] = {<br />
sourceResourceRoot = sourceResourceRoot,<br />
callbackFunctionName = callbackFunctionName,<br />
callbackArguments = callbackArguments,<br />
numberOfQueries = #queries,<br />
replies = {},<br />
}<br />
<br />
for queryNumber, query in ipairs(queries) do<br />
local extraData = {<br />
packID,<br />
queryNumber,<br />
}<br />
_dbQuery(multipleQueryCallback, extraData, mainDB, query.query, getResourceName(sourceResource).."_"..query.tableName, unpack(query))<br />
end<br />
end<br />
<br />
function multipleQueryCallback(queryHandle, packID, queryNumber)<br />
local result, errorCode, errorMessage = dbPoll(queryHandle, 0)<br />
if (not result) then<br />
outputDebugString(string.format("[MYSQL][ERROR] multipleQueryCallback error %i (%s)", errorCode, errorMessage), 1) <br />
end<br />
<br />
local queryTable = multipleQueryTable[packID]<br />
queryTable.replies[queryNumber] = {<br />
result = result,<br />
errorCode = errorCode,<br />
errorMessage = errorMessage,<br />
}<br />
<br />
if (#queryTable.replies == queryTable.numberOfQueries) then<br />
triggerEvent("dbCallback", queryTable.sourceResourceRoot, queryTable.replies, queryTable.callbackFunctionName, queryTable.callbackArguments)<br />
multipleQueryTable[packID] = nil<br />
end<br />
end<br />
<br />
--[[<br />
dbQueryAsyncMultiple(string callbackFunctionName, table callbackArguments, ...)<br />
Where there is an ellipsis, there is a table of this kind for each request:<br />
{<br />
string tableName,<br />
string query,<br />
аргументы через запятую<br />
}<br />
<br />
--The results will be displayed in a table, preserving the order of the executed queries. The table will look like this:<br />
{<br />
{<br />
table result,<br />
number errorCode,<br />
string errorMessage,<br />
},<br />
}<br />
]]<br />
<br />
-- Generating a string of characters<br />
local symbols = {}<br />
for _, range in ipairs({{48, 57}, {65, 90}, {97, 122}}) do -- numbers/lowercase chars/uppercase chars<br />
for i = range[1], range[2] do<br />
table.insert(symbols, string.char(i))<br />
end<br />
end<br />
local symbolCount = #symbols<br />
function generateID()<br />
local str = ""<br />
for i = 1, 8 do<br />
str = str..symbols[math.random(1, symbolCount)]<br />
end<br />
return str<br />
end<br />
</syntaxhighlight><br />
<br />
==Changelog==<br />
{{ChangelogHeader}}<br />
{{ChangelogItem|1.3.1-9.04817|Added options 'log', 'tag' and 'suppress'}}<br />
{{ChangelogItem|1.3.5-9.06386|Added option 'charset'}}<br />
{{ChangelogItem|1.5.2-9.07972|Added option 'multi_statements'}}<br />
{{ChangelogItem|1.5.4-9.11138|Added option 'queue'}}<br />
{{ChangelogItem|1.6.0-9.22396|Added option 'use_ssl'}}<br />
{{ChangelogItem|1.6.0-9.22497|Added option 'get_server_public_key'}}<br />
<br />
==See Also==<br />
{{SQL_functions}}<br />
<br />
[[ru:dbConnect]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=DbConnect&diff=82784DbConnect2026-04-02T03:19:27Z<p>Flox: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function opens a connection to a database and returns an element that can be used with [[dbQuery]]. To disconnect use [[destroyElement]].<br />
{{Note|Connecting and disconnecting many times can have a performance impact on the server. For optimal performance it is recommended that you use dbConnect only once when the resource starts, and share the connection element with the whole script.}}<br />
{{Note|In MySQL 8.0 and later, you can choose between '''`caching_sha2_password`''', '''`sha256_password`''', or '''`mysql_native_password`''' for password management.<br />
* If you opt for '''`caching_sha2_password`''' or '''`sha256_password`''', SSL is not mandatory but recommended for secure authentication.<br />
* If you choose '''`mysql_native_password`''', you can set it as the default authentication plugin:<br />
** In the '''`mysqld.cnf`''' configuration file, by adding or modifying the following line: '''<nowiki>default-authentication-plugin=mysql_native_password</nowiki>'''<br />
** Using SQL queries (e.g., ALTER USER).<br />
** In PHPMyAdmin (via the user settings page).<br />
Please note that starting with MySQL 9.0, '''`mysql_native_password`''' will no longer be available, and only '''`caching_sha2_password`''' and '''`sha256_password`''' will be supported.<br />
}}<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
element dbConnect ( string databaseType, string host [, string username = "", string password = "", string options = "" ] )<br />
</syntaxhighlight><br />
{{OOP||[[Connection]]}}<br />
===Required Arguments===<br />
*'''databaseType:''' The type of database. This can be either ''sqlite'' or ''mysql''<br />
*'''host:''' The target to connect to. The format of this depends on the database type.<br />
** For SQLite it is a [[filepath]] to a SQLite database file. If the filepath starts with ":/" then the server's global databases directory is used. The file will be created if it does not exist.<br />
** For MySQL it is a list of key=value pairs separated by semicolons. Supported keys are:<br />
*** '''dbname''': Name of the database to use e.g. ''dbname=test''<br />
*** '''host''': Host address e.g. ''host=127.0.0.1''<br />
*** '''port''': Host port e.g. ''port=3306'' (optional, defaults to standard MySQL port if not used)<br />
*** '''unix_socket''': Unix socket or named pipe to use (optional)<br />
***'''charset''': Communicate with the server using a character which is different from the default e.g. ''charset<nowiki>=</nowiki>utf8'' (optional)<br />
<br />
===Optional Arguments===<br />
*'''username:''' Usually required for MySQL, ignored by SQLite <br />
*'''password:''' Usually required for MySQL, ignored by SQLite <br />
*'''options :''' List of key=value pairs separated by semicolons. Supported keys are:<br />
**'''share''' which can be set to 0 or 1. (Default value for SQLite is "share=1", for MySQL is "share=0"). When set to 1, the connection is shared and will be used by other calls to dbConnect with the same host string. This is usually a good thing for SQLite connections, but not so good for MySQL unless care is taken.<br />
**'''batch''' which can be set to 0 or 1. (Default is "batch=1"). When set to 1, queries called in the same frame are automatically batched together which can significantly speed up inserts/updates. The downside is you lose control of the feature that is used to achieve batching (For SQLite it is transactions, for MySQL it is autocommit mode). Therefore, if you use transactions, lock tables or control autocommit yourself, you may want to disable this feature.<br />
**'''autoreconnect''' which can be set to 0 or 1. (Default value "autoreconnect=1"). When set to 1, dropped connections will automatically be reconnected. Note that session variables (incl. SET NAMES), user variables, table locks and temporary tables will be reset because of the reconnection. So if you use these fancy features, you will need to turn autoreconnect off and cope with dropped connections some other way.<br />
**'''log''' which can be set to 0 or 1. (Default value "log<nowiki>=</nowiki>1"). When set to 0, activity from this connection will not be recorded in the [[Server_Commands#debugdb|database debug log file]].<br />
**'''tag''' (Default value "tag<nowiki>=</nowiki>script"). A string which helps identify activity from this connection in the [[Server_Commands#debugdb|database debug log file]].<br />
**'''suppress''' A comma separated list of error codes to ignore. (eg. "suppress<nowiki>=</nowiki>1062,1169").<br />
**'''multi_statements''' Enable multiple statements (separated by a semi-colon) in one query. Use [[dbPrepareString]] when building a multiple statement query to reduce SQL injection risks.<br />
**'''queue''' Name of the queue to use. (Default value for SQLite is "sqlite", for MySQL default is the host string from the '''host''' argument). Asynchronous database queries in the same queue are processed in order, one at a time. Any name can be used.<br />
**'''use_ssl''' which can be set to 0 or 1. (Default value is 0), ignored by SQLite<br />
**{{New feature/item|3.0161|1.6.0|22497|'''get_server_public_key''' which can be set to 0 or 1. (Default value is 1), ignored by SQLite. When set to 1, this enables the client to request from the server the public key required for RSA key pair-based password exchange. This option applies to clients that authenticate with the <code>caching_sha2_password</code> authentication plugin.}}<br />
<br />
===Returns===<br />
Returns a database connection element unless there are problems, in which case it return ''false''.<br />
<br />
==Remarks==<br />
Under certain platforms, for example on Unix-based OSes like Linux, using this function could fail with a debug warning containing "[Could not connect]" accompanied by a prior debug error explaining the problem. In that case you should check the [[Server Manual]] to see if you have missed any recommended (best-effort) steps for server set-up.<br />
<br />
==Example==<br />
This example opens a connection to a SQLite database file in the current resource<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in another resource<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":resname/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in the global databases directory<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in a sub directory of the global databases directory<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":/example/sub/dir/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a MySQL database called 'frank' at server ip 1.2.3.4 using utf8 character set and allows the connection to be shared. Note that changing the database or other connection dependent settings affect all connections that are shared.<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "mysql", "dbname=frank;host=1.2.3.4;charset=utf8", "username", "password", "share=1" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database is disallows sharing of the connection<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db", "", "", "share=0" )<br />
</syntaxhighlight><br />
<br />
This example output debug message, if the connection with SQLite database was established or not<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db" )<br />
<br />
if test_db then<br />
outputDebugString( "Connection with database was successfully established." )<br />
else<br />
outputDebugString( "Connection with database couldn't be established." )<br />
end<br />
</syntaxhighlight><br />
<br />
The folowing example shows how you could approach a common resource for database operations with exported functions ('''query''' and '''execute'''):<br />
<br />
<syntaxhighlight lang="lua"><br />
function connect()<br />
DBConnection = dbConnect( "mysql", "dbname=DBNAME;host=HOST;charset=utf8", "USERNAME", "PASSWORD" )<br />
if (not DBConnection) then<br />
outputDebugString("Error: Failed to establish connection to the MySQL database server")<br />
else<br />
outputDebugString("Success: Connected to the MySQL database server")<br />
end<br />
end<br />
<br />
addEventHandler("onResourceStart",resourceRoot, connect)<br />
<br />
function query(...)<br />
local queryHandle = dbQuery(DBConnection, ...)<br />
if (not queryHandle) then<br />
return nil<br />
end<br />
local rows = dbPoll(queryHandle, -1)<br />
return rows<br />
end<br />
<br />
function execute(...)<br />
local queryHandle = dbQuery(DBConnection, ...)<br />
local result, numRows = dbPoll(queryHandle, -1)<br />
return numRows<br />
end<br />
<br />
function getDBConnection()<br />
return DBConnection<br />
end<br />
</syntaxhighlight><br />
<br />
The following example illustrates an exemplary approach to utilizing a common resource for database operations, employing exported functions such as '''dbQuery''', '''dbExec''', '''dbQueryAsync''', '''dbPrepareString''', and '''dbQueryAsyncMultiple.''':<br />
<syntaxhighlight lang="lua"><br />
--[[<br />
<br />
```meta.xml```<br />
[[ <br />
<export function="dbQueryAsync" type="server" /><br />
<export function="dbQuery" type="server" /><br />
<export function="dbExec" type="server" /><br />
<export function="getTableName" type="server" /><br />
<export function="dbPrepareString" type="server" /><br />
<export function="dbQueryAsyncMultiple" type="server" /><br />
]]<br />
```meta.xml end```<br />
<br />
example exported: = <br />
exports.nameres:dbQuery(-1, "test", "SELECT ID FROM ?? WHERE ID = ?", 1)<br />
<br />
exports.nameres:dbExec("test", "UPDATE ?? SET test= ? WHERE ID = ?;", '0', 1)<br />
exports.nameres:dbExec("test", "CREATE TABLE IF NOT EXISTS ?? (`ID` INT UNSIGNED NOT NULL PRIMARY KEY, `test` TEXT) COLLATE=utf8_unicode_ci;")<br />
<br />
exports.nameres:dbExec("test", "INSERT INTO ?? (`ID`, `test`) VALUES (?, ?);", '1', '1')<br />
]]<br />
<br />
host = "IPHost" --"127.0.0.1" -- "localhost"<br />
--unix_socket = "/var/run/mysqld/mysqld.sock"<br />
dbname = "namedb"<br />
user = "rootname"<br />
password = "pass"<br />
<br />
local unix_socket, host = unix_socket, host<br />
local dbname, user, password = dbname, user, password<br />
local mainDB<br />
<br />
function connect()<br />
local startTick = getTickCount()<br />
mainDB = dbConnect("mysql", (unix_socket and "unix_socket="..unix_socket or "host="..host)..";dbname="..dbname, user, password)<br />
if (mainDB) then<br />
outputDebugString("[MYSQL] Connection: "..getTickCount()-startTick.." ms.")<br />
else<br />
outputDebugString("[MYSQL][ERROR] Connection failed!", 1)<br />
setTimer(connect, 5000, 1)<br />
end<br />
end<br />
connect()<br />
<br />
<br />
_dbQuery = dbQuery<br />
function dbQuery(timeout, tableName, query, ...)<br />
local result, errorCode, errorMessage = dbPoll(_dbQuery(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...), timeout)<br />
if (not result) then<br />
outputDebugString (string.format("[MYSQL][ERROR] dbQuery error on %s (table `%s`)", query, tableName), 1) <br />
end<br />
return result, errorCode, errorMessage<br />
end<br />
<br />
<br />
function dbQueryAsync(callbackFunctionName, callbackArguments, tableName, query, ...)<br />
local extraData = {<br />
sourceResourceRoot,<br />
callbackFunctionName,<br />
callbackArguments,<br />
}<br />
return _dbQuery(dbCallback, extraData, mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
function dbCallback(queryHandle, srcResRoot, callbackFunctionName, callbackArguments)<br />
local result, errorCode, errorMessage = dbPoll(queryHandle, 0)<br />
if (not result) then<br />
outputDebugString (string.format("[MYSQL][ERROR] dbCallback error %i (%s)", errorCode, errorMessage), 1) <br />
end<br />
triggerEvent("dbCallback", srcResRoot, result, callbackFunctionName, callbackArguments)<br />
end<br />
<br />
<br />
_dbExec = dbExec<br />
function dbExec(tableName, query, ...)<br />
-- We should also check if our database has fallen off, but unfortunately...<br />
return _dbExec(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
<br />
<br />
function getTableName(tableName)<br />
return getResourceName(sourceResource).."_"..tableName<br />
end<br />
<br />
<br />
_dbPrepareString = dbPrepareString<br />
function dbPrepareString(tableName, query, ...)<br />
return _dbPrepareString(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
<br />
<br />
local multipleQueryTable = {}<br />
function dbQueryAsyncMultiple(callbackFunctionName, callbackArguments, ...)<br />
local queries = {...}<br />
local packID = generateID()<br />
while (multipleQueryTable[packID]) do<br />
packID = generateID()<br />
end<br />
<br />
multipleQueryTable[packID] = {<br />
sourceResourceRoot = sourceResourceRoot,<br />
callbackFunctionName = callbackFunctionName,<br />
callbackArguments = callbackArguments,<br />
numberOfQueries = #queries,<br />
replies = {},<br />
}<br />
<br />
for queryNumber, query in ipairs(queries) do<br />
local extraData = {<br />
packID,<br />
queryNumber,<br />
}<br />
_dbQuery(multipleQueryCallback, extraData, mainDB, query.query, getResourceName(sourceResource).."_"..query.tableName, unpack(query))<br />
end<br />
end<br />
<br />
function multipleQueryCallback(queryHandle, packID, queryNumber)<br />
local result, errorCode, errorMessage = dbPoll(queryHandle, 0)<br />
if (not result) then<br />
outputDebugString(string.format("[MYSQL][ERROR] multipleQueryCallback error %i (%s)", errorCode, errorMessage), 1) <br />
end<br />
<br />
local queryTable = multipleQueryTable[packID]<br />
queryTable.replies[queryNumber] = {<br />
result = result,<br />
errorCode = errorCode,<br />
errorMessage = errorMessage,<br />
}<br />
<br />
if (#queryTable.replies == queryTable.numberOfQueries) then<br />
triggerEvent("dbCallback", queryTable.sourceResourceRoot, queryTable.replies, queryTable.callbackFunctionName, queryTable.callbackArguments)<br />
multipleQueryTable[packID] = nil<br />
end<br />
end<br />
<br />
--[[<br />
dbQueryAsyncMultiple(string callbackFunctionName, table callbackArguments, ...)<br />
Where there is an ellipsis, there is a table of this kind for each request:<br />
{<br />
string tableName,<br />
string query,<br />
аргументы через запятую<br />
}<br />
<br />
--The results will be displayed in a table, preserving the order of the executed queries. The table will look like this:<br />
{<br />
{<br />
table result,<br />
number errorCode,<br />
string errorMessage,<br />
},<br />
}<br />
]]<br />
<br />
-- Generating a string of characters<br />
local symbols = {}<br />
for _, range in ipairs({{48, 57}, {65, 90}, {97, 122}}) do -- numbers/lowercase chars/uppercase chars<br />
for i = range[1], range[2] do<br />
table.insert(symbols, string.char(i))<br />
end<br />
end<br />
local symbolCount = #symbols<br />
function generateID()<br />
local str = ""<br />
for i = 1, 8 do<br />
str = str..symbols[math.random(1, symbolCount)]<br />
end<br />
return str<br />
end<br />
</syntaxhighlight><br />
<br />
==Changelog==<br />
{{ChangelogHeader}}<br />
{{ChangelogItem|1.3.1-9.04817|Added options 'log', 'tag' and 'suppress'}}<br />
{{ChangelogItem|1.3.5-9.06386|Added option 'charset'}}<br />
{{ChangelogItem|1.5.2-9.07972|Added option 'multi_statements'}}<br />
{{ChangelogItem|1.5.4-9.11138|Added option 'queue'}}<br />
{{ChangelogItem|1.6.0-9.22396|Added option 'use_ssl'}}<br />
{{ChangelogItem|1.6.0-9.22497|Added option 'get_server_public_key'}}<br />
<br />
==See Also==<br />
{{SQL_functions}}<br />
<br />
[[ru:dbConnect]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=DbConnect&diff=82783DbConnect2026-04-02T03:12:02Z<p>Flox: /* Example */</p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function opens a connection to a database and returns an element that can be used with [[dbQuery]]. To disconnect use [[destroyElement]].<br />
{{Note|Connecting and disconnecting many times can have a performance impact on the server. For optimal performance it is recommended that you use dbConnect only once when the resource starts, and share the connection element with the whole script.}}<br />
{{Note|In MySQL 8.0 and later, you can choose between '''`caching_sha2_password`''', '''`sha256_password`''', or '''`mysql_native_password`''' for password management.<br />
* If you opt for '''`caching_sha2_password`''' or '''`sha256_password`''', SSL is not mandatory but recommended for secure authentication.<br />
* If you choose '''`mysql_native_password`''', you can set it as the default authentication plugin:<br />
** In the '''`mysqld.cnf`''' configuration file, by adding or modifying the following line: '''<nowiki>default-authentication-plugin=mysql_native_password</nowiki>'''<br />
** Using SQL queries (e.g., ALTER USER).<br />
** In PHPMyAdmin (via the user settings page).<br />
Please note that starting with MySQL 9.0, '''`mysql_native_password`''' will no longer be available, and only '''`caching_sha2_password`''' and '''`sha256_password`''' will be supported.<br />
}}<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
element dbConnect ( string databaseType, string host [, string username = "", string password = "", string options = "" ] )<br />
</syntaxhighlight><br />
{{OOP||[[Connection]]}}<br />
===Required Arguments===<br />
*'''databaseType:''' The type of database. This can be either ''sqlite'' or ''mysql''<br />
*'''host:''' The target to connect to. The format of this depends on the database type.<br />
** For SQLite it is a [[filepath]] to a SQLite database file. If the filepath starts with ":/" then the server's global databases directory is used. The file will be created if it does not exist.<br />
** For MySQL it is a list of key=value pairs separated by semicolons. Supported keys are:<br />
*** '''dbname''': Name of the database to use e.g. ''dbname=test''<br />
*** '''host''': Host address e.g. ''host=127.0.0.1''<br />
*** '''port''': Host port e.g. ''port=3306'' (optional, defaults to standard MySQL port if not used)<br />
*** '''unix_socket''': Unix socket or named pipe to use (optional)<br />
***'''charset''': Communicate with the server using a character which is different from the default e.g. ''charset<nowiki>=</nowiki>utf8'' (optional)<br />
<br />
===Optional Arguments===<br />
*'''username:''' Usually required for MySQL, ignored by SQLite <br />
*'''password:''' Usually required for MySQL, ignored by SQLite <br />
*'''options :''' List of key=value pairs separated by semicolons. Supported keys are:<br />
**'''share''' which can be set to 0 or 1. (Default value for SQLite is "share=1", for MySQL is "share=0"). When set to 1, the connection is shared and will be used by other calls to dbConnect with the same host string. This is usually a good thing for SQLite connections, but not so good for MySQL unless care is taken.<br />
**'''batch''' which can be set to 0 or 1. (Default is "batch=1"). When set to 1, queries called in the same frame are automatically batched together which can significantly speed up inserts/updates. The downside is you lose control of the feature that is used to achieve batching (For SQLite it is transactions, for MySQL it is autocommit mode). Therefore, if you use transactions, lock tables or control autocommit yourself, you may want to disable this feature.<br />
**'''autoreconnect''' which can be set to 0 or 1. (Default value "autoreconnect=1"). When set to 1, dropped connections will automatically be reconnected. Note that session variables (incl. SET NAMES), user variables, table locks and temporary tables will be reset because of the reconnection. So if you use these fancy features, you will need to turn autoreconnect off and cope with dropped connections some other way.<br />
**'''log''' which can be set to 0 or 1. (Default value "log<nowiki>=</nowiki>1"). When set to 0, activity from this connection will not be recorded in the [[Server_Commands#debugdb|database debug log file]].<br />
**'''tag''' (Default value "tag<nowiki>=</nowiki>script"). A string which helps identify activity from this connection in the [[Server_Commands#debugdb|database debug log file]].<br />
**'''suppress''' A comma separated list of error codes to ignore. (eg. "suppress<nowiki>=</nowiki>1062,1169").<br />
**'''multi_statements''' Enable multiple statements (separated by a semi-colon) in one query. Use [[dbPrepareString]] when building a multiple statement query to reduce SQL injection risks.<br />
**'''queue''' Name of the queue to use. (Default value for SQLite is "sqlite", for MySQL default is the host string from the '''host''' argument). Asynchronous database queries in the same queue are processed in order, one at a time. Any name can be used.<br />
**'''use_ssl''' which can be set to 0 or 1. (Default value is 0), ignored by SQLite<br />
**{{New feature/item|3.0161|1.6.0|22497|'''get_server_public_key''' which can be set to 0 or 1. (Default value is 1), ignored by SQLite. When set to 1, this enables the client to request from the server the public key required for RSA key pair-based password exchange. This option applies to clients that authenticate with the <code>caching_sha2_password</code> authentication plugin.}}<br />
<br />
===Returns===<br />
Returns a database connection element unless there are problems, in which case it return ''false''.<br />
<br />
==Remarks==<br />
Under certain platforms, for example on Unix-based OSes like Linux, using this function could fail with a debug warning containing "[Could not connect]" accompanied by a prior debug error explaining the problem. In that case you should check the [[Server Manual]] to see if you have missed any recommended (best-effort) steps for server set-up.<br />
<br />
==Example==<br />
This example opens a connection to a SQLite database file in the current resource<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in another resource<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":resname/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in the global databases directory<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database file in a sub directory of the global databases directory<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", ":/example/sub/dir/file.db" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a MySQL database called 'frank' at server ip 1.2.3.4 using utf8 character set and allows the connection to be shared. Note that changing the database or other connection dependent settings affect all connections that are shared.<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "mysql", "dbname=frank;host=1.2.3.4;charset=utf8", "username", "password", "share=1" )<br />
</syntaxhighlight><br />
<br />
This example opens a connection to a SQLite database is disallows sharing of the connection<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db", "", "", "share=0" )<br />
</syntaxhighlight><br />
<br />
This example output debug message, if the connection with SQLite database was established or not<br />
<syntaxhighlight lang="lua"><br />
test_db = dbConnect( "sqlite", "file.db" )<br />
<br />
if test_db then<br />
outputDebugString( "Connection with database was successfully established." )<br />
else<br />
outputDebugString( "Connection with database couldn't be established." )<br />
end<br />
</syntaxhighlight><br />
<br />
The folowing example shows how you could approach a common resource for database operations with exported functions ('''query''' and '''execute'''):<br />
<br />
<syntaxhighlight lang="lua"><br />
function connect()<br />
DBConnection = dbConnect( "mysql", "dbname=DBNAME;host=HOST;charset=utf8", "USERNAME", "PASSWORD" )<br />
if (not DBConnection) then<br />
outputDebugString("Error: Failed to establish connection to the MySQL database server")<br />
else<br />
outputDebugString("Success: Connected to the MySQL database server")<br />
end<br />
end<br />
<br />
addEventHandler("onResourceStart",resourceRoot, connect)<br />
<br />
function query(...)<br />
local queryHandle = dbQuery(DBConnection, ...)<br />
if (not queryHandle) then<br />
return nil<br />
end<br />
local rows = dbPoll(queryHandle, -1)<br />
return rows<br />
end<br />
<br />
function execute(...)<br />
local queryHandle = dbQuery(DBConnection, ...)<br />
local result, numRows = dbPoll(queryHandle, -1)<br />
return numRows<br />
end<br />
<br />
function getDBConnection()<br />
return DBConnection<br />
end<br />
</syntaxhighlight><br />
<br />
The following example illustrates an exemplary approach to utilizing a common resource for database operations, employing exported functions such as '''dbQuery''', '''dbExec''', '''dbQueryAsync''', '''dbPrepareString''', and '''dbQueryAsyncMultiple.''':<br />
<syntaxhighlight lang="lua"><br />
host = "IPHost" --"127.0.0.1" -- "localhost"<br />
--unix_socket = "/var/run/mysqld/mysqld.sock"<br />
dbname = "namedb"<br />
user = "rootname"<br />
password = "pass"<br />
<br />
local unix_socket, host = unix_socket, host<br />
local dbname, user, password = dbname, user, password<br />
local mainDB<br />
<br />
function connect()<br />
local startTick = getTickCount()<br />
mainDB = dbConnect("mysql", (unix_socket and "unix_socket="..unix_socket or "host="..host)..";dbname="..dbname, user, password)<br />
if (mainDB) then<br />
outputDebugString("[MYSQL] Connection: "..getTickCount()-startTick.." ms.")<br />
else<br />
outputDebugString("[MYSQL][ERROR] Connection failed!", 1)<br />
setTimer(connect, 5000, 1)<br />
end<br />
end<br />
connect()<br />
<br />
<br />
_dbQuery = dbQuery<br />
function dbQuery(timeout, tableName, query, ...)<br />
local result, errorCode, errorMessage = dbPoll(_dbQuery(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...), timeout)<br />
if (not result) then<br />
outputDebugString (string.format("[MYSQL][ERROR] dbQuery error on %s (table `%s`)", query, tableName), 1) <br />
end<br />
return result, errorCode, errorMessage<br />
end<br />
<br />
<br />
function dbQueryAsync(callbackFunctionName, callbackArguments, tableName, query, ...)<br />
local extraData = {<br />
sourceResourceRoot,<br />
callbackFunctionName,<br />
callbackArguments,<br />
}<br />
return _dbQuery(dbCallback, extraData, mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
function dbCallback(queryHandle, srcResRoot, callbackFunctionName, callbackArguments)<br />
local result, errorCode, errorMessage = dbPoll(queryHandle, 0)<br />
if (not result) then<br />
outputDebugString (string.format("[MYSQL][ERROR] dbCallback error %i (%s)", errorCode, errorMessage), 1) <br />
end<br />
triggerEvent("dbCallback", srcResRoot, result, callbackFunctionName, callbackArguments)<br />
end<br />
<br />
<br />
_dbExec = dbExec<br />
function dbExec(tableName, query, ...)<br />
-- We should also check if our database has fallen off, but unfortunately...<br />
return _dbExec(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
<br />
<br />
function getTableName(tableName)<br />
return getResourceName(sourceResource).."_"..tableName<br />
end<br />
<br />
<br />
_dbPrepareString = dbPrepareString<br />
function dbPrepareString(tableName, query, ...)<br />
return _dbPrepareString(mainDB, query, getResourceName(sourceResource).."_"..tableName, ...)<br />
end<br />
<br />
<br />
local multipleQueryTable = {}<br />
function dbQueryAsyncMultiple(callbackFunctionName, callbackArguments, ...)<br />
local queries = {...}<br />
local packID = generateID()<br />
while (multipleQueryTable[packID]) do<br />
packID = generateID()<br />
end<br />
<br />
multipleQueryTable[packID] = {<br />
sourceResourceRoot = sourceResourceRoot,<br />
callbackFunctionName = callbackFunctionName,<br />
callbackArguments = callbackArguments,<br />
numberOfQueries = #queries,<br />
replies = {},<br />
}<br />
<br />
for queryNumber, query in ipairs(queries) do<br />
local extraData = {<br />
packID,<br />
queryNumber,<br />
}<br />
_dbQuery(multipleQueryCallback, extraData, mainDB, query.query, getResourceName(sourceResource).."_"..query.tableName, unpack(query))<br />
end<br />
end<br />
<br />
function multipleQueryCallback(queryHandle, packID, queryNumber)<br />
local result, errorCode, errorMessage = dbPoll(queryHandle, 0)<br />
if (not result) then<br />
outputDebugString(string.format("[MYSQL][ERROR] multipleQueryCallback error %i (%s)", errorCode, errorMessage), 1) <br />
end<br />
<br />
local queryTable = multipleQueryTable[packID]<br />
queryTable.replies[queryNumber] = {<br />
result = result,<br />
errorCode = errorCode,<br />
errorMessage = errorMessage,<br />
}<br />
<br />
if (#queryTable.replies == queryTable.numberOfQueries) then<br />
triggerEvent("dbCallback", queryTable.sourceResourceRoot, queryTable.replies, queryTable.callbackFunctionName, queryTable.callbackArguments)<br />
multipleQueryTable[packID] = nil<br />
end<br />
end<br />
<br />
--[[<br />
dbQueryAsyncMultiple(string callbackFunctionName, table callbackArguments, ...)<br />
Where there is an ellipsis, there is a table of this kind for each request:<br />
{<br />
string tableName,<br />
string query,<br />
аргументы через запятую<br />
}<br />
<br />
--The results will be displayed in a table, preserving the order of the executed queries. The table will look like this:<br />
{<br />
{<br />
table result,<br />
number errorCode,<br />
string errorMessage,<br />
},<br />
}<br />
]]<br />
<br />
-- Generating a string of characters<br />
local symbols = {}<br />
for _, range in ipairs({{48, 57}, {65, 90}, {97, 122}}) do -- numbers/lowercase chars/uppercase chars<br />
for i = range[1], range[2] do<br />
table.insert(symbols, string.char(i))<br />
end<br />
end<br />
local symbolCount = #symbols<br />
function generateID()<br />
local str = ""<br />
for i = 1, 8 do<br />
str = str..symbols[math.random(1, symbolCount)]<br />
end<br />
return str<br />
end<br />
</syntaxhighlight><br />
<br />
==Changelog==<br />
{{ChangelogHeader}}<br />
{{ChangelogItem|1.3.1-9.04817|Added options 'log', 'tag' and 'suppress'}}<br />
{{ChangelogItem|1.3.5-9.06386|Added option 'charset'}}<br />
{{ChangelogItem|1.5.2-9.07972|Added option 'multi_statements'}}<br />
{{ChangelogItem|1.5.4-9.11138|Added option 'queue'}}<br />
{{ChangelogItem|1.6.0-9.22396|Added option 'use_ssl'}}<br />
{{ChangelogItem|1.6.0-9.22497|Added option 'get_server_public_key'}}<br />
<br />
==See Also==<br />
{{SQL_functions}}<br />
<br />
[[ru:dbConnect]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=IsResourceRunning&diff=82782IsResourceRunning2026-04-02T02:34:23Z<p>Flox: /* Example check isResourceRunning(resName) */</p>
<hr />
<div>__NOTOC__ <br />
{{Shared function}}<br />
<br />
==Syntax== <br />
*'''isResourceRunning''' You can insert this code example in your resources.<br />
<br />
===Required Arguments=== <br />
*'''isResourceRunning:''' The value to check resources<br />
<br />
==Example check isResourceRunning(resName)==<br />
<section name="isResourceRunning" class="shared" show="true"><br />
You can insert this code example in your resources.<br />
<syntaxhighlight lang="lua"><br />
function isResourceRunning(resName)<br />
local res = getResourceFromName(resName)<br />
return (res) and (getResourceState(res) == "running")<br />
end<br />
<br />
-- Example of inserting into system code:<br />
--[[<br />
if isResourceRunning("admin") then<br />
--code<br />
else<br />
--alert<br />
end<br />
]]<br />
<br />
addCommandHandler('pos', function (commandName)<br />
if isResourceRunning("admin") then<br />
local x,y,z = getElementPosition(localPlayer)<br />
outputChatBox( x ..', '.. y ..', '.. z, 255, 255, 255 )<br />
else<br />
outputChatBox("The resource is not running 'admin'.", 255, 0, 0)<br />
end<br />
end )<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Resource_functions}}</div>Floxhttps://wiki.multitheftauto.com/index.php?title=IsResourceRunning&diff=82781IsResourceRunning2026-04-02T02:32:30Z<p>Flox: </p>
<hr />
<div>__NOTOC__ <br />
{{Shared function}}<br />
<br />
==Syntax== <br />
*'''isResourceRunning''' You can insert this code example in your resources.<br />
<br />
===Required Arguments=== <br />
*'''isResourceRunning:''' The value to check resources<br />
<br />
==Example check isResourceRunning(resName)==<br />
<section name="Example1" class="shared" show="true"><br />
You can insert this code example in your resources.<br />
<syntaxhighlight lang="lua"><br />
function isResourceRunning(resName)<br />
local res = getResourceFromName(resName)<br />
return (res) and (getResourceState(res) == "running")<br />
end<br />
<br />
-- Example of inserting into system code:<br />
--[[<br />
if isResourceRunning("admin") then<br />
--code<br />
else<br />
--alert<br />
end<br />
]]<br />
<br />
addCommandHandler('pos', function (commandName)<br />
if isResourceRunning("admin") then<br />
local x,y,z = getElementPosition(localPlayer)<br />
outputChatBox( x ..', '.. y ..', '.. z, 255, 255, 255 )<br />
else<br />
outputChatBox("The resource is not running 'admin'.", 255, 0, 0)<br />
end<br />
end )<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Resource_functions}}</div>Floxhttps://wiki.multitheftauto.com/index.php?title=IsResourceRunning&diff=82780IsResourceRunning2026-04-02T02:17:20Z<p>Flox: </p>
<hr />
<div>__NOTOC__ <br />
{{Shared function}}<br />
<br />
==Syntax== <br />
*'''isResourceRunning''' You can insert this code example in your resources.<br />
<br />
===Required Arguments=== <br />
*'''isResourceRunning:''' The value to check resources<br />
<br />
==Example check isResourceRunning(resName)==<br />
<section name="Example1" class="shared" show="true"><br />
You can insert this code example in your resources.<br />
<syntaxhighlight lang="lua"><br />
function isResourceRunning(resName)<br />
local res = getResourceFromName(resName)<br />
return (res) and (getResourceState(res) == "running")<br />
end<br />
<br />
-- Example of inserting into system code:<br />
--[[<br />
if isResourceRunning("admin") then<br />
--code<br />
else<br />
--alert<br />
end<br />
]]<br />
<br />
addCommandHandler('pos', function (commandName)<br />
if isResourceRunning("admin") then<br />
local x,y,z = getElementPosition(localPlayer)<br />
outputChatBox( x ..', '.. y ..', '.. z, 255, 255, 255 )<br />
else<br />
outputChatBox("The resource is not running 'admin'.", 255, 0, 0)<br />
end<br />
end )<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Resource_functions}}</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Resource&diff=82779Resource2026-04-02T02:15:27Z<p>Flox: </p>
<hr />
<div>A [[resource]] object refers to a resource that is loaded in the server.<br />
<br />
A name, state, root element, base directory path are associated to a [[resource]], among other attributes.<br />
<br />
==Related scripting functions==<br />
===Server===<br />
{{Resource functions}}<br />
===Client===<br />
{{Client resource functions}}<br />
[[Category:Scripting Concepts]]<br />
<br />
===Util (Shared)===<br />
[[IsResourceRunning]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Resource&diff=82778Resource2026-04-02T02:15:01Z<p>Flox: </p>
<hr />
<div>A [[resource]] object refers to a resource that is loaded in the server.<br />
<br />
A name, state, root element, base directory path are associated to a [[resource]], among other attributes.<br />
<br />
==Related scripting functions==<br />
===Server===<br />
{{Resource functions}}<br />
===Client===<br />
{{Client resource functions}}<br />
[[Category:Scripting Concepts]]<br />
<br />
==Util==<br />
[[IsResourceRunning]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Resource&diff=82777Resource2026-04-02T02:13:24Z<p>Flox: </p>
<hr />
<div>A [[resource]] object refers to a resource that is loaded in the server.<br />
<br />
A name, state, root element, base directory path are associated to a [[resource]], among other attributes.<br />
<br />
==Related scripting functions==<br />
===Server===<br />
{{Resource functions}}<br />
===Client===<br />
{{Client resource functions}}<br />
[[Category:Scripting Concepts]]<br />
<br />
[[IsResourceRunning]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Resource&diff=82776Resource2026-04-02T02:11:14Z<p>Flox: </p>
<hr />
<div>A [[resource]] object refers to a resource that is loaded in the server.<br />
<br />
A name, state, root element, base directory path are associated to a [[resource]], among other attributes.<br />
<br />
==Related scripting functions==<br />
===Server===<br />
{{Resource functions}}<br />
===Client===<br />
{{Client resource functions}}<br />
[[Category:Scripting Concepts]]<br />
<br />
[[https://wiki.multitheftauto.com/wiki/IsResourceRunning|IsResourceRunning]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Resource&diff=82775Resource2026-04-02T02:10:34Z<p>Flox: </p>
<hr />
<div>A [[resource]] object refers to a resource that is loaded in the server.<br />
<br />
A name, state, root element, base directory path are associated to a [[resource]], among other attributes.<br />
<br />
==Related scripting functions==<br />
===Server===<br />
{{Resource functions}}<br />
===Client===<br />
{{Client resource functions}}<br />
[[Category:Scripting Concepts]]<br />
<br />
https://wiki.multitheftauto.com/wiki/IsResourceRunning</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Resource&diff=82774Resource2026-04-02T02:08:29Z<p>Flox: </p>
<hr />
<div>A [[resource]] object refers to a resource that is loaded in the server.<br />
<br />
A name, state, root element, base directory path are associated to a [[resource]], among other attributes.<br />
<br />
==Related scripting functions==<br />
===Server===<br />
{{Resource functions}}<br />
===Client===<br />
{{Client resource functions}}<br />
[[Category:Scripting Concepts]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=IsResourceRunning&diff=82773IsResourceRunning2026-04-02T02:05:06Z<p>Flox: /* Example */</p>
<hr />
<div>__NOTOC__ <br />
{{Shared function}}<br />
<br />
==Syntax== <br />
*'''isResourceRunning''' You can insert this code example in your resources.<br />
<br />
===Required Arguments=== <br />
*'''isResourceRunning:''' The value to check resources<br />
<br />
==Example check isResourceRunning(resName)==<br />
<section name="Example1" class="shared" show="true"><br />
You can insert this code example in your resources.<br />
<syntaxhighlight lang="lua"><br />
function isResourceRunning(resName)<br />
local res = getResourceFromName(resName)<br />
return (res) and (getResourceState(res) == "running")<br />
end<br />
<br />
-- Example of inserting into system code:<br />
--[[<br />
if isResourceRunning("admin") then<br />
--code<br />
else<br />
--alert<br />
end<br />
]]<br />
<br />
addCommandHandler('pos', function (commandName)<br />
if isResourceRunning("admin") then<br />
local x,y,z = getElementPosition(localPlayer)<br />
outputChatBox( x ..', '.. y ..', '.. z, 255, 255, 255 )<br />
else<br />
outputChatBox("The resource is not running 'admin'.", 255, 0, 0)<br />
end<br />
end )<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Resource_functions}}<br />
[[ru:isBan]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=IsResourceRunning&diff=82772IsResourceRunning2026-04-02T02:04:31Z<p>Flox: </p>
<hr />
<div>__NOTOC__ <br />
{{Shared function}}<br />
<br />
==Syntax== <br />
*'''isResourceRunning''' You can insert this code example in your resources.<br />
<br />
===Required Arguments=== <br />
*'''isResourceRunning:''' The value to check resources<br />
<br />
==Example==<br />
<section name="Example1" class="shared" show="true"><br />
You can insert this code example in your resources.<br />
<syntaxhighlight lang="lua"><br />
function isResourceRunning(resName)<br />
local res = getResourceFromName(resName)<br />
return (res) and (getResourceState(res) == "running")<br />
end<br />
<br />
-- Example of inserting into system code:<br />
--[[<br />
if isResourceRunning("admin") then<br />
--code<br />
else<br />
--alert<br />
end<br />
]]<br />
<br />
addCommandHandler('pos', function (commandName)<br />
if isResourceRunning("admin") then<br />
local x,y,z = getElementPosition(localPlayer)<br />
outputChatBox( x ..', '.. y ..', '.. z, 255, 255, 255 )<br />
else<br />
outputChatBox("The resource is not running 'admin'.", 255, 0, 0)<br />
end<br />
end )<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Resource_functions}}<br />
[[ru:isBan]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=IsResourceRunning&diff=82771IsResourceRunning2026-04-02T02:04:18Z<p>Flox: </p>
<hr />
<div>__NOTOC__ <br />
{{Shared function}}<br />
<br />
==Syntax== <br />
*''isResourceRunning''' You can insert this code example in your resources.<br />
<br />
===Required Arguments=== <br />
*'''isResourceRunning:''' The value to check resources<br />
<br />
==Example==<br />
<section name="Example1" class="shared" show="true"><br />
You can insert this code example in your resources.<br />
<syntaxhighlight lang="lua"><br />
function isResourceRunning(resName)<br />
local res = getResourceFromName(resName)<br />
return (res) and (getResourceState(res) == "running")<br />
end<br />
<br />
-- Example of inserting into system code:<br />
--[[<br />
if isResourceRunning("admin") then<br />
--code<br />
else<br />
--alert<br />
end<br />
]]<br />
<br />
addCommandHandler('pos', function (commandName)<br />
if isResourceRunning("admin") then<br />
local x,y,z = getElementPosition(localPlayer)<br />
outputChatBox( x ..', '.. y ..', '.. z, 255, 255, 255 )<br />
else<br />
outputChatBox("The resource is not running 'admin'.", 255, 0, 0)<br />
end<br />
end )<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Resource_functions}}<br />
[[ru:isBan]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=IsResourceRunning&diff=82770IsResourceRunning2026-04-02T02:03:47Z<p>Flox: /* See Also */</p>
<hr />
<div>__NOTOC__ <br />
{{Shared function}}<br />
<br />
==Syntax== <br />
You can insert this code example in your resources.<br />
<br />
===Required Arguments=== <br />
*'''isResourceRunning:''' The value to check resources<br />
<br />
==Example==<br />
<section name="Example1" class="shared" show="true"><br />
You can insert this code example in your resources.<br />
<syntaxhighlight lang="lua"><br />
function isResourceRunning(resName)<br />
local res = getResourceFromName(resName)<br />
return (res) and (getResourceState(res) == "running")<br />
end<br />
<br />
-- Example of inserting into system code:<br />
--[[<br />
if isResourceRunning("admin") then<br />
--code<br />
else<br />
--alert<br />
end<br />
]]<br />
<br />
addCommandHandler('pos', function (commandName)<br />
if isResourceRunning("admin") then<br />
local x,y,z = getElementPosition(localPlayer)<br />
outputChatBox( x ..', '.. y ..', '.. z, 255, 255, 255 )<br />
else<br />
outputChatBox("The resource is not running 'admin'.", 255, 0, 0)<br />
end<br />
end )<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Resource_functions}}<br />
[[ru:isBan]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=IsResourceRunning&diff=82769IsResourceRunning2026-04-02T02:03:14Z<p>Flox: Created page with "__NOTOC__ {{Shared function}} ==Syntax== You can insert this code example in your resources. ===Required Arguments=== *'''isResourceRunning:''' The value to check resources ==Example== <section name="Example1" 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 o..."</p>
<hr />
<div>__NOTOC__ <br />
{{Shared function}}<br />
<br />
==Syntax== <br />
You can insert this code example in your resources.<br />
<br />
===Required Arguments=== <br />
*'''isResourceRunning:''' The value to check resources<br />
<br />
==Example==<br />
<section name="Example1" class="shared" show="true"><br />
You can insert this code example in your resources.<br />
<syntaxhighlight lang="lua"><br />
function isResourceRunning(resName)<br />
local res = getResourceFromName(resName)<br />
return (res) and (getResourceState(res) == "running")<br />
end<br />
<br />
-- Example of inserting into system code:<br />
--[[<br />
if isResourceRunning("admin") then<br />
--code<br />
else<br />
--alert<br />
end<br />
]]<br />
<br />
addCommandHandler('pos', function (commandName)<br />
if isResourceRunning("admin") then<br />
local x,y,z = getElementPosition(localPlayer)<br />
outputChatBox( x ..', '.. y ..', '.. z, 255, 255, 255 )<br />
else<br />
outputChatBox("The resource is not running 'admin'.", 255, 0, 0)<br />
end<br />
end )<br />
<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Resource}}<br />
[[ru:isBan]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=ConvertServerTickToTimeStamp&diff=82768ConvertServerTickToTimeStamp2026-04-02T01:04:30Z<p>Flox: </p>
<hr />
<div>{{Useful Function}}<br />
__NOTOC__<br />
This function converts server ticks to a unix timestamp. '''Note''': this was built to work with the server tick timestamp returned by [[onPlayerScreenShot]].<br />
Author: qaisjp<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">int convertServerTickToTimeStamp( int ticks )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
* '''ticks''': The ticks to be converted. '''REMEMBER:''' the input tick cannot be from a different server session, this is because ticks are "reset" when the server is booted. <br />
<br />
===Returns===<br />
Returns an int containing the unix timestamp number.<br />
<br />
==Code==<br />
<syntaxhighlight lang="lua"><br />
function convertServerTickToTimeStamp(tick) <br />
-- Get the current time (table).<br />
-- Note: getRealtime() creates a table that consumes memory when called frequently.<br />
<br />
local time = getRealtime()<br />
<br />
-- Calculate the difference between the passed tick and the current one in seconds<br />
-- and add it to the current Unix time.<br />
return time.timestamp + ((tick - getTickCount()) * 0.001)<br />
<br />
-- refactoring code<br />
--return getRealtime().timestamp+((getTickCount()*0.001)-(tick*0.001)); <br />
end<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Useful_Functions}}</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/triggerClientEvent&diff=82729RU/triggerClientEvent2026-02-10T15:49:03Z<p>Flox: </p>
<hr />
<div>__NOTOC__<br />
{{RU/Server function}}<br />
Эта функция позволяет вызвать срабатывание события, предварительно созданного на клиенте. Она относится к основным средствам обмена информацией между сервером и клиентом. На клиентской стороне существует аналогичная функция [[RU/triggerServerEvent|triggerServerEvent]] работающая в противоположном направлении. Эту функцию можно рассматривать как асинхронный вызов функции с использованием [[RU/triggerServerEvent|triggerServerEvent]] для получения ответа\результата, если таковой требуется.<br />
<br />
Передавать можно почти любые типы данных, включая элементы ([[element]]) и сложные вложенные таблицы ([[table]]). Данные неэлементных типов МТА, например указатели на xml (xmlNodes) или указатели на ресурсы не могут быть переданы, поскольку у них может и не существовать какого-либо представления на стороне клиента.<br />
<br />
Вызовы посылаются надежно, поэтому клиенты их получат, однако возможны (хотя, как правило, незначительные) задержки в получении, что также следует принимать во внимание. Также следует учитывать вопросы пропускной способности канала - не отправляйте большой объем данных без необходимости. Отправка одного большого вызова ненамного эффективнее отправки нескольких маленьких.<br />
<br />
==Синтаксис== <br />
<syntaxhighlight lang="lua"><br />
bool triggerClientEvent ( [element triggerFor=getRootElement()], string name, element theElement, [arguments...] )<br />
</syntaxhighlight> <br />
<br />
===Обязательные аргументы=== <br />
*'''name:''' Название события на стороне клиента. Оно должно быть зарегистрировано на стороне клиента с помощью [[RU/addEvent|addEvent]] и иметь хотя бы один обработчик, добавленный с помощью [[RU/addEventHandler|addEventHandler]].<br />
*'''theElement:''' Элемент, который будет источником [[Event system#Event handlers|source]] события. Это может быть, например, другой игрок, или корень (root element), если это непринципиально.<br />
<br />
===Дополнительные аргументы=== <br />
{{OptionalArg}} <br />
*'''triggerFor:''' Событие будет вызвано для всех игроков ( [[player]] ) которые являются потомками этого элемента. По умолчанию это корень, поэтому событие будет вызвано для всех элементов (для всех игроков). Если вы укажете только конкретного игрока, событие будет вызвано только для него. <br />
*'''arguments...:''' Список аргументов, которые будут передаваться вместе с событием. Можно передавать любые типы lua (кроме функций), а также любые элементы ([[element]]).<br />
<br />
===Вывод===<br />
Возвращает ''true'' если вызов события был успешно сделан, ''false'' если указаны некорректные аргументы.<br />
<br />
==Примеры== <br />
===Пример 1===<br />
В этом примере сервер передает простое сообщение "Превед медвед!" всем клиентам.<br />
<br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
function greetingHandler ( message )<br />
outputChatBox ( "The server says: " .. message )<br />
end<br />
addEvent( "onGreeting", true )<br />
addEventHandler( "onGreeting", getRootElement(), greetingHandler )<br />
</syntaxhighlight><br />
</section><br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
function greetingCommand ( playerSource, commandName )<br />
triggerClientEvent ( "onGreeting", getRootElement(), "Превед медвед!" )<br />
end<br />
addCommandHandler ( "greet", greetingCommand )<br />
</syntaxhighlight><br />
</section><br />
<br />
Когда выполняется консольная команда "greet" (вводится через консоль сервера или игрока), на стороне сервера вызывается функция ''greetingCommand''. Она вызывает срабатывание на стороне клиента события ''onGreeting'' с параметром "Превед медвед!". В результате вызывается функция-обработчик ''greetingHandler'', которая и пишет полученное с сервера сообщение в чат.<br />
<br />
<br />
===Пример 2===<br />
В этом примере сервер передает простое сообщение "Превед медвед!" только '''одному''' клиенту.<br />
<br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
function greetingHandler ( message )<br />
outputChatBox ( "The server says: " .. message )<br />
end<br />
addEvent( "onGreeting", true )<br />
addEventHandler( "onGreeting", getRootElement(), greetingHandler )<br />
</syntaxhighlight><br />
</section><br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
function greetingCommandOne ( playerSource, commandName, playerName )<br />
if playerName then<br />
local thePlayer = getPlayerFromName ( playerName )<br />
if thePlayer then<br />
triggerClientEvent ( thePlayer, "onGreeting", getRootElement(), "Превед медвед!" )<br />
else<br />
-- указано неправильное имя<br />
end<br />
else<br />
-- не указано имя<br />
end <br />
end<br />
addCommandHandler ( "greet_one", greetingCommandOne )<br />
</syntaxhighlight><br />
</section><br />
<br />
Пример работает так же, как и предыдущий, за исключением того, что для triggerClientEvent указывается дополнительный аргумент ''thePlayer''.<br />
<br />
==Смотрите также==<br />
{{RU/Event functions}}<br />
<br />
[[en:triggerClientEvent]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/triggerClientEvent&diff=82728RU/triggerClientEvent2026-02-10T15:48:30Z<p>Flox: </p>
<hr />
<div>__NOTOC__<br />
{{RU/Server function}}<br />
Эта функция позволяет вызвать срабатывание события, предварительно созданного на клиенте. Она относится к основным средствам обмена информацией между сервером и клиентом. На клиентской стороне существует аналогичная функция [[RU/triggerServerEvent|triggerServerEvent]] работающая в противоположном направлении. Эту функцию можно рассматривать как асинхронный вызов функции с использованием [[RU/triggerServerEvent|triggerServerEvent]] для получения ответа\результата, если таковой требуется.<br />
<br />
Передавать можно почти любые типы данных, включая элементы ([[element]]) и сложные вложенные таблицы ([[table]]). Данные неэлементных типов МТА, например указатели на xml (xmlNodes) или указатели на ресурсы не могут быть переданы, поскольку у них может и не существовать какого-либо представления на стороне клиента.<br />
<br />
Вызовы посылаются надежно, поэтому клиенты их получат, однако возможны (хотя, как правило, незначительные) задержки в получении, что также следует принимать во внимание. Также следует учитывать вопросы пропускной способности канала - не отправляйте большой объем данных без необходимости. Отправка одного большого вызова ненамного эффективнее отправки нескольких маленьких.<br />
<br />
==Синтаксис== <br />
<syntaxhighlight lang="lua"><br />
bool triggerClientEvent ( [element triggerFor=getRootElement()], string name, element theElement, [arguments...] )<br />
</syntaxhighlight> <br />
<br />
===Обязательные аргументы=== <br />
*'''name:''' Название события на стороне клиента. Оно должно быть зарегистрировано на стороне клиента с помощью [[RU/addEvent|addEvent]] и иметь хотя бы один обработчик, добавленный с помощью [[RU/addEventHandler|addEventHandler]].<br />
*'''theElement:''' Элемент, который будет источником [[Event system#Event handlers|source]] события. Это может быть, например, другой игрок, или корень (root element), если это непринципиально.<br />
<br />
===Дополнительные аргументы=== <br />
{{OptionalArg}} <br />
*'''triggerFor:''' Событие будет вызвано для всех игроков ( [[player]] ) которые являются потомками этого элемента. По умолчанию это корень, поэтому событие будет вызвано для всех элементов (для всех игроков). Если вы укажете только конкретного игрока, событие будет вызвано только для него. <br />
*'''arguments...:''' Список аргументов, которые будут передаваться вместе с событием. Можно передавать любые типы lua (кроме функций), а также любые элементы ([[element]]).<br />
<br />
===Вывод===<br />
Возвращает ''true'' если вызов события был успешно сделан, ''false'' если указаны некорректные аргументы.<br />
<br />
==Примеры== <br />
===Пример 1===<br />
В этом примере сервер передает простое сообщение "Превед медвед!" всем клиентам.<br />
<br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
function greetingHandler ( message )<br />
outputChatBox ( "The server says: " .. message )<br />
end<br />
addEvent( "onGreeting", true )<br />
addEventHandler( "onGreeting", getRootElement(), greetingHandler )<br />
</syntaxhighlight><br />
</section><br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
function greetingCommand ( playerSource, commandName )<br />
triggerClientEvent ( "onGreeting", getRootElement(), "Превед медвед!" )<br />
end<br />
addCommandHandler ( "greet", greetingCommand )<br />
</syntaxhighlight><br />
</section><br />
<br />
Когда выполняется консольная команда "greet" (вводится через консоль сервера или игрока), на стороне сервера вызывается функция ''greetingCommand''. Она вызывает срабатывание на стороне клиента события ''onGreeting'' с параметром "Превед медвед!". В результате вызывается функция-обработчик ''greetingHandler'', которая и пишет полученное с сервера сообщение в чат.<br />
<br />
<br />
===Пример 2===<br />
В этом примере сервер передает простое сообщение "Превед медвед!" только '''одному''' клиенту.<br />
<br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
function greetingHandler ( message )<br />
outputChatBox ( "The server says: " .. message )<br />
end<br />
addEvent( "onGreeting", true )<br />
addEventHandler( "onGreeting", getRootElement(), greetingHandler )<br />
</syntaxhighlight><br />
</section><br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
function greetingCommandOne ( playerSource, commandName, playerName )<br />
if playerName then<br />
local thePlayer = getPlayerFromName ( playerName )<br />
if thePlayer then<br />
triggerClientEvent ( thePlayer, "onGreeting", getRootElement(), "Превед медвед!" )<br />
else<br />
-- указано неправильное имя<br />
end<br />
else<br />
-- не указано имя<br />
end <br />
end<br />
addCommandHandler ( "greet_one", greetingCommandOne )<br />
</syntaxhighlight><br />
</section><br />
<br />
Пример работает так же, как и предыдущий, за исключением того, что для triggerClientEvent указывается дополнительный аргумент ''thePlayer''.<br />
<br />
==Смотрите также==<br />
{{/Event functions}}<br />
<br />
[[en:triggerClientEvent]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Main_Page&diff=82702RU/Main Page2026-01-08T19:21:42Z<p>Flox: </p>
<hr />
<div>{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<div style="/*border: 1px solid #D8D8D8;*/ padding-left: 15px; padding-right: 15px; height: 100%;"><br />
[[File:Mtalogo.png|left|100px|link=https://wiki.multitheftauto.com/wiki/RU/Main_Page]]'''Добро пожаловать в вики о модификации [[RU/Multi Theft Auto|Multi Theft Auto]] для игры Grand Theft Auto: San Andreas.''' Здесь вы найдёте множество информации об использовании этой модификации.<br />
<br />
Есть много [[Как ты можешь помочь|вещей]], которые вы можете сделать, чтобы помочь нам улучшить Multi Theft Auto - создать карту, игровой режим, добавить описание функций скриптинга, написать пример кода, руководство, или просто поиграть в Multi Theft Auto и сообщить о найденных недоработках.<br />
<br />
Если у вас есть какие-либо вопросы или проблемы, связанные со скриптингом, вы можете [[RU/Places_To_Chat|связаться с нами]].<br />
<br/><br/>[ Перестань играть с собой ]<br />
</div><br />
|}<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
|-<br />
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;"><br />
<div style="float:right; width: 32px;">[[File:Input-gaming.png|link=]]</div><br />
<h3>Играть</h3><br />
<div style="background: #FFEEAA; border: 1px solid #FFCD19;"><br />
[[File:Go-down.png|link=https://mtasa.com/]] ''' [https://mtasa.com/ Скачать Multi Theft Auto {{Current Version|full}}]'''</div><br />
* [[RU/Where to buy GTASA|Где купить Grand Theft Auto: San Andreas]]<br />
* [[RU/Client Manual|Руководство о клиенте]]<br />
<!-- * [[Changes_in_{{padleft:|3|{{Current Version|full}}}}| Changes in {{padleft:|3|{{Current Version|full}}}}]] --><br />
* [[Changes_in_{{padleft:|5|{{Current Version|full}}}}| Изменения в версии {{padleft:|5|{{Current Version|full}}}}]]<br />
* [[RU/Known Issues_-_FAQ|Известные проблемы]]<br />
* [[RU/Upgrading_from_MTA:Race|Переход из MTA:Race в MTA:SA {{padleft:|3|{{Current Version|full}}}}]]<br />
* [[RU/Server Manual|Руководство о сервере]]<br />
* [[RU/Map manager|Менеджер карт]]<br />
<br />
<h3>Редактор карт</h3><br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат определения редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
*[[RU/Resource:Editor#FAQ|Часто задаваемые вопросы]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Package-x-generic.png|link=]]</div><br />
<h3>Базы данных</h3><br />
В этом разделе описаны все возможности Lua, предоставляемые Multi Theft Auto и ресурсами.<br />
* [[:RU/Category:Resource|Каталог ресурсов]] - изучите их, чтобы создавать правильные скрипты<br />
* [[RU/Client side scripts|Клиентские скрипты]]<br />
* [[Modules|Модули]]<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Applications-development.png|link=]]</div><br />
<h3>Разработка Multi Theft Auto</h3><br />
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Ночные сборки]<br />
* [[RU/Compiling_MTASA|Компилирование MTA:SA на Windows]]<br />
<!--* [[Building_MTASA_Server_on_Mac_OS_X|Compiling MTASA on Mac OS X]]--><br />
* [[RU/Building_MTASA_Server_on_GNU_Linux|Компилирование MTA:SA на GNU/Linux]]<br />
* [[RU/Coding guidelines|Рекомендации по написанию кода]]<br />
* [https://github.com/multitheftauto/mtasa-blue Главный репозиторий GitHub]<br />
* [[RU/Roadmap|План разработки]]<br />
* [https://bugs.mtasa.com/ Багтрекер]<br />
* [[RU/Branches|Ответвления]]<br />
* [[RU/Forks|Forks and anti cheat]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div><br />
<h3>Вики - как вы можете помочь</h3><br />
* Заполните документацию для [[:Category:RU/Incomplete|незавершённых функций]].<br />
* Добавьте [[:Category:RU/Needs_Example|примеры использования функций и событий]].<br />
* Просмотрите и проверьте [[:Category:RU/Needs Checking|страницы, требующие проверки]].<br />
* Напишите руководства для помощи новичкам.<br />
* Переводите страницы вики.<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png|link=]]</div><br />
<h3>Сообщество</h3><br />
* [https://forum.multitheftauto.com/ Англоязычный форум]<br />
* [https://forum.multitheftauto.com/forum/100-russian-русский/ Русскоязычный форум]<br />
* Discord: [https://forum.mtasa.com/topic/95008-multi-theft-autos-official-discord-server/ Официальный MTA Discord сервер]<br />
* IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]<br />
* [https://community.mtasa.com/ Сообщество MTA] - обмен и закачка ресурсов<br />
* [https://twitter.com/#!/MTAQA/ Twitter] - [https://www.youtube.com/user/MTAQA YouTube] - [https://plus.google.com/102014133442331779727/ Google+] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas Mod DB]<br />
</div><br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div><br />
<h3>Скриптинг</h3><br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI|Введение в GUI-скриптинг]]<br />
* [[RU/Debugging|Руководство по отладке]] - как найти ошибки в ваших скриптах<br />
* [[RU/Resources|Введение в ресурсы]]<br />
** [[RU/Resource Web Access|Веб-доступ к ресурсам]] - как можно связать сайт и ресурсы<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml|Meta.xml]] - имеющийся у каждого ресурса файл-описание<br />
** [[RU/ACL|ACL]] - список контроля доступа, важный для работы комплексных скриптов<br />
* [[RU/Writing_Gamemodes|Создание игровых ресурсов]]<br />
* [[RU/Script_security|Как писать безопасные скрипты и не бояться читеров]]<br />
* [[RU/Useful_Functions|Полезные функции]]<br />
Форумные ссылки<br />
* [https://forum.mtasa.com/forum/71-scripting/ Скриптинг]<br />
* [https://forum.mtasa.com/forum/123-tutorials/ Руководства по скриптингу]<br />
* [https://forum.mtasa.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Вики-копии офлайн]<br />
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div><br />
<h3>Общая информация о Lua</h3><br />
Страницы, которые могут вам помочь в изучении Lua<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на Lua (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory Lua-вики (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[https://forum.multitheftauto.com/viewtopic.php?f=141&t=32458 Справочник статей (русск.)]<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;"><br />
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div><br />
<h3>Справка</h3><br />
* [[RU/Client Scripting Functions|Клиентские функции]]<br />
* [[RU/Client Scripting Events|Клиентские события]]<br />
* [[RU/Server Scripting Functions|Серверные функции]]<br />
* [[RU/Server Scripting Events|Серверные события]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
* [[RU/MTA Classes|Классы MTA]] - подробное описание всех настраиваемых типов MTA<br />
** [[RU/Element|Элементы MTA]]/[[RU/Element tree|Дерево элементов]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div><br />
<h3>[[RU/Id|Списки идентификаторов]]</h3><br />
*[[RU/Animations|Анимации]]<br />
*[[RU/Character Skins|Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда CJ]]<br />
*[[RU/Garage|Гаражи]]<br />
*[[RU/Interior IDs|Интерьеры]]<br />
*[[RU/Material IDs|Материалы]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar Blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle Colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Модернизация транспорта]]<br />
*[[RU/Vehicle variants|Варианты транспорта]]<br />
*[[RU/Vehicle component manipulation|Манипуляция компонентов транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<div style="padding:4px 8px 8px 8px; margin:10px;"><br />
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]<br />
'''Multi Theft Auto''' имеет '''открытый исходный код'''. <br />
<br/>Это значит, что каждый может помочь сделать Multi Theft Auto еще лучше!<br />
</div><br />
|-<br />
| colspan="2" |<br />
|}<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks"><br />
[[File:MTALogo_8ball.png|left|85px|link=Archive]]<br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''О [[Multi Theft Auto]]'''</li><br />
<li>[[RU/Archive|Архив]]</li><br />
<li>[[RU/Press Coverage|В прессе]]</li><br />
<li>[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Разработчики]</li><br />
</ul><br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''Multi Theft Auto 0.5'''</li><br />
<li>[[Archive#Multi_Theft_Auto_0.5|Скачать]]</li><br />
<li>[[MTA 0.5r2 Known Issues|Известные проблемы]]</li><br />
</ul><br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''Статистика вики'''</li><br />
<li>Статей: {{NUMBEROFARTICLES}}</li><br />
<li>Страниц: {{NUMBEROFPAGES}}</li><br />
<li>Зарегистрированных пользователей: {{NUMBEROFUSERS}}</li><br />
</ul><br />
</div><br />
|}<br />
<br />
__NOTOC__<br />
__NOEDITSECTION__<br />
[[ar:Main Page]]<br />
[[cs:hlavni]]<br />
[[sk:Main Page]]<br />
[[de:Hauptseite]]<br />
[[en:Main Page]]<br />
[[es:Página Principal]]<br />
[[fr:Main Page]]<br />
[[hu:Main Page]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[pl:Strona_Główna]]<br />
[[pt-br:Página Inicial]]<br />
[[tr:Anasayfa]]<br />
[[zh-cn:Main Page]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Main_Page&diff=82701RU/Main Page2026-01-08T19:19:28Z<p>Flox: </p>
<hr />
<div>{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<div style="/*border: 1px solid #D8D8D8;*/ padding-left: 15px; padding-right: 15px; height: 100%;"><br />
[[File:Mtalogo.png|left|100px|link=https://wiki.multitheftauto.com/wiki/RU/Main_Page]]'''Добро пожаловать в вики о модификации [[RU/Multi Theft Auto|Multi Theft Auto]] для игры Grand Theft Auto: San Andreas.''' Здесь вы найдёте множество информации об использовании этой модификации.<br />
<br />
Есть много [[Как ты можешь помочь|вещей]], которые вы можете сделать, чтобы помочь нам улучшить Multi Theft Auto - создать карту, игровой режим, добавить описание функций скриптинга, написать пример кода, руководство, или просто поиграть в Multi Theft Auto и сообщить о найденных недоработках.<br />
<br />
Если у вас есть какие-либо вопросы или проблемы, связанные со скриптингом, вы можете [[RU/Places_To_Chat|связаться с нами]].<br />
<br/><br/>[ Перестань играть с собой ]<br />
</div><br />
|}<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
|-<br />
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;"><br />
<div style="float:right; width: 32px;">[[File:Input-gaming.png|link=]]</div><br />
<h3>Играть</h3><br />
<div style="background: #FFEEAA; border: 1px solid #FFCD19;"><br />
[[File:Go-down.png|link=https://mtasa.com/]] ''' [https://mtasa.com/ Скачать Multi Theft Auto {{Current Version|full}}]'''</div><br />
* [[RU/Where to buy GTASA|Где купить Grand Theft Auto: San Andreas]]<br />
* [[RU/Client Manual|Руководство о клиенте]]<br />
<!-- * [[Changes_in_{{padleft:|3|{{Current Version|full}}}}| Changes in {{padleft:|3|{{Current Version|full}}}}]] --><br />
* [[RU/Changes_in_{{padleft:|5|{{Current Version|full}}}}| Изменения в версии {{padleft:|5|{{Current Version|full}}}}]]<br />
* [[RU/Known Issues_-_FAQ|Известные проблемы]]<br />
* [[RU/Upgrading_from_MTA:Race|Переход из MTA:Race в MTA:SA {{padleft:|3|{{Current Version|full}}}}]]<br />
* [[RU/Server Manual|Руководство о сервере]]<br />
* [[RU/Map manager|Менеджер карт]]<br />
<br />
<h3>Редактор карт</h3><br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат определения редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
*[[RU/Resource:Editor#FAQ|Часто задаваемые вопросы]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Package-x-generic.png|link=]]</div><br />
<h3>Базы данных</h3><br />
В этом разделе описаны все возможности Lua, предоставляемые Multi Theft Auto и ресурсами.<br />
* [[:RU/Category:Resource|Каталог ресурсов]] - изучите их, чтобы создавать правильные скрипты<br />
* [[RU/Client side scripts|Клиентские скрипты]]<br />
* [[Modules|Модули]]<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Applications-development.png|link=]]</div><br />
<h3>Разработка Multi Theft Auto</h3><br />
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Ночные сборки]<br />
* [[RU/Compiling_MTASA|Компилирование MTA:SA на Windows]]<br />
<!--* [[Building_MTASA_Server_on_Mac_OS_X|Compiling MTASA on Mac OS X]]--><br />
* [[RU/Building_MTASA_Server_on_GNU_Linux|Компилирование MTA:SA на GNU/Linux]]<br />
* [[RU/Coding guidelines|Рекомендации по написанию кода]]<br />
* [https://github.com/multitheftauto/mtasa-blue Главный репозиторий GitHub]<br />
* [[RU/Roadmap|План разработки]]<br />
* [https://bugs.mtasa.com/ Багтрекер]<br />
* [[RU/Branches|Ответвления]]<br />
* [[RU/Forks|Forks and anti cheat]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div><br />
<h3>Вики - как вы можете помочь</h3><br />
* Заполните документацию для [[:Category:RU/Incomplete|незавершённых функций]].<br />
* Добавьте [[:Category:RU/Needs_Example|примеры использования функций и событий]].<br />
* Просмотрите и проверьте [[:Category:RU/Needs Checking|страницы, требующие проверки]].<br />
* Напишите руководства для помощи новичкам.<br />
* Переводите страницы вики.<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png|link=]]</div><br />
<h3>Сообщество</h3><br />
* [https://forum.multitheftauto.com/ Англоязычный форум]<br />
* [https://forum.multitheftauto.com/forum/100-russian-русский/ Русскоязычный форум]<br />
* Discord: [https://forum.mtasa.com/topic/95008-multi-theft-autos-official-discord-server/ Официальный MTA Discord сервер]<br />
* IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]<br />
* [https://community.mtasa.com/ Сообщество MTA] - обмен и закачка ресурсов<br />
* [https://twitter.com/#!/MTAQA/ Twitter] - [https://www.youtube.com/user/MTAQA YouTube] - [https://plus.google.com/102014133442331779727/ Google+] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas Mod DB]<br />
</div><br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div><br />
<h3>Скриптинг</h3><br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI|Введение в GUI-скриптинг]]<br />
* [[RU/Debugging|Руководство по отладке]] - как найти ошибки в ваших скриптах<br />
* [[RU/Resources|Введение в ресурсы]]<br />
** [[RU/Resource Web Access|Веб-доступ к ресурсам]] - как можно связать сайт и ресурсы<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml|Meta.xml]] - имеющийся у каждого ресурса файл-описание<br />
** [[RU/ACL|ACL]] - список контроля доступа, важный для работы комплексных скриптов<br />
* [[RU/Writing_Gamemodes|Создание игровых ресурсов]]<br />
* [[RU/Script_security|Как писать безопасные скрипты и не бояться читеров]]<br />
* [[RU/Useful_Functions|Полезные функции]]<br />
Форумные ссылки<br />
* [https://forum.mtasa.com/forum/71-scripting/ Скриптинг]<br />
* [https://forum.mtasa.com/forum/123-tutorials/ Руководства по скриптингу]<br />
* [https://forum.mtasa.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Вики-копии офлайн]<br />
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div><br />
<h3>Общая информация о Lua</h3><br />
Страницы, которые могут вам помочь в изучении Lua<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на Lua (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory Lua-вики (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[https://forum.multitheftauto.com/viewtopic.php?f=141&t=32458 Справочник статей (русск.)]<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;"><br />
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div><br />
<h3>Справка</h3><br />
* [[RU/Client Scripting Functions|Клиентские функции]]<br />
* [[RU/Client Scripting Events|Клиентские события]]<br />
* [[RU/Server Scripting Functions|Серверные функции]]<br />
* [[RU/Server Scripting Events|Серверные события]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
* [[RU/MTA Classes|Классы MTA]] - подробное описание всех настраиваемых типов MTA<br />
** [[RU/Element|Элементы MTA]]/[[RU/Element tree|Дерево элементов]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div><br />
<h3>[[RU/Id|Списки идентификаторов]]</h3><br />
*[[RU/Animations|Анимации]]<br />
*[[RU/Character Skins|Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда CJ]]<br />
*[[RU/Garage|Гаражи]]<br />
*[[RU/Interior IDs|Интерьеры]]<br />
*[[RU/Material IDs|Материалы]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar Blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle Colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Модернизация транспорта]]<br />
*[[RU/Vehicle variants|Варианты транспорта]]<br />
*[[RU/Vehicle component manipulation|Манипуляция компонентов транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<div style="padding:4px 8px 8px 8px; margin:10px;"><br />
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]<br />
'''Multi Theft Auto''' имеет '''открытый исходный код'''. <br />
<br/>Это значит, что каждый может помочь сделать Multi Theft Auto еще лучше!<br />
</div><br />
|-<br />
| colspan="2" |<br />
|}<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks"><br />
[[File:MTALogo_8ball.png|left|85px|link=Archive]]<br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''О [[Multi Theft Auto]]'''</li><br />
<li>[[RU/Archive|Архив]]</li><br />
<li>[[RU/Press Coverage|В прессе]]</li><br />
<li>[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Разработчики]</li><br />
</ul><br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''Multi Theft Auto 0.5'''</li><br />
<li>[[Archive#Multi_Theft_Auto_0.5|Скачать]]</li><br />
<li>[[MTA 0.5r2 Known Issues|Известные проблемы]]</li><br />
</ul><br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''Статистика вики'''</li><br />
<li>Статей: {{NUMBEROFARTICLES}}</li><br />
<li>Страниц: {{NUMBEROFPAGES}}</li><br />
<li>Зарегистрированных пользователей: {{NUMBEROFUSERS}}</li><br />
</ul><br />
</div><br />
|}<br />
<br />
__NOTOC__<br />
__NOEDITSECTION__<br />
[[ar:Main Page]]<br />
[[cs:hlavni]]<br />
[[sk:Main Page]]<br />
[[de:Hauptseite]]<br />
[[en:Main Page]]<br />
[[es:Página Principal]]<br />
[[fr:Main Page]]<br />
[[hu:Main Page]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[pl:Strona_Główna]]<br />
[[pt-br:Página Inicial]]<br />
[[tr:Anasayfa]]<br />
[[zh-cn:Main Page]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Main_Page&diff=82700RU/Main Page2026-01-08T19:17:34Z<p>Flox: </p>
<hr />
<div>{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<div style="/*border: 1px solid #D8D8D8;*/ padding-left: 15px; padding-right: 15px; height: 100%;"><br />
[[File:Mtalogo.png|left|100px|link=https://wiki.multitheftauto.com/wiki/RU/Main_Page]]'''Добро пожаловать в вики о модификации [[RU/Multi Theft Auto|Multi Theft Auto]] для игры Grand Theft Auto: San Andreas.''' Здесь вы найдёте множество информации об использовании этой модификации.<br />
<br />
Есть много [[Как ты можешь помочь|вещей]], которые вы можете сделать, чтобы помочь нам улучшить Multi Theft Auto - создать карту, игровой режим, добавить описание функций скриптинга, написать пример кода, руководство, или просто поиграть в Multi Theft Auto и сообщить о найденных недоработках.<br />
<br />
Если у вас есть какие-либо вопросы или проблемы, связанные со скриптингом, вы можете [[RU/Places_To_Chat|связаться с нами]].<br />
<br/><br/>[ Перестань играть с собой ]<br />
</div><br />
|}<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
|-<br />
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;"><br />
<div style="float:right; width: 32px;">[[File:Input-gaming.png|link=]]</div><br />
<h3>Играть</h3><br />
<div style="background: #FFEEAA; border: 1px solid #FFCD19;"><br />
[[File:Go-down.png|link=https://mtasa.com/]] ''' [https://mtasa.com/ Скачать Multi Theft Auto {{Current Version|full}}]'''</div><br />
* [[RU/Where to buy GTASA|Где купить Grand Theft Auto: San Andreas]]<br />
* [[RU/Client Manual|Руководство о клиенте]]<br />
<!-- * [[Changes_in_{{padleft:|3|{{Current Version|full}}}}| Changes in {{padleft:|3|{{Current Version|full}}}}]] --><br />
* [[RU/Changes_in_{{padleft:|5|{{Current Version|full}}}}| Изменения в версии {{padleft:|5|{{Current Version|full}}}}]]<br />
* [[RU/Known Issues_-_FAQ|Известные проблемы]]<br />
* [[RU/Upgrading_from_MTA:Race|Переход из MTA:Race в MTA:SA {{padleft:|3|{{Current Version|full}}}}]]<br />
* [[RU/Server Manual|Руководство о сервере]]<br />
* [[RU/Map manager|Менеджер карт]]<br />
<br />
<h3>Редактор карт</h3><br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат определения редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
*[[RU/Resource:Editor#FAQ|Часто задаваемые вопросы]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Package-x-generic.png|link=]]</div><br />
<h3>Базы данных</h3><br />
В этом разделе описаны все возможности Lua, предоставляемые Multi Theft Auto и ресурсами.<br />
* [[:RU/Category:Resource|Каталог ресурсов]] - изучите их, чтобы создавать правильные скрипты<br />
* [[RU/Client side scripts|Клиентские скрипты]]<br />
* [[Modules|Модули]]<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Applications-development.png|link=]]</div><br />
<h3>Разработка Multi Theft Auto</h3><br />
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Ночные сборки]<br />
* [[RU/Compiling_MTASA|Компилирование MTA:SA на Windows]]<br />
<!--* [[Building_MTASA_Server_on_Mac_OS_X|Compiling MTASA on Mac OS X]]--><br />
* [[RU/Building_MTASA_Server_on_GNU_Linux|Компилирование MTA:SA на GNU/Linux]]<br />
* [[RU/Coding guidelines|Рекомендации по написанию кода]]<br />
* [https://github.com/multitheftauto/mtasa-blue Главный репозиторий GitHub]<br />
* [[RU/Roadmap|План разработки]]<br />
* [https://bugs.mtasa.com/ Багтрекер]<br />
* [[RU/Branches|Ответвления]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div><br />
<h3>Вики - как вы можете помочь</h3><br />
* Заполните документацию для [[:Category:RU/Incomplete|незавершённых функций]].<br />
* Добавьте [[:Category:RU/Needs_Example|примеры использования функций и событий]].<br />
* Просмотрите и проверьте [[:Category:RU/Needs Checking|страницы, требующие проверки]].<br />
* Напишите руководства для помощи новичкам.<br />
* Переводите страницы вики.<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png|link=]]</div><br />
<h3>Сообщество</h3><br />
* [https://forum.multitheftauto.com/ Англоязычный форум]<br />
* [https://forum.multitheftauto.com/forum/100-russian-русский/ Русскоязычный форум]<br />
* Discord: [https://forum.mtasa.com/topic/95008-multi-theft-autos-official-discord-server/ Официальный MTA Discord сервер]<br />
* IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]<br />
* [https://community.mtasa.com/ Сообщество MTA] - обмен и закачка ресурсов<br />
* [https://twitter.com/#!/MTAQA/ Twitter] - [https://www.youtube.com/user/MTAQA YouTube] - [https://plus.google.com/102014133442331779727/ Google+] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas Mod DB]<br />
</div><br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div><br />
<h3>Скриптинг</h3><br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI|Введение в GUI-скриптинг]]<br />
* [[RU/Debugging|Руководство по отладке]] - как найти ошибки в ваших скриптах<br />
* [[RU/Resources|Введение в ресурсы]]<br />
** [[RU/Resource Web Access|Веб-доступ к ресурсам]] - как можно связать сайт и ресурсы<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml|Meta.xml]] - имеющийся у каждого ресурса файл-описание<br />
** [[RU/ACL|ACL]] - список контроля доступа, важный для работы комплексных скриптов<br />
* [[RU/Writing_Gamemodes|Создание игровых ресурсов]]<br />
* [[RU/Script_security|Как писать безопасные скрипты и не бояться читеров]]<br />
* [[RU/Useful_Functions|Полезные функции]]<br />
Форумные ссылки<br />
* [https://forum.mtasa.com/forum/71-scripting/ Скриптинг]<br />
* [https://forum.mtasa.com/forum/123-tutorials/ Руководства по скриптингу]<br />
* [https://forum.mtasa.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Вики-копии офлайн]<br />
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div><br />
<h3>Общая информация о Lua</h3><br />
Страницы, которые могут вам помочь в изучении Lua<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на Lua (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory Lua-вики (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[https://forum.multitheftauto.com/viewtopic.php?f=141&t=32458 Справочник статей (русск.)]<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;"><br />
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div><br />
<h3>Справка</h3><br />
* [[RU/Client Scripting Functions|Клиентские функции]]<br />
* [[RU/Client Scripting Events|Клиентские события]]<br />
* [[RU/Server Scripting Functions|Серверные функции]]<br />
* [[RU/Server Scripting Events|Серверные события]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
* [[RU/MTA Classes|Классы MTA]] - подробное описание всех настраиваемых типов MTA<br />
** [[RU/Element|Элементы MTA]]/[[RU/Element tree|Дерево элементов]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div><br />
<h3>[[RU/Id|Списки идентификаторов]]</h3><br />
*[[RU/Animations|Анимации]]<br />
*[[RU/Character Skins|Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда CJ]]<br />
*[[RU/Garage|Гаражи]]<br />
*[[RU/Interior IDs|Интерьеры]]<br />
*[[RU/Material IDs|Материалы]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar Blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle Colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Модернизация транспорта]]<br />
*[[RU/Vehicle variants|Варианты транспорта]]<br />
*[[RU/Vehicle component manipulation|Манипуляция компонентов транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<div style="padding:4px 8px 8px 8px; margin:10px;"><br />
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]<br />
'''Multi Theft Auto''' имеет '''открытый исходный код'''. <br />
<br/>Это значит, что каждый может помочь сделать Multi Theft Auto еще лучше!<br />
</div><br />
|-<br />
| colspan="2" |<br />
|}<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks"><br />
[[File:MTALogo_8ball.png|left|85px|link=Archive]]<br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''О [[Multi Theft Auto]]'''</li><br />
<li>[[RU/Archive|Архив]]</li><br />
<li>[[RU/Press Coverage|В прессе]]</li><br />
<li>[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Разработчики]</li><br />
</ul><br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''Multi Theft Auto 0.5'''</li><br />
<li>[[Archive#Multi_Theft_Auto_0.5|Скачать]]</li><br />
<li>[[MTA 0.5r2 Known Issues|Известные проблемы]]</li><br />
</ul><br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''Статистика вики'''</li><br />
<li>Статей: {{NUMBEROFARTICLES}}</li><br />
<li>Страниц: {{NUMBEROFPAGES}}</li><br />
<li>Зарегистрированных пользователей: {{NUMBEROFUSERS}}</li><br />
</ul><br />
</div><br />
|}<br />
<br />
__NOTOC__<br />
__NOEDITSECTION__<br />
[[ar:Main Page]]<br />
[[cs:hlavni]]<br />
[[sk:Main Page]]<br />
[[de:Hauptseite]]<br />
[[en:Main Page]]<br />
[[es:Página Principal]]<br />
[[fr:Main Page]]<br />
[[hu:Main Page]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[pl:Strona_Główna]]<br />
[[pt-br:Página Inicial]]<br />
[[tr:Anasayfa]]<br />
[[zh-cn:Main Page]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Main_Page&diff=82699RU/Main Page2026-01-08T19:17:21Z<p>Flox: </p>
<hr />
<div>{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<div style="/*border: 1px solid #D8D8D8;*/ padding-left: 15px; padding-right: 15px; height: 100%;"><br />
[[File:Mtalogo.png|left|100px|link=https://wiki.multitheftauto.com/wiki/RU/Main_Page]]'''Добро пожаловать в вики о модификации [[RU/Multi Theft Auto|Multi Theft Auto]] для игры Grand Theft Auto: San Andreas.''' Здесь вы найдёте множество информации об использовании этой модификации.<br />
<br />
Есть много [[Как ты можешь помочь|вещей]], которые вы можете сделать, чтобы помочь нам улучшить Multi Theft Auto - создать карту, игровой режим, добавить описание функций скриптинга, написать пример кода, руководство, или просто поиграть в Multi Theft Auto и сообщить о найденных недоработках.<br />
<br />
Если у вас есть какие-либо вопросы или проблемы, связанные со скриптингом, вы можете [[RU/Places_To_Chat|связаться с нами]].<br />
<br/><br/>[ Перестань играть с собой ]<br />
</div><br />
|}<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
|-<br />
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background: #FFFCF2;"><br />
<div style="float:right; width: 32px;">[[File:Input-gaming.png|link=]]</div><br />
<h3>Играть</h3><br />
<div style="background: #FFEEAA; border: 1px solid #FFCD19;"><br />
[[File:Go-down.png|link=https://mtasa.com/]] ''' [https://mtasa.com/ Скачать Multi Theft Auto {{Current Version|full}}]'''</div><br />
* [[RU/Where to buy GTASA|Где купить Grand Theft Auto: San Andreas]]<br />
* [[RU/Client Manual|Руководство о клиенте]]<br />
<!-- * [[Changes_in_{{padleft:|3|{{Current Version|full}}}}| Changes in {{padleft:|3|{{Current Version|full}}}}]] --><br />
* [[RU/Changes_in_{{padleft:|5|{{Current Version|full}}}}| Изменения в версии {{padleft:|5|{{Current Version|full}}}}]]<br />
* [[RU/Known Issues_-_FAQ|Известные проблемы]]<br />
* [[RU/Upgrading_from_MTA:Race|Переход из MTA:Race в MTA:SA {{padleft:|3|{{Current Version|full}}}}]]<br />
* [[RU/Server Manual|Руководство о сервере]]<br />
* [[RU/Map manager|Менеджер карт]]<br />
<br />
<h3>Редактор карт</h3><br />
*[[RU/Resource:Editor|Руководство]]<br />
*[[RU/Resource:Editor/EDF|Формат определения редактора]]<br />
*[[RU/Resource:Editor/Plugins|Плагины]]<br />
*[[RU/Resource:Editor#FAQ|Часто задаваемые вопросы]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Package-x-generic.png|link=]]</div><br />
<h3>Базы данных</h3><br />
В этом разделе описаны все возможности Lua, предоставляемые Multi Theft Auto и ресурсами.<br />
* [[:RU/Category:Resource|Каталог ресурсов]] - изучите их, чтобы создавать правильные скрипты<br />
* [[RU/Client side scripts|Клиентские скрипты]]<br />
* [[Modules|Модули]]<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Applications-development.png|link=]]</div><br />
<h3>Разработка Multi Theft Auto</h3><br />
[[File:Go-down.png|link=https://nightly.mtasa.com/]] [https://nightly.mtasa.com/ Ночные сборки]<br />
* [[RU/Compiling_MTASA|Компилирование MTA:SA на Windows]]<br />
<!--* [[Building_MTASA_Server_on_Mac_OS_X|Compiling MTASA on Mac OS X]]--><br />
* [[RU/Building_MTASA_Server_on_GNU_Linux|Компилирование MTA:SA на GNU/Linux]]<br />
* [[RU/Coding guidelines|Рекомендации по написанию кода]]<br />
* [https://github.com/multitheftauto/mtasa-blue Главный репозиторий GitHub]<br />
* [[RU/Roadmap|План разработки]]<br />
* [https://bugs.mtasa.com/ Багтрекер]<br />
* [[RU/Branches|Ответвления]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Applications-office.png|link=]]</div><br />
<h3>Вики - как вы можете помочь</h3><br />
* Заполните документацию для [[:Category:RU/Incomplete|незавершённых функций]].<br />
* Добавьте [[:Category:RU/Needs_Example|примеры использования функций и событий]].<br />
* Просмотрите и проверьте [[:Category:RU/Needs Checking|страницы, требующие проверки]].<br />
* Напишите руководства для помощи новичкам.<br />
* Переводите страницы вики.<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png|link=]]</div><br />
<h3>Сообщество</h3><br />
* [https://forum.multitheftauto.com/ Англоязычный форум]<br />
* [https://forum.multitheftauto.com/forum/100-russian-русский/ Русскоязычный форум]<br />
* Discord: [https://forum.mtasa.com/topic/95008-multi-theft-autos-official-discord-server/ Официальный MTA Discord сервер]<br />
* IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]<br />
* [https://community.mtasa.com/ Сообщество MTA] - обмен и закачка ресурсов<br />
* [https://twitter.com/#!/MTAQA/ Twitter] - [https://www.youtube.com/user/MTAQA YouTube] - [https://plus.google.com/102014133442331779727/ Google+] - [https://www.moddb.com/mods/multi-theft-auto-san-andreas Mod DB]<br />
</div><br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png|link=]]</div><br />
<h3>Скриптинг</h3><br />
* [[RU/Scripting Introduction|Введение в скриптинг]]<br />
* [[RU/Introduction to Scripting the GUI|Введение в GUI-скриптинг]]<br />
* [[RU/Debugging|Руководство по отладке]] - как найти ошибки в ваших скриптах<br />
* [[RU/Resources|Введение в ресурсы]]<br />
** [[RU/Resource Web Access|Веб-доступ к ресурсам]] - как можно связать сайт и ресурсы<br />
** [[:Category:RU/Resource|Каталог ресурсов]]<br />
** [[RU/Meta.xml|Meta.xml]] - имеющийся у каждого ресурса файл-описание<br />
** [[RU/ACL|ACL]] - список контроля доступа, важный для работы комплексных скриптов<br />
* [[RU/Writing_Gamemodes|Создание игровых ресурсов]]<br />
* [[RU/Script_security|- Как писать безопасные скрипты и не бояться читеров]]<br />
* [[RU/Useful_Functions|Полезные функции]]<br />
Форумные ссылки<br />
* [https://forum.mtasa.com/forum/71-scripting/ Скриптинг]<br />
* [https://forum.mtasa.com/forum/123-tutorials/ Руководства по скриптингу]<br />
* [https://forum.mtasa.com/topic/24702-mtasa-wiki-offline-copies-online-mirrors/ Вики-копии офлайн]<br />
<div style="float:right; width: 32px;">[[File:start-here.png|link=]]</div><br />
<h3>Общая информация о Lua</h3><br />
Страницы, которые могут вам помочь в изучении Lua<br />
*[http://www.lua.ru/doc/ Руководство по программированию на Lua (русск.)] <br />
*[http://www.lua.org/pil/index.html Руководство по программированию на Lua (англ.)]<br />
*[http://lua-users.org/wiki/TutorialDirectory Lua-вики (англ.)]<br />
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Базовое руководство по Lua от Nixstaller (англ.)]<br />
*[https://forum.multitheftauto.com/viewtopic.php?f=141&t=32458 Справочник статей (русск.)]<br />
</div><br />
<br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#F2F2FF;"><br />
<div style="float:right; width: 32px;">[[File:Preferences-system.png|link=]]</div><br />
<h3>Справка</h3><br />
* [[RU/Client Scripting Functions|Клиентские функции]]<br />
* [[RU/Client Scripting Events|Клиентские события]]<br />
* [[RU/Server Scripting Functions|Серверные функции]]<br />
* [[RU/Server Scripting Events|Серверные события]]<br />
<!-- Incomplete * [[Module functions|Server-side external module scripting functions list]] --><br />
* [[RU/MTA Classes|Классы MTA]] - подробное описание всех настраиваемых типов MTA<br />
** [[RU/Element|Элементы MTA]]/[[RU/Element tree|Дерево элементов]]<br />
</div><br />
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;"><br />
<div style="float:right; width: 32px;">[[File:System-file-manager.png|link=]]</div><br />
<h3>[[RU/Id|Списки идентификаторов]]</h3><br />
*[[RU/Animations|Анимации]]<br />
*[[RU/Character Skins|Скины персонажей]]<br />
*[[RU/CJ_Clothes|Одежда CJ]]<br />
*[[RU/Garage|Гаражи]]<br />
*[[RU/Interior IDs|Интерьеры]]<br />
*[[RU/Material IDs|Материалы]]<br />
*[[RU/Projectiles|Снаряды]]<br />
*[[RU/Radar Blips|Метки радара]]<br />
*[[RU/Sounds|Звуки]]<br />
*[[RU/Vehicle IDs|Транспорт]]<br />
*[[RU/Vehicle Colors|Цвета транспорта]]<br />
*[[RU/Vehicle Upgrades|Модернизация транспорта]]<br />
*[[RU/Vehicle variants|Варианты транспорта]]<br />
*[[RU/Vehicle component manipulation|Манипуляция компонентов транспорта]]<br />
*[[RU/Weapons|Оружие]]<br />
*[[RU/Weather|Погода]]<br />
</div><br />
<div style="padding:4px 8px 8px 8px; margin:10px;"><br />
[[File:Osi symbol.png|75px|link=https://opensource.org/|left]]<br />
'''Multi Theft Auto''' имеет '''открытый исходный код'''. <br />
<br/>Это значит, что каждый может помочь сделать Multi Theft Auto еще лучше!<br />
</div><br />
|-<br />
| colspan="2" |<br />
|}<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<div style="padding-left: 15px; padding-right: 15px;" class="plainlinks"><br />
[[File:MTALogo_8ball.png|left|85px|link=Archive]]<br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''О [[Multi Theft Auto]]'''</li><br />
<li>[[RU/Archive|Архив]]</li><br />
<li>[[RU/Press Coverage|В прессе]]</li><br />
<li>[https://github.com/multitheftauto/mtasa-blue/graphs/contributors Разработчики]</li><br />
</ul><br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''Multi Theft Auto 0.5'''</li><br />
<li>[[Archive#Multi_Theft_Auto_0.5|Скачать]]</li><br />
<li>[[MTA 0.5r2 Known Issues|Известные проблемы]]</li><br />
</ul><br />
<ul style="list-style: none; width: 200px; float: left;"><br />
<li>'''Статистика вики'''</li><br />
<li>Статей: {{NUMBEROFARTICLES}}</li><br />
<li>Страниц: {{NUMBEROFPAGES}}</li><br />
<li>Зарегистрированных пользователей: {{NUMBEROFUSERS}}</li><br />
</ul><br />
</div><br />
|}<br />
<br />
__NOTOC__<br />
__NOEDITSECTION__<br />
[[ar:Main Page]]<br />
[[cs:hlavni]]<br />
[[sk:Main Page]]<br />
[[de:Hauptseite]]<br />
[[en:Main Page]]<br />
[[es:Página Principal]]<br />
[[fr:Main Page]]<br />
[[hu:Main Page]]<br />
[[it:Pagina principale]]<br />
[[nl:Main Page]]<br />
[[pl:Strona_Główna]]<br />
[[pt-br:Página Inicial]]<br />
[[tr:Anasayfa]]<br />
[[zh-cn:Main Page]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Script_security&diff=82698RU/Script security2026-01-08T19:13:07Z<p>Flox: Created page with "==Внимание к клиентской памяти == Начнем с самых основ: * Вы должны знать, что все, что вы храните на стороне клиента, подвержено риску, в том числе и lua-файлы. Злоумышленники могут получить доступ к любым конфиденциальным (и/или) важным данным, которые хранятся ил..."</p>
<hr />
<div>==Внимание к клиентской памяти ==<br />
<br />
Начнем с самых основ:<br />
<br />
* Вы должны знать, что все, что вы храните на стороне клиента, подвержено риску, в том числе и lua-файлы. Злоумышленники могут получить доступ к любым конфиденциальным (и/или) важным данным, которые хранятся или передаются на стороне клиента (ПК игрока).<br />
* Для обеспечения безопасности конфиденциальных данных (и/или) логики Lua используйте серверную часть.<br />
* Обратите внимание, что скрипты, помеченные как '''shared''', также действуют как '''client code''', что означает, что к ним применимо все вышесказанное. Например, определение:<br />
<br />
<syntaxhighlight lang="xml"><br />
<script src="script.lua" type="shared"/> <!-- этот скрипт будет выполняться отдельно как на клиенте, так и на сервере --><br />
</syntaxhighlight><br />
<br />
Это то же самое, что делать:<br />
<br />
<syntaxhighlight lang="xml"><br />
<script src="script.lua" type="client"/> <!-- define it separately on client --><br />
<script src="script.lua" type="server"/> <!-- do the same, but on server --><br />
</syntaxhighlight><br />
<br />
==Дополнительный уровень защиты ==<br />
<br />
Чтобы ''немного усложнить'' задачу для тех, у кого плохие намерения по отношению к вашему серверу, вы можете использовать атрибут 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 Руководство по борьбе с читерством].<br />
<br />
<syntaxhighlight lang="xml"><br />
<script src="shared.lua" type="shared" cache="false"/> <!-- cache="false" означает, что этот Lua-файл не будет сохранен на ПК игрока --><br />
<script src="client.lua" type="client" cache="false"/> <!-- cache="false" означает, что этот Lua-файл не будет сохранен на ПК игрока --><br />
</syntaxhighlight><br />
<br />
* ''Для некоторых'' ''немного сложнее'', ''но не невозможно'', получить клиентский код, но при этом он отлично справляется с тем, что удерживает ''большинство'' пользователей от проверки ваших lua-файлов - тех, кто ищет возможные логические ошибки (баги) или отсутствующие / некорректные проверки на основе безопасности.<br />
* Может использоваться как для ''клиентских (client)'', так и для ''общих (shared)'' скриптов (не влияет на Lua на стороне сервера).<br />
* Не удаляет файлы Lua, которые были загружены ранее.<br />
<br />
==Обнаружение бэкдоров и читерских программ и борьба с ними==<br />
'''Для обеспечения минимального ущерба (или его отсутствия) от Lua-скриптов:'''<br />
* Поддерживайте свой сервер в актуальном состоянии, вы можете [https://nightly.multitheftauto.com/ загружать последние сборки сервера с сайта MTA:SA nightly.] Информацию о конкретных сборках можно [https://buildinfo.multitheftauto.com/ найти здесь.]<br />
* Поддерживайте свои ресурсы в актуальном состоянии, вы можете \ [https://github.com/multitheftauto/mtasa-resources загружать последние (по умолчанию) ресурсы из репозитория GitHub.] Они часто содержат последние исправления для системы безопасности, что может привести к тому, что ваш сервер будет защищен от атак или нет.<br />
* Убедитесь в правильной настройке [https://wiki.multitheftauto.com/wiki/Access%20Control%20List ACL (Список контроля доступа)], который будет блокировать использование ресурсами определенных потенциально опасных функций.<br />
* Нулевое доверие с предоставлением прав администратора для ресурсов (включая карты), поступающих из неизвестных источников.<br />
* Перед запуском любого ресурса, которому вы не доверяете, проанализируйте его:<br />
** [https://wiki.multitheftauto.com/wiki/Meta.xml meta.xml] на предмет возможных скрытых скриптов, скрывающихся под другими расширениями файлов.<br />
** Это исходный код, на предмет вредоносной логики.<br />
* Не запускайте и не продолжайте использовать скомпилированные ресурсы (скрипты), в легитимности которых вы не уверены.<br />
<br />
'''Чтобы обеспечить минимальный ущерб при подключении мошенника к вашему серверу:'''<br />
* При создании скриптов помните, что никогда не следует доверять данным, поступающим от клиента.<br />
* При проверке скриптов на предмет возможных дыр в системе безопасности. Обратите внимание на любые данные, поступающие от клиента, которым вы доверяете.<br />
* Могут быть отправлены любые данные, следовательно, серверные скрипты, которые взаимодействуют с клиентом, получая данные, отправленные игроками, должны проверить их перед дальнейшим использованием в последующих частях кода. В основном, это будет сделано либо с помощью [[setElementData]], либо с помощью [[triggerServerEvent]].<br />
* Вам не следует полагаться только на игрока [https://wiki.multitheftauto.com/wiki/Serial серийный номер ], когда речь заходит о выполнении важных операций (авторегистрация/действия администратора). '''Не гарантируется, что серийные номера будут уникальными или не поддающимися подделке'''. Вот почему вам следует "оставить это позади" системы учетных записей, как '''важный фактор аутентификации''' (например, '''логин и пароль''').<br />
* Логика на стороне сервера '''не может быть обойдена''' или '''изменена''' (если только сервер не взломан или если в коде есть ошибка, но это совсем другой сценарий) - "используйте это в своих интересах". В большинстве случаев вы сможете выполнить проверку безопасности без участия клиента.<br />
* Используя концепцию ""'“, все параметры, включая источник, могут быть подделаны, и им не следует доверять. Глобальной переменной client можно доверять.”""" - дает вам надежную гарантию того, что игрок, на которого вы ссылаетесь (через ""client"") ""на самом деле""тот, кто действительно вызвал событие"". Такой подход защитит вас от ситуаций, когда мошенник может вызывать и обрабатывать, например, события администратора (например, кикнуть/забанить игрока), передавая фактический администратор ("'2-й"' аргумент в "'[[triggerServerEvent]]"'), или запускать события для других целей. игроки (как будто это они их вызвали, но на самом деле это было принудительно сделано читером) - как следствие использования неправильной переменной. Чтобы убедиться, что вы полностью поняли это, взгляните на примеры ниже:<br />
<br />
<syntaxhighlight lang="lua"><br />
--[[<br />
НИКОГДА НЕ ДЕЛАЙТЕ ЭТОГО - ЭТО СОВЕРШЕННО НЕПРАВИЛЬНО И НЕБЕЗОПАСНО<br />
ПРОБЛЕМА: ИСПОЛЬЗУЯ "source" В hasObjectPermissionTo, ВЫ ОСТАВЛЯЕТЕ ДВЕРЬ ОТКРЫТОЙ ДЛЯ МОШЕННИКОВ<br />
]]<br />
<br />
function onServerWrongAdminEvent(playerToBan)<br />
if (not client) then -- "client" указывает на игрока, который инициировал событие, и должен использоваться в качестве меры безопасности (чтобы предотвратить подделку игрока).<br />
return false -- если эта переменная в данный момент не существует (по неизвестной причине, или это сервер инициировал это событие), остановите выполнение кода<br />
end<br />
<br />
local defaultPermission = false -- не разрешайте действие по умолчанию, смотрите (defaultPermission): https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo<br />
local canAdminBanPlayer = hasObjectPermissionTo(source, "function.banPlayer", defaultPermission) -- уязвимость кроется именно здесь...<br />
<br />
if (not canAdminBanPlayer) then -- если у игрока нет прав доступа<br />
return false -- не делайте этого<br />
end<br />
<br />
local validElement = isElement(playerToBan) -- проверяет, является ли аргумент, переданный от клиента, элементом<br />
<br />
if (not validElement) then -- it is not<br />
return false -- остановить обработку кода<br />
end<br />
<br />
local elementType = getElementType(playerToBan) -- это элемент, поэтому укажите его тип<br />
local playerType = (elementType == "player") -- убедитесь, что это игрок<br />
<br />
if (not playerType) then -- it's not a player<br />
return false - остановись здесь<br />
end<br />
<br />
-- banPlayer(...) -- do what needs to be done<br />
end<br />
addEvent("onServerWrongAdminEvent", true)<br />
addEventHandler("onServerWrongAdminEvent", root, onServerWrongAdminEvent)<br />
<br />
--[[<br />
onServerCorrectAdminEvent ПОЛНОСТЬЮ ЗАЩИЩЕН, КАК И ДОЛЖНО БЫТЬ<br />
ЗДЕСЬ НЕТ ПРОБЛЕМ: МЫ ИСПОЛЬЗОВАЛИ "клиент" В hasObjectPermissionTo, ЧТО ПОЗВОЛЯЕТ ЗАЩИТИТЬ ЕГО ОТ ПОДДЕЛКИ ИГРОКОМ, ВЫЗВАВШИМ СОБЫТИЕ<br />
]]<br />
<br />
function onServerCorrectAdminEvent(playerToBan)<br />
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)<br />
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<br />
end<br />
<br />
local defaultPermission = false -- do not allow action by default, see (defaultPermission): https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo<br />
local canAdminBanPlayer = hasObjectPermissionTo(client, "function.banPlayer", defaultPermission) -- is player allowed to do that?<br />
<br />
if (not canAdminBanPlayer) then -- if player doesn't have permissions<br />
return false -- don't do it<br />
end<br />
<br />
local validElement = isElement(playerToBan) -- check whether argument passed from client is an element<br />
<br />
if (not validElement) then -- it is not<br />
return false -- stop code processing<br />
end<br />
<br />
local elementType = getElementType(playerToBan) -- it's an element, so get it's type<br />
local playerType = (elementType == "player") -- make sure that it's a player<br />
<br />
if (not playerType) then -- it's not a player<br />
return false -- stop here<br />
end<br />
<br />
-- banPlayer(...) -- do what needs to be done<br />
end<br />
addEvent("onServerCorrectAdminEvent", true)<br />
addEventHandler("onServerCorrectAdminEvent", root, onServerCorrectAdminEvent)<br />
</syntaxhighlight><br />
<br />
==Защита данных setElementData==<br />
<br />
* Вам следует воздержаться от использования [[element data]] везде, его следует использовать только тогда, когда это действительно необходимо. Рекомендуется заменить его на [[triggerClientEvent]].<br />
* Если вы все еще настаиваете на его использовании, рекомендуется установить для '''4-го''' аргумента в [[setElementData]] значение '''false''' (отключив синхронизацию для этих определенных данных) и использовать режим подписчика - [[addElementDataSubscriber]], как по соображениям безопасности, так и по соображениям производительности, описанным в [https://wiki.multitheftauto.com/wiki/Script_security#Securing_triggerServerEvent разделе "события".]<br />
{{Важное примечание|Отключение синхронизации, однако, не обеспечивает полной защиты ключа данных. По умолчанию он по-прежнему уязвим, но в этом случае вы не оставляете его на виду. Использование [[getAllElementData]] или копание в оперативной памяти не выявит его, поскольку оно не будет синхронизировано с клиентом в первую очередь. Следовательно, его также необходимо добавить в античит.}}<br />
* Все параметры, включая '''source''', могут быть подделаны, и им не следует доверять.<br />
* Глобальной переменной '''client''' можно доверять.<br />
<br />
<br />
<br />
<section name="Server" class="server" show="true"><br />
Пример защиты данных базового элемента от обмана.<br />
<syntaxhighlight lang="lua"><br />
local function reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue) -- вспомогательная функция для логирования и отката изменений<br />
local logClient = inspect(clientElement) -- подробный вид игрока, который инициировал синхронизацию данных элемента<br />
local logSerial = getPlayerSerial(clientElement) or "N/A" -- серийник клиента, или "N/A", если по какой-то причине это невозможно<br />
local logSource = tostring(sourceElement) -- элемент, который получил данные<br />
local logOldValue = tostring(oldValue) -- старое значение<br />
local logNewValue = tostring(newValue) -- новое значение<br />
local logText = -- заполняем наш отчет данными<br />
"=======================================\n"..<br />
"Detected element data abnormality:\n"..<br />
"Client: "..logClient.."\n"..<br />
"Client serial: "..logSerial.."\n"..<br />
"Source: "..logSource.."\n"..<br />
"Data key: "..dataKey.."\n"..<br />
"Old data value: "..logOldValue.."\n"..<br />
"New data value: "..logNewValue.."\n"..<br />
"======================================="<br />
<br />
local logVisibleTo = root -- указываем, кто увидит этот лог в консоли, в данном случае каждый игрок, подключенный к серверу<br />
local hadData = (oldValue ~= nil) -- проверяем, был ли у элемента такой данные раньше<br />
<br />
if (hadData) then -- если у элемента ранее были такие данные<br />
setElementData(sourceElement, dataKey, oldValue, true) -- откатываем изменения, это вызовет событие onElementDataChange, но не пройдет (остановится) на первом условии - потому что сервер (не клиент) принудительно изменил данные<br />
else<br />
removeElementData(sourceElement, dataKey) -- полностью удаляем его<br />
end<br />
<br />
outputConsole(logText, logVisibleTo) -- выводим это в консоль<br />
<br />
return true -- все успешно<br />
end<br />
<br />
function onElementDataChangeBasicAC(dataKey, oldValue, newValue) -- сердце нашего античита, которое выполняет все магические меры безопасности<br />
if (not client) then -- проверяем, идут ли данные от клиента<br />
return false -- если нет, не идем дальше<br />
end<br />
<br />
local checkSpecialThing = (dataKey == "special_thing") -- сравниваем, совпадает ли dataKey с "special_thing"<br />
local checkFlagWaving = (dataKey == "flag_waving") -- сравниваем, совпадает ли dataKey с "flag_waving"<br />
<br />
if (checkSpecialThing) then -- если совпадает, проводим проверки безопасности<br />
local invalidElement = (client ~= source) -- проверяем, отличается ли исходный элемент от игрока, изменившего данные<br />
<br />
if (invalidElement) then -- если так и есть<br />
reportAndRevertDataChange(client, source, dataKey, oldValue, newValue) -- откатываем изменение данных, потому что "special_thing" может быть установлен только для самого игрока<br />
end<br />
end<br />
<br />
if (checkFlagWaving) then -- если совпадает, проводим проверки безопасности<br />
local playerVehicle = getPedOccupiedVehicle(client) -- получаем текущий транспорт игрока<br />
local invalidVehicle = (playerVehicle ~= source) -- проверяем, отличается ли исходный элемент от транспорта игрока<br />
<br />
if (invalidVehicle) then -- если так и есть<br />
reportAndRevertDataChange(client, source, dataKey, oldValue, newValue) -- откатываем изменение данных, потому что "flag_waving" может быть установлен только для собственного транспорта игрока<br />
end<br />
end<br />
end<br />
addEventHandler("onElementDataChange", root, onElementDataChangeBasicAC)<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="true"><br />
Пример расширенной защиты данных element от обмана.<br />
<syntaxhighlight lang="lua"><br />
--[[<br />
Для максимальной безопасности установите punishPlayerOnDetect, punishmentBan, allowOnlyProtectedKeys в true (как настроено по умолчанию)<br />
Если включен allowOnlyProtectedKeys, не забудьте добавить каждый ключ элемент данных на стороне клиента в таблицу protectedKeys - иначе возникнут ложные срабатывания<br />
<br />
Структура таблицы античита (handleDataChange) и её параметры:<br />
<br />
["keyName"] = { -- имя ключа, который будет защищен<br />
onlyForPlayerHimself = true, -- включение этого (true) гарантирует, что этот ключ данных элемента может быть установлен только игроком, который его синхронизировал (игнорирует onlyForOwnPlayerVeh и allowForElements), используйте false/nil для отключения<br />
onlyForOwnPlayerVeh = false, -- включение этого (true) гарантирует, что этот ключ данных элемента может быть установлен только на текущем транспорте игрока, который его синхронизировал (игнорирует allowForElements), используйте false/nil для отключения<br />
allowForElements = { -- ограничить этот ключ для определенных типов элементов, установите false/nil или оставьте пустым, чтобы не проверять это (полный список типов элементов: https://wiki.multitheftauto.com/wiki/GetElementsByType)<br />
["player"] = true,<br />
["ped"] = true,<br />
["vehicle"] = true,<br />
["object"] = true,<br />
},<br />
allowedDataTypes = { -- ограничить этот ключ для определенных типов значений, установите false/nil или оставьте пустым, чтобы не проверять это<br />
["string"] = true,<br />
["number"] = true,<br />
["table"] = true,<br />
["boolean"] = true,<br />
["nil"] = true,<br />
},<br />
allowedStringLength = {1, 32}, -- если значение является строкой, то её длина должна быть в пределах (мин-макс), установите false/nil, чтобы не проверять длину строки - учтите, что allowedDataTypes должен содержать ["string"] = true<br />
allowedTableLength = {1, 64}, -- если значение является таблицей, то её длина должна быть в пределах (мин-макс), установите false/nil, чтобы не проверять длину таблицы - учтите, что allowedDataTypes должен содержать ["table"] = true<br />
allowedNumberRange = {1, 128}, -- если значение является числом, то оно должно быть в пределах (мин-макс), установите false/nil, чтобы не проверять диапазон чисел - учтите, что allowedDataTypes должен содержать ["number"] = true<br />
}<br />
]]<br />
<br />
local punishPlayerOnDetect = true -- должен ли игрок быть наказан при обнаружении (убедитесь, что ресурс, запускающий этот код, имеет права администратора)<br />
local punishmentBan = true -- актуально только если punishPlayerOnDetect установлен в true; используйте true для бана или false для кика<br />
local punishmentReason = "Altering element data" -- актуально только если punishPlayerOnDetect установлен в true; причина, которая будет показана наказанному игроку<br />
local punishedBy = "Console" -- актуально только если punishPlayerOnDetect установлен в true; кто ответственен за наказание, также показывается наказанному игроку<br />
local banByIP = false -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; бан по IP в настоящее время не рекомендуется (...)<br />
local banByUsername = false -- имя пользователя сообщества - устаревшая вещь, поэтому установлено в false и должно оставаться таким<br />
local banBySerial = true -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; (...) если есть серийный номер игрока, который можно использовать вместо этого<br />
local banTime = 0 -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; время в секундах, 0 навсегда<br />
local allowOnlyProtectedKeys = true -- запрещать (удалять с помощью removeElementData) любые данные элементов, кроме тех, что указаны в таблице protectedKeys; на случай, если кто-то захочет завалить сервер мусорными ключами, которые будут храниться в памяти до перезапуска сервера или ручного удаления - setElementData(source, key, nil) не удалит их; необходимо использовать removeElementData<br />
local debugLevel = 4 -- этот уровень отладки позволяет скрыть префикс INFO: и использовать пользовательские цвета<br />
local debugR = 255 -- сообщение отладки - красный цвет<br />
local debugG = 127 -- сообщение отладки - зеленый цвет<br />
local debugB = 0 -- сообщение отладки - синий цвет<br />
local protectedKeys = {<br />
["vehicleNumber"] = { -- мы хотим, чтобы vehicleNumber устанавливался только на транспорте, с четкими числами в диапазоне 1-100<br />
allowForElements = {<br />
["vehicle"] = true,<br />
},<br />
allowedDataTypes = {<br />
["number"] = true,<br />
},<br />
allowedNumberRange = {1, 100},<br />
},<br />
["personalVehData"] = { -- мы хотим иметь возможность устанавливать personalVehData только на текущем транспорте, также это должна быть строка длиной от 1 до 24<br />
onlyForOwnPlayerVeh = true,<br />
allowedDataTypes = {<br />
["string"] = true,<br />
},<br />
allowedStringLength = {1, 24},<br />
},<br />
-- выполнять проверки безопасности для ключей, хранящихся в этой таблице, удобным способом<br />
}<br />
<br />
local function reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- вспомогательная функция для логирования и отката изменений<br />
local logClient = inspect(clientElement) -- подробный вид игрока, который инициировал синхронизацию данных элемента<br />
local logSerial = getPlayerSerial(clientElement) or "N/A" -- серийник клиента, или "N/A", если по какой-то причине это невозможно<br />
local logSource = inspect(sourceElement) -- подробный вид элемента, который получил данные<br />
local logOldValue = inspect(oldValue) -- подробный вид старого значения<br />
local logNewValue = inspect(newValue) -- подробный вид нового значения<br />
local logText = -- заполняем наш отчет данными<br />
"*\n"..<br />
"Detected element data abnormality:\n"..<br />
"Client: "..logClient.."\n"..<br />
"Client serial: "..logSerial.."\n"..<br />
"Source: "..logSource.."\n"..<br />
"Data key: "..dataKey.."\n"..<br />
"Old data value: "..logOldValue.."\n"..<br />
"New data value: "..logNewValue.."\n"..<br />
"Fail reason: "..failReason.."\n"..<br />
"*"<br />
<br />
outputDebugString(logText, debugLevel, debugR, debugG, debugB) -- выводим это в отладку<br />
<br />
if (forceRemove) then -- мы вообще не хотим, чтобы этот ключ данных элемента существовал<br />
removeElementData(sourceElement, dataKey) -- удаляем его<br />
<br />
return true -- возвращаем успех и останавливаемся здесь, дальнейшие проверки не нужны<br />
end<br />
<br />
setElementData(sourceElement, dataKey, oldValue, true) -- откатываем изменения, это вызовет событие onElementDataChange, но не пройдет (остановится) на первом условии - потому что сервер (не клиент) принудительно изменил данные<br />
<br />
return true -- возвращаем успех<br />
end<br />
<br />
local function handleDataChange(clientElement, sourceElement, dataKey, oldValue, newValue) -- сердце нашего античита, которое выполняет все магические меры безопасности, возвращает true, если не было изменений от клиента (на основе данных из protectedKeys), иначе false<br />
local protectedKey = protectedKeys[dataKey] -- проверяем, хранится ли измененный ключ в таблице protectedKeys<br />
<br />
if (not protectedKey) then -- если его нет<br />
<br />
if (allowOnlyProtectedKeys) then -- если мы не хотим мусорные ключи<br />
local failReason = "Key isn't present in protectedKeys" -- причина, показанная в отчете<br />
local forceRemove = true -- должен ли ключ быть полностью удален<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
<br />
return true -- этот ключ не защищен, пропускаем его<br />
end<br />
<br />
local onlyForPlayerHimself = protectedKey.onlyForPlayerHimself -- если у ключа есть блокировка "только для себя"<br />
local onlyForOwnPlayerVeh = protectedKey.onlyForOwnPlayerVeh -- если у ключа есть блокировка "свой транспорт"<br />
local allowForElements = protectedKey.allowForElements -- если у ключа есть проверка типа элемента<br />
local allowedDataTypes = protectedKey.allowedDataTypes -- если у ключа есть проверка разрешенного типа данных<br />
<br />
if (onlyForPlayerHimself) then -- если блокировка "только для себя" активна<br />
local matchingElement = (clientElement == sourceElement) -- проверяем, равен ли игрок, установивший данные, элементу, который получил данные<br />
<br />
if (not matchingElement) then -- если не совпадает<br />
local failReason = "Can only set on player himself" -- причина, показанная в отчете<br />
local forceRemove = false -- должен ли ключ быть полностью удален<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
<br />
if (onlyForOwnPlayerVeh) then -- если блокировка "свой транспорт" активна<br />
local playerVehicle = getPedOccupiedVehicle(clientElement) -- получить текущий транспорт игрока, который установил данные<br />
local matchingVehicle = (playerVehicle == sourceElement) -- проверяем, совпадает ли он с тем, который получил данные<br />
<br />
if (not matchingVehicle) then -- если не совпадает<br />
local failReason = "Can only set on player's own vehicle" -- причина, показанная в отчете<br />
local forceRemove = false -- должен ли ключ быть полностью удален<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
<br />
if (allowForElements) then -- проверяем, является ли оно одним из них<br />
local elementType = getElementType(sourceElement) -- получить тип элемента, данные которого изменились<br />
local matchingElementType = allowForElements[elementType] -- проверяем, разрешено ли это<br />
<br />
if (not matchingElementType) then -- это не совпадает<br />
local failReason = "Invalid element type" -- причина, показанная в отчете<br />
local forceRemove = false -- должен ли ключ быть полностью удален<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
<br />
if (allowedDataTypes) then -- если есть разрешенные типы данных<br />
local valueType = type(newValue) -- получить тип данных значения<br />
local matchingType = allowedDataTypes[valueType] -- проверяем, является ли оно одним из разрешенных<br />
<br />
if (not matchingType) then -- если нет, тогда<br />
local failReason = "Invalid data type" -- причина, показанная в отчете<br />
local forceRemove = false -- должен ли ключ быть полностью удален<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
<br />
local allowedStringLength = protectedKey.allowedStringLength -- если у ключа есть указанная проверка длины строки<br />
local dataString = (valueType == "string") -- убеждаемся, что это строка<br />
<br />
if (allowedStringLength and dataString) then -- если мы должны проверить длину строки<br />
local minLength = allowedStringLength[1] -- получить минимальную длину<br />
local maxLength = allowedStringLength[2] -- получить максимальную длину<br />
local stringLength = utf8.len(newValue) -- получить длину строки данных<br />
local matchingLength = (stringLength >= minLength) and (stringLength <= maxLength) -- сравниваем, подходит ли значение в промежуток<br />
<br />
if (not matchingLength) then -- если не подходит<br />
local failReason = "Invalid string length (must be between "..minLength.."-"..maxLength..")" -- причина, показанная в отчете<br />
local forceRemove = false -- должен ли ключ быть полностью удален<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
<br />
local allowedTableLength = protectedKey.allowedTableLength -- если у ключа есть проверка длины таблицы<br />
local dataTable = (valueType == "table") -- убеждаемся, что это таблица<br />
<br />
if (allowedTableLength and dataTable) then -- если мы должны проверить длину таблицы<br />
local minLength = allowedTableLength[1] -- получить минимальную длину<br />
local maxLength = allowedTableLength[2] -- получить максимальную длину<br />
local minLengthAchieved = false -- переменная, которая проверяет 'была ли достигнута минимальная длина'<br />
local maxLengthExceeded = false -- переменная, которая проверяет 'превысила ли длина разрешенный максимум'<br />
local tableLength = 0 -- сохранить начальную длину таблицы<br />
<br />
for _, _ in pairs(newValue) do -- проходим по всей таблице<br />
tableLength = (tableLength + 1) -- добавляем + 1 для каждой записи таблицы<br />
minLengthAchieved = (tableLength >= minLength) -- больше ли длина или по крайней мере такой минимум, который мы требуем<br />
maxLengthExceeded = (tableLength > maxLength) -- превысила ли таблица максимальную длину?<br />
<br />
if (maxLengthExceeded) then -- она больше, чем должна быть<br />
break -- прерываем цикл (из-за того, что условие выше выполнено, нет смысла считать дальше и тратить процессор на таблицу, которая потенциально может иметь огромное количество записей)<br />
end<br />
end<br />
<br />
local matchingLength = (minLengthAchieved and not maxLengthExceeded) -- проверяем, достигнута ли минимальная длина, и убеждаемся, что она не превышает максимальную<br />
<br />
if (not matchingLength) then -- эта таблица не соответствует требованиям<br />
local failReason = "Invalid table length (must be between "..minLength.."-"..maxLength..")" -- причина, показанная в отчете<br />
local forceRemove = false -- должен ли ключ быть полностью удален<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
<br />
local allowedNumberRange = protectedKey.allowedNumberRange -- если у ключа есть проверка разрешенного диапазона чисел<br />
local dataNumber = (valueType == "number") -- убеждаемся, что это число<br />
<br />
if (allowedNumberRange and dataNumber) then -- если мы должны проверить диапазон чисел<br />
local minRange = allowedNumberRange[1] -- получить минимальный диапазон чисел<br />
local maxRange = allowedNumberRange[2] -- получить максимальный диапазон чисел<br />
local matchingRange = (newValue >= minRange) and (newValue <= maxRange) -- сравниваем, подходит ли значение в промежуток<br />
<br />
if (not matchingRange) then -- если не подходит<br />
local failReason = "Invalid number range (must be between "..minRange.."-"..maxRange..")" -- причина, показанная в отчете<br />
local forceRemove = false -- должен ли ключ быть полностью удален<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
end<br />
<br />
return true -- проверки безопасности пройдены, с этим ключом данных всё в порядке<br />
end<br />
<br />
function onElementDataChangeAdvancedAC(dataKey, oldValue, newValue) -- это событие использует handleDataChange, код был разделен для лучшей читаемости<br />
if (not client) then -- проверяем, идут ли данные от клиента<br />
return false -- если нет, не продолжаем<br />
end<br />
<br />
local approvedChange = handleDataChange(client, source, dataKey, oldValue, newValue) -- запускаем наши проверки безопасности<br />
<br />
if (approvedChange) then -- всё круто и хорошо<br />
return false -- нам не нужны дальнейшие действия<br />
end<br />
<br />
if (not punishPlayerOnDetect) then -- мы не хотим наказывать игрока по какой-то причине<br />
return false -- так что останавливаемся здесь<br />
end<br />
<br />
if (punishmentBan) then -- если это бан<br />
banPlayer(client, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- удаляем его присутствие с сервера<br />
else -- иначе<br />
kickPlayer(client, punishedBy, punishmentReason) -- просто кикаем игрока с сервера<br />
end<br />
end<br />
addEventHandler("onElementDataChange", root, onElementDataChangeAdvancedAC)<br />
</syntaxhighlight><br />
</section><br />
<br />
==Защита triggerServerEvent==<br />
* Все параметры, включая "source", могут быть подделаны, и им не следует доверять.<br />
* Глобальной переменной "client" можно доверять.<br />
* "События" в стиле "Admin" должны подтверждать "права доступа" игрока (клиента) либо с помощью [https://wiki.multitheftauto.com/wiki/IsObjectInACLGroup isObjectInACLGroup], либо [https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo hasObjectPermissionTo].<br />
* Не используйте для своего пользовательского события то же имя, что и для событий собственного сервера MTA (которые по умолчанию не запускаются удаленно), например: "onPlayerLogin"; это откроет дверь для манипуляций мошенников.<br />
* Будьте в курсе, каким игрокам отправляется событие через [[triggerClientEvent]]. Как по соображениям безопасности, так и по соображениям производительности, события, подобные admin, должны приниматься только администраторами (чтобы предотвратить доступ к конфиденциальным данным), в то же время вы не должны отправлять каждое событие всем пользователям сервера (например, событие успешного входа в систему, которое скрывает панель входа для определенного игрока). [[triggerClientEvent]] позволяет вам указать получатель события в качестве первого (необязательного) аргумента. По умолчанию используется значение [[root]], что означает, что если вы его не укажете, оно будет отправлено всем, кто подключен к серверу, даже тем, кто все еще загружает серверный кэш (что приводит к "событию, инициированному сервером на стороне клиента, eventName, но событие не добавлено на стороне клиента"). Вы можете передать либо элемент игрока, либо таблицу с получателями:<br />
<br />
<syntaxhighlight lang="lua"><br />
local playersToReceiveEvent = {player1, player2, player3} -- каждый PlayerX является элементом игрока<br />
<br />
triggerClientEvent(playersToReceiveEvent, ...) -- не забудьте заполнить последнюю часть аргументов<br />
</syntaxhighlight><br />
<br />
----------<br />
<section name="Server" class="server" show="true"><br />
Пример функции защиты от мошенничества, разработанной для событий, используемых для проверки данных как для обычных, так и для административных событий, которые вызываются со стороны клиента.<br />
<syntaxhighlight lang="lua"><br />
--[[<br />
Для максимальной безопасности установите punishPlayerOnDetect, punishmentBan в true (как настроено по умолчанию)<br />
<br />
Структура таблицы античита (processServerEventData) и её параметры:<br />
<br />
checkACLGroup = { -- проверить, принадлежит ли игрок, вызвавший событие, хотя бы к одной из групп ниже, установите false/nil, чтобы не проверять это<br />
"Admin",<br />
},<br />
checkPermissions = { -- проверить, есть ли у игрока, вызвавшего событие, разрешение хотя бы на одно из нижеперечисленного, установите false/nil, чтобы не проверять это<br />
"function.kickPlayer",<br />
},<br />
checkEventData = {<br />
{<br />
debugData = "source", -- дополнительные данные для отчета, показанные в сообщении отладки<br />
eventData = source, -- данные, которые мы хотим проверить<br />
equalTo = client, -- сравнить, совпадают ли eventData и equalTo<br />
allowedElements = { -- ограничить eventData определенными типами элементов, установите false/nil или оставьте пустым, чтобы не проверять это (полный список типов элементов: https://wiki.multitheftauto.com/wiki/GetElementsByType)<br />
["player"] = true,<br />
["ped"] = true,<br />
["vehicle"] = true,<br />
["object"] = true,<br />
},<br />
allowedDataTypes = { -- ограничить eventData определенными типами значений, установите false/nil или оставьте пустым, чтобы не проверять это<br />
["string"] = true,<br />
["number"] = true,<br />
["table"] = true,<br />
["boolean"] = true,<br />
["nil"] = true,<br />
},<br />
allowedStringLength = {1, 32}, -- если eventData является строкой, то её длина должна быть в пределах (мин-макс), установите false/nil, чтобы не проверять длину строки - учтите, что allowedDataTypes должен содержать ["string"] = true<br />
allowedTableLength = {1, 64}, -- если eventData является таблицей, то её длина должна быть в пределах (мин-макс), установите false/nil, чтобы не проверять длину таблицы - учтите, что allowedDataTypes должен содержать ["table"] = true<br />
allowedNumberRange = {1, 128}, -- если eventData является числом, то оно должно быть в пределах (мин-макс), установите false/nil, чтобы не проверять диапазон чисел - учтите, что allowedDataTypes должен содержать ["number"] = true<br />
},<br />
},<br />
]]<br />
<br />
local punishPlayerOnDetect = true -- должен ли игрок быть наказан при обнаружении (убедитесь, что ресурс, запускающий этот код, имеет права администратора)<br />
local punishmentBan = true -- актуально только если punishPlayerOnDetect установлен в true; используйте true для бана или false для кика<br />
local punishmentReason = "Altering server event data" -- актуально только если punishPlayerOnDetect установлен в true; причина, которая будет показана наказанному игроку<br />
local punishedBy = "Console" -- актуально только если punishPlayerOnDetect установлен в true; кто ответственен за наказание, также показывается наказанному игроку<br />
local banByIP = false -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; бан по IP в настоящее время не рекомендуется (...)<br />
local banByUsername = false -- имя пользователя сообщества - устаревшая вещь, поэтому установлено в false и должно оставаться таким<br />
local banBySerial = true -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; (...) если есть серийный номер игрока, который можно использовать вместо этого<br />
local banTime = 0 -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; время в секундах, 0 навсегда<br />
local debugLevel = 4 -- этот уровень отладки позволяет скрыть префикс INFO: и использовать пользовательские цвета<br />
local debugR = 255 -- сообщение отладки - красный цвет<br />
local debugG = 127 -- сообщение отладки - зеленый цвет<br />
local debugB = 0 -- сообщение отладки - синий цвет<br />
<br />
function processServerEventData(clientElement, sourceElement, serverEvent, securityChecks) -- сердце нашего античита, которое выполняет все магические меры безопасности, возвращает true, если не было изменений от клиента (на основе данных из securityChecks), иначе false<br />
if (not securityChecks) then -- если мы не передали никаких проверок безопасности<br />
return true -- нечего проверять, даем коду идти дальше<br />
end<br />
<br />
if (not clientElement) then -- если переменная client недоступна по какой-то причине (хотя это не должно произойти)<br />
local failReason = "Client variable not present" -- причина, показанная в отчете<br />
local skipPunishment = true -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
<br />
local checkACLGroup = securityChecks.checkACLGroup -- если есть какие-либо группы ACL для проверки<br />
local checkPermissions = securityChecks.checkPermissions -- если есть какие-либо разрешения для проверки<br />
local checkEventData = securityChecks.checkEventData -- если есть какие-либо проверки данных<br />
<br />
if (checkACLGroup) then -- проверим группы ACL игрока<br />
local playerAccount = getPlayerAccount(clientElement) -- получить текущий аккаунт игрока<br />
local guestAccount = isGuestAccount(playerAccount) -- если аккаунт гость (это значит, что игрок не вошел в систему)<br />
<br />
if (guestAccount) then -- это так<br />
local failReason = "Can't retrieve player login - guest account" -- причина, показанная в отчете<br />
local skipPunishment = true -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
<br />
local accountName = getAccountName(playerAccount) -- получить имя текущего аккаунта игрока<br />
local aclString = "user."..accountName -- форматируем это для дальнейшего использования в функции isObjectInACLGroup<br />
<br />
for groupID = 1, #checkACLGroup do -- перебираем таблицу заданных групп<br />
local groupName = checkACLGroup[groupID] -- получить имя каждой группы<br />
local aclGroup = aclGetGroup(groupName) -- проверить, существует ли такая группа<br />
<br />
if (not aclGroup) then -- не существует<br />
local failReason = "ACL group '"..groupName.."' is missing" -- причина, показанная в отчете<br />
local skipPunishment = true -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
<br />
local playerInACLGroup = isObjectInACLGroup(aclString, aclGroup) -- проверить, принадлежит ли игрок к группе<br />
<br />
if (playerInACLGroup) then -- да, это так<br />
return true -- значит, успех<br />
end<br />
end<br />
<br />
local failReason = "Player doesn't belong to any given ACL group" -- причина, показанная в отчете<br />
local skipPunishment = true -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
<br />
if (checkPermissions) then -- проверить, есть ли у игрока хотя бы одно желаемое разрешение<br />
local allowedByDefault = false -- есть ли у него доступ по умолчанию<br />
<br />
for permissionID = 1, #checkPermissions do -- перебираем все разрешения<br />
local permissionName = checkPermissions[permissionID] -- получить имя разрешения<br />
local hasPermission = hasObjectPermissionTo(clientElement, permissionName, allowedByDefault) -- проверить, разрешено ли игроку выполнять определенное действие<br />
<br />
if (hasPermission) then -- если у игрока есть доступ<br />
return true -- одно доступно (и достаточно), сервер не станет проверять остальные (так как return также прерывает цикл)<br />
end<br />
end<br />
<br />
local failReason = "Not enough permissions" -- причина, показанная в отчете<br />
local skipPunishment = true -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
<br />
if (checkEventData) then -- если есть какие-то данные для проверки<br />
<br />
for dataID = 1, #checkEventData do -- перебираем каждые данные<br />
local dataToCheck = checkEventData[dataID] -- получить каждый набор данных<br />
local eventData = dataToCheck.eventData -- это то, что мы будем проверять<br />
local equalTo = dataToCheck.equalTo -- мы хотим сравнить, совпадают ли eventData и equalTo<br />
local allowedElements = dataToCheck.allowedElements -- проверить, является ли это элементом и принадлежит ли к определенным типам элементов<br />
local allowedDataTypes = dataToCheck.allowedDataTypes -- ограничиваем ли мы данные определенным типом?<br />
local debugData = dataToCheck.debugData -- дополнительные вспомогательные данные<br />
local debugText = debugData and " ("..debugData..")" or "" -- если оно присутствует, красиво форматируем<br />
<br />
if (equalTo) then -- проверка на равенство существует<br />
local matchingData = (eventData == equalTo) -- сравнить, равны ли эти два значения<br />
<br />
if (not matchingData) then -- они не равны<br />
local failReason = "Data isn't equal @ argument "..dataID..debugText -- причина, показанная в отчете<br />
local skipPunishment = false -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
<br />
if (allowedElements) then -- мы проверяем, является ли это элементом и принадлежит ли хотя бы одному из списка<br />
local validElement = isElement(eventData) -- проверить, является ли это фактическим элементом<br />
<br />
if (not validElement) then -- это не так<br />
local failReason = "Data isn't element @ argument "..dataID..debugText -- причина, показанная в отчете<br />
local skipPunishment = false -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
<br />
local elementType = getElementType(eventData) -- это элемент, поэтому мы хотим узнать его тип<br />
local matchingElementType = allowedElements[elementType] -- проверить, разрешено ли это<br />
<br />
if (not matchingElementType) then -- не разрешено<br />
local failReason = "Invalid element type @ argument "..dataID..debugText -- причина, показанная в отчете<br />
local skipPunishment = false -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
<br />
if (allowedDataTypes) then -- проверим разрешенные типы данных<br />
local dataType = type(eventData) -- получить тип данных<br />
local matchingType = allowedDataTypes[dataType] -- проверить, разрешено ли это<br />
<br />
if (not matchingType) then -- не разрешено<br />
local failReason = "Invalid data type @ argument "..dataID..debugText -- причина, показанная в отчете<br />
local skipPunishment = false -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
<br />
local allowedStringLength = dataToCheck.allowedStringLength -- если данные имеют проверку длины строки<br />
local dataString = (dataType == "string") -- убеждаемся, что это строка<br />
<br />
if (allowedStringLength and dataString) then -- если мы должны проверить длину строки<br />
local minLength = allowedStringLength[1] -- получить минимальную длину<br />
local maxLength = allowedStringLength[2] -- получить максимальную длину<br />
local stringLength = utf8.len(eventData) -- получить длину строки данных<br />
local matchingLength = (stringLength >= minLength) and (stringLength <= maxLength) -- сравниваем, подходит ли значение в промежуток<br />
<br />
if (not matchingLength) then -- если не подходит<br />
local failReason = "Invalid string length (must be between "..minLength.."-"..maxLength..") @ argument "..dataID..debugText -- причина, показанная в отчете<br />
local skipPunishment = false -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
<br />
local allowedTableLength = dataToCheck.allowedTableLength -- если данные имеют проверку длины таблицы<br />
local dataTable = (dataType == "table") -- убеждаемся, что это таблица<br />
<br />
if (allowedTableLength and dataTable) then -- если мы должны проверить длину таблицы<br />
local minLength = allowedTableLength[1] -- получить минимальную длину<br />
local maxLength = allowedTableLength[2] -- получить максимальную длину<br />
local minLengthAchieved = false -- переменная, которая проверяет 'была ли достигнута минимальная длина'<br />
local maxLengthExceeded = false -- переменная, которая проверяет 'превысила ли длина разрешенный максимум'<br />
local tableLength = 0 -- сохранить начальную длину таблицы<br />
<br />
for _, _ in pairs(eventData) do -- проходим по всей таблице<br />
tableLength = (tableLength + 1) -- добавляем + 1 для каждой записи таблицы<br />
minLengthAchieved = (tableLength >= minLength) -- больше ли длина или по крайней мере такой минимум, который мы требуем<br />
maxLengthExceeded = (tableLength > maxLength) -- превысила ли таблица максимальную длину?<br />
<br />
if (maxLengthExceeded) then -- она больше, чем должна быть<br />
break -- прерываем цикл (из-за того, что условие выше выполнено, нет смысла считать дальше и тратить процессор на таблицу, которая потенциально может иметь огромное количество записей)<br />
end<br />
end<br />
<br />
local matchingLength = (minLengthAchieved and not maxLengthExceeded) -- проверяем, достигнута ли минимальная длина, и убеждаемся, что она не превышает максимальную<br />
<br />
if (not matchingLength) then -- эта таблица не соответствует требованиям<br />
local failReason = "Invalid table length (must be between "..minLength.."-"..maxLength..") @ argument "..dataID..debugText -- причина, показанная в отчете<br />
local skipPunishment = false -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
<br />
local allowedNumberRange = dataToCheck.allowedNumberRange -- если данные имеют проверку диапазона чисел<br />
local dataNumber = (dataType == "number") -- убеждаемся, что это число<br />
<br />
if (allowedNumberRange and dataNumber) then -- если мы должны проверить диапазон чисел<br />
local minRange = allowedNumberRange[1] -- получить минимальный диапазон чисел<br />
local maxRange = allowedNumberRange[2] -- получить максимальный диапазон чисел<br />
local matchingRange = (eventData >= minRange) and (eventData <= maxRange) -- сравниваем, подходит ли значение в промежуток<br />
<br />
if (not matchingRange) then -- если не подходит<br />
local failReason = "Invalid number range (must be between "..minRange.."-"..maxRange..") @ argument "..dataID..debugText -- причина, показанная в отчете<br />
local skipPunishment = false -- должен ли сервер пропустить наказание<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- сообщить о происшествии и обработать (или нет) этого игрока<br />
<br />
return false -- вернуть неудачу<br />
end<br />
end<br />
end<br />
end<br />
end<br />
<br />
return true -- проверки безопасности пройдены, с этим вызовом события всё в порядке<br />
end<br />
<br />
function reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- вспомогательная функция для логирования и обработки инцидентов<br />
local logClient = inspect(clientElement) -- подробный вид игрока, вызвавшего событие<br />
local logSerial = getPlayerSerial(clientElement) or "N/A" -- серийник клиента, или "N/A", если по какой-то причине это невозможно<br />
local logSource = inspect(sourceElement) -- подробный вид исходного элемента<br />
local logText = -- заполняем наш отчет данными<br />
"*\n"..<br />
"Detected event abnormality:\n"..<br />
"Client: "..logClient.."\n"..<br />
"Client serial: "..logSerial.."\n"..<br />
"Source: "..logSource.."\n"..<br />
"Event: "..serverEvent.."\n"..<br />
"Reason: "..failReason.."\n"..<br />
"*"<br />
<br />
outputDebugString(logText, debugLevel, debugR, debugG, debugB) -- выводим это в отладку<br />
<br />
if (not punishPlayerOnDetect or skipPunishment) then -- мы не хотим наказывать игрока по какой-то причине<br />
return true -- останавливаемся здесь<br />
end<br />
<br />
if (punishmentBan) then -- если это бан<br />
banPlayer(clientElement, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- удаляем его присутствие с сервера<br />
else -- иначе<br />
kickPlayer(clientElement, punishedBy, punishmentReason) -- просто кикаем игрока с сервера<br />
end<br />
<br />
return true -- всё готово, сообщаем об успехе<br />
end<br />
<br />
function onServerEvent(clientData)<br />
--[[<br />
Предположим, что это серверское событие (функция) вызывается следующим образом:<br />
<br />
local dataToPass = 10<br />
<br />
triggerServerEvent("onServerEvent", localPlayer, dataToPass)<br />
]]<br />
<br />
local shouldProcessServerCode = processServerEventData(<br />
client, -- элемент клиента - ответственный за вызов события<br />
source, -- исходный элемент - переданный в triggerServerEvent (в качестве 2-го аргумента)<br />
eventName, -- имя события - в данном случае 'onServerEvent'<br />
{<br />
checkEventData = { -- мы хотим проверить всё, что приходит от клиента<br />
{<br />
eventData = source, -- первое на проверку, переменная source<br />
equalTo = client, -- мы хотим проверить, совпадает ли это с игроком, вызвавшим событие<br />
debugData = "source", -- вспомогательные данные, которые будут показаны в отчете отладки<br />
},<br />
{<br />
eventData = clientData, -- давайте проверим данные, которые клиент прислал нам<br />
allowedDataTypes = {<br />
["number"] = true, -- мы хотим, чтобы это было только число<br />
},<br />
allowedNumberRange = {1, 100}, -- в диапазоне от 1 до 100<br />
debugData = "clientData", -- если что-то пойдет не так, дадим серверу знать где (это появится в отчете отладки)<br />
},<br />
},<br />
}<br />
)<br />
<br />
if (not shouldProcessServerCode) then -- что-то не так, зеленого света для выполнения кода за этим пределом нет<br />
return false -- остановить выполнение кода<br />
end<br />
<br />
-- выполняем код как обычно<br />
end<br />
addEvent("onServerEvent", true)<br />
addEventHandler("onServerEvent", root, onServerEvent)<br />
<br />
function onServerAdminEvent(playerToBan)<br />
--[[<br />
Предположим, что это серверское событие администратора (функция) вызывается следующим образом:<br />
<br />
local playerToBan = getPlayerFromName("playerToBan")<br />
<br />
triggerServerEvent("onServerAdminEvent", localPlayer, playerToBan)<br />
]]<br />
<br />
local shouldProcessServerCode = processServerEventData(<br />
client, -- элемент клиента - ответственный за вызов события<br />
source, -- исходный элемент - переданный в triggerServerEvent (в качестве 2-го аргумента)<br />
eventName, -- имя события - в данном случае 'onServerAdminEvent'<br />
{<br />
checkACLGroup = { -- нам нужно проверить, принадлежит ли игрок, вызвавший событие, к группам ACL<br />
"Admin", -- в данном случае группа администраторов<br />
},<br />
checkEventData = { -- мы хотим проверить всё, что приходит от клиента<br />
{<br />
eventData = source, -- первое на проверку, переменная source<br />
equalTo = client, -- мы хотим проверить, совпадает ли это с игроком, вызвавшим событие<br />
debugData = "source", -- вспомогательные данные, которые будут показаны в отчете отладки<br />
},<br />
{<br />
eventData = playerToBan, -- давайте проверим данные, которые клиент прислал нам<br />
allowedDataTypes = {<br />
["player"] = true, -- мы хотим, чтобы это был игрок<br />
},<br />
debugData = "playerToBan", -- если что-то пойдет не так, дадим серверу знать где (это появится в отчете отладки)<br />
},<br />
},<br />
}<br />
)<br />
<br />
if (not shouldProcessServerCode) then -- что-то не так, зеленого света для выполнения кода за этим пределом нет<br />
return false -- остановить выполнение кода<br />
end<br />
<br />
-- выполняем код как обычно<br />
end<br />
addEvent("onServerAdminEvent", true)<br />
addEventHandler("onServerAdminEvent", root, onServerAdminEvent)<br />
</syntaxhighlight><br />
</section><br />
<br />
==Защита событий, относящихся только к серверу ==<br />
* Очень важно отключить удаленный запуск''' в [https://wiki.multitheftauto.com/wiki/AddEvent addEvent], чтобы предотвратить вызов событий, относящихся только к серверу, со стороны клиента.<br />
* '''События''' в стиле '''Admin''' должны подтверждать '''права доступа''' игрока, либо с помощью [https://wiki.multitheftauto.com/wiki/IsObjectInACLGroup isObjectInACLGroup], либо [https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo hasObjectPermissionTo].<br />
<br />
----------<br />
<section name="Server" class="server" show="true"><br />
В этом примере показано, как вы должны создавать события только на стороне сервера.<br />
<syntaxhighlight lang="lua"><br />
function onServerSideOnlyEvent()<br />
-- делаем какие-то вещи на стороне сервера<br />
end<br />
addEvent("onServerSideOnlyEvent", false) -- установите второй аргумент (allowRemoteTriger) в false, чтобы его нельзя было вызвать с клиента<br />
addEventHandler("onServerSideOnlyEvent", root, onServerSideOnlyEvent) -- связываем наше событие с функцией onServerSideOnlyEvent<br />
</syntaxhighlight><br />
</section><br />
<br />
==Защита снарядов и взрывных устройств ==<br />
Этот раздел (и '''код''' - '''работа продолжается''') - '''используйте на свой страх и риск'''.<br />
----------<br />
<section name="Server" class="server" show="false"><br />
Устройство для отслеживания боеприпасов к снарядам:<br />
<syntaxhighlight lang="lua"><br />
local playerProjectileAmmo = {} -- хранить здесь боезапас оружия игрока<br />
local playerWeaponsToTrack = { -- отслеживать боезапас для определенных типов оружия игрока, в основном тех, которые создают снаряды; [weaponID] = weaponSlot<br />
[16] = 8, -- grenade<br />
[17] = 8, -- teargas<br />
[18] = 8, -- molotov<br />
[35] = 7, -- rocket launcher<br />
[36] = 7, -- rocket launcher (heat-seeking)<br />
[39] = 8, -- satchel charge<br />
}<br />
<br />
local function updateProjectileAmmoForPlayer(playerElement)<br />
local validElement = isElement(playerElement)<br />
<br />
if (not validElement) then<br />
return false<br />
end<br />
<br />
local playerDead = isPedDead(playerElement)<br />
<br />
if (playerDead) then<br />
return false<br />
end<br />
<br />
for weaponID, weaponSlot in pairs(playerWeaponsToTrack) do<br />
local weaponInSlot = getPedWeapon(playerElement, weaponSlot)<br />
local weaponTotalAmmo = getPedTotalAmmo(playerElement, weaponSlot)<br />
local weaponHasAmmo = (weaponTotalAmmo > 0)<br />
local weaponMatching = (weaponInSlot == weaponID)<br />
local updateWeaponAmmo = (weaponMatching and weaponHasAmmo)<br />
<br />
if (updateWeaponAmmo) then<br />
local storedProjectileAmmo = playerProjectileAmmo[playerElement]<br />
local newWeaponAmmo = (updateWeaponAmmo and weaponTotalAmmo or nil)<br />
<br />
if (not storedProjectileAmmo) then<br />
playerProjectileAmmo[playerElement] = {}<br />
storedProjectileAmmo = playerProjectileAmmo[playerElement]<br />
end<br />
<br />
storedProjectileAmmo[weaponID] = newWeaponAmmo<br />
end<br />
end<br />
<br />
return true<br />
end<br />
<br />
function hasPlayerProjectileAmmo(playerElement, projectileWeapon)<br />
local validElement = isElement(playerElement)<br />
<br />
if (not validElement) then<br />
return false<br />
end<br />
<br />
local playerDead = isPedDead(playerElement)<br />
<br />
if (playerDead) then<br />
return false<br />
end<br />
<br />
local projectileData = playerProjectileAmmo[playerElement]<br />
local projectileAmmo = (projectileData and projectileData[projectileWeapon])<br />
<br />
return projectileAmmo<br />
end<br />
<br />
function decreasePlayerProjectileAmmo(playerElement, projectileWeapon)<br />
local validElement = isElement(playerElement)<br />
<br />
if (not validElement) then<br />
return false<br />
end<br />
<br />
local playerDead = isPedDead(playerElement)<br />
<br />
if (playerDead) then<br />
return false<br />
end<br />
<br />
local playerProjectileData = playerProjectileAmmo[playerElement]<br />
<br />
if (not playerProjectileData) then<br />
return false<br />
end<br />
<br />
local projectileWeaponAmmo = playerProjectileData[projectileWeapon]<br />
local tempProjectileAmmo = (projectileWeaponAmmo - 1)<br />
local newProjectileAmmo = (tempProjectileAmmo > 0 and tempProjectileAmmo or nil)<br />
<br />
playerProjectileData[projectileWeapon] = newProjectileAmmo<br />
<br />
return true<br />
end<br />
<br />
function onPlayerWeaponSwitchAntiCheat(previousWeaponID, currentWeaponID)<br />
setTimer(updateProjectileAmmoForPlayer, 50, 1, source)<br />
end<br />
addEventHandler("onPlayerWeaponSwitch", root, onPlayerWeaponSwitchAntiCheat)<br />
<br />
function onResourceStartAntiCheat()<br />
local playersTable = getElementsByType("player")<br />
<br />
for playerID = 1, #playersTable do<br />
local playerElement = playersTable[playerID]<br />
<br />
updateProjectileAmmoForPlayer(playerElement)<br />
end<br />
end<br />
addEventHandler("onResourceStart", resourceRoot, onResourceStartAntiCheat)<br />
<br />
function onPlayerWastedQuitAntiCheat()<br />
playerProjectileAmmo[source] = nil<br />
end<br />
addEventHandler("onPlayerWasted", root, onPlayerWastedQuitAntiCheat)<br />
addEventHandler("onPlayerQuit", root, onPlayerWastedQuitAntiCheat)<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="false"><br />
Манипулятор со снарядом:<br />
<syntaxhighlight lang="lua"><br />
local playerCreatedProjectiles = {} -- хранить количество легитимно созданных снарядов игрока; [playerElement] = {[projectileType] = activeProjectiles}<br />
local projectileTypes = {<br />
[16] = { -- Grenade<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 2,<br />
projectileAllowedWeapons = {<br />
[16] = true, -- grenade<br />
},<br />
},<br />
[17] = { -- Teargas<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 2,<br />
projectileAllowedWeapons = {<br />
[17] = true, -- teargas<br />
},<br />
},<br />
[18] = { -- Molotov<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 2,<br />
projectileAllowedWeapons = {<br />
[18] = true, -- molotov<br />
},<br />
},<br />
[19] = { -- Rocket<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 5,<br />
projectileMaxVelocity = 2,<br />
projectileAllowedWeapons = {<br />
[35] = true, -- rocket launcher<br />
},<br />
projectileAllowedVehicles = {<br />
[425] = true, -- hunter<br />
[520] = true, -- hydra<br />
},<br />
},<br />
[20] = { -- Rocket (heat-seeking)<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 5,<br />
projectileMaxVelocity = 2,<br />
projectileAllowedWeapons = {<br />
[36] = true, -- rocket launcher (heat-seeking)<br />
},<br />
projectileAllowedVehicles = {<br />
[520] = true, -- hydra<br />
},<br />
},<br />
[21] = { -- Airbomb<br />
projectileAllowed = true,<br />
projectileAllowedVehicles = {<br />
[520] = true, -- hydra<br />
},<br />
},<br />
[39] = { -- Satchel charge<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 2,<br />
projectileAllowedWeapons = {<br />
[39] = true, -- satchel charge<br />
},<br />
},<br />
[58] = { -- Hydra flare<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 5,<br />
projectileAllowedVehicles = {<br />
[520] = true, -- hydra<br />
},<br />
},<br />
}<br />
<br />
local reportAbnormality = true -- сообщать ли о нарушениях в скрипте отладки - по умолчанию<br />
local punishPlayerOnDetect = false -- должен ли игрок быть наказан при обнаружении; true - да, или false, чтобы ничего не делать (убедитесь, что ресурс, запускающий этот код, имеет права администратора)<br />
local punishmentBan = true -- актуально только если punishPlayerOnDetect установлен в true; используйте true для бана или false для кика<br />
local punishmentReason = "Projectile/explosion anti-cheat" -- актуально только если punishPlayerOnDetect установлен в true; причина, которая будет показана наказанному игроку<br />
local punishedBy = "Console" -- актуально только если punishPlayerOnDetect установлен в true; кто ответственен за наказание, также показывается наказанному игроку<br />
local banByIP = false -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; бан по IP в настоящее время не рекомендуется (...)<br />
local banByUsername = false -- имя пользователя сообщества - устаревшая вещь, поэтому установлено в false и должно оставаться таким<br />
local banBySerial = true -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; (...) если есть серийный номер игрока, который можно использовать вместо этого<br />
local banTime = 0 -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; время в секундах, 0 навсегда<br />
local debugMsgLevel = 4 -- этот уровень отладки позволяет скрыть префикс INFO: и использовать пользовательские цвета<br />
local debugMsgR = 255 -- сообщение отладки - красный цвет<br />
local debugMsgG = 127 -- сообщение отладки - зеленый цвет<br />
local debugMsgB = 0 -- сообщение отладки - синий цвет<br />
<br />
local function reportProjectileAbnormality(playerElement, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ, detectionCode)<br />
local projectileSyncer = inspect(playerElement)<br />
local projectilePosition = projectileX..", "..projectileY..", "..projectileZ<br />
local projectileZoneName = getZoneName(projectileX, projectileY, projectileZ, false)<br />
local projectileCityName = getZoneName(projectileX, projectileY, projectileZ, true)<br />
local projectileLog =<br />
"* Detected projectile abnormality - "..detectionCode.." *\n"..<br />
"Projectile syncer: "..projectileSyncer.."\n"..<br />
"Projectile type: "..projectileType.."\n"..<br />
"Projectile position: "..projectilePosition.. " ("..projectileZoneName..", "..projectileCityName..")\n"<br />
<br />
outputDebugString(projectileLog, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)<br />
<br />
return true<br />
end<br />
<br />
local function processProjectileChecks(playerElement, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)<br />
local projectileData = projectileTypes[projectileType]<br />
local projectileAllowed = projectileData.projectileAllowed<br />
<br />
if (not projectileAllowed) then<br />
return false, "Projectile not allowed"<br />
end<br />
<br />
local projectileAllowedWeapons = projectileData.projectileAllowedWeapons<br />
<br />
if (projectileAllowedWeapons) then<br />
local playerWeapon = getPedWeapon(playerElement)<br />
local allowedWeapon = projectileAllowedWeapons[playerWeapon]<br />
<br />
if (not allowedWeapon) then<br />
return false, "Player is not holding correct weapon"<br />
end<br />
<br />
local weaponAmmo = hasPlayerProjectileAmmo(playerElement, playerWeapon)<br />
local playerHasAmmo = (weaponAmmo > 0)<br />
<br />
if (not playerHasAmmo) then<br />
return false, "Player doesn't have ammo for weapon"<br />
end<br />
<br />
decreasePlayerProjectileAmmo(playerElement, playerWeapon)<br />
end<br />
<br />
local playerVehicle = getPedOccupiedVehicle(playerElement)<br />
<br />
if (playerVehicle) then<br />
local projectileAllowedVehicles = projectileData.projectileAllowedVehicles<br />
<br />
if (projectileAllowedVehicles) then<br />
local vehicleModel = getElementModel(playerVehicle)<br />
local allowedVehicle = projectileAllowedVehicles[vehicleModel]<br />
<br />
if (not allowedVehicle) then<br />
return false, "Player is not inside allowed vehicles"<br />
end<br />
<br />
local vehicleDriver = getVehicleController(playerVehicle)<br />
local playerDriver = (playerElement == vehicleDriver)<br />
<br />
if (not playerDriver) then<br />
return false, "Player is not vehicle driver"<br />
end<br />
<br />
return true<br />
end<br />
<br />
return false, "Player in vehicle"<br />
end<br />
<br />
local projectileMaxDistanceFromCreator = projectileData.projectileMaxDistanceFromCreator<br />
<br />
if (projectileMaxDistanceFromCreator) then<br />
local playerX, playerY, playerZ = getElementPosition(playerElement)<br />
local distanceToProjectile = getDistanceBetweenPoints3D(playerX, playerY, playerZ, projectileX, projectileY, projectileZ)<br />
local matchingProjectileDistance = (distanceToProjectile <= projectileMaxDistanceFromCreator)<br />
<br />
if (not matchingProjectileDistance) then<br />
return false, "Projectile distance mismatch"<br />
end<br />
end<br />
<br />
local projectileMaxVelocity = projectileData.projectileMaxVelocity<br />
<br />
if (projectileMaxVelocity) then<br />
local projectileVelocity = (projectileVX ^ 2 + projectileVY ^ 2 + projectileVZ ^ 2)<br />
local projectileSpeed = math.sqrt(projectileVelocity)<br />
local matchingProjectileVelocity = (projectileSpeed <= projectileMaxVelocity)<br />
<br />
if (not matchingProjectileVelocity) then<br />
return false, "Projectile velocity mismatch"<br />
end<br />
end<br />
<br />
return true<br />
end<br />
<br />
local function trackPlayerProjectile(playerElement, projectileID)<br />
local validElement = isElement(playerElement)<br />
<br />
if (not validElement) then<br />
return false<br />
end<br />
<br />
local playerProjectiles = playerCreatedProjectiles[playerElement]<br />
<br />
if (not playerProjectiles) then<br />
playerCreatedProjectiles[playerElement] = {}<br />
playerProjectiles = playerCreatedProjectiles[playerElement]<br />
end<br />
<br />
local projectilesByType = playerProjectiles[projectileID] or 0<br />
local newProjectilesCount = (projectilesByType + 1)<br />
<br />
playerProjectiles[projectileID] = newProjectilesCount<br />
<br />
return true<br />
end<br />
<br />
local function getProjectileDetectionOverwrittenBehavior(projectileType)<br />
local projectileData = projectileTypes[projectileType]<br />
<br />
if (not projectileData) then<br />
return reportAbnormality, punishPlayerOnDetect, punishmentBan<br />
end<br />
<br />
local projectileBehaviour = projectileData.projectileOverwriteBehaviour<br />
<br />
if (not projectileBehaviour) then<br />
return reportAbnormality, punishPlayerOnDetect, punishmentBan<br />
end<br />
<br />
local overwriteReport = projectileBehaviour.reportAbnormality<br />
local overwritePunish = projectileBehaviour.punishPlayerOnDetect<br />
local overwriteBan = projectileBehaviour.punishmentBan<br />
<br />
return overwriteReport, overwritePunish, overwriteBan<br />
end<br />
<br />
function decreasePlayerProjectiles(playerElement, projectileID)<br />
local validElement = isElement(playerElement)<br />
<br />
if (not validElement) then<br />
return false<br />
end<br />
<br />
local playerProjectiles = playerCreatedProjectiles[playerElement]<br />
<br />
if (not playerProjectiles) then<br />
return false, true<br />
end<br />
<br />
local projectilesByType = playerProjectiles[projectileID]<br />
<br />
if (not projectilesByType) then<br />
return false, true<br />
end<br />
<br />
local tempProjectilesCount = (projectilesByType - 1)<br />
local newProjectilesCount = (tempProjectilesCount > 0 and tempProjectilesCount or nil)<br />
<br />
playerProjectiles[projectileID] = newProjectilesCount<br />
<br />
return true<br />
end<br />
<br />
function onPlayerProjectileCreationAntiCheat(projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)<br />
local approvedProjectile, detectionCode = processProjectileChecks(source, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)<br />
<br />
if (approvedProjectile) then<br />
trackPlayerProjectile(source, projectileType)<br />
<br />
return true<br />
end<br />
<br />
local reportAbnormality, punishPlayerOnDetect, punishmentBan = getProjectileDetectionOverwrittenBehavior(projectileType)<br />
<br />
if (reportAbnormality) then<br />
reportProjectileAbnormality(source, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ, detectionCode)<br />
end<br />
<br />
cancelEvent()<br />
<br />
if (not punishPlayerOnDetect) then -- мы не хотим наказывать игрока по какой-то причине<br />
return false -- так что останавливаемся здесь<br />
end<br />
<br />
if (punishmentBan) then -- если это бан<br />
banPlayer(source, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- удаляем его присутствие с сервера<br />
else -- иначе<br />
kickPlayer(source, punishedBy, punishmentReason) -- просто кикаем игрока с сервера<br />
end<br />
end<br />
addEventHandler("onPlayerProjectileCreation", root, onPlayerProjectileCreationAntiCheat)<br />
<br />
function onPlayerQuitAntiCheat()<br />
playerCreatedProjectiles[source] = nil<br />
end<br />
addEventHandler("onPlayerQuit", root, onPlayerQuitAntiCheat)<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="false"><br />
Обработчик взрывов:<br />
<syntaxhighlight lang="lua"><br />
local rocketInstantExplosionDistanceThreshold = 1.55 -- дистанция, ниже которой будет создан только взрыв (а не снаряд ракеты, следовательно, не вызывается onPlayerProjectileCreation); не меняйте это<br />
local explosionTypes = { -- более конкретная информация о взрыве и разрешен ли он<br />
[0] = { -- Grenade<br />
explosionAllowed = true,<br />
explosionAllowedProjectiles = {<br />
[16] = true, -- grenade<br />
},<br />
},<br />
[1] = { -- Molotov<br />
explosionAllowed = true,<br />
explosionAllowedProjectiles = {<br />
[18] = true, -- molotov<br />
},<br />
},<br />
[2] = { -- Rocket<br />
explosionAllowed = true,<br />
explosionAllowedWeapons = {<br />
[35] = true, -- rocket launcher<br />
[36] = true, -- rocket launcher (heat-seeking)<br />
},<br />
explosionAllowedProjectiles = {<br />
[19] = true, -- rocket<br />
[20] = true, -- rocket (heat-seeking)<br />
},<br />
},<br />
[3] = { -- Rocket weak<br />
explosionAllowed = true,<br />
explosionAllowedProjectiles = {<br />
[19] = true, -- rocket<br />
[20] = true, -- rocket (heat-seeking)<br />
},<br />
},<br />
[4] = { -- Car<br />
explosionAllowed = true,<br />
},<br />
[5] = { -- Car quick<br />
explosionAllowed = true,<br />
},<br />
[6] = { -- Boat<br />
explosionAllowed = true,<br />
},<br />
[7] = { -- Heli<br />
explosionAllowed = true,<br />
},<br />
[8] = { -- Mine<br />
explosionAllowed = true,<br />
},<br />
[9] = { -- Object<br />
explosionAllowed = true,<br />
},<br />
[10] = { -- Tank grenade<br />
explosionAllowed = true,<br />
explosionMaxDistanceFromCreator = 80,<br />
explosionAllowedVehicles = {<br />
[432] = true,<br />
}<br />
},<br />
[11] = { -- Small<br />
explosionAllowed = true,<br />
},<br />
[12] = { -- Tiny<br />
explosionAllowed = true,<br />
},<br />
}<br />
<br />
local reportAbnormality = true -- сообщать ли о нарушениях в скрипте отладки - по умолчанию<br />
local punishPlayerOnDetect = false -- должен ли игрок быть наказан при обнаружении; true - да, или false, чтобы ничего не делать (убедитесь, что ресурс, запускающий этот код, имеет права администратора)<br />
local punishmentBan = true -- актуально только если punishPlayerOnDetect установлен в true; используйте true для бана или false для кика<br />
local punishmentReason = "Projectile/explosion anti-cheat" -- актуально только если punishPlayerOnDetect установлен в true; причина, которая будет показана наказанному игроку<br />
local punishedBy = "Console" -- актуально только если punishPlayerOnDetect установлен в true; кто ответственен за наказание, также показывается наказанному игроку<br />
local banByIP = false -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; бан по IP в настоящее время не рекомендуется (...)<br />
local banByUsername = false -- имя пользователя сообщества - устаревшая вещь, поэтому установлено в false и должно оставаться таким<br />
local banBySerial = true -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; (...) если есть серийный номер игрока, который можно использовать вместо этого<br />
local banTime = 0 -- актуально только если punishPlayerOnDetect и punishmentBan установлены в true; время в секундах, 0 навсегда<br />
local debugMsgLevel = 4 -- этот уровень отладки позволяет скрыть префикс INFO: и использовать пользовательские цвета<br />
local debugMsgR = 255 -- сообщение отладки - красный цвет<br />
local debugMsgG = 127 -- сообщение отладки - зеленый цвет<br />
local debugMsgB = 0 -- сообщение отладки - синий цвет<br />
<br />
local function reportExplosionAbnormality(playerElement, explosionType, explosionX, explosionY, explosionZ, detectionCode)<br />
local explosionSyncer = inspect(playerElement)<br />
local explosionType = explosionType<br />
local explosionPosition = explosionX..", "..explosionY..", "..explosionZ<br />
local explosionZoneName = getZoneName(explosionX, explosionY, explosionZ, false)<br />
local explosionCityName = getZoneName(explosionX, explosionY, explosionZ, true)<br />
local explosionLog =<br />
"* Detected explosion abnormality - "..detectionCode.." *\n"..<br />
"Explosion syncer: "..explosionSyncer.."\n"..<br />
"Explosion type: "..explosionType.."\n"..<br />
"Explosion position: "..explosionPosition.. " ("..explosionZoneName..", "..explosionCityName..")\n"<br />
<br />
outputDebugString(explosionLog, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)<br />
<br />
return true<br />
end<br />
<br />
local function processExplosionChecks(playerElement, explosionType, explosionX, explosionY, explosionZ)<br />
local explosionData = explosionTypes[explosionType]<br />
local explosionAllowed = explosionData.explosionAllowed<br />
<br />
if (not explosionAllowed) then<br />
return false, "Explosion type not allowed"<br />
end<br />
<br />
local rocketExplosion = (explosionType == 2)<br />
<br />
if (rocketExplosion) then<br />
local playerX, playerY, playerZ = getElementPosition(playerElement)<br />
local distanceToExplosion = getDistanceBetweenPoints3D(playerX, playerY, playerZ, explosionX, explosionY, explosionZ)<br />
local instantExplosion = (distanceToExplosion < rocketInstantExplosionDistanceThreshold)<br />
<br />
if (instantExplosion) then<br />
local explosionAllowedWeapons = explosionData.explosionAllowedWeapons<br />
local playerWeapon = getPedWeapon(playerElement)<br />
local allowedWeapon = explosionAllowedWeapons[playerWeapon]<br />
<br />
if (not allowedWeapon) then<br />
return false, "Player is not holding rocket launcher"<br />
end<br />
<br />
local weaponAmmo = hasPlayerProjectileAmmo(playerElement, playerWeapon)<br />
local playerHasAmmo = (weaponAmmo > 0)<br />
<br />
if (not playerHasAmmo) then<br />
return false, "Player doesn't have ammo for rocket launcher"<br />
end<br />
<br />
decreasePlayerProjectileAmmo(playerElement, playerWeapon)<br />
<br />
return true<br />
end<br />
end<br />
<br />
local explosionAllowedProjectiles = explosionData.explosionAllowedProjectiles<br />
<br />
if (explosionAllowedProjectiles) then<br />
<br />
for projectileID, _ in pairs(explosionAllowedProjectiles) do<br />
local atleastOneProjectile = decreasePlayerProjectiles(playerElement, projectileID)<br />
<br />
if (atleastOneProjectile) then<br />
return true<br />
end<br />
end<br />
<br />
return false, "Explosion created without respective projectile"<br />
end<br />
<br />
local explosionAllowedVehicles = explosionData.explosionAllowedVehicles<br />
<br />
if (explosionAllowedVehicles) then<br />
local playerVehicle = getPedOccupiedVehicle(playerElement)<br />
<br />
if (not playerVehicle) then<br />
return false, "Player is not in vehicle"<br />
end<br />
<br />
local vehicleModel = getElementModel(playerVehicle)<br />
local allowedVehicle = explosionAllowedVehicles[vehicleModel]<br />
<br />
if (not allowedVehicle) then<br />
return false, "Player is inside not allowed vehicles"<br />
end<br />
<br />
local vehicleDriver = getVehicleController(playerVehicle)<br />
local playerDriver = (playerElement == vehicleDriver)<br />
<br />
if (not playerDriver) then<br />
return false, "Player is not vehicle driver"<br />
end<br />
end<br />
<br />
local explosionMaxDistanceFromCreator = explosionData.explosionMaxDistanceFromCreator<br />
<br />
if (explosionMaxDistanceFromCreator) then<br />
local playerX, playerY, playerZ = getElementPosition(playerElement)<br />
local distanceToExplosion = getDistanceBetweenPoints3D(playerX, playerY, playerZ, explosionX, explosionY, explosionZ)<br />
local matchingExplosionDistance = (distanceToExplosion < explosionMaxDistanceFromCreator)<br />
<br />
if (not matchingExplosionDistance) then<br />
return false, "Explosion distance mismatch"<br />
end<br />
end<br />
<br />
return true<br />
end<br />
<br />
local function getExplosionDetectionOverwrittenBehavior(explosionType)<br />
local explosionData = explosionTypes[explosionType]<br />
<br />
if (not explosionData) then<br />
return reportAbnormality, punishPlayerOnDetect, punishmentBan<br />
end<br />
<br />
local explosionBehaviour = explosionData.explosionOverwriteBehaviour<br />
<br />
if (not explosionBehaviour) then<br />
return reportAbnormality, punishPlayerOnDetect, punishmentBan<br />
end<br />
<br />
local overwriteReport = explosionBehaviour.reportAbnormality<br />
local overwritePunish = explosionBehaviour.punishPlayerOnDetect<br />
local overwriteBan = explosionBehaviour.punishmentBan<br />
<br />
return overwriteReport, overwritePunish, overwriteBan<br />
end<br />
<br />
function onExplosionAntiCheat(explosionX, explosionY, explosionZ, explosionType)<br />
local serverSyncExplosion = (source == root)<br />
<br />
if (serverSyncExplosion) then<br />
return true<br />
end<br />
<br />
local approvedExplosion, detectionCode = processExplosionChecks(source, explosionType, explosionX, explosionY, explosionZ)<br />
<br />
if (approvedExplosion) then<br />
return true<br />
end<br />
<br />
local reportAbnormality, punishPlayerOnDetect, punishmentBan = getExplosionDetectionOverwrittenBehavior(explosionType)<br />
<br />
if (reportAbnormality) then<br />
reportExplosionAbnormality(source, explosionType, explosionX, explosionY, explosionZ, detectionCode)<br />
end<br />
<br />
cancelEvent()<br />
<br />
if (not punishPlayerOnDetect) then -- мы не хотим наказывать игрока по какой-то причине<br />
return false -- так что останавливаемся здесь<br />
end<br />
<br />
if (punishmentBan) then -- если это бан<br />
banPlayer(source, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- удаляем его присутствие с сервера<br />
else -- иначе<br />
kickPlayer(source, punishedBy, punishmentReason) -- просто кикаем игрока с сервера<br />
end<br />
end<br />
addEventHandler("onExplosion", root, onExplosionAntiCheat)<br />
</syntaxhighlight><br />
</section><br />
<br />
==Обработка незарегистрированных событий==<br />
Смотрите: [[onPlayerTriggerInvalidEvent]]<br />
<br />
==Обработка нежелательных событий==<br />
Смотрите: [[onPlayerTriggerEventThreshold]]<br />
<br />
__NOTOC__<br />
__NOEDITSECTION__<br />
[[ru:Script security]]<br />
[[en:Script security]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Script_security&diff=82697Script security2026-01-08T19:12:19Z<p>Flox: </p>
<hr />
<div>==Awareness of client memory==<br />
<br />
Starting from very basics:<br />
* You should be aware that everything you store on client-side is at risk, this includes .lua files as well. Any confidential (and/or) important data which is stored, or travels through client-side (player PC) could be accessed by malicious clients.<br />
* To keep sensitive data (and/or) Lua logic safe - use server-side.<br />
* Do note that scripts marked as '''shared''' act also as '''client code''', which means that everything above applies to them. For example defining:<br />
<br />
<syntaxhighlight lang="xml"><br />
<script src="script.lua" type="shared"/> <!-- this script will run separately both on client and server --><br />
</syntaxhighlight><br />
<br />
Is same as doing:<br />
<br />
<syntaxhighlight lang="xml"><br />
<script src="script.lua" type="client"/> <!-- define it separately on client --><br />
<script src="script.lua" type="server"/> <!-- do the same, but on server --><br />
</syntaxhighlight><br />
<br />
==Additional protection layer==<br />
<br />
In order to make things ''slightly harder*'' for those having bad intentions towards your server, you can make use of cache attribute (and/or [https://luac.mtasa.com/ Lua compile (also known as Luac) with extra obfuscation set to level '''3'''] - [https://wiki.multitheftauto.com/wiki/Lua_compilation_API API]) available in [https://wiki.multitheftauto.com/wiki/Meta.xml meta.xml], along with configuring MTA's built-in AC by toggling SD (Special detections), see: [https://wiki.multitheftauto.com/wiki/Anti-cheat_guide Anti-cheat guide].<br />
<br />
<syntaxhighlight lang="xml"><br />
<script src="shared.lua" type="shared" cache="false"/> <!-- cache="false" indicates that this Lua file won't be saved on player's PC --><br />
<script src="client.lua" type="client" cache="false"/> <!-- cache="false" indicates that this Lua file won't be saved on player's PC --><br />
</syntaxhighlight><br />
<br />
* ''Slightly harder'' '''but not impossible''' for some to obtain client code, yet does good job at keeping '''most''' people away from inspecting your .lua files - those looking for possible logic flaws (bugs) or missing/incorrect security based checks.<br />
* Can be used on both '''client''' and '''shared''' script type (has no effect on server-sided Lua).<br />
* It doesn't remove Lua files which were previously downloaded.<br />
<br />
==Detecting and dealing with backdoors and cheats==<br />
'''To ensure minimum (or no) damage resulting from Lua scripts:'''<br />
* Keep your server up-to-date, you can [https://nightly.multitheftauto.com/ download latest server builds from MTA:SA nightly site.] Information on specific builds can be [https://buildinfo.multitheftauto.com/ found here.]<br />
* Keep your resources up-to-date, you can [https://github.com/multitheftauto/mtasa-resources download latest (default) resources from GitHub repository.] Those often contain latest security fixes, which could mean difference between having your server resist from attack or not.<br />
* Make sure to properly configure [https://wiki.multitheftauto.com/wiki/Access%20Control%20List ACL (Access Control List)] - which will block resources from using certain, potentially dangerous functions.<br />
* Zero-trust with giving away admin rights for resources (including maps) coming from unknown sources.<br />
* Before running any resource you don't trust, analyze:<br />
** [https://wiki.multitheftauto.com/wiki/Meta.xml meta.xml] of it, for possible hidden scripts lurking beneath other file extensions.<br />
** It's source code, for malicious logic.<br />
* Do not run/keep using compiled resources (scripts) of which legitimacy you aren't sure.<br />
<br />
'''To ensure minimum damage when a cheater connects to your server:'''<br />
* When making scripts, remember to never trust data coming from a client.<br />
* While reviewing scripts for possible security holes. Look at any data coming from the client that is being trusted.<br />
* Any kind of data could be sent, hence server scripts which communicate with client by receiving data sent by players should validate it, before further use in latter parts of code. Mostly, it will be done either by [[setElementData]] or [[triggerServerEvent]].<br />
* You shouldn't rely only on player [https://wiki.multitheftauto.com/wiki/Serial serial], when it comes to processing crucial operations (auto-login/admin actions). '''Serials aren't guaranted to be unique or non-fakable'''. This is why you should '''put it behind''' account system, as '''important authentication factor''' (e.g: '''login & password''').<br />
* Server-side logic '''can not be bypassed''' or '''tampered''' with (unless server is breached or when there is a bug in code, but that's whole different scenario) - '''use it to your advantage'''. In majority of cases, you will be able to perform security validations with no participation of client-side.<br />
* Using concept of '''''“All parameters including source can be faked and should not be trusted. Global variable client can be trusted.”''''' - gives you reliable assurance that player to which you refer (via '''client''') '''is''' in fact, '''the one which really called event'''. This approach will protect you from situations where cheater can call & process for instance: admin events (e.g kick/ban player) by passing the actual admin ('''2nd''' argument in '''[[triggerServerEvent]]'''), or trigger events for other players (as if they were the ones who called them, but in reality it was forcefully done by cheater) - as a consequence of using wrong variable. To make sure you fully understood it, take a look at examples below:<br />
<br />
<syntaxhighlight lang="lua"><br />
--[[<br />
DON'T EVER DO THAT - THAT IS COMPLETELY WRONG AND INSECURE<br />
THE ISSUE: BY USING 'source' IN hasObjectPermissionTo YOU ARE LEAVING DOOR STRAIGHT OPEN FOR CHEATERS<br />
]]<br />
<br />
function onServerWrongAdminEvent(playerToBan)<br />
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)<br />
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<br />
end<br />
<br />
local defaultPermission = false -- do not allow action by default, see (defaultPermission): https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo<br />
local canAdminBanPlayer = hasObjectPermissionTo(source, "function.banPlayer", defaultPermission) -- the vulnerability lies here...<br />
<br />
if (not canAdminBanPlayer) then -- if player doesn't have permissions<br />
return false -- don't do it<br />
end<br />
<br />
local validElement = isElement(playerToBan) -- check whether argument passed from client is an element<br />
<br />
if (not validElement) then -- it is not<br />
return false -- stop code processing<br />
end<br />
<br />
local elementType = getElementType(playerToBan) -- it's an element, so get it's type<br />
local playerType = (elementType == "player") -- make sure that it's a player<br />
<br />
if (not playerType) then -- it's not a player<br />
return false -- stop here<br />
end<br />
<br />
-- banPlayer(...) -- do what needs to be done<br />
end<br />
addEvent("onServerWrongAdminEvent", true)<br />
addEventHandler("onServerWrongAdminEvent", root, onServerWrongAdminEvent)<br />
<br />
--[[<br />
onServerCorrectAdminEvent IS PERFECTLY SECURED, AS IT SHOULD BE<br />
NO ISSUE HERE: WE'VE USED 'client' IN hasObjectPermissionTo WHICH MAKES IT SAFE FROM FAKING PLAYER WHO CALLED EVENT<br />
]]<br />
<br />
function onServerCorrectAdminEvent(playerToBan)<br />
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)<br />
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<br />
end<br />
<br />
local defaultPermission = false -- do not allow action by default, see (defaultPermission): https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo<br />
local canAdminBanPlayer = hasObjectPermissionTo(client, "function.banPlayer", defaultPermission) -- is player allowed to do that?<br />
<br />
if (not canAdminBanPlayer) then -- if player doesn't have permissions<br />
return false -- don't do it<br />
end<br />
<br />
local validElement = isElement(playerToBan) -- check whether argument passed from client is an element<br />
<br />
if (not validElement) then -- it is not<br />
return false -- stop code processing<br />
end<br />
<br />
local elementType = getElementType(playerToBan) -- it's an element, so get it's type<br />
local playerType = (elementType == "player") -- make sure that it's a player<br />
<br />
if (not playerType) then -- it's not a player<br />
return false -- stop here<br />
end<br />
<br />
-- banPlayer(...) -- do what needs to be done<br />
end<br />
addEvent("onServerCorrectAdminEvent", true)<br />
addEventHandler("onServerCorrectAdminEvent", root, onServerCorrectAdminEvent)<br />
</syntaxhighlight><br />
<br />
==Securing setElementData==<br />
<br />
* You should refrain from using [[element data]] everywhere, it should be only used when really necessary. It is advised to replace it with [[triggerClientEvent]] instead.<br />
* If you still insist on using it, it is recommended to set '''4th''' argument in [[setElementData]] to '''false''' (disabling sync for this, certain data) and use subscriber mode - [[addElementDataSubscriber]], for both security & performance reasons described in [https://wiki.multitheftauto.com/wiki/Script_security#Securing_triggerServerEvent event section.]<br />
{{Important Note|Disabling sync however, doesn't fully protect data key. It would be still vulnerable by default, but in this case you are not leaving it in plain sight. Using [[getAllElementData]] or digging in RAM wouldn't expose it, since it won't be synced to client in first place. Therefore, it needs to be added to anti-cheat as well.}} <br />
* All parameters including '''source''' can be faked and should not be trusted.<br />
* Global variable '''client''' can be trusted.<br />
<br />
----------<br />
<section name="Server" class="server" show="true"><br />
Example of basic element data anti-cheat.<br />
<syntaxhighlight lang="lua"><br />
local function reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue) -- helper function to log and revert changes<br />
local logClient = inspect(clientElement) -- in-depth view of player which forced element data sync<br />
local logSerial = getPlayerSerial(clientElement) or "N/A" -- client serial, or "N/A" if not possible, for some reason<br />
local logSource = tostring(sourceElement) -- element which received data<br />
local logOldValue = tostring(oldValue) -- old value<br />
local logNewValue = tostring(newValue) -- new value<br />
local logText = -- fill our report with data<br />
"=======================================\n"..<br />
"Detected element data abnormality:\n"..<br />
"Client: "..logClient.."\n"..<br />
"Client serial: "..logSerial.."\n"..<br />
"Source: "..logSource.."\n"..<br />
"Data key: "..dataKey.."\n"..<br />
"Old data value: "..logOldValue.."\n"..<br />
"New data value: "..logNewValue.."\n"..<br />
"======================================="<br />
<br />
local logVisibleTo = root -- specify who will see this log in console, in this case each player connected to server<br />
local hadData = (oldValue ~= nil) -- check if element had such data before<br />
<br />
if (hadData) then -- if element had such data before<br />
setElementData(sourceElement, dataKey, oldValue, true) -- revert changes, it will call onElementDataChange event, but will fail (stop) on first condition - because server (not client) forced change<br />
else<br />
removeElementData(sourceElement, dataKey) -- remove it completely<br />
end<br />
<br />
outputConsole(logText, logVisibleTo) -- print it to console<br />
<br />
return true -- all success<br />
end<br />
<br />
function onElementDataChangeBasicAC(dataKey, oldValue, newValue) -- the heart of our anti-cheat, which does all the magic security measurements<br />
if (not client) then -- check if data is coming from client<br />
return false -- if it's not, do not go further<br />
end<br />
<br />
local checkSpecialThing = (dataKey == "special_thing") -- compare whether dataKey matches "special_thing"<br />
local checkFlagWaving = (dataKey == "flag_waving") -- compare whether dataKey matches "flag_waving"<br />
<br />
if (checkSpecialThing) then -- if it does, do our security checks<br />
local invalidElement = (client ~= source) -- verify whether source element is different from player which changed data<br />
<br />
if (invalidElement) then -- if it's so<br />
reportAndRevertDataChange(client, source, dataKey, oldValue, newValue) -- revert data change, because "special_thing" can only be set for player himself<br />
end<br />
end<br />
<br />
if (checkFlagWaving) then -- if it does, do our security checks<br />
local playerVehicle = getPedOccupiedVehicle(client) -- get player's current vehicle<br />
local invalidVehicle = (playerVehicle ~= source) -- verify whether source element is different from player's vehicle<br />
<br />
if (invalidVehicle) then -- if it's so<br />
reportAndRevertDataChange(client, source, dataKey, oldValue, newValue) -- revert data change, because "flag_waving" can only be set for player's own vehicle<br />
end<br />
end<br />
end<br />
addEventHandler("onElementDataChange", root, onElementDataChangeBasicAC)<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="true"><br />
Example of advanced element data anti-cheat.<br />
<syntaxhighlight lang="lua"><br />
--[[<br />
For maximum security set punishPlayerOnDetect, punishmentBan, allowOnlyProtectedKeys to true (as per default configuration)<br />
If allowOnlyProtectedKeys is enabled, do not forget to add every client-side element data key to protectedKeys table - otherwise you will face false-positives<br />
<br />
Anti-cheat (handleDataChange) table structure and it's options:<br />
<br />
["keyName"] = { -- name of key which would be protected<br />
onlyForPlayerHimself = true, -- enabling this (true) will make sure that this element data key can only be set on player who synced it (ignores onlyForOwnPlayerVeh and allowForElements), use false/nil to disable this<br />
onlyForOwnPlayerVeh = false, -- enabling this (true) will make sure that this element data key can only be set on player's current vehicle who synced it (ignores allowForElements), use false/nil to disable this<br />
allowForElements = { -- restrict this key for certain element type(s), set to false/nil or leave it empty to not check this (full list of element types: https://wiki.multitheftauto.com/wiki/GetElementsByType)<br />
["player"] = true,<br />
["ped"] = true,<br />
["vehicle"] = true,<br />
["object"] = true,<br />
},<br />
allowedDataTypes = { -- restrict this key for certain value type(s), set to false/nil or leave it empty to not check this<br />
["string"] = true,<br />
["number"] = true,<br />
["table"] = true,<br />
["boolean"] = true,<br />
["nil"] = true,<br />
},<br />
allowedStringLength = {1, 32}, -- if value is a string, then it's length must be in between (min-max), set it to false/nil to not check string length - do note that allowedDataTypes must contain ["string"] = true<br />
allowedTableLength = {1, 64}, -- if value is a table, then it's length must be in between (min-max), set it to false/nil to not check table length - do note that allowedDataTypes must contain ["table"] = true<br />
allowedNumberRange = {1, 128}, -- if value is a number, then it must be in between (min-max), set it to false/nil to not check number range - do note that allowedDataTypes must contain ["number"] = true<br />
}<br />
]]<br />
<br />
local punishPlayerOnDetect = true -- should player be punished upon detection (make sure that resource which runs this code has admin rights)<br />
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick<br />
local punishmentReason = "Altering element data" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player<br />
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player<br />
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)<br />
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that<br />
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead<br />
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent<br />
local allowOnlyProtectedKeys = true -- disallow (remove by using removeElementData) every element data besides those given in protectedKeys table; in case someone wanted to flood server with garbage keys, which would be kept in memory until server restart or manual remove - setElementData(source, key, nil) won't remove it; it has to be removeElementData<br />
local debugLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors<br />
local debugR = 255 -- debug message - red color<br />
local debugG = 127 -- debug message - green color<br />
local debugB = 0 -- debug message - blue color<br />
local protectedKeys = {<br />
["vehicleNumber"] = { -- we want vehicleNumber to be set only on vehicles, with stricte numbers in range of 1-100<br />
allowForElements = {<br />
["vehicle"] = true,<br />
},<br />
allowedDataTypes = {<br />
["number"] = true,<br />
},<br />
allowedNumberRange = {1, 100},<br />
},<br />
["personalVehData"] = { -- we want be able to set personalVehData only on current vehicle, also it should be a string with length between 1-24<br />
onlyForOwnPlayerVeh = true,<br />
allowedDataTypes = {<br />
["string"] = true,<br />
},<br />
allowedStringLength = {1, 24},<br />
},<br />
-- perform security checks on keys stored in this table, in a convenient way<br />
}<br />
<br />
local function reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- helper function to log and revert changes<br />
local logClient = inspect(clientElement) -- in-depth view of player which forced element data sync<br />
local logSerial = getPlayerSerial(clientElement) or "N/A" -- client serial, or "N/A" if not possible, for some reason<br />
local logSource = inspect(sourceElement) -- in-depth view of element which received data<br />
local logOldValue = inspect(oldValue) -- in-depth view of old value<br />
local logNewValue = inspect(newValue) -- in-depth view of new value<br />
local logText = -- fill our report with data<br />
"*\n"..<br />
"Detected element data abnormality:\n"..<br />
"Client: "..logClient.."\n"..<br />
"Client serial: "..logSerial.."\n"..<br />
"Source: "..logSource.."\n"..<br />
"Data key: "..dataKey.."\n"..<br />
"Old data value: "..logOldValue.."\n"..<br />
"New data value: "..logNewValue.."\n"..<br />
"Fail reason: "..failReason.."\n"..<br />
"*"<br />
<br />
outputDebugString(logText, debugLevel, debugR, debugG, debugB) -- print it to debug<br />
<br />
if (forceRemove) then -- we don't want this element data key to exist at all<br />
removeElementData(sourceElement, dataKey) -- remove it<br />
<br />
return true -- return success and stop here, we don't need further checks<br />
end<br />
<br />
setElementData(sourceElement, dataKey, oldValue, true) -- revert changes, it will call onElementDataChange event, but will fail (stop) on first condition - because server (not client) forced change<br />
<br />
return true -- return success<br />
end<br />
<br />
local function handleDataChange(clientElement, sourceElement, dataKey, oldValue, newValue) -- the heart of our anti-cheat, which does all the magic security measurements, returns true if there was no altering from client (based on data from protectedKeys), false otherwise<br />
local protectedKey = protectedKeys[dataKey] -- look up whether key changed is stored in protectedKeys table<br />
<br />
if (not protectedKey) then -- if it's not<br />
<br />
if (allowOnlyProtectedKeys) then -- if we don't want garbage keys<br />
local failReason = "Key isn't present in protectedKeys" -- reason shown in report<br />
local forceRemove = true -- should key be completely removed<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
<br />
return true -- this key isn't protected, let it through<br />
end<br />
<br />
local onlyForPlayerHimself = protectedKey.onlyForPlayerHimself -- if key has "self-set" lock<br />
local onlyForOwnPlayerVeh = protectedKey.onlyForOwnPlayerVeh -- if key has "self-vehicle" lock<br />
local allowForElements = protectedKey.allowForElements -- if key has element type check<br />
local allowedDataTypes = protectedKey.allowedDataTypes -- if key has allowed data type check<br />
<br />
if (onlyForPlayerHimself) then -- if "self-set" lock is active<br />
local matchingElement = (clientElement == sourceElement) -- verify whether player who set data is equal to element which received data<br />
<br />
if (not matchingElement) then -- if it's not matching<br />
local failReason = "Can only set on player himself" -- reason shown in report<br />
local forceRemove = false -- should key be completely removed<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
<br />
if (onlyForOwnPlayerVeh) then -- if "self-vehicle" lock is active<br />
local playerVehicle = getPedOccupiedVehicle(clientElement) -- get current vehicle of player which set data<br />
local matchingVehicle = (playerVehicle == sourceElement) -- check whether it matches the one which received data<br />
<br />
if (not matchingVehicle) then -- if it doesn't match<br />
local failReason = "Can only set on player's own vehicle" -- reason shown in report<br />
local forceRemove = false -- should key be completely removed<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
<br />
if (allowForElements) then -- check if it's one of them<br />
local elementType = getElementType(sourceElement) -- get type of element whose data changed<br />
local matchingElementType = allowForElements[elementType] -- verify whether it's allowed<br />
<br />
if (not matchingElementType) then -- this isn't matching<br />
local failReason = "Invalid element type" -- reason shown in report<br />
local forceRemove = false -- should key be completely removed<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
<br />
if (allowedDataTypes) then -- if there's allowed data types<br />
local valueType = type(newValue) -- get data type of value<br />
local matchingType = allowedDataTypes[valueType] -- check if it's one of allowed<br />
<br />
if (not matchingType) then -- if it's not then<br />
local failReason = "Invalid data type" -- reason shown in report<br />
local forceRemove = false -- should key be completely removed<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
<br />
local allowedStringLength = protectedKey.allowedStringLength -- if key has specified string length check<br />
local dataString = (valueType == "string") -- make sure it's a string<br />
<br />
if (allowedStringLength and dataString) then -- if we should check string length<br />
local minLength = allowedStringLength[1] -- retrieve min length<br />
local maxLength = allowedStringLength[2] -- retrieve max length<br />
local stringLength = utf8.len(newValue) -- get length of data string<br />
local matchingLength = (stringLength >= minLength) and (stringLength <= maxLength) -- compare whether value fits in between<br />
<br />
if (not matchingLength) then -- if it doesn't<br />
local failReason = "Invalid string length (must be between "..minLength.."-"..maxLength..")" -- reason shown in report<br />
local forceRemove = false -- should key be completely removed<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
<br />
local allowedTableLength = protectedKey.allowedTableLength -- if key has table length check<br />
local dataTable = (valueType == "table") -- make sure it's a table<br />
<br />
if (allowedTableLength and dataTable) then -- if we should check table length<br />
local minLength = allowedTableLength[1] -- retrieve min length<br />
local maxLength = allowedTableLength[2] -- retrieve max length<br />
local minLengthAchieved = false -- variable which checks 'does minimum length was achieved'<br />
local maxLengthExceeded = false -- variable which checks 'does length has exceeds more than allowed maximum'<br />
local tableLength = 0 -- store initial table length<br />
<br />
for _, _ in pairs(newValue) do -- loop through whole table<br />
tableLength = (tableLength + 1) -- add + 1 on each table entry<br />
minLengthAchieved = (tableLength >= minLength) -- is length bigger or at very minimum we require<br />
maxLengthExceeded = (tableLength > maxLength) -- does table exceeded more than max length?<br />
<br />
if (maxLengthExceeded) then -- it is bigger than it should be<br />
break -- break the loop (due of condition above being worthy, it makes no point to count further and waste CPU, on a table which potentially could have huge amount of entries)<br />
end<br />
end<br />
<br />
local matchingLength = (minLengthAchieved and not maxLengthExceeded) -- check if min length has been achieved, and make sure that it doesn't go beyond max length<br />
<br />
if (not matchingLength) then -- this table doesn't match requirements<br />
local failReason = "Invalid table length (must be between "..minLength.."-"..maxLength..")" -- reason shown in report<br />
local forceRemove = false -- should key be completely removed<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
<br />
local allowedNumberRange = protectedKey.allowedNumberRange -- if key has allowed number range check<br />
local dataNumber = (valueType == "number") -- make sure it's a number<br />
<br />
if (allowedNumberRange and dataNumber) then -- if we should check number range<br />
local minRange = allowedNumberRange[1] -- retrieve min number range<br />
local maxRange = allowedNumberRange[2] -- retrieve max number range<br />
local matchingRange = (newValue >= minRange) and (newValue <= maxRange) -- compare whether value fits in between<br />
<br />
if (not matchingRange) then -- if it doesn't<br />
local failReason = "Invalid number range (must be between "..minRange.."-"..maxRange..")" -- reason shown in report<br />
local forceRemove = false -- should key be completely removed<br />
<br />
reportAndRevertDataChange(clientElement, sourceElement, dataKey, oldValue, newValue, failReason, forceRemove) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
end<br />
<br />
return true -- security checks passed, we are all clear with this data key<br />
end<br />
<br />
function onElementDataChangeAdvancedAC(dataKey, oldValue, newValue) -- this event makes use of handleDataChange, the code was split for better readability<br />
if (not client) then -- check if data is coming from client<br />
return false -- if it's not, do not continue<br />
end<br />
<br />
local approvedChange = handleDataChange(client, source, dataKey, oldValue, newValue) -- run our security checks<br />
<br />
if (approvedChange) then -- it's all cool and good<br />
return false -- we don't need further action<br />
end<br />
<br />
if (not punishPlayerOnDetect) then -- we don't want to punish player for some reason<br />
return false -- so stop here<br />
end<br />
<br />
if (punishmentBan) then -- if it's ban<br />
banPlayer(client, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server<br />
else -- otherwise<br />
kickPlayer(client, punishedBy, punishmentReason) -- simply kick player out of server<br />
end<br />
end<br />
addEventHandler("onElementDataChange", root, onElementDataChangeAdvancedAC)<br />
</syntaxhighlight><br />
</section><br />
<br />
==Securing triggerServerEvent==<br />
<br />
* All parameters including '''source''' can be faked and should not be trusted.<br />
* Global variable '''client''' can be trusted.<br />
* '''Admin''' styled '''events''' should be verifying player (client) '''ACL rights''', either by [https://wiki.multitheftauto.com/wiki/IsObjectInACLGroup isObjectInACLGroup] or [https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo hasObjectPermissionTo].<br />
* Do '''not''' use the same name for your custom event as MTA native server events (which aren't remotely triggerable by default), e.g: '''onPlayerLogin'''; doing so would open door for cheaters manipulations.<br />
* Be aware to which players event is sent via [[triggerClientEvent]]. For both security & performance reasons, admin like events should be received by admins only (to prevent confidential data being accessed), in the same time you shouldn't send each event to everyone on server (e.g: login success event which hides login panel for certain player). [[triggerClientEvent]] allows you to specify the event receiver as first (optional) argument. It defaults to [[root]], meaning if you don't specify it, it will be sent to everyone connected to server - even those who are still downloading server cache (which results in ''Server triggered clientside event eventName, but event is not added clientside.''). You can either pass player element or table with receivers:<br />
<syntaxhighlight lang="lua"><br />
local playersToReceiveEvent = {player1, player2, player3} -- each playerX is player element<br />
<br />
triggerClientEvent(playersToReceiveEvent, ...) -- do not forget to fill the latter part of arguments<br />
</syntaxhighlight><br />
<br />
----------<br />
<section name="Server" class="server" show="true"><br />
Example of anti-cheat function designed for events, used for data validation for both normal, and admin events which are called from client-side.<br />
<syntaxhighlight lang="lua"><br />
--[[<br />
For maximum security set punishPlayerOnDetect, punishmentBan to true (as per default configuration)<br />
<br />
Anti-cheat (processServerEventData) table structure and it's options:<br />
<br />
checkACLGroup = { -- check whether player who called event belongs to at least one group below, set to false/nil to not check this<br />
"Admin",<br />
},<br />
checkPermissions = { -- check whether player who called event has permission to at least one thing below, set to false/nil to not check this<br />
"function.kickPlayer",<br />
},<br />
checkEventData = {<br />
{<br />
debugData = "source", -- optional details for report shown in debug message<br />
eventData = source, -- data we want to verify<br />
equalTo = client, -- compare whether eventData == equalTo<br />
allowedElements = { -- restrict eventData to be certain element type(s), set to false/nil or leave it empty to not check this (full list of element types: https://wiki.multitheftauto.com/wiki/GetElementsByType)<br />
["player"] = true,<br />
["ped"] = true,<br />
["vehicle"] = true,<br />
["object"] = true,<br />
},<br />
allowedDataTypes = { -- restrict eventData to be certain value type(s), set to false/nil or leave it empty to not check this<br />
["string"] = true,<br />
["number"] = true,<br />
["table"] = true,<br />
["boolean"] = true,<br />
["nil"] = true,<br />
},<br />
allowedStringLength = {1, 32}, -- if eventData is a string, then it's length must be in between (min-max), set it to false/nil to not check string length - do note that allowedDataTypes must contain ["string"] = true<br />
allowedTableLength = {1, 64}, -- if eventData is a table, then it's length must be in between (min-max), set it to false/nil to not check table length - do note that allowedDataTypes must contain ["table"] = true<br />
allowedNumberRange = {1, 128}, -- if eventData is a number, then it must be in between (min-max), set it to false/nil to not check number range - do note that allowedDataTypes must contain ["number"] = true<br />
},<br />
},<br />
]]<br />
<br />
local punishPlayerOnDetect = true -- should player be punished upon detection (make sure that resource which runs this code has admin rights)<br />
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick<br />
local punishmentReason = "Altering server event data" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player<br />
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player<br />
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)<br />
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that<br />
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead<br />
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent<br />
local debugLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors<br />
local debugR = 255 -- debug message - red color<br />
local debugG = 127 -- debug message - green color<br />
local debugB = 0 -- debug message - blue color<br />
<br />
function processServerEventData(clientElement, sourceElement, serverEvent, securityChecks) -- the heart of our anti-cheat, which does all the magic security measurements, returns true if there was no altering from client (based on data from securityChecks), false otherwise<br />
if (not securityChecks) then -- if we haven't passed any security checks<br />
return true -- nothing to check, let code go further<br />
end<br />
<br />
if (not clientElement) then -- if client variable isn't available for some reason (although it should never happen)<br />
local failReason = "Client variable not present" -- reason shown in report<br />
local skipPunishment = true -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
<br />
local checkACLGroup = securityChecks.checkACLGroup -- if there's any ACL groups to check<br />
local checkPermissions = securityChecks.checkPermissions -- if there's any permissions to check<br />
local checkEventData = securityChecks.checkEventData -- if there's any data checks<br />
<br />
if (checkACLGroup) then -- let's check player ACL groups<br />
local playerAccount = getPlayerAccount(clientElement) -- get current account of player<br />
local guestAccount = isGuestAccount(playerAccount) -- if account is guest (meaning player is not logged in)<br />
<br />
if (guestAccount) then -- it's the case<br />
local failReason = "Can't retrieve player login - guest account" -- reason shown in report<br />
local skipPunishment = true -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
<br />
local accountName = getAccountName(playerAccount) -- get name of player's current account<br />
local aclString = "user."..accountName -- format it for further use in isObjectInACLGroup function<br />
<br />
for groupID = 1, #checkACLGroup do -- iterate over table of given groups<br />
local groupName = checkACLGroup[groupID] -- get each group name<br />
local aclGroup = aclGetGroup(groupName) -- check if such group exists<br />
<br />
if (not aclGroup) then -- it doesn't<br />
local failReason = "ACL group '"..groupName.."' is missing" -- reason shown in report<br />
local skipPunishment = true -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
<br />
local playerInACLGroup = isObjectInACLGroup(aclString, aclGroup) -- check if player belong to the group<br />
<br />
if (playerInACLGroup) then -- yep, it's the case<br />
return true -- so it's a success<br />
end<br />
end<br />
<br />
local failReason = "Player doesn't belong to any given ACL group" -- reason shown in report<br />
local skipPunishment = true -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
<br />
if (checkPermissions) then -- check if player has at least one desired permission<br />
local allowedByDefault = false -- does he have access by default<br />
<br />
for permissionID = 1, #checkPermissions do -- iterate over all permissions<br />
local permissionName = checkPermissions[permissionID] -- get permission name<br />
local hasPermission = hasObjectPermissionTo(clientElement, permissionName, allowedByDefault) -- check whether player is allowed to perform certain action<br />
<br />
if (hasPermission) then -- if player has access<br />
return true -- one is available (and enough), server won't bother to check others (as return keywords also breaks loop)<br />
end<br />
end<br />
<br />
local failReason = "Not enough permissions" -- reason shown in report<br />
local skipPunishment = true -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
<br />
if (checkEventData) then -- if there is some data to verify<br />
<br />
for dataID = 1, #checkEventData do -- iterate over each of data<br />
local dataToCheck = checkEventData[dataID] -- get each data set<br />
local eventData = dataToCheck.eventData -- this is the one we'll be verifying<br />
local equalTo = dataToCheck.equalTo -- we want to compare whether eventData == equalTo<br />
local allowedElements = dataToCheck.allowedElements -- check whether is element, and whether belongs to certain element types<br />
local allowedDataTypes = dataToCheck.allowedDataTypes -- do we restrict data to be certain type?<br />
local debugData = dataToCheck.debugData -- additional helper data<br />
local debugText = debugData and " ("..debugData..")" or "" -- if it's present, format it nicely<br />
<br />
if (equalTo) then -- equal check exists<br />
local matchingData = (eventData == equalTo) -- compare whether those two values are equal<br />
<br />
if (not matchingData) then -- they aren't<br />
local failReason = "Data isn't equal @ argument "..dataID..debugText -- reason shown in report<br />
local skipPunishment = false -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
<br />
if (allowedElements) then -- we do check whether is an element, and belongs to at least one given in the list<br />
local validElement = isElement(eventData) -- check if it's actual element<br />
<br />
if (not validElement) then -- it's not<br />
local failReason = "Data isn't element @ argument "..dataID..debugText -- reason shown in report<br />
local skipPunishment = false -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
<br />
local elementType = getElementType(eventData) -- it's element, so we want to know it's type<br />
local matchingElementType = allowedElements[elementType] -- verify whether it's allowed<br />
<br />
if (not matchingElementType) then -- it's not allowed<br />
local failReason = "Invalid element type @ argument "..dataID..debugText -- reason shown in report<br />
local skipPunishment = false -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
<br />
if (allowedDataTypes) then -- let's check allowed data types<br />
local dataType = type(eventData) -- get data type<br />
local matchingType = allowedDataTypes[dataType] -- verify whether it's allowed<br />
<br />
if (not matchingType) then -- it isn't<br />
local failReason = "Invalid data type @ argument "..dataID..debugText -- reason shown in report<br />
local skipPunishment = false -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
<br />
local allowedStringLength = dataToCheck.allowedStringLength -- if data has string length check<br />
local dataString = (dataType == "string") -- make sure it's a string<br />
<br />
if (allowedStringLength and dataString) then -- if we should check string length<br />
local minLength = allowedStringLength[1] -- retrieve min length<br />
local maxLength = allowedStringLength[2] -- retrieve max length<br />
local stringLength = utf8.len(eventData) -- get length of data string<br />
local matchingLength = (stringLength >= minLength) and (stringLength <= maxLength) -- compare whether value fits in between<br />
<br />
if (not matchingLength) then -- if it doesn't<br />
local failReason = "Invalid string length (must be between "..minLength.."-"..maxLength..") @ argument "..dataID..debugText -- reason shown in report<br />
local skipPunishment = false -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
<br />
local allowedTableLength = dataToCheck.allowedTableLength -- if data has table length check<br />
local dataTable = (dataType == "table") -- make sure it's a table<br />
<br />
if (allowedTableLength and dataTable) then -- if we should check table length<br />
local minLength = allowedTableLength[1] -- retrieve min length<br />
local maxLength = allowedTableLength[2] -- retrieve max length<br />
local minLengthAchieved = false -- variable which checks 'does minimum length was achieved'<br />
local maxLengthExceeded = false -- variable which checks 'does length has exceeds more than allowed maximum'<br />
local tableLength = 0 -- store initial table length<br />
<br />
for _, _ in pairs(eventData) do -- loop through whole table<br />
tableLength = (tableLength + 1) -- add + 1 on each table entry<br />
minLengthAchieved = (tableLength >= minLength) -- is length bigger or at very minimum we require<br />
maxLengthExceeded = (tableLength > maxLength) -- does table exceeded more than max length?<br />
<br />
if (maxLengthExceeded) then -- it is bigger than it should be<br />
break -- break the loop (due of condition above being worthy, it makes no point to count further and waste CPU, on a table which potentially could have huge amount of entries)<br />
end<br />
end<br />
<br />
local matchingLength = (minLengthAchieved and not maxLengthExceeded) -- check if min length has been achieved, and make sure that it doesn't go beyond max length<br />
<br />
if (not matchingLength) then -- this table doesn't match requirements<br />
local failReason = "Invalid table length (must be between "..minLength.."-"..maxLength..") @ argument "..dataID..debugText -- reason shown in report<br />
local skipPunishment = false -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
<br />
local allowedNumberRange = dataToCheck.allowedNumberRange -- if data has number range check<br />
local dataNumber = (dataType == "number") -- make sure it's a number<br />
<br />
if (allowedNumberRange and dataNumber) then -- if we should check number range<br />
local minRange = allowedNumberRange[1] -- retrieve min number range<br />
local maxRange = allowedNumberRange[2] -- retrieve max number range<br />
local matchingRange = (eventData >= minRange) and (eventData <= maxRange) -- compare whether value fits in between<br />
<br />
if (not matchingRange) then -- if it doesn't<br />
local failReason = "Invalid number range (must be between "..minRange.."-"..maxRange..") @ argument "..dataID..debugText -- reason shown in report<br />
local skipPunishment = false -- should server skip punishment<br />
<br />
reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- report accident, and handle (or not) this player<br />
<br />
return false -- return failure<br />
end<br />
end<br />
end<br />
end<br />
end<br />
<br />
return true -- security checks passed, we are all clear with this event call<br />
end<br />
<br />
function reportAndHandleEventAbnormality(clientElement, sourceElement, serverEvent, failReason, skipPunishment) -- helper function to log and handle accidents<br />
local logClient = inspect(clientElement) -- in-depth view player which called event<br />
local logSerial = getPlayerSerial(clientElement) or "N/A" -- client serial, or "N/A" if not possible, for some reason<br />
local logSource = inspect(sourceElement) -- in-depth view of source element<br />
local logText = -- fill our report with data<br />
"*\n"..<br />
"Detected event abnormality:\n"..<br />
"Client: "..logClient.."\n"..<br />
"Client serial: "..logSerial.."\n"..<br />
"Source: "..logSource.."\n"..<br />
"Event: "..serverEvent.."\n"..<br />
"Reason: "..failReason.."\n"..<br />
"*"<br />
<br />
outputDebugString(logText, debugLevel, debugR, debugG, debugB) -- print it to debug<br />
<br />
if (not punishPlayerOnDetect or skipPunishment) then -- we don't want to punish player for some reason<br />
return true -- stop here<br />
end<br />
<br />
if (punishmentBan) then -- if it's ban<br />
banPlayer(clientElement, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server<br />
else -- otherwise<br />
kickPlayer(clientElement, punishedBy, punishmentReason) -- simply kick player out of server<br />
end<br />
<br />
return true -- all done, report success<br />
end<br />
<br />
function onServerEvent(clientData)<br />
--[[<br />
Assume this server event (function) is called in such way:<br />
<br />
local dataToPass = 10<br />
<br />
triggerServerEvent("onServerEvent", localPlayer, dataToPass)<br />
]]<br />
<br />
local shouldProcessServerCode = processServerEventData(<br />
client, -- client element - responsible for calling event<br />
source, -- source element - passed in triggerServerEvent (as 2nd argument)<br />
eventName, -- name of event - in this case 'onServerEvent'<br />
{<br />
checkEventData = { -- we want to verify everything what comes from client<br />
{<br />
eventData = source, -- first to check, source variable<br />
equalTo = client, -- we want to check whether it matches player who called event<br />
debugData = "source", -- helper details which would be shown in report<br />
},<br />
{<br />
eventData = clientData, -- let's check the data which client sent to us<br />
allowedDataTypes = {<br />
["number"] = true, -- we want it to be only number<br />
},<br />
allowedNumberRange = {1, 100}, -- in range of 1 to 100<br />
debugData = "clientData", -- if something goes wrong, let server know where (it will appear in debug report)<br />
},<br />
},<br />
}<br />
)<br />
<br />
if (not shouldProcessServerCode) then -- something isn't right, no green light for processing code behind this scope<br />
return false -- stop code execution<br />
end<br />
<br />
-- do code as usual<br />
end<br />
addEvent("onServerEvent", true)<br />
addEventHandler("onServerEvent", root, onServerEvent)<br />
<br />
function onServerAdminEvent(playerToBan)<br />
--[[<br />
Assume this server admin event (function) is called in such way:<br />
<br />
local playerToBan = getPlayerFromName("playerToBan")<br />
<br />
triggerServerEvent("onServerAdminEvent", localPlayer, playerToBan)<br />
]]<br />
<br />
local shouldProcessServerCode = processServerEventData(<br />
client, -- client element - responsible for calling event<br />
source, -- source element - passed in triggerServerEvent (as 2nd argument)<br />
eventName, -- name of event - in this case 'onServerAdminEvent'<br />
{<br />
checkACLGroup = { -- we need to check whether player who called event belongs to ACL groups<br />
"Admin", -- in this case admin group<br />
},<br />
checkEventData = { -- we want to verify everything what comes from client<br />
{<br />
eventData = source, -- first to check, source variable<br />
equalTo = client, -- we want to check whether it matches player who called event<br />
debugData = "source", -- helper details which would be shown in report<br />
},<br />
{<br />
eventData = playerToBan, -- let's check the data which client sent to us<br />
allowedDataTypes = {<br />
["player"] = true, -- we want it to be player<br />
},<br />
debugData = "playerToBan", -- if something goes wrong, let server know where (it will appear in debug report)<br />
},<br />
},<br />
}<br />
)<br />
<br />
if (not shouldProcessServerCode) then -- something isn't right, no green light for processing code behind this scope<br />
return false -- stop code execution<br />
end<br />
<br />
-- do code as usual<br />
end<br />
addEvent("onServerAdminEvent", true)<br />
addEventHandler("onServerAdminEvent", root, onServerAdminEvent)<br />
</syntaxhighlight><br />
</section><br />
<br />
==Securing server-only events==<br />
* It is very important to '''disable remote triggering''' ability in [https://wiki.multitheftauto.com/wiki/AddEvent addEvent], to prevent calling server-side only events from client-side.<br />
* '''Admin''' styled '''events''' should be verifying player '''ACL rights''', either by [https://wiki.multitheftauto.com/wiki/IsObjectInACLGroup isObjectInACLGroup] or [https://wiki.multitheftauto.com/wiki/HasObjectPermissionTo hasObjectPermissionTo].<br />
<br />
----------<br />
<section name="Server" class="server" show="true"><br />
This example shows how you should make event server-side only.<br />
<syntaxhighlight lang="lua"><br />
function onServerSideOnlyEvent()<br />
-- do some server-side stuff<br />
end<br />
addEvent("onServerSideOnlyEvent", false) -- set second argument (allowRemoteTriger) to false, so it can't be called from client<br />
addEventHandler("onServerSideOnlyEvent", root, onServerSideOnlyEvent) -- associate our event with function onServerSideOnlyEvent<br />
</syntaxhighlight><br />
</section><br />
<br />
==Securing projectiles & explosions==<br />
This section (and '''code''' is '''work in progress''') - '''use at your own risk'''.<br />
<br />
----------<br />
<section name="Server" class="server" show="false"><br />
Projectile ammo tracker:<br />
<syntaxhighlight lang="lua"><br />
local playerProjectileAmmo = {} -- store player-held weapons ammo here<br />
local playerWeaponsToTrack = { -- keep track of ammo for certain player-held weapon types, basically those which create projectile; [weaponID] = weaponSlot<br />
[16] = 8, -- grenade<br />
[17] = 8, -- teargas<br />
[18] = 8, -- molotov<br />
[35] = 7, -- rocket launcher<br />
[36] = 7, -- rocket launcher (heat-seeking)<br />
[39] = 8, -- satchel charge<br />
}<br />
<br />
local function updateProjectileAmmoForPlayer(playerElement)<br />
local validElement = isElement(playerElement)<br />
<br />
if (not validElement) then<br />
return false<br />
end<br />
<br />
local playerDead = isPedDead(playerElement)<br />
<br />
if (playerDead) then<br />
return false<br />
end<br />
<br />
for weaponID, weaponSlot in pairs(playerWeaponsToTrack) do<br />
local weaponInSlot = getPedWeapon(playerElement, weaponSlot)<br />
local weaponTotalAmmo = getPedTotalAmmo(playerElement, weaponSlot)<br />
local weaponHasAmmo = (weaponTotalAmmo > 0)<br />
local weaponMatching = (weaponInSlot == weaponID)<br />
local updateWeaponAmmo = (weaponMatching and weaponHasAmmo)<br />
<br />
if (updateWeaponAmmo) then<br />
local storedProjectileAmmo = playerProjectileAmmo[playerElement]<br />
local newWeaponAmmo = (updateWeaponAmmo and weaponTotalAmmo or nil)<br />
<br />
if (not storedProjectileAmmo) then<br />
playerProjectileAmmo[playerElement] = {}<br />
storedProjectileAmmo = playerProjectileAmmo[playerElement]<br />
end<br />
<br />
storedProjectileAmmo[weaponID] = newWeaponAmmo<br />
end<br />
end<br />
<br />
return true<br />
end<br />
<br />
function hasPlayerProjectileAmmo(playerElement, projectileWeapon)<br />
local validElement = isElement(playerElement)<br />
<br />
if (not validElement) then<br />
return false<br />
end<br />
<br />
local playerDead = isPedDead(playerElement)<br />
<br />
if (playerDead) then<br />
return false<br />
end<br />
<br />
local projectileData = playerProjectileAmmo[playerElement]<br />
local projectileAmmo = (projectileData and projectileData[projectileWeapon])<br />
<br />
return projectileAmmo<br />
end<br />
<br />
function decreasePlayerProjectileAmmo(playerElement, projectileWeapon)<br />
local validElement = isElement(playerElement)<br />
<br />
if (not validElement) then<br />
return false<br />
end<br />
<br />
local playerDead = isPedDead(playerElement)<br />
<br />
if (playerDead) then<br />
return false<br />
end<br />
<br />
local playerProjectileData = playerProjectileAmmo[playerElement]<br />
<br />
if (not playerProjectileData) then<br />
return false<br />
end<br />
<br />
local projectileWeaponAmmo = playerProjectileData[projectileWeapon]<br />
local tempProjectileAmmo = (projectileWeaponAmmo - 1)<br />
local newProjectileAmmo = (tempProjectileAmmo > 0 and tempProjectileAmmo or nil)<br />
<br />
playerProjectileData[projectileWeapon] = newProjectileAmmo<br />
<br />
return true<br />
end<br />
<br />
function onPlayerWeaponSwitchAntiCheat(previousWeaponID, currentWeaponID)<br />
setTimer(updateProjectileAmmoForPlayer, 50, 1, source)<br />
end<br />
addEventHandler("onPlayerWeaponSwitch", root, onPlayerWeaponSwitchAntiCheat)<br />
<br />
function onResourceStartAntiCheat()<br />
local playersTable = getElementsByType("player")<br />
<br />
for playerID = 1, #playersTable do<br />
local playerElement = playersTable[playerID]<br />
<br />
updateProjectileAmmoForPlayer(playerElement)<br />
end<br />
end<br />
addEventHandler("onResourceStart", resourceRoot, onResourceStartAntiCheat)<br />
<br />
function onPlayerWastedQuitAntiCheat()<br />
playerProjectileAmmo[source] = nil<br />
end<br />
addEventHandler("onPlayerWasted", root, onPlayerWastedQuitAntiCheat)<br />
addEventHandler("onPlayerQuit", root, onPlayerWastedQuitAntiCheat)<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="false"><br />
Projectile handler:<br />
<syntaxhighlight lang="lua"><br />
local playerCreatedProjectiles = {} -- store count of legitimately created player projectiles; [playerElement] = {[projectileType] = activeProjectiles}<br />
local projectileTypes = {<br />
[16] = { -- Grenade<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 2,<br />
projectileAllowedWeapons = {<br />
[16] = true, -- grenade<br />
},<br />
},<br />
[17] = { -- Teargas<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 2,<br />
projectileAllowedWeapons = {<br />
[17] = true, -- teargas<br />
},<br />
},<br />
[18] = { -- Molotov<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 2,<br />
projectileAllowedWeapons = {<br />
[18] = true, -- molotov<br />
},<br />
},<br />
[19] = { -- Rocket<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 5,<br />
projectileMaxVelocity = 2,<br />
projectileAllowedWeapons = {<br />
[35] = true, -- rocket launcher<br />
},<br />
projectileAllowedVehicles = {<br />
[425] = true, -- hunter<br />
[520] = true, -- hydra<br />
},<br />
},<br />
[20] = { -- Rocket (heat-seeking)<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 5,<br />
projectileMaxVelocity = 2,<br />
projectileAllowedWeapons = {<br />
[36] = true, -- rocket launcher (heat-seeking)<br />
},<br />
projectileAllowedVehicles = {<br />
[520] = true, -- hydra<br />
},<br />
},<br />
[21] = { -- Airbomb<br />
projectileAllowed = true,<br />
projectileAllowedVehicles = {<br />
[520] = true, -- hydra<br />
},<br />
},<br />
[39] = { -- Satchel charge<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 2,<br />
projectileAllowedWeapons = {<br />
[39] = true, -- satchel charge<br />
},<br />
},<br />
[58] = { -- Hydra flare<br />
projectileAllowed = true,<br />
projectileMaxDistanceFromCreator = 5,<br />
projectileAllowedVehicles = {<br />
[520] = true, -- hydra<br />
},<br />
},<br />
}<br />
<br />
local reportAbnormality = true -- whether to report about abnormality in debug script - by default<br />
local punishPlayerOnDetect = false -- should player be punished upon detection; true - yes, or false to not do anything (make sure that resource which runs this code has admin rights)<br />
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick<br />
local punishmentReason = "Projectile/explosion anti-cheat" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player<br />
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player<br />
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)<br />
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that<br />
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead<br />
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent<br />
local debugMsgLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors<br />
local debugMsgR = 255 -- debug message - red color<br />
local debugMsgG = 127 -- debug message - green color<br />
local debugMsgB = 0 -- debug message - blue color<br />
<br />
local function reportProjectileAbnormality(playerElement, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ, detectionCode)<br />
local projectileSyncer = inspect(playerElement)<br />
local projectilePosition = projectileX..", "..projectileY..", "..projectileZ<br />
local projectileZoneName = getZoneName(projectileX, projectileY, projectileZ, false)<br />
local projectileCityName = getZoneName(projectileX, projectileY, projectileZ, true)<br />
local projectileLog =<br />
"* Detected projectile abnormality - "..detectionCode.." *\n"..<br />
"Projectile syncer: "..projectileSyncer.."\n"..<br />
"Projectile type: "..projectileType.."\n"..<br />
"Projectile position: "..projectilePosition.. " ("..projectileZoneName..", "..projectileCityName..")\n"<br />
<br />
outputDebugString(projectileLog, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)<br />
<br />
return true<br />
end<br />
<br />
local function processProjectileChecks(playerElement, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)<br />
local projectileData = projectileTypes[projectileType]<br />
local projectileAllowed = projectileData.projectileAllowed<br />
<br />
if (not projectileAllowed) then<br />
return false, "Projectile not allowed"<br />
end<br />
<br />
local projectileAllowedWeapons = projectileData.projectileAllowedWeapons<br />
<br />
if (projectileAllowedWeapons) then<br />
local playerWeapon = getPedWeapon(playerElement)<br />
local allowedWeapon = projectileAllowedWeapons[playerWeapon]<br />
<br />
if (not allowedWeapon) then<br />
return false, "Player is not holding correct weapon"<br />
end<br />
<br />
local weaponAmmo = hasPlayerProjectileAmmo(playerElement, playerWeapon)<br />
local playerHasAmmo = (weaponAmmo > 0)<br />
<br />
if (not playerHasAmmo) then<br />
return false, "Player doesn't have ammo for weapon"<br />
end<br />
<br />
decreasePlayerProjectileAmmo(playerElement, playerWeapon)<br />
end<br />
<br />
local playerVehicle = getPedOccupiedVehicle(playerElement)<br />
<br />
if (playerVehicle) then<br />
local projectileAllowedVehicles = projectileData.projectileAllowedVehicles<br />
<br />
if (projectileAllowedVehicles) then<br />
local vehicleModel = getElementModel(playerVehicle)<br />
local allowedVehicle = projectileAllowedVehicles[vehicleModel]<br />
<br />
if (not allowedVehicle) then<br />
return false, "Player is not inside allowed vehicles"<br />
end<br />
<br />
local vehicleDriver = getVehicleController(playerVehicle)<br />
local playerDriver = (playerElement == vehicleDriver)<br />
<br />
if (not playerDriver) then<br />
return false, "Player is not vehicle driver"<br />
end<br />
<br />
return true<br />
end<br />
<br />
return false, "Player in vehicle"<br />
end<br />
<br />
local projectileMaxDistanceFromCreator = projectileData.projectileMaxDistanceFromCreator<br />
<br />
if (projectileMaxDistanceFromCreator) then<br />
local playerX, playerY, playerZ = getElementPosition(playerElement)<br />
local distanceToProjectile = getDistanceBetweenPoints3D(playerX, playerY, playerZ, projectileX, projectileY, projectileZ)<br />
local matchingProjectileDistance = (distanceToProjectile <= projectileMaxDistanceFromCreator)<br />
<br />
if (not matchingProjectileDistance) then<br />
return false, "Projectile distance mismatch"<br />
end<br />
end<br />
<br />
local projectileMaxVelocity = projectileData.projectileMaxVelocity<br />
<br />
if (projectileMaxVelocity) then<br />
local projectileVelocity = (projectileVX ^ 2 + projectileVY ^ 2 + projectileVZ ^ 2)<br />
local projectileSpeed = math.sqrt(projectileVelocity)<br />
local matchingProjectileVelocity = (projectileSpeed <= projectileMaxVelocity)<br />
<br />
if (not matchingProjectileVelocity) then<br />
return false, "Projectile velocity mismatch"<br />
end<br />
end<br />
<br />
return true<br />
end<br />
<br />
local function trackPlayerProjectile(playerElement, projectileID)<br />
local validElement = isElement(playerElement)<br />
<br />
if (not validElement) then<br />
return false<br />
end<br />
<br />
local playerProjectiles = playerCreatedProjectiles[playerElement]<br />
<br />
if (not playerProjectiles) then<br />
playerCreatedProjectiles[playerElement] = {}<br />
playerProjectiles = playerCreatedProjectiles[playerElement]<br />
end<br />
<br />
local projectilesByType = playerProjectiles[projectileID] or 0<br />
local newProjectilesCount = (projectilesByType + 1)<br />
<br />
playerProjectiles[projectileID] = newProjectilesCount<br />
<br />
return true<br />
end<br />
<br />
local function getProjectileDetectionOverwrittenBehavior(projectileType)<br />
local projectileData = projectileTypes[projectileType]<br />
<br />
if (not projectileData) then<br />
return reportAbnormality, punishPlayerOnDetect, punishmentBan<br />
end<br />
<br />
local projectileBehaviour = projectileData.projectileOverwriteBehaviour<br />
<br />
if (not projectileBehaviour) then<br />
return reportAbnormality, punishPlayerOnDetect, punishmentBan<br />
end<br />
<br />
local overwriteReport = projectileBehaviour.reportAbnormality<br />
local overwritePunish = projectileBehaviour.punishPlayerOnDetect<br />
local overwriteBan = projectileBehaviour.punishmentBan<br />
<br />
return overwriteReport, overwritePunish, overwriteBan<br />
end<br />
<br />
function decreasePlayerProjectiles(playerElement, projectileID)<br />
local validElement = isElement(playerElement)<br />
<br />
if (not validElement) then<br />
return false<br />
end<br />
<br />
local playerProjectiles = playerCreatedProjectiles[playerElement]<br />
<br />
if (not playerProjectiles) then<br />
return false, true<br />
end<br />
<br />
local projectilesByType = playerProjectiles[projectileID]<br />
<br />
if (not projectilesByType) then<br />
return false, true<br />
end<br />
<br />
local tempProjectilesCount = (projectilesByType - 1)<br />
local newProjectilesCount = (tempProjectilesCount > 0 and tempProjectilesCount or nil)<br />
<br />
playerProjectiles[projectileID] = newProjectilesCount<br />
<br />
return true<br />
end<br />
<br />
function onPlayerProjectileCreationAntiCheat(projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)<br />
local approvedProjectile, detectionCode = processProjectileChecks(source, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ)<br />
<br />
if (approvedProjectile) then<br />
trackPlayerProjectile(source, projectileType)<br />
<br />
return true<br />
end<br />
<br />
local reportAbnormality, punishPlayerOnDetect, punishmentBan = getProjectileDetectionOverwrittenBehavior(projectileType)<br />
<br />
if (reportAbnormality) then<br />
reportProjectileAbnormality(source, projectileType, projectileX, projectileY, projectileZ, projectileForce, projectileTarget, projectileRX, projectileRY, projectileRZ, projectileVX, projectileVY, projectileVZ, detectionCode)<br />
end<br />
<br />
cancelEvent()<br />
<br />
if (not punishPlayerOnDetect) then -- we don't want to punish player for some reason<br />
return false -- so stop here<br />
end<br />
<br />
if (punishmentBan) then -- if it's ban<br />
banPlayer(source, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server<br />
else -- otherwise<br />
kickPlayer(source, punishedBy, punishmentReason) -- simply kick player out of server<br />
end<br />
end<br />
addEventHandler("onPlayerProjectileCreation", root, onPlayerProjectileCreationAntiCheat)<br />
<br />
function onPlayerQuitAntiCheat()<br />
playerCreatedProjectiles[source] = nil<br />
end<br />
addEventHandler("onPlayerQuit", root, onPlayerQuitAntiCheat)<br />
</syntaxhighlight><br />
</section><br />
<br />
<section name="Server" class="server" show="false"><br />
Explosions handler:<br />
<syntaxhighlight lang="lua"><br />
local rocketInstantExplosionDistanceThreshold = 1.55 -- distance below which only explosion will be created (and not rocket projectile, hence not calling onPlayerProjectileCreation); do not change it<br />
local explosionTypes = { -- more specific info on explosion, and whether it is allowed<br />
[0] = { -- Grenade<br />
explosionAllowed = true,<br />
explosionAllowedProjectiles = {<br />
[16] = true, -- grenade<br />
},<br />
},<br />
[1] = { -- Molotov<br />
explosionAllowed = true,<br />
explosionAllowedProjectiles = {<br />
[18] = true, -- molotov<br />
},<br />
},<br />
[2] = { -- Rocket<br />
explosionAllowed = true,<br />
explosionAllowedWeapons = {<br />
[35] = true, -- rocket launcher<br />
[36] = true, -- rocket launcher (heat-seeking)<br />
},<br />
explosionAllowedProjectiles = {<br />
[19] = true, -- rocket<br />
[20] = true, -- rocket (heat-seeking)<br />
},<br />
},<br />
[3] = { -- Rocket weak<br />
explosionAllowed = true,<br />
explosionAllowedProjectiles = {<br />
[19] = true, -- rocket<br />
[20] = true, -- rocket (heat-seeking)<br />
},<br />
},<br />
[4] = { -- Car<br />
explosionAllowed = true,<br />
},<br />
[5] = { -- Car quick<br />
explosionAllowed = true,<br />
},<br />
[6] = { -- Boat<br />
explosionAllowed = true,<br />
},<br />
[7] = { -- Heli<br />
explosionAllowed = true,<br />
},<br />
[8] = { -- Mine<br />
explosionAllowed = true,<br />
},<br />
[9] = { -- Object<br />
explosionAllowed = true,<br />
},<br />
[10] = { -- Tank grenade<br />
explosionAllowed = true,<br />
explosionMaxDistanceFromCreator = 80,<br />
explosionAllowedVehicles = {<br />
[432] = true,<br />
}<br />
},<br />
[11] = { -- Small<br />
explosionAllowed = true,<br />
},<br />
[12] = { -- Tiny<br />
explosionAllowed = true,<br />
},<br />
}<br />
<br />
local reportAbnormality = true -- whether to report about abnormality in debug script - by default<br />
local punishPlayerOnDetect = false -- should player be punished upon detection; true - yes, or false to not do anything (make sure that resource which runs this code has admin rights)<br />
local punishmentBan = true -- only relevant if punishPlayerOnDetect is set to true; use true for ban or false for kick<br />
local punishmentReason = "Projectile/explosion anti-cheat" -- only relevant if punishPlayerOnDetect is set to true; reason which would be shown to punished player<br />
local punishedBy = "Console" -- only relevant if punishPlayerOnDetect is set to true; who was responsible for punishing, as well shown to punished player<br />
local banByIP = false -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; banning by IP nowadays is not recommended (...)<br />
local banByUsername = false -- community username - legacy thing, hence is set to false and should stay like that<br />
local banBySerial = true -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; (...) if there is a player serial to use instead<br />
local banTime = 0 -- only relevant if punishPlayerOnDetect and punishmentBan is set to true; time in seconds, 0 for permanent<br />
local debugMsgLevel = 4 -- this debug level allows to hide INFO: prefix, and use custom colors<br />
local debugMsgR = 255 -- debug message - red color<br />
local debugMsgG = 127 -- debug message - green color<br />
local debugMsgB = 0 -- debug message - blue color<br />
<br />
local function reportExplosionAbnormality(playerElement, explosionType, explosionX, explosionY, explosionZ, detectionCode)<br />
local explosionSyncer = inspect(playerElement)<br />
local explosionType = explosionType<br />
local explosionPosition = explosionX..", "..explosionY..", "..explosionZ<br />
local explosionZoneName = getZoneName(explosionX, explosionY, explosionZ, false)<br />
local explosionCityName = getZoneName(explosionX, explosionY, explosionZ, true)<br />
local explosionLog =<br />
"* Detected explosion abnormality - "..detectionCode.." *\n"..<br />
"Explosion syncer: "..explosionSyncer.."\n"..<br />
"Explosion type: "..explosionType.."\n"..<br />
"Explosion position: "..explosionPosition.. " ("..explosionZoneName..", "..explosionCityName..")\n"<br />
<br />
outputDebugString(explosionLog, debugMsgLevel, debugMsgR, debugMsgG, debugMsgB)<br />
<br />
return true<br />
end<br />
<br />
local function processExplosionChecks(playerElement, explosionType, explosionX, explosionY, explosionZ)<br />
local explosionData = explosionTypes[explosionType]<br />
local explosionAllowed = explosionData.explosionAllowed<br />
<br />
if (not explosionAllowed) then<br />
return false, "Explosion type not allowed"<br />
end<br />
<br />
local rocketExplosion = (explosionType == 2)<br />
<br />
if (rocketExplosion) then<br />
local playerX, playerY, playerZ = getElementPosition(playerElement)<br />
local distanceToExplosion = getDistanceBetweenPoints3D(playerX, playerY, playerZ, explosionX, explosionY, explosionZ)<br />
local instantExplosion = (distanceToExplosion < rocketInstantExplosionDistanceThreshold)<br />
<br />
if (instantExplosion) then<br />
local explosionAllowedWeapons = explosionData.explosionAllowedWeapons<br />
local playerWeapon = getPedWeapon(playerElement)<br />
local allowedWeapon = explosionAllowedWeapons[playerWeapon]<br />
<br />
if (not allowedWeapon) then<br />
return false, "Player is not holding rocket launcher"<br />
end<br />
<br />
local weaponAmmo = hasPlayerProjectileAmmo(playerElement, playerWeapon)<br />
local playerHasAmmo = (weaponAmmo > 0)<br />
<br />
if (not playerHasAmmo) then<br />
return false, "Player doesn't have ammo for rocket launcher"<br />
end<br />
<br />
decreasePlayerProjectileAmmo(playerElement, playerWeapon)<br />
<br />
return true<br />
end<br />
end<br />
<br />
local explosionAllowedProjectiles = explosionData.explosionAllowedProjectiles<br />
<br />
if (explosionAllowedProjectiles) then<br />
<br />
for projectileID, _ in pairs(explosionAllowedProjectiles) do<br />
local atleastOneProjectile = decreasePlayerProjectiles(playerElement, projectileID)<br />
<br />
if (atleastOneProjectile) then<br />
return true<br />
end<br />
end<br />
<br />
return false, "Explosion created without respective projectile"<br />
end<br />
<br />
local explosionAllowedVehicles = explosionData.explosionAllowedVehicles<br />
<br />
if (explosionAllowedVehicles) then<br />
local playerVehicle = getPedOccupiedVehicle(playerElement)<br />
<br />
if (not playerVehicle) then<br />
return false, "Player is not in vehicle"<br />
end<br />
<br />
local vehicleModel = getElementModel(playerVehicle)<br />
local allowedVehicle = explosionAllowedVehicles[vehicleModel]<br />
<br />
if (not allowedVehicle) then<br />
return false, "Player is inside not allowed vehicles"<br />
end<br />
<br />
local vehicleDriver = getVehicleController(playerVehicle)<br />
local playerDriver = (playerElement == vehicleDriver)<br />
<br />
if (not playerDriver) then<br />
return false, "Player is not vehicle driver"<br />
end<br />
end<br />
<br />
local explosionMaxDistanceFromCreator = explosionData.explosionMaxDistanceFromCreator<br />
<br />
if (explosionMaxDistanceFromCreator) then<br />
local playerX, playerY, playerZ = getElementPosition(playerElement)<br />
local distanceToExplosion = getDistanceBetweenPoints3D(playerX, playerY, playerZ, explosionX, explosionY, explosionZ)<br />
local matchingExplosionDistance = (distanceToExplosion < explosionMaxDistanceFromCreator)<br />
<br />
if (not matchingExplosionDistance) then<br />
return false, "Explosion distance mismatch"<br />
end<br />
end<br />
<br />
return true<br />
end<br />
<br />
local function getExplosionDetectionOverwrittenBehavior(explosionType)<br />
local explosionData = explosionTypes[explosionType]<br />
<br />
if (not explosionData) then<br />
return reportAbnormality, punishPlayerOnDetect, punishmentBan<br />
end<br />
<br />
local explosionBehaviour = explosionData.explosionOverwriteBehaviour<br />
<br />
if (not explosionBehaviour) then<br />
return reportAbnormality, punishPlayerOnDetect, punishmentBan<br />
end<br />
<br />
local overwriteReport = explosionBehaviour.reportAbnormality<br />
local overwritePunish = explosionBehaviour.punishPlayerOnDetect<br />
local overwriteBan = explosionBehaviour.punishmentBan<br />
<br />
return overwriteReport, overwritePunish, overwriteBan<br />
end<br />
<br />
function onExplosionAntiCheat(explosionX, explosionY, explosionZ, explosionType)<br />
local serverSyncExplosion = (source == root)<br />
<br />
if (serverSyncExplosion) then<br />
return true<br />
end<br />
<br />
local approvedExplosion, detectionCode = processExplosionChecks(source, explosionType, explosionX, explosionY, explosionZ)<br />
<br />
if (approvedExplosion) then<br />
return true<br />
end<br />
<br />
local reportAbnormality, punishPlayerOnDetect, punishmentBan = getExplosionDetectionOverwrittenBehavior(explosionType)<br />
<br />
if (reportAbnormality) then<br />
reportExplosionAbnormality(source, explosionType, explosionX, explosionY, explosionZ, detectionCode)<br />
end<br />
<br />
cancelEvent()<br />
<br />
if (not punishPlayerOnDetect) then -- we don't want to punish player for some reason<br />
return false -- so stop here<br />
end<br />
<br />
if (punishmentBan) then -- if it's ban<br />
banPlayer(source, banByIP, banByUsername, banBySerial, punishedBy, punishmentReason, banTime) -- remove his presence from server<br />
else -- otherwise<br />
kickPlayer(source, punishedBy, punishmentReason) -- simply kick player out of server<br />
end<br />
end<br />
addEventHandler("onExplosion", root, onExplosionAntiCheat)<br />
</syntaxhighlight><br />
</section><br />
<br />
==Handling non-registered events==<br />
<br />
See: [[onPlayerTriggerInvalidEvent]]<br />
<br />
==Handling events spam==<br />
See: [[onPlayerTriggerEventThreshold]]<br />
<br />
__NOTOC__<br />
__NOEDITSECTION__<br />
[[ru:Script security]]<br />
[[en:Script security]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Forks&diff=82687RU/Forks2026-01-02T20:15:14Z<p>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]. Любой может создать форк проекта, если будет соблюдать условия нашей лиценз..."</p>
<hr />
<div>__NOTOC__ {{Note|Information on this page does not apply to the official builds of MTA.}}<br />
<br />
Multi Theft Auto - Это программное обеспечение с открытым исходным кодом, доступное бесплатно на [https://github.com/multitheftauto/mtasa-blue GitHub multitheftauto/mtasa-blue].<br />
Любой может создать форк проекта, если будет соблюдать условия нашей лицензии — Стандартной общественной лицензии GNU версии 3.<br />
<br />
Вы можете ознакомиться с пояснениями к 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] отдается нашей лицензии, но обычно это означает, что вы должны:<br />
<br />
* указать существенные изменения, внесенные в программное обеспечение<br />
* раскрыть исходный код <br />
* поделиться своим кодом под той же лицензией<br />
* включить оригинальное уведомление об авторских правах<br />
<br />
Если вы работаете над форком, мы просим вас указать ссылку на вашу домашнюю страницу и указать, где мы можем найти исходный код. Это позволяет нам быть в курсе событий, связанных с проектами, и даже вносить улучшения для подавляющего большинства игроков в MTA. Указывать имя в Discord не обязательно, но если вы обратитесь за помощью в разработке на наш GitHub, форум или в Discord, это поможет нам понять, из какого вы проекта и соблюдаете ли вы условия лицензии.<br />
<br />
== Forks and anti-cheat==<br />
<br />
(from https://wiki.multitheftauto.com/wiki/Anti-cheat_support_for_custom_builds)<br />
<br />
=== '''// UPDATE (December 2022)''' ===<br />
Теперь вы также можете использовать «полный античит для форков». Для получения дополнительной информации прочтите эту статью: '''[[Forks Full AC]]'''<br><br><br />
<br />
.. But otherwise<br />
<br />
Пользовательские сборки MTA и форки столкнутся с некоторыми проблемами, связанными с античитом (AC). Из-за того, что многие форки и пользовательские сборки работают не так, как ожидает модуль античита, мы были вынуждены удалить множество расширенных средств обнаружения и защиты от античита, чтобы создать и предоставить отдельный модуль (тот, что с https://mirror-cdn.multitheftauto.com/bdata/netc.dll), который, проще говоря, является гораздо более слабым античитом, чем «настоящий» MTA. Таким образом, если вы не примете меры, ваш форк-проект может (и будет) легко заражён мошенниками. Этого можно избежать с помощью [[Forks Full AC]] (нажмите, чтобы прочитать статью). Но в стандартном сценарии вам поможет информация, представленная ниже.<br />
<br />
Компоненты античита и неткода (netc.dll, net.dll, FairplayKD.sys), в отличие от самого MTA, имеют закрытый исходный код, поэтому без дополнительной информации вам будет сложно справиться с трудностями.<br />
<br />
AC, как правило, не поддерживается в форках и в будущем может быть полностью исключён. Это означает, что вы, как правило, ''не можете'' полагаться на античит MTA в своём форке. '''Мы настоятельно рекомендуем вам написать и внедрить собственный античит.'''<br />
<br />
Если вы не можете написать свой собственный AC, вот несколько шагов, которые помогут вам максимально эффективно использовать наш (не поддерживаемый) AC:<br />
<br />
* Всегда используйте версию наших сетевых модулей (например, [https://mirror-cdn.multitheftauto.com/bdata/netc.dll netc.dll] и [https://mirror-cdn.multitheftauto.com/bdata/net.dll net.dll]), которая соответствует нашему коммиту в основной ветке, на которой основан ваш форк<br />
** Если говорить конкретно, вы можете использовать последнюю версию модуля, совместимую с битовым потоком<br />
** Вы можете загрузить эти модули, выполнив команду https://github.com/multitheftauto/mtasa-blue/blob/master/win-build.bat<br />
* Никогда не блокируйте трафик MTA (клиент и сервер взаимодействуют с официальными серверами MTAHQ) в своём проекте<br />
'''* Обязательно используйте тип сборки «нестабильный», а не «пользовательский», иначе 15 % функций AC для «bdata forks netc» снизятся до 1 %. Подробную информацию и правильную конфигурацию см. в документации по типу сборки по адресу [https://github.com/multitheftauto/mtasa-blue/blob/master/Shared/sdk/version.h mtasa-blue/Shared/sdk/version.h] '''<br />
<br />
=== Функции AC отсутствуют в пользовательских сборках === <br />
* Не обнаруживаются изменения в разделе кода gta_sa<br />
* Не обнаруживаются изменения в некоторых переменных gta_sa<br />
* Не обнаруживаются изменения в памяти<br />
* Не обнаруживаются различные методы внедрения Lua<br />
* SetElementData не защищён от внешних изменений с помощью хаков<br />
* Гораздо меньше эвристических методов защиты от читов и внутренних средств защиты<br />
* Не гарантируется постоянное обновление всех исправленных методов и уязвимостей, на основе которых можно писать читы (иногда они выбираются случайным образом; это одна из причин, по которой рекомендуется обновлять netc.dll до последней доступной версии). Это самая большая (и самая важная) часть оригинального античита.<br />
* Модули MTA не проверяются на предмет модификаций или удалённого перехвата/манипулирования<br />
* и многое другое<br />
<br />
Как правило, лучше всего работают системы обнаружения на основе сигнатур. Никаких эвристических методов, исправленных методов и исправленных уязвимостей. Системы обнаружения на основе сигнатур — самые слабые, и основная античит-система решает реальную проблему, а не полагается на сигнатуры. Обратите внимание, что в некоторых форках (например, в российской «MTA Province») античит-система MTA поддерживается ещё хуже, чем в большинстве других форков. Это связано с тем, что разработчики форков имеют возможность полностью блокировать или прерывать коммуникационный трафик клиента > MTAHQ (на что мы в значительной степени полагаемся, чтобы помочь форкам противодействовать мошенничеству, поскольку большинство обычных функций AC недоступны), или выполнять и изменять другие действия, которые с технической точки зрения приведут к тому, что функции AC не будут работать. работайте по назначению или немедленно выйдите из строя. Если вы не хотите, чтобы ваш форк был заражен читерами так же сильно, как "провинция MTA" и как они ее называют, "их клоны" (из провинции).. в дополнение к тому, что вы установили тип сборки «custom», тогда как он должен быть «unstable». Теперь, надеюсь, вы знаете, на что следует обратить внимание как разработчику форка. Кроме того, было бы неплохо, если бы это сообщение дошло до разработчиков форков с большим количеством читеров, таких как Province.<br />
<br />
Кроме того, команда по борьбе с мошенничеством в MTA выполняет дополнительную работу вручную, чтобы пресекать мошенничество на форках, например, время от времени блокируя читеров из известных форков с помощью слишком простых методов обнаружения, прилагая все усилия (без каких-либо гарантий). Это всего лишь любезность со стороны MTA, которую мы проявляем, когда нам этого хочется, или, может быть, когда вы обращаетесь к нам... и на это нельзя полагаться.<br />
<br /><br />
Известно, что вышеупомянутые волны банов приводят к банам по причинам, которые выглядят одинаково и известны читерам как «БАН: RPBOX / NEXTRP / PROVINCE CHEAT» (в зависимости от названий форков, затронутых определенным читом). Поэтому, пожалуйста, не направляйте этих пользователей в MTA для обжалования банов.<br />
<br />
[[Category:Development]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Where_to_buy_GTASA&diff=82686RU/Where to buy GTASA2026-01-02T20:00:24Z<p>Flox: </p>
<hr />
<div>На этой странице описывается общая совместимость версий Grand Theft Auto: San Andreas с MTA:SA, а также где их можно приобрести.<br />
<br />
=== Совместимость ===<br />
<br />
Если версия Grand Theft Auto: San Andreas, отмеченная ниже как совместимая, не работает, попробуйте переустановить MTA:SA. Если это не сработает, следуйте [https://forum.mtasa.com/topic/11757-patching-your-101-or-200-version-of-gta_saexe/ этим инструкциям]. Если это по-прежнему не сработает, пожалуйста, свяжитесь с нами на форуме [https://forum.mtasa.com/forum/83-client/] или присоединяйтесь к [https://mtasa.com/discord MTA Discord #help-support channel].<br />
<br />
{{Important Note|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' это совершенно новая версия игры. Данная версия является '''несовместимой''' с MTA:SA.}}<br />
<br />
=== Получение совместимых и бывших в употреблении копий ===<br />
<br />
Официально единственный способ приобрести совместимую копию Grand Theft Auto: San Andreas от Rockstar Games и Take-Two — это приобрести коллекцию classic collection [https://store.rockstargames.com/en/game/buy/grand-theft-auto-the-trilogy "Grand Theft Auto: Trilogy" (2005) в магазине Rockstar Store].<br />
<br />
Есть только два других варианта: либо приобрести подержанную физическую копию через блошиные рынки и частных посредников, либо приобрести ключ для совместимой цифровой версии у посредника по продаже ключей.<br />
<br />
Ярким примером покупки подержанной физической копии на сайтах, указанных ниже. Введя в поле поиска «gta san andreas pc» или «gta san andreas», вы сможете найти множество людей, которые все еще продают совместимую игру. Однако будьте осторожны, поскольку покупка у ненадежных реселлеров, таких как неизвестные люди, не занимающиеся бизнесом, сопряжена с риском (например, подделки или поврежденные копии).<br />
<br />
Чтобы найти продавца цифровых ключей, воспользуйтесь поисковой системой, чтобы найти «Grand Theft Auto: San Andreas key» или что-то подобное.<br />
<br />
<br />
=== Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. ===<br />
<br />
На этой странице перечислены некоторые веб-сайты, на которых можно купить Grand Theft Auto San Andreas в цифровом виде и играть в MTA:SA (иногда с автоматическим понижением версии игры). Не все из них были проверены, но все должно работать без проблем. Если нет, пожалуйста, обратитесь в службу поддержки.<br />
<br />
Известно, что все версии (DVD) GTA:SA для Windows функционируют нормально. Если вы планируете покупать DVD-диск GTA:SA, вам следует попытаться получить "Standard" версию, а не "Second Edition" или "Greatest Hits" издания, хотя они будут работать нормально.<br />
<br />
{| class="wikitable" style="width: 900px; text-align: center; table-layout: fixed;"<br />
|-<br />
!Ритейлер<br />
!Примечания<br />
!Работает с MTA: SA?<br />
|-<br />
|[http://store.steampowered.com/app/12120/ Steam]<br />
|Внимание: Grand Theft Auto: San Andreas больше не доступна в магазине Steam.Специализированная Steam-версия игры. Установщик MTA произведет даунгрейд (понижение) версии игры. <br />
|{{Yes|Да}}<br />
|-<br />
| rowspan="2" |[http://www.amazon.com/Grand-Theft-Auto-Andreas-Download/dp/B006YVXGJQ Amazon]<br />
| Для '''Standard''' издания игры, если MTA несовместима, попробуйте найти GTA SA 1.00 No CD - любой релиз от HOODLUM будет функционировать без проблем.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
| Steam-версия и копии дисков GTASA будут функционировать нормально<br />
| {{Yes| Да (Steam/DVD-бокс)}}<br />
|-<br />
|[http://www.gamersgate.co.uk/DD-GTASAS/grand-theft-auto-san-andreas GamersGate]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.game.co.uk/en/grand-theft-auto-san-andreas-301403 Game UK]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://digital.gamefly.co.uk/#!/download-grand-theft-auto-san-andreas/5006365 GameFly Digital]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.greenmangaming.com/s/gb/en/pc/games/action/grand-theft-auto-san-andreas/ GreenManGaming]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.gamestop.com/pc/games/grand-theft-auto-san-andreas/37409 GameStop]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.walmart.com/ip/Take-Two-GTASAESD-Grand-Theft-Auto-San-Andreas-PC/36754297 Walmart]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[https://www.ebay.com/sch/i.html?_from=R40&_trksid=p4432023.m570.l1313&_nkw=GTA%3ASA&_sacat=0 Ebay]<br />
|Доступна к покупке (Нужна версия ПК).<br />
|{{Yes|Да}}<br />
|-<br />
|-<br />
|[https://www.ozon.ru/category/gta-san-andreas-na-pk/?__rr=1&abt_att=1 Ozon MarketPlace]<br />
|Доступна к покупке. Не проверено при работе с MTA:SA.<br />
| {{Partial|Не проверено}}<br />
|-<br />
|-<br />
|[https://www.wildberries.ru/catalog/0/search.aspx?search=gta%20san%20andreas%20диск%20на%20пк Wildberries MarketPlace]<br />
|Доступна к покупке. Не проверено при работе с MTA:SA.<br />
| {{Partial|Не проверено}}<br />
|-<br />
|Windows App Store<br />
|Мобильная версия игры, перенесенная на ПК. '''Никогда не будет работать с MTA'''.<br />
|{{No|Нет}}<br />
|-<br />
<br />
[[en:Where to buy GTASA]]<br />
[[es:Dónde comprar GTA: SA]]<br />
[[uk:Where to buy GTASA]]<br />
[[pl:Where to buy GTASA]]<br />
[[tr:GTA:SA Nerden Alınır]]<br />
[[zh-cn:在那里可以购买GTASA]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Where_to_buy_GTASA&diff=82453RU/Where to buy GTASA2025-09-06T13:37:05Z<p>Flox: /* Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. */</p>
<hr />
<div>На этой странице описывается общая совместимость версий Grand Theft Auto: San Andreas с MTA:SA, а также где их можно приобрести.<br />
<br />
=== Совместимость ===<br />
<br />
Если версия Grand Theft Auto: San Andreas, отмеченная ниже как совместимая, не работает, попробуйте переустановить MTA:SA. Если это не сработает, следуйте [https://forum.mtasa.com/topic/11757-patching-your-101-or-200-version-of-gta_saexe/ этим инструкциям]. Если это по-прежнему не сработает, пожалуйста, свяжитесь с нами на форуме [https://forum.mtasa.com/forum/83-client/] или присоединяйтесь к [https://mtasa.com/discord MTA Discord #help-support channel].<br />
<br />
{{Important Note|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' это совершенно новая версия игры. Данная версия является '''несовместимой''' с MTA:SA.}}<br />
<br />
=== Получение совместимых и бывших в употреблении копий ===<br />
<br />
Официально единственный способ приобрести совместимую копию Grand Theft Auto: San Andreas от Rockstar Games и Take-Two — это приобрести коллекцию classic collection [https://store.rockstargames.com/en/game/buy/grand-theft-auto-the-trilogy "Grand Theft Auto: Trilogy" (2005) в магазине Rockstar Store].<br />
<br />
Есть только два других варианта: либо приобрести подержанную физическую копию через блошиные рынки и частных посредников, либо приобрести ключ для совместимой цифровой версии у посредника по продаже ключей.<br />
<br />
Ярким примером покупки подержанной физической копии на сайтах, указанных ниже. Введя в поле поиска «gta san andreas pc» или «gta san andreas», вы сможете найти множество людей, которые все еще продают совместимую игру. Однако будьте осторожны, поскольку покупка у ненадежных реселлеров, таких как неизвестные люди, не занимающиеся бизнесом, сопряжена с риском (например, подделки или поврежденные копии).<br />
<br />
Чтобы найти продавца цифровых ключей, воспользуйтесь поисковой системой, чтобы найти «Grand Theft Auto: San Andreas key» или что-то подобное.<br />
<br />
<br />
=== Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. ===<br />
<br />
На этой странице перечислены некоторые веб-сайты, на которых можно купить Grand Theft Auto San Andreas в цифровом виде и играть в MTA:SA (иногда с автоматическим понижением версии игры). Не все из них были проверены, но все должно работать без проблем. Если нет, пожалуйста, обратитесь в службу поддержки.<br />
<br />
Известно, что все версии (DVD) GTA:SA для Windows функционируют нормально. Если вы планируете покупать DVD-диск GTA:SA, вам следует попытаться получить "Standard" версию, а не "Second Edition" или "Greatest Hits" издания, хотя они будут работать нормально.<br />
<br />
{| class="wikitable" style="width: 900px; text-align: center; table-layout: fixed;"<br />
|-<br />
!Ритейлер<br />
!Примечания<br />
!Работает с MTA: SA?<br />
|-<br />
|[http://store.steampowered.com/app/12120/ Steam]<br />
|Внимание: Grand Theft Auto: San Andreas больше не доступна в магазине Steam.Специализированная Steam-версия игры. Установщик MTA произведет даунгрейд (понижение) версии игры. <br />
|{{Yes|Да}}<br />
|-<br />
| rowspan="2" |[http://www.amazon.com/Grand-Theft-Auto-Andreas-Download/dp/B006YVXGJQ Amazon]<br />
| Для '''Standard''' издания игры, если MTA несовместима, попробуйте найти GTA SA 1.00 No CD - любой релиз от HOODLUM будет функционировать без проблем.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
| Steam-версия и копии дисков GTASA будут функционировать нормально<br />
| {{Yes| Да (Steam/DVD-бокс)}}<br />
|-<br />
|[http://www.gamersgate.co.uk/DD-GTASAS/grand-theft-auto-san-andreas GamersGate]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.game.co.uk/en/grand-theft-auto-san-andreas-301403 Game UK]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://digital.gamefly.co.uk/#!/download-grand-theft-auto-san-andreas/5006365 GameFly Digital]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.greenmangaming.com/s/gb/en/pc/games/action/grand-theft-auto-san-andreas/ GreenManGaming]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.gamestop.com/pc/games/grand-theft-auto-san-andreas/37409 GameStop]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.walmart.com/ip/Take-Two-GTASAESD-Grand-Theft-Auto-San-Andreas-PC/36754297 Walmart]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[https://www.ebay.com/sch/i.html?_from=R40&_trksid=p4432023.m570.l1313&_nkw=GTA%3ASA&_sacat=0 Ebay]<br />
|Доступна к покупке (Нужна версия ПК).<br />
|{{Yes|Да}}<br />
|-<br />
|-<br />
|[https://www.ozon.ru/category/gta-san-andreas-na-pk/?__rr=1&abt_att=1 Ozon MarketPlace]<br />
|Доступна к покупке. Не проверено при работе с MTA:SA.<br />
| {{Partial|Не проверено}}<br />
|-<br />
|Windows App Store<br />
|Мобильная версия игры, перенесенная на ПК. '''Никогда не будет работать с MTA'''.<br />
|{{No|Нет}}<br />
|-<br />
<br />
[[en:Where to buy GTASA]]<br />
[[es:Dónde comprar GTA: SA]]<br />
[[uk:Where to buy GTASA]]<br />
[[pl:Where to buy GTASA]]<br />
[[tr:GTA:SA Nerden Alınır]]<br />
[[zh-cn:在那里可以购买GTASA]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Where_to_buy_GTASA&diff=82452RU/Where to buy GTASA2025-09-06T13:36:39Z<p>Flox: /* Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. */</p>
<hr />
<div>На этой странице описывается общая совместимость версий Grand Theft Auto: San Andreas с MTA:SA, а также где их можно приобрести.<br />
<br />
=== Совместимость ===<br />
<br />
Если версия Grand Theft Auto: San Andreas, отмеченная ниже как совместимая, не работает, попробуйте переустановить MTA:SA. Если это не сработает, следуйте [https://forum.mtasa.com/topic/11757-patching-your-101-or-200-version-of-gta_saexe/ этим инструкциям]. Если это по-прежнему не сработает, пожалуйста, свяжитесь с нами на форуме [https://forum.mtasa.com/forum/83-client/] или присоединяйтесь к [https://mtasa.com/discord MTA Discord #help-support channel].<br />
<br />
{{Important Note|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' это совершенно новая версия игры. Данная версия является '''несовместимой''' с MTA:SA.}}<br />
<br />
=== Получение совместимых и бывших в употреблении копий ===<br />
<br />
Официально единственный способ приобрести совместимую копию Grand Theft Auto: San Andreas от Rockstar Games и Take-Two — это приобрести коллекцию classic collection [https://store.rockstargames.com/en/game/buy/grand-theft-auto-the-trilogy "Grand Theft Auto: Trilogy" (2005) в магазине Rockstar Store].<br />
<br />
Есть только два других варианта: либо приобрести подержанную физическую копию через блошиные рынки и частных посредников, либо приобрести ключ для совместимой цифровой версии у посредника по продаже ключей.<br />
<br />
Ярким примером покупки подержанной физической копии на сайтах, указанных ниже. Введя в поле поиска «gta san andreas pc» или «gta san andreas», вы сможете найти множество людей, которые все еще продают совместимую игру. Однако будьте осторожны, поскольку покупка у ненадежных реселлеров, таких как неизвестные люди, не занимающиеся бизнесом, сопряжена с риском (например, подделки или поврежденные копии).<br />
<br />
Чтобы найти продавца цифровых ключей, воспользуйтесь поисковой системой, чтобы найти «Grand Theft Auto: San Andreas key» или что-то подобное.<br />
<br />
<br />
=== Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. ===<br />
<br />
На этой странице перечислены некоторые веб-сайты, на которых можно купить Grand Theft Auto San Andreas в цифровом виде и играть в MTA:SA (иногда с автоматическим понижением версии игры). Не все из них были проверены, но все должно работать без проблем. Если нет, пожалуйста, обратитесь в службу поддержки.<br />
<br />
Известно, что все версии (DVD) GTA:SA для Windows функционируют нормально. Если вы планируете покупать DVD-диск GTA:SA, вам следует попытаться получить "Standard" версию, а не "Second Edition" или "Greatest Hits" издания, хотя они будут работать нормально.<br />
<br />
{| class="wikitable" style="width: 900px; text-align: center; table-layout: fixed;"<br />
|-<br />
!Ритейлер<br />
!Примечания<br />
!Работает с MTA: SA?<br />
|-<br />
|[http://store.steampowered.com/app/12120/ Steam]<br />
|Внимание: Grand Theft Auto: San Andreas больше не доступна в магазине Steam.Специализированная Steam-версия игры. Установщик MTA произведет даунгрейд (понижение) версии игры. <br />
|{{Yes|Да}}<br />
|-<br />
| rowspan="2" |[http://www.amazon.com/Grand-Theft-Auto-Andreas-Download/dp/B006YVXGJQ Amazon]<br />
| Для '''Standard''' издания игры, если MTA несовместима, попробуйте найти GTA SA 1.00 No CD - любой релиз от HOODLUM будет функционировать без проблем.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
| Steam-версия и копии дисков GTASA будут функционировать нормально<br />
| {{Yes| Да (Steam/DVD-бокс)}}<br />
|-<br />
|[http://www.gamersgate.co.uk/DD-GTASAS/grand-theft-auto-san-andreas GamersGate]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.game.co.uk/en/grand-theft-auto-san-andreas-301403 Game UK]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://digital.gamefly.co.uk/#!/download-grand-theft-auto-san-andreas/5006365 GameFly Digital]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.greenmangaming.com/s/gb/en/pc/games/action/grand-theft-auto-san-andreas/ GreenManGaming]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.gamestop.com/pc/games/grand-theft-auto-san-andreas/37409 GameStop]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.walmart.com/ip/Take-Two-GTASAESD-Grand-Theft-Auto-San-Andreas-PC/36754297 Walmart]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[https://www.ebay.com/sch/i.html?_from=R40&_trksid=p4432023.m570.l1313&_nkw=GTA%3ASA&_sacat=0 Ebay]<br />
|Доступна к покупке (Нужна версия ПК).<br />
|{{Yes|Да}}<br />
|-<br />
|-<br />
|[https://www.ozon.ru/category/gta-san-andreas-na-pk/?__rr=1&abt_att=1 Ozon MarketPlace]<br />
|Доступна к покупке. Не проверено при работе с MTA:SA.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
|{{Yes|Да}}<br />
|-<br />
|Windows App Store<br />
|Мобильная версия игры, перенесенная на ПК. '''Никогда не будет работать с MTA'''.<br />
|{{No|Нет}}<br />
|-<br />
<br />
[[en:Where to buy GTASA]]<br />
[[es:Dónde comprar GTA: SA]]<br />
[[uk:Where to buy GTASA]]<br />
[[pl:Where to buy GTASA]]<br />
[[tr:GTA:SA Nerden Alınır]]<br />
[[zh-cn:在那里可以购买GTASA]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Where_to_buy_GTASA&diff=82451RU/Where to buy GTASA2025-09-06T13:36:09Z<p>Flox: </p>
<hr />
<div>На этой странице описывается общая совместимость версий Grand Theft Auto: San Andreas с MTA:SA, а также где их можно приобрести.<br />
<br />
=== Совместимость ===<br />
<br />
Если версия Grand Theft Auto: San Andreas, отмеченная ниже как совместимая, не работает, попробуйте переустановить MTA:SA. Если это не сработает, следуйте [https://forum.mtasa.com/topic/11757-patching-your-101-or-200-version-of-gta_saexe/ этим инструкциям]. Если это по-прежнему не сработает, пожалуйста, свяжитесь с нами на форуме [https://forum.mtasa.com/forum/83-client/] или присоединяйтесь к [https://mtasa.com/discord MTA Discord #help-support channel].<br />
<br />
{{Important Note|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' это совершенно новая версия игры. Данная версия является '''несовместимой''' с MTA:SA.}}<br />
<br />
=== Получение совместимых и бывших в употреблении копий ===<br />
<br />
Официально единственный способ приобрести совместимую копию Grand Theft Auto: San Andreas от Rockstar Games и Take-Two — это приобрести коллекцию classic collection [https://store.rockstargames.com/en/game/buy/grand-theft-auto-the-trilogy "Grand Theft Auto: Trilogy" (2005) в магазине Rockstar Store].<br />
<br />
Есть только два других варианта: либо приобрести подержанную физическую копию через блошиные рынки и частных посредников, либо приобрести ключ для совместимой цифровой версии у посредника по продаже ключей.<br />
<br />
Ярким примером покупки подержанной физической копии на сайтах, указанных ниже. Введя в поле поиска «gta san andreas pc» или «gta san andreas», вы сможете найти множество людей, которые все еще продают совместимую игру. Однако будьте осторожны, поскольку покупка у ненадежных реселлеров, таких как неизвестные люди, не занимающиеся бизнесом, сопряжена с риском (например, подделки или поврежденные копии).<br />
<br />
Чтобы найти продавца цифровых ключей, воспользуйтесь поисковой системой, чтобы найти «Grand Theft Auto: San Andreas key» или что-то подобное.<br />
<br />
<br />
=== Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. ===<br />
<br />
На этой странице перечислены некоторые веб-сайты, на которых можно купить Grand Theft Auto San Andreas в цифровом виде и играть в MTA:SA (иногда с автоматическим понижением версии игры). Не все из них были проверены, но все должно работать без проблем. Если нет, пожалуйста, обратитесь в службу поддержки.<br />
<br />
Известно, что все версии (DVD) GTA:SA для Windows функционируют нормально. Если вы планируете покупать DVD-диск GTA:SA, вам следует попытаться получить "Standard" версию, а не "Second Edition" или "Greatest Hits" издания, хотя они будут работать нормально.<br />
<br />
{| class="wikitable" style="width: 900px; text-align: center; table-layout: fixed;"<br />
|-<br />
!Ритейлер<br />
!Примечания<br />
!Работает с MTA: SA?<br />
|-<br />
|[http://store.steampowered.com/app/12120/ Steam]<br />
|Внимание: Grand Theft Auto: San Andreas больше не доступна в магазине Steam.Специализированная Steam-версия игры. Установщик MTA произведет даунгрейд (понижение) версии игры. <br />
|{{Yes|Да}}<br />
|-<br />
| rowspan="2" |[http://www.amazon.com/Grand-Theft-Auto-Andreas-Download/dp/B006YVXGJQ Amazon]<br />
| Для '''Standard''' издания игры, если MTA несовместима, попробуйте найти GTA SA 1.00 No CD - любой релиз от HOODLUM будет функционировать без проблем.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
| Steam-версия и копии дисков GTASA будут функционировать нормально<br />
| {{Yes| Да (Steam/DVD-бокс)}}<br />
|-<br />
|[http://www.gamersgate.co.uk/DD-GTASAS/grand-theft-auto-san-andreas GamersGate]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.game.co.uk/en/grand-theft-auto-san-andreas-301403 Game UK]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://digital.gamefly.co.uk/#!/download-grand-theft-auto-san-andreas/5006365 GameFly Digital]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.greenmangaming.com/s/gb/en/pc/games/action/grand-theft-auto-san-andreas/ GreenManGaming]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.gamestop.com/pc/games/grand-theft-auto-san-andreas/37409 GameStop]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.walmart.com/ip/Take-Two-GTASAESD-Grand-Theft-Auto-San-Andreas-PC/36754297 Walmart]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[https://www.ebay.com/sch/i.html?_from=R40&_trksid=p4432023.m570.l1313&_nkw=GTA%3ASA&_sacat=0 Ebay]<br />
|Доступна к покупке (Нужна версия ПК).<br />
|{{Yes|Да}}<br />
|-<br />
|-<br />
|[https://www.ozon.ru/category/gta-san-andreas-na-pk/?__rr=1&abt_att=1 Ozon MarketPlace]<br />
|Доступна к покупке. Не проверено при работе с MTA:SA.<br />
|{{Yes|Да}}<br />
|-<br />
|Windows App Store<br />
|Мобильная версия игры, перенесенная на ПК. '''Никогда не будет работать с MTA'''.<br />
|{{No|Нет}}<br />
|-<br />
<br />
[[en:Where to buy GTASA]]<br />
[[es:Dónde comprar GTA: SA]]<br />
[[uk:Where to buy GTASA]]<br />
[[pl:Where to buy GTASA]]<br />
[[tr:GTA:SA Nerden Alınır]]<br />
[[zh-cn:在那里可以购买GTASA]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Where_to_buy_GTASA&diff=82450RU/Where to buy GTASA2025-09-06T13:29:03Z<p>Flox: </p>
<hr />
<div>На этой странице описывается общая совместимость версий Grand Theft Auto: San Andreas с MTA:SA, а также где их можно приобрести.<br />
<br />
=== Совместимость ===<br />
<br />
Если версия Grand Theft Auto: San Andreas, отмеченная ниже как совместимая, не работает, попробуйте переустановить MTA:SA. Если это не сработает, следуйте [https://forum.mtasa.com/topic/11757-patching-your-101-or-200-version-of-gta_saexe/ этим инструкциям]. Если это по-прежнему не сработает, пожалуйста, свяжитесь с нами на форуме [https://forum.mtasa.com/forum/83-client/] или присоединяйтесь к [https://mtasa.com/discord MTA Discord #help-support channel].<br />
<br />
{{Important Note|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' это совершенно новая версия игры. Данная версия является '''несовместимой''' с MTA:SA.}}<br />
<br />
=== Получение совместимых и бывших в употреблении копий ===<br />
<br />
Официально единственный способ приобрести совместимую копию Grand Theft Auto: San Andreas от Rockstar Games и Take-Two — это приобрести коллекцию classic collection [https://store.rockstargames.com/en/game/buy/grand-theft-auto-the-trilogy "Grand Theft Auto: Trilogy" (2005) в магазине Rockstar Store].<br />
<br />
Есть только два других варианта: либо приобрести подержанную физическую копию через блошиные рынки и частных посредников, либо приобрести ключ для совместимой цифровой версии у посредника по продаже ключей.<br />
<br />
Ярким примером покупки подержанной физической копии на сайтах, указанных ниже. Введя в поле поиска «gta san andreas pc» или «gta san andreas», вы сможете найти множество людей, которые все еще продают совместимую игру. Однако будьте осторожны, поскольку покупка у ненадежных реселлеров, таких как неизвестные люди, не занимающиеся бизнесом, сопряжена с риском (например, подделки или поврежденные копии).<br />
<br />
Чтобы найти продавца цифровых ключей, воспользуйтесь поисковой системой, чтобы найти «Grand Theft Auto: San Andreas key» или что-то подобное.<br />
<br />
<br />
=== Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. ===<br />
<br />
На этой странице перечислены некоторые веб-сайты, на которых можно купить Grand Theft Auto San Andreas в цифровом виде и играть в MTA:SA (иногда с автоматическим понижением версии игры). Не все из них были проверены, но все должно работать без проблем. Если нет, пожалуйста, обратитесь в службу поддержки.<br />
<br />
Известно, что все версии (DVD) GTA:SA для Windows функционируют нормально. Если вы планируете покупать DVD-диск GTA:SA, вам следует попытаться получить "Standard" версию, а не "Second Edition" или "Greatest Hits" издания, хотя они будут работать нормально.<br />
<br />
{| class="wikitable" style="width: 900px; text-align: center; table-layout: fixed;"<br />
|-<br />
!Ритейлер<br />
!Примечания<br />
!Работает с MTA: SA?<br />
|-<br />
|[http://store.steampowered.com/app/12120/ Steam]<br />
|Внимание: Grand Theft Auto: San Andreas больше не доступна в магазине Steam.Специализированная Steam-версия игры. Установщик MTA произведет даунгрейд (понижение) версии игры. <br />
|{{Yes|Да}}<br />
|-<br />
| rowspan="2" |[http://www.amazon.com/Grand-Theft-Auto-Andreas-Download/dp/B006YVXGJQ Amazon]<br />
| Для '''Standard''' издания игры, если MTA несовместима, попробуйте найти GTA SA 1.00 No CD - любой релиз от HOODLUM будет функционировать без проблем.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
| Steam-версия и копии дисков GTASA будут функционировать нормально<br />
| {{Yes| Да (Steam/DVD-бокс)}}<br />
|-<br />
|[http://www.gamersgate.co.uk/DD-GTASAS/grand-theft-auto-san-andreas GamersGate]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.game.co.uk/en/grand-theft-auto-san-andreas-301403 Game UK]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://digital.gamefly.co.uk/#!/download-grand-theft-auto-san-andreas/5006365 GameFly Digital]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.greenmangaming.com/s/gb/en/pc/games/action/grand-theft-auto-san-andreas/ GreenManGaming]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.gamestop.com/pc/games/grand-theft-auto-san-andreas/37409 GameStop]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.walmart.com/ip/Take-Two-GTASAESD-Grand-Theft-Auto-San-Andreas-PC/36754297 Walmart]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[https://www.ebay.com/sch/i.html?_from=R40&_trksid=p4432023.m570.l1313&_nkw=GTA%3ASA&_sacat=0 Ebay]<br />
|Доступна к покупке (Нужна версия ПК).<br />
|{{Yes|Да}}<br />
|-<br />
|Windows App Store<br />
|Мобильная версия игры, перенесенная на ПК. '''Никогда не будет работать с MTA'''.<br />
|{{No|Нет}}<br />
|-<br />
<br />
[[en:Where to buy GTASA]]<br />
[[es:Dónde comprar GTA: SA]]<br />
[[uk:Where to buy GTASA]]<br />
[[pl:Where to buy GTASA]]<br />
[[tr:GTA:SA Nerden Alınır]]<br />
[[zh-cn:在那里可以购买GTASA]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Where_to_buy_GTASA&diff=82449RU/Where to buy GTASA2025-09-06T13:28:38Z<p>Flox: </p>
<hr />
<div>На этой странице описывается общая совместимость версий Grand Theft Auto: San Andreas с MTA:SA, а также где их можно приобрести.<br />
<br />
=== Совместимость ===<br />
<br />
Если версия Grand Theft Auto: San Andreas, отмеченная ниже как совместимая, не работает, попробуйте переустановить MTA:SA. Если это не сработает, следуйте [https://forum.mtasa.com/topic/11757-patching-your-101-or-200-version-of-gta_saexe/ этим инструкциям]. Если это по-прежнему не сработает, пожалуйста, свяжитесь с нами на форуме [https://forum.mtasa.com/forum/83-client/] или присоединяйтесь к [https://mtasa.com/discord MTA Discord #help-support channel].<br />
<br />
{{Важное замечание|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' — это совершенно новая версия игры. Данная версия является '''несовместимой''' с MTA:SA.}}<br />
{{Important Note|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' это совершенно новая версия игры. Данная версия является '''not compatible''' with MTA:SA.}}<br />
<br />
=== Получение совместимых и бывших в употреблении копий ===<br />
<br />
Официально единственный способ приобрести совместимую копию Grand Theft Auto: San Andreas от Rockstar Games и Take-Two — это приобрести коллекцию classic collection [https://store.rockstargames.com/en/game/buy/grand-theft-auto-the-trilogy "Grand Theft Auto: Trilogy" (2005) в магазине Rockstar Store].<br />
<br />
Есть только два других варианта: либо приобрести подержанную физическую копию через блошиные рынки и частных посредников, либо приобрести ключ для совместимой цифровой версии у посредника по продаже ключей.<br />
<br />
Ярким примером покупки подержанной физической копии на сайтах, указанных ниже. Введя в поле поиска «gta san andreas pc» или «gta san andreas», вы сможете найти множество людей, которые все еще продают совместимую игру. Однако будьте осторожны, поскольку покупка у ненадежных реселлеров, таких как неизвестные люди, не занимающиеся бизнесом, сопряжена с риском (например, подделки или поврежденные копии).<br />
<br />
Чтобы найти продавца цифровых ключей, воспользуйтесь поисковой системой, чтобы найти «Grand Theft Auto: San Andreas key» или что-то подобное.<br />
<br />
<br />
=== Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. ===<br />
<br />
На этой странице перечислены некоторые веб-сайты, на которых можно купить Grand Theft Auto San Andreas в цифровом виде и играть в MTA:SA (иногда с автоматическим понижением версии игры). Не все из них были проверены, но все должно работать без проблем. Если нет, пожалуйста, обратитесь в службу поддержки.<br />
<br />
Известно, что все версии (DVD) GTA:SA для Windows функционируют нормально. Если вы планируете покупать DVD-диск GTA:SA, вам следует попытаться получить "Standard" версию, а не "Second Edition" или "Greatest Hits" издания, хотя они будут работать нормально.<br />
<br />
{| class="wikitable" style="width: 900px; text-align: center; table-layout: fixed;"<br />
|-<br />
!Ритейлер<br />
!Примечания<br />
!Работает с MTA: SA?<br />
|-<br />
|[http://store.steampowered.com/app/12120/ Steam]<br />
|Внимание: Grand Theft Auto: San Andreas больше не доступна в магазине Steam.Специализированная Steam-версия игры. Установщик MTA произведет даунгрейд (понижение) версии игры. <br />
|{{Yes|Да}}<br />
|-<br />
| rowspan="2" |[http://www.amazon.com/Grand-Theft-Auto-Andreas-Download/dp/B006YVXGJQ Amazon]<br />
| Для '''Standard''' издания игры, если MTA несовместима, попробуйте найти GTA SA 1.00 No CD - любой релиз от HOODLUM будет функционировать без проблем.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
| Steam-версия и копии дисков GTASA будут функционировать нормально<br />
| {{Yes| Да (Steam/DVD-бокс)}}<br />
|-<br />
|[http://www.gamersgate.co.uk/DD-GTASAS/grand-theft-auto-san-andreas GamersGate]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.game.co.uk/en/grand-theft-auto-san-andreas-301403 Game UK]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://digital.gamefly.co.uk/#!/download-grand-theft-auto-san-andreas/5006365 GameFly Digital]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.greenmangaming.com/s/gb/en/pc/games/action/grand-theft-auto-san-andreas/ GreenManGaming]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.gamestop.com/pc/games/grand-theft-auto-san-andreas/37409 GameStop]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.walmart.com/ip/Take-Two-GTASAESD-Grand-Theft-Auto-San-Andreas-PC/36754297 Walmart]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[https://www.ebay.com/sch/i.html?_from=R40&_trksid=p4432023.m570.l1313&_nkw=GTA%3ASA&_sacat=0 Ebay]<br />
|Доступна к покупке (Нужна версия ПК).<br />
|{{Yes|Да}}<br />
|-<br />
|Windows App Store<br />
|Мобильная версия игры, перенесенная на ПК. '''Никогда не будет работать с MTA'''.<br />
|{{No|Нет}}<br />
|-<br />
<br />
[[en:Where to buy GTASA]]<br />
[[es:Dónde comprar GTA: SA]]<br />
[[uk:Where to buy GTASA]]<br />
[[pl:Where to buy GTASA]]<br />
[[tr:GTA:SA Nerden Alınır]]<br />
[[zh-cn:在那里可以购买GTASA]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Where_to_buy_GTASA&diff=82448RU/Where to buy GTASA2025-09-06T13:28:12Z<p>Flox: </p>
<hr />
<div>На этой странице описывается общая совместимость версий Grand Theft Auto: San Andreas с MTA:SA, а также где их можно приобрести.<br />
<br />
=== Совместимость ===<br />
<br />
Если версия Grand Theft Auto: San Andreas, отмеченная ниже как совместимая, не работает, попробуйте переустановить MTA:SA. Если это не сработает, следуйте [https://forum.mtasa.com/topic/11757-patching-your-101-or-200-version-of-gta_saexe/ этим инструкциям]. Если это по-прежнему не сработает, пожалуйста, свяжитесь с нами на форуме [https://forum.mtasa.com/forum/83-client/] или присоединяйтесь к [https://mtasa.com/discord MTA Discord #help-support channel].<br />
<br />
{{Важное замечание|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' — это совершенно новая версия игры. Данная версия является '''несовместимой''' с MTA:SA.}}<br />
{{Важное замечание|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' — это совершенно новая версия игры. Данная версия является '''несовместимой''' c MTA:SA.}}<br />
<br />
=== Получение совместимых и бывших в употреблении копий ===<br />
<br />
Официально единственный способ приобрести совместимую копию Grand Theft Auto: San Andreas от Rockstar Games и Take-Two — это приобрести коллекцию classic collection [https://store.rockstargames.com/en/game/buy/grand-theft-auto-the-trilogy "Grand Theft Auto: Trilogy" (2005) в магазине Rockstar Store].<br />
<br />
Есть только два других варианта: либо приобрести подержанную физическую копию через блошиные рынки и частных посредников, либо приобрести ключ для совместимой цифровой версии у посредника по продаже ключей.<br />
<br />
Ярким примером покупки подержанной физической копии на сайтах, указанных ниже. Введя в поле поиска «gta san andreas pc» или «gta san andreas», вы сможете найти множество людей, которые все еще продают совместимую игру. Однако будьте осторожны, поскольку покупка у ненадежных реселлеров, таких как неизвестные люди, не занимающиеся бизнесом, сопряжена с риском (например, подделки или поврежденные копии).<br />
<br />
Чтобы найти продавца цифровых ключей, воспользуйтесь поисковой системой, чтобы найти «Grand Theft Auto: San Andreas key» или что-то подобное.<br />
<br />
<br />
=== Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. ===<br />
<br />
На этой странице перечислены некоторые веб-сайты, на которых можно купить Grand Theft Auto San Andreas в цифровом виде и играть в MTA:SA (иногда с автоматическим понижением версии игры). Не все из них были проверены, но все должно работать без проблем. Если нет, пожалуйста, обратитесь в службу поддержки.<br />
<br />
Известно, что все версии (DVD) GTA:SA для Windows функционируют нормально. Если вы планируете покупать DVD-диск GTA:SA, вам следует попытаться получить "Standard" версию, а не "Second Edition" или "Greatest Hits" издания, хотя они будут работать нормально.<br />
<br />
{| class="wikitable" style="width: 900px; text-align: center; table-layout: fixed;"<br />
|-<br />
!Ритейлер<br />
!Примечания<br />
!Работает с MTA: SA?<br />
|-<br />
|[http://store.steampowered.com/app/12120/ Steam]<br />
|Внимание: Grand Theft Auto: San Andreas больше не доступна в магазине Steam.Специализированная Steam-версия игры. Установщик MTA произведет даунгрейд (понижение) версии игры. <br />
|{{Yes|Да}}<br />
|-<br />
| rowspan="2" |[http://www.amazon.com/Grand-Theft-Auto-Andreas-Download/dp/B006YVXGJQ Amazon]<br />
| Для '''Standard''' издания игры, если MTA несовместима, попробуйте найти GTA SA 1.00 No CD - любой релиз от HOODLUM будет функционировать без проблем.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
| Steam-версия и копии дисков GTASA будут функционировать нормально<br />
| {{Yes| Да (Steam/DVD-бокс)}}<br />
|-<br />
|[http://www.gamersgate.co.uk/DD-GTASAS/grand-theft-auto-san-andreas GamersGate]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.game.co.uk/en/grand-theft-auto-san-andreas-301403 Game UK]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://digital.gamefly.co.uk/#!/download-grand-theft-auto-san-andreas/5006365 GameFly Digital]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.greenmangaming.com/s/gb/en/pc/games/action/grand-theft-auto-san-andreas/ GreenManGaming]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.gamestop.com/pc/games/grand-theft-auto-san-andreas/37409 GameStop]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.walmart.com/ip/Take-Two-GTASAESD-Grand-Theft-Auto-San-Andreas-PC/36754297 Walmart]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[https://www.ebay.com/sch/i.html?_from=R40&_trksid=p4432023.m570.l1313&_nkw=GTA%3ASA&_sacat=0 Ebay]<br />
|Доступна к покупке (Нужна версия ПК).<br />
|{{Yes|Да}}<br />
|-<br />
|Windows App Store<br />
|Мобильная версия игры, перенесенная на ПК. '''Никогда не будет работать с MTA'''.<br />
|{{No|Нет}}<br />
|-<br />
<br />
[[en:Where to buy GTASA]]<br />
[[es:Dónde comprar GTA: SA]]<br />
[[uk:Where to buy GTASA]]<br />
[[pl:Where to buy GTASA]]<br />
[[tr:GTA:SA Nerden Alınır]]<br />
[[zh-cn:在那里可以购买GTASA]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Where_to_buy_GTASA&diff=82447RU/Where to buy GTASA2025-09-06T13:27:41Z<p>Flox: </p>
<hr />
<div>На этой странице описывается общая совместимость версий Grand Theft Auto: San Andreas с MTA:SA, а также где их можно приобрести.<br />
<br />
=== Совместимость ===<br />
<br />
Если версия Grand Theft Auto: San Andreas, отмеченная ниже как совместимая, не работает, попробуйте переустановить MTA:SA. Если это не сработает, следуйте [https://forum.mtasa.com/topic/11757-patching-your-101-or-200-version-of-gta_saexe/ этим инструкциям]. Если это по-прежнему не сработает, пожалуйста, свяжитесь с нами на форуме [https://forum.mtasa.com/forum/83-client/] или присоединяйтесь к [https://mtasa.com/discord MTA Discord #help-support channel].<br />
<br />
{{Важное замечание|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' — это совершенно новая версия игры. Данная версия является '''несовместимой''' с MTA:SA.}}<br />
{{Important Note|Grand Theft Auto: San Andreas as part of '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' is an entirely new release of the game. This version is '''not compatible''' with MTA:SA.}}<br />
<br />
=== Получение совместимых и бывших в употреблении копий ===<br />
<br />
Официально единственный способ приобрести совместимую копию Grand Theft Auto: San Andreas от Rockstar Games и Take-Two — это приобрести коллекцию classic collection [https://store.rockstargames.com/en/game/buy/grand-theft-auto-the-trilogy "Grand Theft Auto: Trilogy" (2005) в магазине Rockstar Store].<br />
<br />
Есть только два других варианта: либо приобрести подержанную физическую копию через блошиные рынки и частных посредников, либо приобрести ключ для совместимой цифровой версии у посредника по продаже ключей.<br />
<br />
Ярким примером покупки подержанной физической копии на сайтах, указанных ниже. Введя в поле поиска «gta san andreas pc» или «gta san andreas», вы сможете найти множество людей, которые все еще продают совместимую игру. Однако будьте осторожны, поскольку покупка у ненадежных реселлеров, таких как неизвестные люди, не занимающиеся бизнесом, сопряжена с риском (например, подделки или поврежденные копии).<br />
<br />
Чтобы найти продавца цифровых ключей, воспользуйтесь поисковой системой, чтобы найти «Grand Theft Auto: San Andreas key» или что-то подобное.<br />
<br />
<br />
=== Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. ===<br />
<br />
На этой странице перечислены некоторые веб-сайты, на которых можно купить Grand Theft Auto San Andreas в цифровом виде и играть в MTA:SA (иногда с автоматическим понижением версии игры). Не все из них были проверены, но все должно работать без проблем. Если нет, пожалуйста, обратитесь в службу поддержки.<br />
<br />
Известно, что все версии (DVD) GTA:SA для Windows функционируют нормально. Если вы планируете покупать DVD-диск GTA:SA, вам следует попытаться получить "Standard" версию, а не "Second Edition" или "Greatest Hits" издания, хотя они будут работать нормально.<br />
<br />
{| class="wikitable" style="width: 900px; text-align: center; table-layout: fixed;"<br />
|-<br />
!Ритейлер<br />
!Примечания<br />
!Работает с MTA: SA?<br />
|-<br />
|[http://store.steampowered.com/app/12120/ Steam]<br />
|Внимание: Grand Theft Auto: San Andreas больше не доступна в магазине Steam.Специализированная Steam-версия игры. Установщик MTA произведет даунгрейд (понижение) версии игры. <br />
|{{Yes|Да}}<br />
|-<br />
| rowspan="2" |[http://www.amazon.com/Grand-Theft-Auto-Andreas-Download/dp/B006YVXGJQ Amazon]<br />
| Для '''Standard''' издания игры, если MTA несовместима, попробуйте найти GTA SA 1.00 No CD - любой релиз от HOODLUM будет функционировать без проблем.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
| Steam-версия и копии дисков GTASA будут функционировать нормально<br />
| {{Yes| Да (Steam/DVD-бокс)}}<br />
|-<br />
|[http://www.gamersgate.co.uk/DD-GTASAS/grand-theft-auto-san-andreas GamersGate]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.game.co.uk/en/grand-theft-auto-san-andreas-301403 Game UK]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://digital.gamefly.co.uk/#!/download-grand-theft-auto-san-andreas/5006365 GameFly Digital]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.greenmangaming.com/s/gb/en/pc/games/action/grand-theft-auto-san-andreas/ GreenManGaming]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.gamestop.com/pc/games/grand-theft-auto-san-andreas/37409 GameStop]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.walmart.com/ip/Take-Two-GTASAESD-Grand-Theft-Auto-San-Andreas-PC/36754297 Walmart]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[https://www.ebay.com/sch/i.html?_from=R40&_trksid=p4432023.m570.l1313&_nkw=GTA%3ASA&_sacat=0 Ebay]<br />
|Доступна к покупке (Нужна версия ПК).<br />
|{{Yes|Да}}<br />
|-<br />
|Windows App Store<br />
|Мобильная версия игры, перенесенная на ПК. '''Никогда не будет работать с MTA'''.<br />
|{{No|Нет}}<br />
|-<br />
<br />
[[en:Where to buy GTASA]]<br />
[[es:Dónde comprar GTA: SA]]<br />
[[uk:Where to buy GTASA]]<br />
[[pl:Where to buy GTASA]]<br />
[[tr:GTA:SA Nerden Alınır]]<br />
[[zh-cn:在那里可以购买GTASA]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Where_to_buy_GTASA&diff=82446RU/Where to buy GTASA2025-09-06T13:26:24Z<p>Flox: </p>
<hr />
<div>На этой странице описывается общая совместимость версий Grand Theft Auto: San Andreas с MTA:SA, а также где их можно приобрести.<br />
<br />
=== Совместимость ===<br />
<br />
Если версия Grand Theft Auto: San Andreas, отмеченная ниже как совместимая, не работает, попробуйте переустановить MTA:SA. Если это не сработает, следуйте [https://forum.mtasa.com/topic/11757-patching-your-101-or-200-version-of-gta_saexe/ этим инструкциям]. Если это по-прежнему не сработает, пожалуйста, свяжитесь с нами на форуме [https://forum.mtasa.com/forum/83-client/] или присоединяйтесь к [https://mtasa.com/discord MTA Discord #help-support channel].<br />
<br />
{{Важное замечание|Grand Theft Auto: San Andreas как часть '''Grand Theft Auto: The Trilogy – The Definitive Edition''' ''(2021)'' — это совершенно новая версия игры. Данная версия является '''несовместимой''' с MTA:SA.}}<br />
<br />
=== Получение совместимых и бывших в употреблении копий ===<br />
<br />
Официально единственный способ приобрести совместимую копию Grand Theft Auto: San Andreas от Rockstar Games и Take-Two — это приобрести коллекцию classic collection [https://store.rockstargames.com/en/game/buy/grand-theft-auto-the-trilogy "Grand Theft Auto: Trilogy" (2005) в магазине Rockstar Store].<br />
<br />
Есть только два других варианта: либо приобрести подержанную физическую копию через блошиные рынки и частных посредников, либо приобрести ключ для совместимой цифровой версии у посредника по продаже ключей.<br />
<br />
Ярким примером покупки подержанной физической копии на сайтах, указанных ниже. Введя в поле поиска «gta san andreas pc» или «gta san andreas», вы сможете найти множество людей, которые все еще продают совместимую игру. Однако будьте осторожны, поскольку покупка у ненадежных реселлеров, таких как неизвестные люди, не занимающиеся бизнесом, сопряжена с риском (например, подделки или поврежденные копии).<br />
<br />
Чтобы найти продавца цифровых ключей, воспользуйтесь поисковой системой, чтобы найти «Grand Theft Auto: San Andreas key» или что-то подобное.<br />
<br />
<br />
=== Прежде чем рассматривать возможность покупки, оцените, какие источники являются надежными, и убедитесь, что ключ будет работать в вашем регионе. ===<br />
<br />
На этой странице перечислены некоторые веб-сайты, на которых можно купить Grand Theft Auto San Andreas в цифровом виде и играть в MTA:SA (иногда с автоматическим понижением версии игры). Не все из них были проверены, но все должно работать без проблем. Если нет, пожалуйста, обратитесь в службу поддержки.<br />
<br />
Известно, что все версии (DVD) GTA:SA для Windows функционируют нормально. Если вы планируете покупать DVD-диск GTA:SA, вам следует попытаться получить "Standard" версию, а не "Second Edition" или "Greatest Hits" издания, хотя они будут работать нормально.<br />
<br />
{| class="wikitable" style="width: 900px; text-align: center; table-layout: fixed;"<br />
|-<br />
!Ритейлер<br />
!Примечания<br />
!Работает с MTA: SA?<br />
|-<br />
|[http://store.steampowered.com/app/12120/ Steam]<br />
|Внимание: Grand Theft Auto: San Andreas больше не доступна в магазине Steam.Специализированная Steam-версия игры. Установщик MTA произведет даунгрейд (понижение) версии игры. <br />
|{{Yes|Да}}<br />
|-<br />
| rowspan="2" |[http://www.amazon.com/Grand-Theft-Auto-Andreas-Download/dp/B006YVXGJQ Amazon]<br />
| Для '''Standard''' издания игры, если MTA несовместима, попробуйте найти GTA SA 1.00 No CD - любой релиз от HOODLUM будет функционировать без проблем.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
| Steam-версия и копии дисков GTASA будут функционировать нормально<br />
| {{Yes| Да (Steam/DVD-бокс)}}<br />
|-<br />
|[http://www.gamersgate.co.uk/DD-GTASAS/grand-theft-auto-san-andreas GamersGate]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.game.co.uk/en/grand-theft-auto-san-andreas-301403 Game UK]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://digital.gamefly.co.uk/#!/download-grand-theft-auto-san-andreas/5006365 GameFly Digital]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.greenmangaming.com/s/gb/en/pc/games/action/grand-theft-auto-san-andreas/ GreenManGaming]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.gamestop.com/pc/games/grand-theft-auto-san-andreas/37409 GameStop]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.walmart.com/ip/Take-Two-GTASAESD-Grand-Theft-Auto-San-Andreas-PC/36754297 Walmart]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[https://www.ebay.com/sch/i.html?_from=R40&_trksid=p4432023.m570.l1313&_nkw=GTA%3ASA&_sacat=0 Ebay]<br />
|Доступна к покупке (Нужна версия ПК).<br />
|{{Yes|Да}}<br />
|-<br />
|Windows App Store<br />
|Мобильная версия игры, перенесенная на ПК. '''Никогда не будет работать с MTA'''.<br />
|{{No|Нет}}<br />
|-<br />
<br />
[[en:Where to buy GTASA]]<br />
[[es:Dónde comprar GTA: SA]]<br />
[[uk:Where to buy GTASA]]<br />
[[pl:Where to buy GTASA]]<br />
[[tr:GTA:SA Nerden Alınır]]<br />
[[zh-cn:在那里可以购买GTASA]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Resource:Hedit&diff=82190Resource:Hedit2025-07-01T20:58:31Z<p>Flox: </p>
<hr />
<div>{{Resource page}}<br />
The MTA Ingame Handling Editor (known as 'hedit') is an open source resource that was created in 2010 and has been included in the official MTA resources package since 2021.<br />
<br />
You can see and download the latest version on the Hedit page of [https://github.com/multitheftauto/mtasa-resources/tree/master/%5Bgameplay%5D/hedit official resources '''GitHub repository'''] or download it directly from the latest package at https://mirror-cdn.multitheftauto.com/mtasa/resources/mtasa-resources-latest.zip. <br><br><br />
<br />
'''[https://forum.mtasa.com/topic/25539-hedit-mta-ingame-handling-editor-v214/ Be sure to see the Hedit forum topic for all information!]'''<br />
<br />
[https://github.com/multitheftauto/mtasa-resources/tree/master/%5Bgameplay%5D/hedit GitHub repository] - See and get the latest changes here.<br><br />
[https://forum.mtasa.com/topic/25539-hedit-mta-ingame-handling-editor-v214/ Official Forum Topic] - The place for discussing this project.<br><br />
[http://www.youtube.com/user/SilentStrikeMTA?feature=mhsn#p/p Youtube playlist] - Full playlist of several development video's of the handling editor.</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Where_to_buy_GTASA&diff=79372RU/Where to buy GTASA2024-05-22T18:40:59Z<p>Flox: </p>
<hr />
<div>На этой странице перечислены некоторые веб-сайты, на которых можно купить Grand Theft Auto San Andreas в цифровом виде и играть в MTASA (иногда с автоматическим понижением версии игры). Не все из них были проверены, но все должно работать без проблем. Если нет, пожалуйста, обратитесь в службу поддержки.<br />
<br />
Известно, что все версии (DVD) GTASA для Windows функционируют нормально. Если вы планируете покупать DVD-диск GTASA, вам следует попытаться получить "Standard" версию, а не "Second Edition" или "Greatest Hits" издания, хотя они будут работать нормально.<br />
<br />
{| class="wikitable" style="width: 900px; text-align: center; table-layout: fixed;"<br />
|-<br />
!Ритейлер<br />
!Примечания<br />
!Работает с MTA: SA?<br />
|-<br />
|[http://store.steampowered.com/app/12120/ Steam]<br />
|Внимание: Grand Theft Auto: San Andreas больше не доступна в магазине Steam.Специализированная Steam-версия игры. Установщик MTA произведет даунгрейд (понижение) версии игры. <br />
|{{Yes|Да}}<br />
|-<br />
| rowspan="2" |[http://www.amazon.com/Grand-Theft-Auto-Andreas-Download/dp/B006YVXGJQ Amazon]<br />
| Для '''Standard''' издания игры, если MTA несовместима, попробуйте найти GTA SA 1.00 No CD - любой релиз от HOODLUM будет функционировать без проблем.<br />
| {{Partial|Не подтверждено (Standard)}}<br />
|-<br />
| Steam-версия и копии дисков GTASA будут функционировать нормально<br />
| {{Yes| Да (Steam/DVD-бокс)}}<br />
|-<br />
|[http://www.gamersgate.co.uk/DD-GTASAS/grand-theft-auto-san-andreas GamersGate]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.game.co.uk/en/grand-theft-auto-san-andreas-301403 Game UK]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://digital.gamefly.co.uk/#!/download-grand-theft-auto-san-andreas/5006365 GameFly Digital]<br />
|К сожалению, данная страница больше не доступна. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.greenmangaming.com/s/gb/en/pc/games/action/grand-theft-auto-san-andreas/ GreenManGaming]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.gamestop.com/pc/games/grand-theft-auto-san-andreas/37409 GameStop]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[http://www.walmart.com/ip/Take-Two-GTASAESD-Grand-Theft-Auto-San-Andreas-PC/36754297 Walmart]<br />
|К сожалению, этот сайт недоступен в вашем регионе. <br />
|{{Yes|Да}}<br />
|-<br />
|[https://www.ebay.com/sch/i.html?_from=R40&_trksid=p4432023.m570.l1313&_nkw=GTA%3ASA&_sacat=0 Ebay]<br />
|Доступна к покупке (Нужна версия ПК).<br />
|{{Yes|Да}}<br />
|-<br />
|Windows App Store<br />
|Мобильная версия игры, перенесенная на ПК. '''Никогда не будет работать с MTA'''.<br />
|{{No|Нет}}<br />
|-<br />
<br />
[[en:Where to buy GTASA]]<br />
[[es:Dónde comprar GTA: SA]]<br />
[[uk:Where to buy GTASA]]<br />
[[pl:Where to buy GTASA]]<br />
[[tr:GTA:SA Nerden Alınır]]<br />
[[zh-cn:在那里可以购买GTASA]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=OOP&diff=79364OOP2024-05-21T15:54:35Z<p>Flox: </p>
<hr />
<div>Object Orientated Programming was introduced in MTA:SA 1.4 and comes with special utility classes like [[Vector]] and [[Matrix]]. This page contains general information about the OOP functions and provides useful links.<br />
<br />
== Turning it on ==<br />
By default, OOP is disabled (however, vectors and matrices are always available) - this is mainly because the vast majority of servers will prefer to stick to what they know - procedural programming. In fact, functions are still available even when OOP is enabled. Enabling OOP is as simple as adding the following line to the resource meta file:<br />
<syntaxhighlight lang="xml"><oop>true</oop></syntaxhighlight><br />
<br />
== Vectors and Matrices ==<br />
[[Vector|Vectors]] and [[Matrix|Matrices]] make it easier to drop the complex maths and go straight ahead with fun part of maths. As mentioned above, OOP does not have to be enabled in the server config for this to be enabled.<br />
<br />
==ADVANCED: OOP Metatable Structure==<br />
You will understand this if you're proficient with Lua and have a decent understanding of metatables. Understanding this section is not necessary to use OOP.<br />
<syntaxhighlight lang="lua"><br />
-- Exposed to global environment<br />
Element = {<br />
Element = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
Vehicle = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Hidden in lua registry, applied to userdata<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__call = __class.create,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__call = __class.create,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight><br />
<br />
== Useful Links ==<br />
* '''[[OOP Introduction]]''' - teaches you about the basics of OOP<br />
* '''[[OOP_client|Function list (client)]]''' and '''[[OOP_server|Function list (server)]]''' - a list of functions implemented<br />
<br />
[[Category:OOP]]<br />
[[Category:Incomplete]]<br />
[[Category:Tutorials]]<br />
<br />
[[Ru/OOP]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=OOP&diff=79363OOP2024-05-21T15:54:14Z<p>Flox: </p>
<hr />
<div>Object Orientated Programming was introduced in MTA:SA 1.4 and comes with special utility classes like [[Vector]] and [[Matrix]]. This page contains general information about the OOP functions and provides useful links.<br />
<br />
== Turning it on ==<br />
By default, OOP is disabled (however, vectors and matrices are always available) - this is mainly because the vast majority of servers will prefer to stick to what they know - procedural programming. In fact, functions are still available even when OOP is enabled. Enabling OOP is as simple as adding the following line to the resource meta file:<br />
<syntaxhighlight lang="xml"><oop>true</oop></syntaxhighlight><br />
<br />
== Vectors and Matrices ==<br />
[[Vector|Vectors]] and [[Matrix|Matrices]] make it easier to drop the complex maths and go straight ahead with fun part of maths. As mentioned above, OOP does not have to be enabled in the server config for this to be enabled.<br />
<br />
==ADVANCED: OOP Metatable Structure==<br />
You will understand this if you're proficient with Lua and have a decent understanding of metatables. Understanding this section is not necessary to use OOP.<br />
<syntaxhighlight lang="lua"><br />
-- Exposed to global environment<br />
Element = {<br />
Element = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
Vehicle = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Hidden in lua registry, applied to userdata<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__call = __class.create,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__call = __class.create,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight><br />
<br />
== Useful Links ==<br />
* '''[[OOP Introduction]]''' - teaches you about the basics of OOP<br />
* '''[[OOP_client|Function list (client)]]''' and '''[[OOP_server|Function list (server)]]''' - a list of functions implemented<br />
<br />
[[Category:OOP]]<br />
[[Category:Incomplete]]<br />
[[Category:Tutorials]]<br />
<br />
[[ru:OOP]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=OOP&diff=79362OOP2024-05-21T15:54:02Z<p>Flox: </p>
<hr />
<div>Object Orientated Programming was introduced in MTA:SA 1.4 and comes with special utility classes like [[Vector]] and [[Matrix]]. This page contains general information about the OOP functions and provides useful links.<br />
<br />
== Turning it on ==<br />
By default, OOP is disabled (however, vectors and matrices are always available) - this is mainly because the vast majority of servers will prefer to stick to what they know - procedural programming. In fact, functions are still available even when OOP is enabled. Enabling OOP is as simple as adding the following line to the resource meta file:<br />
<syntaxhighlight lang="xml"><oop>true</oop></syntaxhighlight><br />
<br />
== Vectors and Matrices ==<br />
[[Vector|Vectors]] and [[Matrix|Matrices]] make it easier to drop the complex maths and go straight ahead with fun part of maths. As mentioned above, OOP does not have to be enabled in the server config for this to be enabled.<br />
<br />
==ADVANCED: OOP Metatable Structure==<br />
You will understand this if you're proficient with Lua and have a decent understanding of metatables. Understanding this section is not necessary to use OOP.<br />
<syntaxhighlight lang="lua"><br />
-- Exposed to global environment<br />
Element = {<br />
Element = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
Vehicle = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Hidden in lua registry, applied to userdata<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__call = __class.create,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__call = __class.create,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight><br />
<br />
== Useful Links ==<br />
* '''[[OOP Introduction]]''' - teaches you about the basics of OOP<br />
* '''[[OOP_client|Function list (client)]]''' and '''[[OOP_server|Function list (server)]]''' - a list of functions implemented<br />
<br />
[[Category:OOP]]<br />
[[Category:Incomplete]]<br />
[[Category:Tutorials]]<br />
<br />
[[ru:OOP Russian]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Ru/OOP&diff=79361Ru/OOP2024-05-21T15:50:47Z<p>Flox: </p>
<hr />
<div>Объектно-ориентированное программирование было введено в MTA:SA 1.4 и поставляется со специальными служебными классами, такими как [[Vector]] и [[Matrix]]. Эта страница содержит общую информацию о функциях OOP и содержит полезные ссылки.<br />
<br />
== Включение ==<br />
По умолчанию ООП отключено (однако векторы и матрицы доступны всегда) - это происходит главным образом потому, что подавляющее большинство серверов предпочитают придерживаться того, что они знают, - процедурного программирования. На самом деле, функции по-прежнему доступны, даже если ООП включено. Включить ООП так же просто, как добавить следующую строку в мета-файл ресурса:<br />
<syntaxhighlight lang="xml"><oop>true</oop></syntaxhighlight><br />
<br />
== Векторы и матрицы ==<br />
[[Vector|Vectors]] и [[Matrix|Matrices]] так будет проще отказаться от сложной математики и сразу перейти к увлекательной ее части. Как упоминалось выше, для этого необязательно включать OOP в конфигурации сервера.<br />
<br />
==ДОПОЛНИТЕЛЬНО: Метастабильная структура OOP ==<br />
Вы поймете это, если хорошо владеете Lua и хорошо разбираетесь в метатаблях. Понимание этого раздела не обязательно для использования OOP.<br />
<syntaxhighlight lang="lua"><br />
-- Подвержен воздействию глобальной окружающей среды<br />
Element = {<br />
Element = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
Vehicle = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Скрыто в реестре lua, применяется к пользовательским данным<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__call = __class.create,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__call = __class.create,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight><br />
<br />
== Полезные ссылки ==<br />
* '''[[OOP Introduction]]''' - познакомит вас с основами OOP<br />
* '''[[OOP_client|Function list (client)]]''' и '''[[OOP_server|Function list (server)]]''' - список реализованных функций<br />
<br />
== Выше предоставлены страницы с полезными ссылками на английском языке. ==<br />
<br />
[[Category:OOP]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Ru/OOP&diff=79360Ru/OOP2024-05-21T15:50:34Z<p>Flox: </p>
<hr />
<div>Объектно-ориентированное программирование было введено в MTA:SA 1.4 и поставляется со специальными служебными классами, такими как [[Vector]] и [[Matrix]]. Эта страница содержит общую информацию о функциях OOP и содержит полезные ссылки.<br />
<br />
== Включение ==<br />
По умолчанию ООП отключено (однако векторы и матрицы доступны всегда) - это происходит главным образом потому, что подавляющее большинство серверов предпочитают придерживаться того, что они знают, - процедурного программирования. На самом деле, функции по-прежнему доступны, даже если ООП включено. Включить ООП так же просто, как добавить следующую строку в мета-файл ресурса:<br />
<syntaxhighlight lang="xml"><oop>true</oop></syntaxhighlight><br />
<br />
== Векторы и матрицы ==<br />
[[Vector|Vectors]] и [[Matrix|Matrices]] так будет проще отказаться от сложной математики и сразу перейти к увлекательной ее части. Как упоминалось выше, для этого необязательно включать OOP в конфигурации сервера.<br />
<br />
==ДОПОЛНИТЕЛЬНО: Метастабильная структура OOP ==<br />
Вы поймете это, если хорошо владеете Lua и хорошо разбираетесь в метатаблях. Понимание этого раздела не обязательно для использования OOP.<br />
<syntaxhighlight lang="lua"><br />
-- Подвержен воздействию глобальной окружающей среды<br />
Element = {<br />
Element = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
Vehicle = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Скрыто в реестре lua, применяется к пользовательским данным<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__call = __class.create,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__call = __class.create,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight><br />
<br />
== Полезные ссылки ==<br />
* '''[[OOP Introduction]]''' - познакомит вас с основами OOP<br />
* '''[[OOP_client|Function list (client)]]''' и '''[[OOP_server|Function list (server)]]''' - список реализованных функций<br />
<br />
== Выше предоставлены страницы с полезными ссылками на английском языке. ==<br />
<br />
[[Category:OOP]]<br />
<br />
[[OOP English]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=Ru/OOP&diff=79359Ru/OOP2024-05-21T15:49:28Z<p>Flox: </p>
<hr />
<div>Объектно-ориентированное программирование было введено в MTA:SA 1.4 и поставляется со специальными служебными классами, такими как [[Vector]] и [[Matrix]]. Эта страница содержит общую информацию о функциях OOP и содержит полезные ссылки.<br />
<br />
== Включение ==<br />
По умолчанию ООП отключено (однако векторы и матрицы доступны всегда) - это происходит главным образом потому, что подавляющее большинство серверов предпочитают придерживаться того, что они знают, - процедурного программирования. На самом деле, функции по-прежнему доступны, даже если ООП включено. Включить ООП так же просто, как добавить следующую строку в мета-файл ресурса:<br />
<syntaxhighlight lang="xml"><oop>true</oop></syntaxhighlight><br />
<br />
== Векторы и матрицы ==<br />
[[Vector|Vectors]] и [[Matrix|Matrices]] так будет проще отказаться от сложной математики и сразу перейти к увлекательной ее части. Как упоминалось выше, для этого необязательно включать OOP в конфигурации сервера.<br />
<br />
==ДОПОЛНИТЕЛЬНО: Метастабильная структура OOP ==<br />
Вы поймете это, если хорошо владеете Lua и хорошо разбираетесь в метатаблях. Понимание этого раздела не обязательно для использования OOP.<br />
<syntaxhighlight lang="lua"><br />
-- Подвержен воздействию глобальной окружающей среды<br />
Element = {<br />
Element = createElement,<br />
setPosition = setElementPosition,<br />
...<br />
}<br />
<br />
Vehicle = {<br />
Vehicle = createVehicle,<br />
setColor = setVehicleColor,<br />
...<br />
}<br />
<br />
-- Скрыто в реестре lua, применяется к пользовательским данным<br />
ElementMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Element,<br />
__call = __class.create,<br />
__set = {<br />
type = CLuaClassDefs::ReadOnly,<br />
health = setElementHealth,<br />
...<br />
},<br />
__get = {<br />
type = getElementType,<br />
health = getElementHealth,<br />
...<br />
},<br />
}<br />
<br />
VehicleMT = {<br />
__index = CLuaClassDefs::Index,<br />
__newindex = CLuaClassDefs::NewIndex,<br />
__class = Vehicle,<br />
__parent = ElementMT,<br />
__call = __class.create,<br />
__set = {<br />
damageProof = setVehicleDamageProof<br />
...<br />
},<br />
__get = {<br />
damageProof = isVehicleDamageProof<br />
...<br />
},<br />
}<br />
</syntaxhighlight><br />
<br />
== Полезные ссылки ==<br />
* '''[[OOP Introduction]]''' - познакомит вас с основами OOP<br />
* '''[[OOP_client|Function list (client)]]''' и '''[[OOP_server|Function list (server)]]''' - список реализованных функций<br />
<br />
== Выше предоставлены страницы с полезными ссылками на английском языке. ==<br />
<br />
[[Category:OOP]]<br />
<br />
[[https://wiki.multitheftauto.com/wiki/OOP|en:OOP English]]</div>Floxhttps://wiki.multitheftauto.com/index.php?title=RU/Meta.xml&diff=79358RU/Meta.xml2024-05-21T15:47:18Z<p>Flox: /* Тэги */</p>
<hr />
<div>Файл ''meta.xml'' представляет MTA набор метаданных, таких как название ресурса, включенные в него скрипты и какие файлы предварительно кэшировать для отправки клиенту, это лишь часть. В нем также объявляются "элементы" для дальнейшей работы с ними. Он написан в XML, который базируется на HTML, и является родителем XHTML.<br />
<br />
=Тэги=<br />
XML - текстовый формат данных, широко используемый для представления данных. MTA использует базирующийся на XML язык для описания метаданных ресурсов с использованием тегов ниже:<br />
<br />
*'''<info />''' Информация об этом ресурсе, возможные для включения параметры (любые произвольные параметры могут быть использованы и прочитаны с помощью [[getResourceInfo]]):<br />
** '''author:''' Автор данного ресурса<br />
** '''version:''' Версия ресурса<br />
** '''name:''' Название ресурса<br />
** '''description:''' Краткое описание ресурса<br />
** '''type:''' Тип ресурса, может быть "gamemode" (игровой режим, мод), "script" (сценарий, скрипт), "map" (карта) или "misc" (разное).<br />
*'''<script />''' Исходный код ресурса, возможные параметры:<br />
** '''src:''' Название файла с исходным кодом (скрипта)<br />
** '''type:''' Тип исходного кода: "client", "server" или "shared"<br />
** '''validate:''' Если установлено значение "false", то актуальность скрипта проверяться не будет.<br />
** '''cache:''' Кеширование для клиентского скрипта, если установлено "false", то скрипт не будет сохраняться на диске клиента.<br />
<!--<br />
** '''protected:''' Для клиентских скриптов, должен ли данный скрипт сохраняться на жестком диске клиента или нет: "true" (да) или "false" (нет). <br />
--><br />
*'''<map />''' Карта для мода, возможные параметры:<br />
**'''src:''' название .map-файла (может быть в т.ч. и путь, напр. "maps/filename.map")<br />
**'''dimension:''' Измерение, в котором карта будет загружена (опционально)<br />
*'''<file />''' Клиентский файл. В основном, это картинки, .txd, .col, .dff или .xml файлы. Они будут скачаны клиентами при старте ресурса (или при заходе)<br />
**'''src:''' название клиентского файла (может быть в т.ч. и путь, напр. "images/image.png")<br />
**'''download:''' Должен ли файл быть послан клиенту автоматически или нет (опционально). По умолчанию "true", использование "no" или "false" будет значить, что файл не будет послан при старте ресурса, но сможет быть задействован позже через [[downloadFile]] (с версии 1.4)<br />
*'''<include />''' Включение других ресурсов, которые будет использовать данный ресурс<br />
**'''resource:''' Название ресурса, который вы хотите чтоб стартовал с данным ресурсом<br />
**'''minversion:''' Минимальная версия, которая должна быть у '''ресурса''' (опционально)<br />
**'''maxversion:''' Максимальная версия, которая должна быть у '''ресурса''' (опционально)<br />
*'''<config />''' Конфигурационный файл (.xml), к которому будет иметь доступ ресурс, допустимые параметры:<br />
**'''src:''' Название конфигурационного файла<br />
**'''type:''' Тип конфигурационного файла: "client" или "server"<br />
*'''<export />''' Это экспортирует функции из данного ресурса, чтобы другие ресурсы могли ими пользоваться через [[call]]<br />
**'''function:''' Название функции<br />
**'''type''' Является ли экспортированная функция серверной или клиентской (допустимые значения: "client", "server" и "shared")<br />
**'''http:''' Может ли функция быть вызвана через HTTP (true/false)<br />
*'''<html />'''<br />
**'''src:''' Название HTTP-файла (может быть и путем)<br />
**'''default:''' Является ли html-файл тем, который будет показан по умолчанию при заходе в /имяРесурса/ на сервере. Только один html может быть по умолчанию, все остальные игнорируются. (true/false)<br />
**'''raw:''' Html-файл не анализируется Lua-интерпретатором и рассматривается как двоичные данные. Обязательно должно использоваться для двоичных файлов (в основном картинок) (true/false)<br />
*'''<settings> <setting name="" value=""/> </settings>:''' Большинство модов использует [[settings system]], чтобы позволить администраторам серверов настраивать его по их желанию. Например, вы можете установить время раунда, а затем воспользоваться [[get]] и [[set]] для получения или изменения значений соответственно.<br />
*'''<min_mta_version />''' Минимальная требуемая версия для правильной работы данного ресурса. При авторинге ресурсов, обычно минимальная версия должна быть установлена на в данный момент зарелиженную версию MTA:SA (на данный момент это "{{Current Version|full}}").<br />
**'''client:''' Минимальная версия клиента<br />
**'''server:''' Минимальная версия сервера<br />
*'''<aclrequest />''' Лист [[Access_Control_List|ACL]]-прав, которые понадобятся ресурсу.<br />
*'''<oop>true/false</oop>''' Пожалуйста, обратитесь к [[Ru/OOP|ООП]] за документацией<br />
{{New items|3.0139|1.3.1 r4141|<br />
*'''<sync_map_element_data />''' Контролирует, пересылаются ли [[Element_data|данные элементов]] карты, такие как "PosX" и "DoubleSided" клиенту. Эти данные зачастую не требуются большинству модов или ресурсов. (Но следует отметить значимое исключения - map editor). При установке параметра в meta.xml мода, настройка применится ко всем картам, загруженным данным ресурсом.<br />
**'''false:''' Отключить пересылку данных элементов карты. Это может значительно уменьшить время закачки карты.<br />
**'''true:''' Включить пересылку данных элементов карты (по умолчанию).<br />
}}<br />
<br />
== Пример ==<br />
Вот и пример meta-файла, использующего некоторые из упомянутых тегов:<br />
{{#tag:syntaxhighlight |<br />
<meta><br />
<info author="Slothman" type="gamemode" name="Stealth" /><br />
<config src="help.xml" type="client"/><br />
<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" /><br />
<br />
<script src="stealthmain_server.lua" /><br />
<script src="noiseblip.lua" /><br />
<script src="mission_timer.lua" /><br />
<script src="gadgets_server.lua" /><br />
<script src="gadgets_client.lua" type="client"/><br />
<script src="stealthmain_client.lua" type="client"/><br />
<script src="noisebar.lua" type="client"/><br />
<script src="spycam.lua" type="client"/><br />
<script src="riemann_z_demonstration.lua" type="client" cache="false"/><br />
<br />
<file src="riot_shield.txd" /><br />
<file src="riot_shield.dff" /><br />
<file src="riot_shield.col" /><br />
<file src="armor.png" download="true"/><br />
<file src="camera.png" download="false"/><br />
<file src="cloak.png" /><br />
<file src="goggles.png" /><br />
<file src="mine.png" /><br />
<file src="radar.png" /><br />
<file src="shield.png" /><br />
<br />
<include resource="scoreboard" /><br />
<include resource="killmessages" /><br />
<include resource="maplimits" /><br />
<br />
<br />
<export function="exampleExport1" type="server" /> <!-- Название ваших функций сервера --><br />
<export function="exampleExport2" type="client" /> <!-- Название ваших функций клиента --><br />
<export function="exampleExport3" type="shared" /> <!-- Название ваших функций конфига --><br />
<br />
<br />
<settings><br />
<setting name="roundlimit" value="[6]" /> <!-- длина раунда в минутах --><br />
<setting name="teamdamage" value="[1]" /> <!-- 0 для выключения командной защиты, 1 для включения --><br />
<setting name="teambalance" value="[1]" /> <!-- максимум разницы игроков между командами --><br />
<setting name="spazammo" value="[25]" /> <!-- количество патронов --><br />
<setting name="m4ammo" value="[100]" /><br />
<setting name="shotgunammo" value="[25]" /><br />
<setting name="sniperammo" value="[20]" /><br />
<setting name="ak47ammo" value="[120]" /><br />
<setting name="rifleammo" value="[40]" /><br />
<setting name="deserteagleammo" value="[45]" /><br />
<setting name="pistolammo" value="[132]" /><br />
<setting name="uziammo" value="[150]" /><br />
<setting name="tec9ammo" value="[150]" /><br />
<setting name="silencedammo" value="[65]" /><br />
<setting name="grenadeammo" value="[4]" /><br />
<setting name="satchelammo" value="[4]" /><br />
<setting name="teargasammo" value="[4]" /><br />
<setting name="molatovammo" value="[4]" /><br />
</settings><br />
<br />
<aclrequest><br />
<right name="function.startResource" access="true" /><br />
<right name="function.stopResource" access="true" /><br />
<right name="function.setPlayerMuted" access="true" /><br />
</aclrequest><br />
<br />
<sync_map_element_data>false</sync_map_element_data><br />
<br />
<oop>false</oop><br />
<br />
<download_priority_group>0</download_priority_group><br />
</meta><br />
|lang="xml"}}<br />
[[Category:Понятия скриптинга]]<br />
[[cs:Meta.xml]]<br />
[[de:Meta.xml]]<br />
[[en:Meta.xml]]<br />
[[es:Sobre el archivo "meta.xml"]]<br />
[[it:Meta.xml]]<br />
[[pl:Meta.xml]]</div>Flox