Multi Theft Auto: Wiki - User contributions [en]

EngineSetModelLODDistance

2025-02-02T16:00:20Z

TheNormalnij: /* Example */ These numbers have no sense there.

{{Client function}}
__NOTOC__
This function sets a custom LOD distance for any object / model ID. This is the distance at which objects of that model ID are switched to their LOD model, or (if there is no LOD model) become invisible.

'''Notes:'''
The actual draw distance used is modified by the draw distance slider in the settings 'Video' tab of the MTA client.

*When the 'Video' tab draw distance slider is 0%, the engineSetModelLODDistance setting approximately matches the draw distance used.
:''e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of '''100''' units.''

*When the 'Video' tab draw distance slider is 100%, the engineSetModelLODDistance setting is approximately doubled before use.
:''e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of '''200''' units.''

However, there is a general draw distance limit of 300 units. So engineSetModelLODDistance(1337,400) will mean model 1337 will be visible up to a distance of 300 units no matter what the 'Video' tab says.

Therefore, unless it's really important, engineSetModelLODDistance should not be set to anything greater than 170. 
170 will still give the maximum draw distance (of 300 units) on clients that have a 'Video' tab draw distance setting of 100%, and it will help reduce lag for players who chose a lower draw distance in their settings.

'''Note for low LOD [[object]]s''':
*The limit is 300 units, but the actual draw distance used is 5 times the setting value. Also, they ignore the 'Video' tab draw distance slider. So a setting of 200 will mean a low LOD element will always have a draw distance of '''1000''' units.

'''Note for low LOD [[building]]s''':
*The distance must be set greater than 300 for a low LOD building in order to work correctly. Otherwise, the low LOD will always be visible. The actual draw distance is NOT 5 times the setting value.

==Syntax==
<syntaxhighlight lang="lua">
bool engineSetModelLODDistance ( int model, float distance [, bool extendedLod = false ] )
</syntaxhighlight>
{{OOP||Engine.setModelLODDistance}}
===Required Arguments===
*'''model:''' The model / object ID number you want to change the LOD distance of.
*'''distance:''' New LOD distance value in San Andreas units.

===Optional Arguments===
{{OptionalArg}}
{{New feature/item|3.0161|1.6.0|22676|
*'''extendedLod:''' Allows to set a greater distance than the current 325 units.
}}

===Returns===
Returns ''true'' if the function executed succesfully, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
-- Cause massive lag by maxing out draw distance of all objects

local objectsTable = getElementsByType("object")

for i = 1, #objectsTable do
local objectElement = objectsTable[i]
local objectModel = getElementModel(objectElement)

engineSetModelLODDistance(objectModel, 300) -- Set maximum draw distance
end
</syntaxhighlight>

This example will, besides replacing with custom map objects, also set the LOD distance accordingly, a necessary step (otherwise the object could seem to fail loading and only show up 1 feet away)
<syntaxhighlight lang="lua">
function replaceObjects()

local col1 = engineLoadCOL("map1.col")
local col2 = engineLoadCOL("map2.col")

local txd = engineLoadTXD("map.txd")
engineImportTXD(txd, 2357)
engineImportTXD(txd, 2290)

local dff1 = engineLoadDFF("map1.dff")
local dff2 = engineLoadDFF("map2.dff")

engineReplaceCOL(col1, 2357)
engineReplaceCOL(col2, 2290)
engineReplaceModel(dff1, 2357)
engineReplaceModel(dff2, 2290)

engineSetModelLODDistance(2357, 300)
engineSetModelLODDistance(2290, 300)
end
</syntaxhighlight>

This example shows how to use LOD's with buildings
<syntaxhighlight lang="lua">
function createMyPyramid()
local pos = Vector3(0, 0, 3)
local rot = Vector3(0, 0, 0)

local modelHi = 8395 -- This model has a lot of polygons
local modelLow = 8701 -- This model is optimized for drawing at a long distance

-- Always call this function if you don't like default draw distance
-- or you allocated the model with using engineRequestModel
engineSetModelLODDistance(modelHi, 100, true)
engineSetModelLODDistance(modelLow, 500, true)

local lod = createBuilding(modelLow, pos, rot)
local building = createBuilding(modelHi, pos, rot)

setLowLODElement(building,lod)
end
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.6.0-9.22676|Added extendedLod argument}}

==See Also==
* [[getVehiclesLODDistance]]
* [[resetVehiclesLODDistance]]
* [[setVehiclesLODDistance]]
{{Engine_functions}}

EngineSetModelLODDistance

2025-02-02T15:47:27Z

TheNormalnij: /* Example */ fix typo

{{Client function}}
__NOTOC__
This function sets a custom LOD distance for any object / model ID. This is the distance at which objects of that model ID are switched to their LOD model, or (if there is no LOD model) become invisible.

'''Notes:'''
The actual draw distance used is modified by the draw distance slider in the settings 'Video' tab of the MTA client.

*When the 'Video' tab draw distance slider is 0%, the engineSetModelLODDistance setting approximately matches the draw distance used.
:''e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of '''100''' units.''

*When the 'Video' tab draw distance slider is 100%, the engineSetModelLODDistance setting is approximately doubled before use.
:''e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of '''200''' units.''

However, there is a general draw distance limit of 300 units. So engineSetModelLODDistance(1337,400) will mean model 1337 will be visible up to a distance of 300 units no matter what the 'Video' tab says.

Therefore, unless it's really important, engineSetModelLODDistance should not be set to anything greater than 170. 
170 will still give the maximum draw distance (of 300 units) on clients that have a 'Video' tab draw distance setting of 100%, and it will help reduce lag for players who chose a lower draw distance in their settings.

'''Note for low LOD [[object]]s''':
*The limit is 300 units, but the actual draw distance used is 5 times the setting value. Also, they ignore the 'Video' tab draw distance slider. So a setting of 200 will mean a low LOD element will always have a draw distance of '''1000''' units.

'''Note for low LOD [[building]]s''':
*The distance must be set greater than 300 for a low LOD building in order to work correctly. Otherwise, the low LOD will always be visible. The actual draw distance is NOT 5 times the setting value.

==Syntax==
<syntaxhighlight lang="lua">
bool engineSetModelLODDistance ( int model, float distance [, bool extendedLod = false ] )
</syntaxhighlight>
{{OOP||Engine.setModelLODDistance}}
===Required Arguments===
*'''model:''' The model / object ID number you want to change the LOD distance of.
*'''distance:''' New LOD distance value in San Andreas units.

===Optional Arguments===
{{OptionalArg}}
{{New feature/item|3.0161|1.6.0|22676|
*'''extendedLod:''' Allows to set a greater distance than the current 325 units.
}}

===Returns===
Returns ''true'' if the function executed succesfully, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
-- Cause massive lag by maxing out draw distance of all objects

local objectsTable = getElementsByType("object")

for i = 1, #objectsTable do
local objectElement = objectsTable[i]
local objectModel = getElementModel(objectElement)

engineSetModelLODDistance(objectModel, 300) -- Set maximum draw distance
end
</syntaxhighlight>

This example will, besides replacing with custom map objects, also set the LOD distance accordingly, a necessary step (otherwise the object could seem to fail loading and only show up 1 feet away)
<syntaxhighlight lang="lua">
function replaceObjects()

local col1 = engineLoadCOL("map1.col")
local col2 = engineLoadCOL("map2.col")

local txd = engineLoadTXD("map.txd")
engineImportTXD(txd, 2357)
engineImportTXD(txd, 2290)

local dff1 = engineLoadDFF("map1.dff")
local dff2 = engineLoadDFF("map2.dff")

engineReplaceCOL(col1, 2357)
engineReplaceCOL(col2, 2290)
engineReplaceModel(dff1, 2357)
engineReplaceModel(dff2, 2290)

engineSetModelLODDistance(2357, 2000)
engineSetModelLODDistance(2290, 2000)
end
</syntaxhighlight>

This example shows how to use LOD's with buildings
<syntaxhighlight lang="lua">
function createMyPyramid()
local pos = Vector3(0, 0, 3)
local rot = Vector3(0, 0, 0)

local modelHi = 8395 -- This model has a lot of polygons
local modelLow = 8701 -- This model is optimized for drawing at a long distance

-- Always call this function if you don't like default draw distance
-- or you allocated the model with using engineRequestModel
engineSetModelLODDistance(modelHi, 100, true)
engineSetModelLODDistance(modelLow, 500, true)

local lod = createBuilding(modelLow, pos, rot)
local building = createBuilding(modelHi, pos, rot)

setLowLODElement(building,lod)
end
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.6.0-9.22676|Added extendedLod argument}}

==See Also==
* [[getVehiclesLODDistance]]
* [[resetVehiclesLODDistance]]
* [[setVehiclesLODDistance]]
{{Engine_functions}}

EngineSetModelLODDistance

2025-02-02T15:46:58Z

TheNormalnij: /* Example */ Add an example for buildings

{{Client function}}
__NOTOC__
This function sets a custom LOD distance for any object / model ID. This is the distance at which objects of that model ID are switched to their LOD model, or (if there is no LOD model) become invisible.

'''Notes:'''
The actual draw distance used is modified by the draw distance slider in the settings 'Video' tab of the MTA client.

*When the 'Video' tab draw distance slider is 0%, the engineSetModelLODDistance setting approximately matches the draw distance used.
:''e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of '''100''' units.''

*When the 'Video' tab draw distance slider is 100%, the engineSetModelLODDistance setting is approximately doubled before use.
:''e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of '''200''' units.''

However, there is a general draw distance limit of 300 units. So engineSetModelLODDistance(1337,400) will mean model 1337 will be visible up to a distance of 300 units no matter what the 'Video' tab says.

Therefore, unless it's really important, engineSetModelLODDistance should not be set to anything greater than 170. 
170 will still give the maximum draw distance (of 300 units) on clients that have a 'Video' tab draw distance setting of 100%, and it will help reduce lag for players who chose a lower draw distance in their settings.

'''Note for low LOD [[object]]s''':
*The limit is 300 units, but the actual draw distance used is 5 times the setting value. Also, they ignore the 'Video' tab draw distance slider. So a setting of 200 will mean a low LOD element will always have a draw distance of '''1000''' units.

'''Note for low LOD [[building]]s''':
*The distance must be set greater than 300 for a low LOD building in order to work correctly. Otherwise, the low LOD will always be visible. The actual draw distance is NOT 5 times the setting value.

==Syntax==
<syntaxhighlight lang="lua">
bool engineSetModelLODDistance ( int model, float distance [, bool extendedLod = false ] )
</syntaxhighlight>
{{OOP||Engine.setModelLODDistance}}
===Required Arguments===
*'''model:''' The model / object ID number you want to change the LOD distance of.
*'''distance:''' New LOD distance value in San Andreas units.

===Optional Arguments===
{{OptionalArg}}
{{New feature/item|3.0161|1.6.0|22676|
*'''extendedLod:''' Allows to set a greater distance than the current 325 units.
}}

===Returns===
Returns ''true'' if the function executed succesfully, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
-- Cause massive lag by maxing out draw distance of all objects

local objectsTable = getElementsByType("object")

for i = 1, #objectsTable do
local objectElement = objectsTable[i]
local objectModel = getElementModel(objectElement)

engineSetModelLODDistance(objectModel, 300) -- Set maximum draw distance
end
</syntaxhighlight>

This example will, besides replacing with custom map objects, also set the LOD distance accordingly, a necessary step (otherwise the object could seem to fail loading and only show up 1 feet away)
<syntaxhighlight lang="lua">
function replaceObjects()

local col1 = engineLoadCOL("map1.col")
local col2 = engineLoadCOL("map2.col")

local txd = engineLoadTXD("map.txd")
engineImportTXD(txd, 2357)
engineImportTXD(txd, 2290)

local dff1 = engineLoadDFF("map1.dff")
local dff2 = engineLoadDFF("map2.dff")

engineReplaceCOL(col1, 2357)
engineReplaceCOL(col2, 2290)
engineReplaceModel(dff1, 2357)
engineReplaceModel(dff2, 2290)

engineSetModelLODDistance(2357, 2000)
engineSetModelLODDistance(2290, 2000)
end
</syntaxhighlight>

This example shows how to use LOD's with buildings
<syntaxhighlight lang="lua">
function createMyPiramid()
local pos = Vector3(0, 0, 3)
local rot = Vector3(0, 0, 0)

local modelHi = 8395 -- This model has a lot of polygons
local modelLow = 8701 -- This model is optimized for drawing at a long distance

-- Always call this function if you don't like default draw distance
-- or you allocated the model with using engineRequestModel
engineSetModelLODDistance(modelHi, 100, true)
engineSetModelLODDistance(modelLow, 500, true)

local lod = createBuilding(modelLow, pos, rot)
local building = createBuilding(modelHi, pos, rot)

setLowLODElement(building,lod)
end
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.6.0-9.22676|Added extendedLod argument}}

==See Also==
* [[getVehiclesLODDistance]]
* [[resetVehiclesLODDistance]]
* [[setVehiclesLODDistance]]
{{Engine_functions}}

EngineSetModelLODDistance

2025-02-02T15:33:26Z

TheNormalnij: 300 only for low lod

{{Client function}}
__NOTOC__
This function sets a custom LOD distance for any object / model ID. This is the distance at which objects of that model ID are switched to their LOD model, or (if there is no LOD model) become invisible.

'''Notes:'''
The actual draw distance used is modified by the draw distance slider in the settings 'Video' tab of the MTA client.

*When the 'Video' tab draw distance slider is 0%, the engineSetModelLODDistance setting approximately matches the draw distance used.
:''e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of '''100''' units.''

*When the 'Video' tab draw distance slider is 100%, the engineSetModelLODDistance setting is approximately doubled before use.
:''e.g. engineSetModelLODDistance(1337,100) will mean model 1337 will be visible up to a distance of '''200''' units.''

However, there is a general draw distance limit of 300 units. So engineSetModelLODDistance(1337,400) will mean model 1337 will be visible up to a distance of 300 units no matter what the 'Video' tab says.

Therefore, unless it's really important, engineSetModelLODDistance should not be set to anything greater than 170. 
170 will still give the maximum draw distance (of 300 units) on clients that have a 'Video' tab draw distance setting of 100%, and it will help reduce lag for players who chose a lower draw distance in their settings.

'''Note for low LOD [[object]]s''':
*The limit is 300 units, but the actual draw distance used is 5 times the setting value. Also, they ignore the 'Video' tab draw distance slider. So a setting of 200 will mean a low LOD element will always have a draw distance of '''1000''' units.

'''Note for low LOD [[building]]s''':
*The distance must be set greater than 300 for a low LOD building in order to work correctly. Otherwise, the low LOD will always be visible. The actual draw distance is NOT 5 times the setting value.

==Syntax==
<syntaxhighlight lang="lua">
bool engineSetModelLODDistance ( int model, float distance [, bool extendedLod = false ] )
</syntaxhighlight>
{{OOP||Engine.setModelLODDistance}}
===Required Arguments===
*'''model:''' The model / object ID number you want to change the LOD distance of.
*'''distance:''' New LOD distance value in San Andreas units.

===Optional Arguments===
{{OptionalArg}}
{{New feature/item|3.0161|1.6.0|22676|
*'''extendedLod:''' Allows to set a greater distance than the current 325 units.
}}

===Returns===
Returns ''true'' if the function executed succesfully, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
-- Cause massive lag by maxing out draw distance of all objects

local objectsTable = getElementsByType("object")

for i = 1, #objectsTable do
local objectElement = objectsTable[i]
local objectModel = getElementModel(objectElement)

engineSetModelLODDistance(objectModel, 300) -- Set maximum draw distance
end
</syntaxhighlight>

This example will, besides replacing with custom map objects, also set the LOD distance accordingly, a neccesary step (otherwise the object could seem to fail loading and only show up 1 feet away)
<syntaxhighlight lang="lua">
function replaceObjects()

local col1 = engineLoadCOL("map1.col")
local col2 = engineLoadCOL("map2.col")

local txd = engineLoadTXD("map.txd")
engineImportTXD(txd, 2357)
engineImportTXD(txd, 2290)

local dff1 = engineLoadDFF("map1.dff")
local dff2 = engineLoadDFF("map2.dff")

engineReplaceCOL(col1, 2357)
engineReplaceCOL(col2, 2290)
engineReplaceModel(dff1, 2357)
engineReplaceModel(dff2, 2290)

engineSetModelLODDistance(2357, 2000)
engineSetModelLODDistance(2290, 2000)
end
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.6.0-9.22676|Added extendedLod argument}}

==See Also==
* [[getVehiclesLODDistance]]
* [[resetVehiclesLODDistance]]
* [[setVehiclesLODDistance]]
{{Engine_functions}}

Table.size

2025-01-28T14:57:08Z

TheNormalnij: /* Example */ #tab returns 3 in this case

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function returns the total size of a table and not only the highest numerical index like table.maxn or the number of fields that have a numerical index like the #-operator.

==Syntax==
<syntaxhighlight lang="lua">int table.size( table tab )</syntaxhighlight>

===Required Arguments===
* '''tab''': The table to retrieve the total size of.

===Returns===
Returns the total number of fields the table contains.

==Code==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
function table.size(tab)
local length = 0
for _ in pairs(tab) do length = length + 1 end
return length
end
</syntaxhighlight>
</section>

==Example==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
local tab = { 1, 2, 3, [25] = 4, five = 5, foo = "bar" }
outputChatBox(tostring(#tab)) --prints: 3 (because there are 3 sequential fields with a numerical index)
outputChatBox(tostring(table.maxn(tab))) --prints: 25 (because the highest numerical index is 25)
outputChatBox(tostring(table.size(tab))) --prints: 6 (because the table has 6 fields in total)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2025-01-28T14:27:26Z

TheNormalnij: /* Table functions */ Remove table.fromString

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

=== ACL functions ===
*[[aclGroupClone]] » This function clone a group to another group with/without ACLs and/or objects.
*[[renameAclGroup]] » This function gives an existing ACL group a new name.
*[[getPlayersInACLGroup]] » This function returns all players in an ACL group.
*[[isPlayerInACL]] » This function checks if a player element is in an ACL group.

=== Account functions ===
*[[getPlayerFromAccountName]] » This function is used to obtain a player by the name of his account.
*[[isPlayerAccount]] » This function checks if the account is a valid player account (account exists and is not a guest account)

=== Camera functions ===
*[[smoothMoveCamera]] » This function allows you to create a cinematic camera flight.
*[[sCamera]] » The function creates a speed camera in-game, fines speeding vehicles, and notifies the driver and take money from player based on vehicle speed.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

===String functions===
*[[string.endsWith]] » This function checks if a string ends with other string.
*[[string.startsWith]] » This function checks if a string starts with other string.
*[[string.repetition]] » This function repeats a substring n times.
<noinclude>[[Category:Useful Functions]]</noinclude>

Table.fromString

2025-01-28T14:25:06Z

TheNormalnij:

{{delete| This implementation compromises script security.}}

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function converts string to a table. 
==Syntax==
<syntaxhighlight lang="lua">string table.fromString( string str )</syntaxhighlight>

===Required Arguments===
* '''str''': The string to convert.

===Returns===
Returns table if string was successfully converted, false otherwise.

<section name="Shared function" class="both" show="true">
<syntaxhighlight lang="lua">
function table.fromString(str)
if type(str) ~= 'string' then return false end
return (loadstring)('return '..str)()
end
</syntaxhighlight>
</section>

'''Author:''' Tracer

==See Also==
{{Useful_Functions}}

Talk:Table.fromString

2025-01-28T14:21:35Z

TheNormalnij: Created page with "This implementation violates script security. --~~~~"

This implementation violates script security. --[[User:TheNormalnij|TheNormalnij]] ([[User talk:TheNormalnij|talk]]) 14:21, 28 January 2025 (UTC)

Template:ExampleCreateObjectOrBuilding

2025-01-24T15:10:24Z

TheNormalnij: setElementAlpha works only with objects

<noinclude>This template is used on [[createBuilding]] and [[createObject]] pages, as a unified example. <hr>

</noinclude><section name="How to automatically perform object/building creation" class="client" show="true">
This example shows you how to automatically create an object or building element according to certain parameters.

'''This script onlys works CLIENTSIDE due to [[createBuilding]] and [[engineGetModelPhysicalPropertiesGroup]].'''
<syntaxhighlight lang="lua">
-- Creates an 'object' or 'building' element based on certain parameters or one of the functions fails
-- This function will throw an error when unexpected arguments are used
-- TODO: Add LOD support
function createObjectOrBuilding(modelID, x, y, z, rx, ry, rz, interior, dimension)
-- Validate the arguments passed
assert(type(modelID)=="number", "invalid modelID passed: " .. tostring(modelID))
assert(type(x)=="number" and type(y)== "number" and type(z)=="number", "invalid position passed: " .. tostring(x) .. ", " .. tostring(y) .. ", " .. tostring(z))
if not rx then rx = 0 end
if not ry then ry = 0 end
if not rz then rz = 0 end
assert(type(rx)=="number" and type(ry)== "number" and type(rz)=="number", "invalid rotation passed: " .. tostring(rx) .. ", " .. tostring(ry) .. ", " .. tostring(rz))
if not interior then interior = 0 end
if not dimension then dimension = 0 end
assert(type(interior)=="number" and interior >= 0 and interior <= 255, "invalid interior (must be 0-255) passed: " .. tostring(interior))
assert(type(dimension)=="number" and dimension >= -1 and dimension <= 65535, "invalid dimension passed (must be -1 65535): " .. tostring(dimension))

-- Dynamic object models will always have a physical properties group different than -1.
local isNonDynamic = engineGetModelPhysicalPropertiesGroup(modelID) == -1
-- Buildings can't be affected by dimension
local isNormalDimension = dimension == 0
-- Buildings can't be placed outside regular map boundaries
local isInsideMapLimits = x >= -3000 and x <= 3000 and y >= -3000 and y <= 3000

local obj, bld
if isNonDynamic and isNormalDimension and isInsideMapLimits then
bld = createBuilding(modelID, x, y, z, rx, ry, rz, interior)
assert(bld, ("Failed to create building with model ID %d at %f, %f, %f in interior %d"):format(modelID, x, y, z, interior))
else
obj = createObject(modelID, x, y, z, rx, ry, rz, false)
assert(obj, ("Failed to create object with model ID %d at %f, %f, %f"):format(modelID, x, y, z))
setElementInterior(obj, interior)
setElementDimension(obj, dimension)
end
return obj or bld
end

-- Test this create object/building function
addCommandHandler("testobject", function()
-- This would be your object's model ID
local modelID = 3556
-- This would be your object's position coordinates
local x, y, z = 0, 0, 69
-- This would be your object's rotation coordinates
local rx, ry, rz = 0, 0, 90
-- This would be your object's interior ID
local interior = 0
-- This would be your object's dimension ID
local dimension = 0

-- We use pcall to catch any errors that may be thrown
local success, element = pcall(createObjectOrBuilding, modelID, x, y, z, rx, ry, rz, interior, dimension)
if not success then
outputDebugString(("Failed to create object or building: %s"):format(tostring(element)), 4, 255, 25, 25)
return
end

-- OPTIONAL: Then you can apply additional properties, like so:
if getElementType(element) == "object" then
setObjectScale(element, 1.69)
setObjectBreakable(element, false)
setElementAlpha(element, 230)
end
setElementCollisionsEnabled(element, true)
setElementFrozen(element, false)
end)
</syntaxhighlight>
</section>

Element data

2025-01-15T12:22:30Z

TheNormalnij: Add security options

Each [[element]] that is loaded is able to have [[element data]] values attached to it. These are values that can be accessed using a keyword string and directly correspond to the element's attributes in the map file, unless changed via scripting. Element data is a good (but expensive) way to store distributed information you want associated with an element, for example you could use it to associate a score with a player, or a team with a vehicle.

Element data is synchronized by default between the server and the client (you can disable it via fourth argument in [[setElementData]]. Setting data from any of the two sides will force an update in the other, triggering the corresponding element data change events. This is very useful, as it provides a simple way to keep element properties synced without having to set special events to do it manually. This also means that excessive use of element data to store variables that are not required by both server and client becomes a waste of bandwidth.

Since not all data types can be packetized to be transferred, there are some restrictions. The types that cannot be stored as element data are ''non-element userdata'' (see [[MTA Classes]]), ''functions'' and ''threads''. Also, you may not send tables which contain one or more values of any of these types.

{{Added feature/item|1.6.1|1.6.0|22790|Element data is not protected from clinet changes by default. You '''SHOULD''' enable [[Server_mtaserver.conf#elementdata_whitelisted|elementdata_whitelisted]] in '''mtaserver.conf''' to protect your server simple cheats. Use the '''clientChangesPolicy''' parameter in [[setElementData]] to allow some changes.}}

==Relevant functions==
* [[setElementData]]: sets an element data value.
* [[getElementData]]: retrieves an element data value.

==Relevant events==
* [[onElementDataChange]]: triggered on the server after element data is changed.
* [[onPlayerChangesProtectedData]]: triggered on the server after the client attempts to change protected element data.
* [[onClientElementDataChange]]: triggered on the client after element data is changed.
[[pt-br:Element_data]]
[[pl:Element data]]

[[Category:Scripting Concepts]]

Element data

2025-01-15T12:14:36Z

TheNormalnij: /* Relevant events */ Add onPlayerChangesProtectedData

Each [[element]] that is loaded is able to have [[element data]] values attached to it. These are values that can be accessed using a keyword string and directly correspond to the element's attributes in the map file, unless changed via scripting. Element data is a good (but expensive) way to store distributed information you want associated with an element, for example you could use it to associate a score with a player, or a team with a vehicle.

Element data is synchronized by default between the server and the client (you can disable it via fourth argument in [[setElementData]]. Setting data from any of the two sides will force an update in the other, triggering the corresponding element data change events. This is very useful, as it provides a simple way to keep element properties synced without having to set special events to do it manually. This also means that excessive use of element data to store variables that are not required by both server and client becomes a waste of bandwidth.

Since not all data types can be packetized to be transferred, there are some restrictions. The types that cannot be stored as element data are ''non-element userdata'' (see [[MTA Classes]]), ''functions'' and ''threads''. Also, you may not send tables which contain one or more values of any of these types.

==Relevant functions==
* [[setElementData]]: sets an element data value.
* [[getElementData]]: retrieves an element data value.

==Relevant events==
* [[onElementDataChange]]: triggered on the server after element data is changed.
* [[onPlayerChangesProtectedData]]: triggered on the server after the client attempts to change protected element data.
* [[onClientElementDataChange]]: triggered on the client after element data is changed.
[[pt-br:Element_data]]
[[pl:Element data]]

[[Category:Scripting Concepts]]

EngineRequestModel

2025-01-05T14:48:40Z

TheNormalnij: There is no parentId limits

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

===Optional Arguments===
*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds, 3425 - clump models, 4715 - timed objects, 994 - damageable objects).
{{Important Note|parentID should be the same model type to prevent crashes.}}

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

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

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

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

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

EngineRequestModel

2025-01-05T14:44:39Z

TheNormalnij:

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

===Optional Arguments===
*'''parentID''': The ID of the parent model (by default this is: 1337 - objects, 400 - vehicles, 7 - peds, 3425 - clump models, 4715 - timed objects, 994 - damageable objects).
{{Important Note|Here is the parentID limit for each element type: 
*'''ped''': 0 - 26315
*'''vehicle''': 400 - 611
*'''object''': 615 - 11681
*'''timed-object''': 615 - 11681
*'''clump''': 615 - 11681
If you try to use higher values than the limit, your client may crash.}}

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

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

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

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

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

Template:BuildingInfo

2025-01-05T13:30:08Z

TheNormalnij: Dynamic models update

<noinclude>This template is used on [[Building]] and related pages. <hr></noinclude>
== [[File:Dialog-warning.svg|48px]] Important info about [[Building|Buildings]] ==
* There is a distinction in GTA: San Andreas between static and dynamic models (these use a separate streaming system). Examples of buildings include building models, roads, and terrain. Objects created as [[Building|Buildings]] can contain '''glass''' and '''shadows''', unlike those created as [[Object|Objects]] (which are missing these features).

* Buildings can be created with dynamic object model IDs, but they won't have any physical interaction. For example, [https://dev.prineside.com/en/gtasa_samp_model_id/model/1502-Gen_doorINT04/ object ID 1502 (Gen_doorINT04)] is a door that can only be opened if created with [[createObject]].

* Using buildings for mapping is more optimized than using objects. Gains in FPS can be noticed in areas where a lot of objects were replaced with buildings of this new system.

* Buildings can only be created inside regular GTA:SA Map Boundaries (X between -3000 and 3000; Y between -3000 and 3000). Use [[createObject]] to spawn objects outside these normal limits. '''This limitation is probably going to stop existing in the near future.'''

* Created buildings can have '''LOD models'''. The procedure is as follows: spawn the LOD building using [[createBuilding]], then use [[setLowLODElement]] to associate it with the non-LOD building element you created beforehand. LOD model distance changed with [[engineSetModelLODDistance]] works for buildings.

* Buildings cannot appear in certain a [[Dimension|dimension]], and not show in others. Function [[setElementDimension]] returns false on any building. A building is created in a specific [[Interior|interior world]] (such as 0, the main world), like the default GTA:SA landscape objects. All '''buildings appear in EVERY DIMENSION'''.

OnPlayerChangesProtectedData

2024-12-06T14:32:49Z

TheNormalnij: Created page with "__NOTOC__ {{Server event}} {{Added feature/item|1.6.1|1.6.0|22790|This event is triggered when a player tries to change protected element data. The server protects element data with using elementdata_whitelisted from '''mtaserver.conf''' and the '''clientChangesPolicy''' parameter in [setElementData.}} ==Parameters== *'''element''': The affected element. *'''key''': The name of the element data entry that has changed...."

__NOTOC__
{{Server event}}
{{Added feature/item|1.6.1|1.6.0|22790|This event is triggered when a player tries to change protected element data. The server protects element data with using [[Server_mtaserver.conf#elementdata_whitelisted|elementdata_whitelisted]] from '''mtaserver.conf''' and the '''clientChangesPolicy''' parameter in [[[setElementData]].}}
==Parameters==
*'''element''': The affected element.
*'''key''': The name of the element data entry that has changed.
*'''value''': The value that the player sends.

==Source==
The [[event system#Event source|source]] of this event is the [[player]] who changes protected element data.

==Example==
The below example will ban all players who are trying to change protected element data.
<syntaxhighlight lang="lua">
function processPlayerElementDataHack()
addBan(source, "Element data hacking attempt")
end
addEventHandler("onPlayerChangesProtectedData", root, processPlayerElementDataHack)

</syntaxhighlight>
{{See also/Server event|Player events}}

Template:Player events

2024-12-06T14:32:36Z

TheNormalnij:

<ul>
<li>[[onPlayerACInfo]]</li>
<li>[[onPlayerBan]]</li>
<li>[[onPlayerChangeNick]]</li>
{{Added feature/item|1.6.1|1.6.0|22790|
<li>[[onPlayerChangesWorldSpecialProperty]]</li>
}}
{{Added feature/item|1.6.1|1.6.0|22790|
<li>[[onPlayerChangesProtectedData]]</li>
}}
<li>[[onPlayerChat]]</li>
<li>[[onPlayerClick]]</li>
<li>[[onPlayerCommand]]</li>
<li>[[onPlayerConnect]]</li>
<li>[[onPlayerContact]]</li>
<li>[[onPlayerDamage]]</li>
{{Added feature/item|1.6.1|1.6.0|22293|
<li>[[onPlayerDetonateSatchels]]</li>
}}
<li>[[onPlayerJoin]]</li>
<li>[[onPlayerLogin]]</li>
<li>[[onPlayerLogout]]</li>
<li>[[onPlayerMarkerHit]]</li>
<li>[[onPlayerMarkerLeave]]</li>
<li>[[onPlayerModInfo]]</li>
<li>[[onPlayerMute]]</li>
<li>[[onPlayerNetworkStatus]]</li>
<li>[[onPlayerPickupHit]]</li>
{{New items|3.0156|1.5.5|
<li>[[onPlayerPickupLeave]]</li>
|11783}}
<li>[[onPlayerPickupUse]]</li>
<li>[[onPlayerPrivateMessage]]</li>
{{Added feature/item|1.6.1|1.6.0|22293|
<li>[[onPlayerProjectileCreation]]</li>
}}
<li>[[onPlayerQuit]]</li>
<li>[[onPlayerScreenShot]]</li>
<li>[[onPlayerSpawn]]</li>
<li>[[onPlayerStealthKill]]</li>
<li>[[onPlayerTarget]]</li>
{{Added feature/item|1.6.1|1.6.0|22447|
<li>[[onPlayerTeamChange]]</li>
}}
{{Added feature/item|1.6.1|1.6.0|22313|
<li>[[onPlayerTriggerEventThreshold]]</li>
}}
{{Added feature/item|1.6.1|1.6.0|22459|
<li>[[onPlayerTriggerInvalidEvent]]</li>
}}
<li>[[onPlayerUnmute]]</li>
<li>[[onPlayerVehicleEnter]]</li>
<li>[[onPlayerVehicleExit]]</li>
<li>[[onPlayerVoiceStart]]</li>
<li>[[onPlayerVoiceStop]]</li>
<li>[[onPlayerWasted]]</li>
<li>[[onPlayerWeaponFire]]</li>
<li>[[onPlayerWeaponSwitch]]</li>
</ul>

<noinclude>[[Category:Events templates]]</noinclude>

Server mtaserver.conf

2024-12-06T13:36:09Z

TheNormalnij: elementdata_whitelisted

This page lists the settings that can be set in the settings file. ''Setting from the default '''mtaserver.conf''' settings file is in italics''.

==Settings==

====servername====
:''<servername>Default MTA Server</servername>''
:This parameter specifies the name the server will be visible as in the ingame server browser and on Game-Monitor. It is a required parameter.

====owner_email_address====
:''<owner_email_address></owner_email_address>''
:This parameter specifies the contact email addresses for the owner(s) of this server.
:The email addresses will not be publicly available, and only used by MTA administrators to contact the server owner.
:Note: Missing or incorrect owner_email_address can affect visibility in the master server list.
:Values: Comma separated list of email addresses

====serverip====
:''<serverip>auto</serverip>
:'''ONLY USE THIS PARAMETER IF YOU ARE SURE OF WHAT YOU ARE DOING''' - it is generally only needed for complex network topologies and should be left at the default value otherwise.
: This parameter specifies the public IP address that the server will announce to the MTA servers, for the purposes of registering itself in the master server list and receiving some internal status updates. Usually, setting this parameter is only useful for some specialized scenarios, like servers that can be reached by multiple public addresses, or when a firewall is used for controlling incoming connections. If set to auto, the public IP address the requests originate from will be used as the server IP for communicating with MTA servers, which works fine in most cases.
:Values: auto or x.x.x.x ; default value: auto
:SERVERIP SHOULD BE LEFT SET TO auto UNLESS YOU ARE SURE OF WHAT YOU ARE DOING
:WARNING: SETTING serverip AND THEN ASKING FOR SUPPORT CAN CAUSE DEATH OR INJURY

====serverport====
:''<serverport>22003</serverport>
:This parameter specifies the UDP port on which the server will be accepting incoming player connections;
:default value: 22003. It is a required parameter.

====maxplayers====
:''<maxplayers>32</maxplayers>
:This parameter specifies the number of maximum player slots available on the server;
:default value: 32. It is a required parameter.

====httpserver====

:''<httpserver>1</httpserver>
:This parameter specifies whether the built-in http server will be used.
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]

====httpport====
:''<httpport>22005</httpport>
:This parameter specifies the TCP port on which the server will be accepting incoming http connections. It can be set to the same value as <serverport>. It is a required parameter if <httpserver> is set to 1.
:More information: [[Server_Manual#Using_the_web_interface|Using the web interface]]

====httpdownloadurl====
:''<httpdownloadurl></httpdownloadurl>
:If set, this parameter specifies the external URL from which clients will be able to download needed resources ingame. Otherwise they will download them directly from the server.
:More information: [[Server_Manual#Configuring_an_external_web_server|Configuring an external web server]]

====httpmaxconnectionsperclient====
:''<httpmaxconnectionsperclient>5</httpmaxconnectionsperclient>
:This parameter limits the number of http connections each client can make. Depending on the type of http server that is used, a lower figure may reduce download timeouts. Only relevant when using an external http server.
:Available range: 1 to 8.

====httpdosthreshold====
:''<httpdosthreshold>20</httpdosthreshold>
:This parameter limits the number http connections that an IP can initiate over a short period of time.
:Available range: 1 to 100. default value: 20

====http_dos_exclude====
:''<http_dos_exclude></http_dos_exclude>
:This parameter lists the IP addresses that are to be excluded from http dos threshold limits.
:e.g. 88.11.22.33,101.2.3.4

====allow_gta3_img_mods====
:''<allow_gta3_img_mods>none</allow_gta3_img_mods>
:By default, the server will block the use of locally customized gta3.img player skins
:This setting can be used to allow such mods. Not recommended for competitive servers.
:Values: none, peds ; default value: none

====client_file====
:''<nowiki></nowiki>
:By default, the server will block the use of customized GTA:SA data files.
:To allow specific client files, add one or more of the above lines.
:More information: [[Anti-cheat_guide#.3Cclient_file_name.3D.22data.2Fcarmods.dat.22_verify.3D.220.22.2F.3E|Anti-cheat guide]]

====disableac====
:''<disableac></disableac>
:Comma separated list of disabled anti-cheats.
:e.g. To disable anti-cheat #2 and #3, use: 2,3
:More information: [[Anti-cheat_guide#.3Cdisableac.3E.3C.2Fdisableac.3E|Anti-cheat guide]]

====enablesd====
:''<enablesd>31,32</enablesd>
:Comma separated list of enabled special detections. A special detection is a type of anti-cheat for (usually) harmless game modifications.
:Competitive servers may wish to enable certain special detections, but most servers should leave this setting on its default.
:Values: special detection (SD) codes ; default value: 31,32 (e.g. enables special detections #31 and #32)
:More information: [[Anti-cheat_guide#.3Cenablesd.3E.3C.2Fenablesd.3E|Anti-cheat guide]]

====minclientversion====
:''<minclientversion></minclientversion>
:Minimum client version. Clients with a lower version will not be allowed to connect. After disconnection, clients will be given an opportunity to download an update. If left blank, this setting is disabled and there are no restrictions on who can connect. Version numbers are described in [[getPlayerVersion]] and look like this: 1.1.0-9.03100.0
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[https://nightly.mtasa.com/ver highest available]].'''

====minclientversion_auto_update====
:''<minclientversion_auto_update>1</minclientversion_auto_update>
:This parameter specifies if/when the <minclientversion> setting is automatically updated.
:Keeping <minclientversion> updated can help reduce cheating.
:Note: The instant setting (2) is only recommended for competitive servers.
:Values: 0 - disabled, 1 - enabled (delayed by a few days), 2 - enabled (instant) ; default value: 1.

====recommendedclientversion====
:''<recommendedclientversion></recommendedclientversion>
:Recommended client version. When connecting, if clients have a lower version, they will be given the option to download an update. If left blank, this setting is disabled.
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]
:'''Note that this setting only determines if the client should be prompted to update. The actual build number they receive will be the [[https://nightly.mtasa.com/ver highest available]].'''

====ase====
:''<ase>1</ase>
:This parameter can be used to make the server report to Game-Monitor master servers, allowing it to be visible in the in-game server browser. An additional UDP port needs to be available for this to work (value from <serverport> + 123 , so on a default <serverport> value 22003 the right port will be 22126 ).
:Available values: 0 - disabled , 1 - enabled. Optional parameter, defaults to 0.

====donotbroadcastlan====
:''<donotbroadcastlan>0</donotbroadcastlan>
:This parameter allows you to disable LAN broadcasting.

====password====
:''<password></password>
:If set, players will have to provide a password specified below, before they can connect to the server. If left blank, server doesn't require a password from them.
:This parameter can changed and saved while the server is running with [[setServerPassword]] or [[setServerConfigSetting]]

====bandwidth_reduction====
:''<bandwidth_reduction>medium</bandwidth_reduction>
:This parameter reduces the server's bandwidth usage by using various optimizations.
:Values: none, medium or maximum ; default value: medium
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====unoccupied_vehicle_syncer_distance====

:''<unoccupied_vehicle_syncer_distance>130</unoccupied_vehicle_syncer_distance>
:This parameter determines the distance limit for remote synced unoccupied vehicles
:Available range: 50 - 400; default value: 130
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====ped_syncer_distance====

:''<ped_syncer_distance>100</ped_syncer_distance>
:This parameter determines the distance limit for remote synced peds
:Available range: 50 - 400; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====player_sync_interval====
:''<player_sync_interval>100</player_sync_interval>
:This parameter determines the time in milliseconds between player sync packets.
:Available range: 50 - 4000; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====lightweight_sync_interval====
:''<lightweight_sync_interval>1500</lightweight_sync_interval>
:This parameter determines the time in milliseconds between lightweight (player) sync packets.
:Available range: 200 - 4000; default value: 1500
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====camera_sync_interval====
:''<camera_sync_interval>500</camera_sync_interval>
:This parameter determines the time in milliseconds between camera sync packets.
:Available range: 50 - 4000; default value: 500
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====ped_sync_interval====
:''<ped_sync_interval>500</ped_sync_interval>
:This parameter determines the time in milliseconds between ped sync packets when the ped is near the player.
:Available range: 50 - 4000; default value: 500
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====ped_far_sync_interval====
:''<ped_far_sync_interval>2000</ped_far_sync_interval>
:This parameter determines the time in milliseconds between ped sync packets when the ped is far away from the player.
:Available range: 50 - 4000; default value: 2000
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====unoccupied_vehicle_sync_interval====
:''<unoccupied_vehicle_sync_interval>400</unoccupied_vehicle_sync_interval>
:This parameter determines the time in milliseconds between unoccupied vehicle sync packets.
:Available range: 50 - 4000; default value: 400
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====keysync_mouse_sync_interval====
:''<keysync_mouse_sync_interval>100</keysync_mouse_sync_interval>
:This parameter determines the minimum time in milliseconds between key sync packets due to mouse movement.
:Available range: 50 - 4000; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====keysync_analog_sync_interval====
:''<keysync_analog_sync_interval>100</keysync_analog_sync_interval>
:This parameter determines the minimum time in milliseconds between key sync packets due to joystick movement.
:Available range: 50 - 4000; default value: 100
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
:Suggested values for this and the other sync_interval settings can be found here: [[Sync_interval_settings|Sync interval settings]]

====bullet_sync====
:''<bullet_sync>1</bullet_sync>
:This parameter can improve the reliability of shots when using certain weapons. However, it uses more bandwidth.
:Note that bullet sync will be active regardless of this setting when certain [[setGlitchEnabled|glitches]] are enabled.
:Values: 0 - disabled , 1 - enabled ; default value: 1.
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

{{Added feature/item|1.6.1|1.6.0|22430|
====vehicle_contact_sync_radius====
:''<vehicle_contact_sync_radius>30</vehicle_contact_sync_radius>
:This parameter specifies the radius in which any contact with a vehicle will turn the player into its syncer.
:Changing this setting to 0 will cause vehicles to not pick a new syncer based on which player is touching the vehicle.
:Available range: 0 to 130. Default - 30
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]
}}

====vehext_percent====
:''<vehext_percent>0</vehext_percent>
:This parameter sets the amount of extrapolation that clients will apply to remote vehicles.
:This can reduce some of the latency induced location disparency by predicting where the remote vehicles will probably be.
:Depending on the gamemode, an incorrect prediction may have a negative effect.
:Therefore this setting should be considered experimental.
:Available range: 0 to 100. Default - 0

====vehext_ping_limit====
:''<vehext_ping_limit>150</vehext_ping_limit>
:This parameter places a limit on how much time (in milliseconds) the vehicle extrapolation will attempt to compensate for.
:Only relevant if <vehext_percent> is greater than zero.
:Available range: 50 to 500. Default - 150

====latency_reduction====
:''<latency_reduction>0</latency_reduction>
:This parameter can reduce the delay of player actions appearing on remote clients by 2 frames (approx 50ms).
:Due to the impact this may have on shot lag compensation, it should be considered experimental.
:Values: 0 - disabled , 1 - enabled ; default value: 0.
:Bugs caused by enabling latency_reduction: https://bugs.mtasa.com/view.php?id=8191 + https://bugs.mtasa.com/view.php?id=8226

====threadnet====

:''<threadnet>1</threadnet>
:This parameter specifies whether or not to run the network synchronization on another thread.
:Enabling will make the sync smoother, but may increase CPU usage slightly.
:Values: 0 - disabled , 1 - enabled ; default value: 1.
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====idfile====
:''<idfile>server-id.keys</idfile>
:Specifies the location and file name of this servers unique private key. This is used to prevent private files saved on the client from being read by other servers.
:Keep a backup of this file in a safe place. Default value: server-id.keys
:More information about client private files: [[Filepath]]

====logfile====
:''<logfile>logs/server.log</logfile>
:Specifies the location and name of the main server log file. If left blank, server won't be saving this file.

====authfile====
:''<authfile>logs/server_auth.log</authfile>
:As well as the main log file, login successes and failures are logged here for easy reviewing of security issues. If left blank, this file is not used

====dbfile====
:''<dbfile>logs/db.log</dbfile>
:Specifies the location and name of the file used to log database queries. The server command [[Server_Commands#debugdb|debugdb]] sets the amount of logging.

====loadstringfile====
:''<nowiki></nowiki>
:Specifies the location and name of the file used to log loadstring function calls. If left blank or not set, no logging is done.

====acl====
:''<acl>acl.xml</acl>
:This parameter specifies the location and name of the Access Control List settings file. If left
:blank, server will use acl.xml file, located in the same folder as this configuration file.

====scriptdebuglogfile====
:''<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>
:Specifies the location and name of the debugscript log file. If left blank, server won't be saving this file.

====scriptdebugloglevel====
:''<scriptdebugloglevel>0</scriptdebugloglevel>
:Specifies the level of the debugscript log file. Available values: 0, 1, 2, 3. When not set, defaults to 0.

====htmldebuglevel====
:''<htmldebuglevel>0</htmldebuglevel>
:Specifies the level of the html debug. Available values: 0, 1, 2, 3. When not set, defaults to 0.

====filter_duplicate_log_lines====
:''<filter_duplicate_log_lines>1</filter_duplicate_log_lines>
:Specifies whether or not duplicate log lines should be filtered. Available values: 0 or 1, defaults to 1.

====fpslimit====
:''<fpslimit>74</fpslimit>
:Specifies the frame rate limit that will be applied to connecting clients.
:Available range: 25 to 32767. Default: 74. You can also use 0 for uncapped fps.
:This parameter can be changed and saved while the server is running with [[setServerConfigSetting]]

====voice====
:''<voice>0</voice>
:This parameter specifies whether or not to enable player voice chat in-game
:Values: 0 - disabled , 1 - enabled

====voice_samplerate====
:''<voice_samplerate>1</voice_samplerate>
:This parameter specifies the sample rate for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the sampling quality of voice chat
:Values: 0 - Narrowband (8kHz), 1 - Wideband (16kHz), 2 - Ultrawideband (32kHz). Default - 1

====voice_quality====
:''<voice_quality>4</voice_quality>
:This parameter specifies the voice quality for voice chat. 'voice' parameter must be set to 1 for this to be effective. Higher settings use more bandwidth and increase the the overall quality of voice chat
:Available range: 0 to 10. Default - 4

====voice_bitrate====
:''<nowiki></nowiki>
:Specifies the voice bitrate, in bps. This optional parameter overrides the previous two settings. If not set, MTA handles this automatically. Use with care.

====backup_path====
:''<backup_path>backups</backup_path>
:This parameter specifies the path to use for a basic backup of some server files. Note that basic backups are only made during server startup. Default value: backups

====backup_interval====
:''<backup_interval>3</backup_interval>
:This parameter specifies the number of days between each basic backup. Backups are only made during server startup, so the actual interval maybe much longer. Setting backup_interval to 0 will disable backups
:Available range: 0 to 30. Default - 3

====backup_copies====
:''<backup_copies>10</backup_copies>
:This parameter specifies the maximum number of backup copies to keep. Setting backup_copies to 0 will disable backups
:Available range: 0 to 100. Default - 10

====compact_internal_databases====
:''<compact_internal_databases>1</compact_internal_databases>
:This parameter specifies when the internal sqlite databases should be defragmented.
:For more info see: https://www.sqlite.org/lang_vacuum.html
:Values: 0 - Never, 1 - On server start only after basic backup, 2 - On server start always. Default - 1

====crash_dump_upload====
:''<crash_dump_upload>1</crash_dump_upload>
:This parameter specifies whether server crash dump files should be sent to MTA HQ.
:Values: 0 - Off, 1 - On. Default - 1

====fakelag====

:''<fakelag>0</fakelag>
:This parameter specifies whether the [[Command fakelag|fakelag and sfakelag]] commands are enabled
:Values: 0 - Off, 1 - On. Default - 0

====auth_serial_groups====
:''<auth_serial_groups>Admin</auth_serial_groups>
:This parameter lists the ACL groups that are protected by serial authorization.
:Login attempts to a protected account from a second serial are blocked until the serial is manually authorized via the authserial command.
:For more info see: https://mtasa.com/authserial
:Note: This is security critical feature and disabling auth_serial_groups can affect visibility in the master server list.
:Values: Comma separated list of ACL groups. Default - Admin
:See [[Authorized Serial Account Protection]] for more information.

====auth_serial_http====
:''<auth_serial_http>1</auth_serial_http>
:This parameter specifies if the authorized serial login checks should also apply to the http interface.
:Protected account login attempts to the http interface will only succeed if the IP address matches one recently used by the account holder in-game.
:For more info see: https://mtasa.com/authserialhttp
:Note: This is security critical feature and disabling auth_serial_http can affect visibility in the master server list.
:Values: 0 - Off, 1 - Enabled. Default - 1

====auth_serial_http_ip_exceptions====
:''<auth_serial_http_ip_exceptions>127.0.0.1</auth_serial_http_ip_exceptions>
:This parameter specifies which IP addresses should always pass auth_serial_http checks.
:Values: Comma separated list of IP addresses

====database_credentials_protection====
:''<database_credentials_protection>1</database_credentials_protection>
:This parameter specifies if extra security measures are applied to resources which use [[dbConnect]] with MySQL.
:The extra measures are:
: - script files cannot be accessed with [[fileOpen]]
: - [[meta.xml]] is read-only
:'''NOTE:''' This only protects resources which use [[dbConnect]] with MySQL.
:Values: 0 - Off, 1 - Enabled. Default - 1

{{New items|6.0160|1.6.0-22790|
====elementdata_whitelisted====
:''<elementdata_whitelisted>0</elementdata_whitelisted>
:Enables extra protection for [[SetElementData|element data]].
:When this option is enabled, the server ignores element data sync packets from the client, except for allowed keys.
:Values: 0 - Off, 1 - Enabled. Default - 0
}}

====player_triggered_event_interval====
:''<player_triggered_event_interval>1000</player_triggered_event_interval>
:Time interval for counting max (see below: max_player_triggered_events_per_interval) triggered events (via triggerServerEvent), exceeding this will call [[onPlayerTriggerEventThreshold]]
:Values: 50-5000; default: 1000 (in ms)

====max_player_triggered_events_per_interval====
:''<max_player_triggered_events_per_interval>100</max_player_triggered_events_per_interval>
:Max triggered amount of events (via triggerServerEvent) within interval above (player_triggered_event_interval), exceeding this will call [[onPlayerTriggerEventThreshold]]
:Values: 1-1000; default: 100

====module====
:''<nowiki></nowiki>
:''<nowiki></nowiki>
:Specifies the module(s) which are loaded with the server. To load several modules, add more <module> parameter(s). Optional parameter.

====resource_client_file_checks====

:''<resource_client_file_checks>1</resource_client_file_checks>
:If enabled, the server will perform checks on files in resources (listed in [[meta.xml]]) with PNG, TXD and DFF extensions, checking if they are corrupted. When the system finds a non-valid file of these types, it outputs a warning to the server console.
:You may want to disable thse checks when storing different/non-conforming data in files with these extensions (e.g. encrypted data).
:Values: 0 - Off, 1 - Enabled. Default - 1

====resource====
:''<resource src="admin" startup="1" protected="0" />
:''<resource src="defaultstats" startup="1" protected="0" />
:''<resource src="helpmanager" startup="1" protected="0" />
:''<resource src="joinquit" startup="1" protected="0" />
:''<resource src="mapcycler" startup="1" protected="0" />
:''<resource src="mapmanager" startup="1" protected="0" />
:''<resource src="parachute" startup="1" protected="0" />
:''<resource src="resourcebrowser" startup="1" protected="1" default="true" />
:''<resource src="resourcemanager" startup="1" protected="1" />
:''<resource src="scoreboard" startup="1" protected="0" />
:''<resource src="spawnmanager" startup="1" protected="0" />
:''<resource src="voice" startup="1" protected="0" />
:''<resource src="votemanager" startup="1" protected="0" />
:''<resource src="webadmin" startup="1" protected="0" />
:''<resource src="play" startup="1" protected="0" />
:''<resource src-"resources" startup"1" protected="0"
:Specifies persistent resources which are loaded when the server starts. Persistent resources are not stopped even if all the other resources that depend on them stop; that is, the only way to stop them is by explicitly using the ''stop'' server command or [[stopResource]] scripting function. To load several resources, add more <resource> parameters.

:In addition, there are several flags which control how the server deals with each resource:

:* '''src''': the resource name. This is the only mandatory flag.
:* '''startup''': controls whether the resource will be started with the server or not. If "1", "true" or "yes", the resource will be started. If not specified, defaults to not starting the resource.
:* '''protected''': if "1", "true" or "yes", the resource will not be able to be stopped when started. Otherwise, even if not specified, it will default to the normal behaviour.
:* '''default''': if given a "1", "true" or "yes" value, this resource will be the one who populates the built-in HTTP server main page, which is seen when no resource is given in the web address. It is not possible to have more than one default resource.

==Deprecated settings==

The following settings have been deprecated in the production version of MTA:SA and no longer work.

====networkencryption====

:''<networkencryption>1</networkencryption>
:This parameter specifies whether communications between the server and client is encrypted. Encryption can help prevent network data being viewed and modified.
:Values: 0 - disabled , 1 - enabled ; default value: 1. Optional parameter.
:This parameter can changed and saved while the server is running with [[setServerConfigSetting]]

====autologin====

:''<autologin>0</autologin>
:Specifies whether or not players should automatically be logged in based on their IP adresses.
:Values: 0 - disabled , 1 - enabled ; default value: 0.

====httpautoclientfiles====

:''<httpautoclientfiles>1</httpautoclientfiles>

[[Category: Support]]
[[ru:Server mtaserver.conf]]
[[pl:mtaserver.conf]]

SetElementData

2024-12-06T13:12:43Z

TheNormalnij: clientChangesPolicy

{{Server client function}}
__NOTOC__
This function stores [[element data]] under a certain key, attached to an element. Element data set using this is then synced with all clients and the server. The data can contain server-created elements, but you should avoid passing data that is not able to be synced such as xmlnodes, acls, aclgroups etc.

As element data is synced to all clients, it can generate a lot of network traffic and be heavy on performance. Events are much more efficient for sending data from a client to the server only, or from the server to a specific client. 
Usage of element data should be discouraged where your goal can be achieved with events like above, and [[table|tables]] for storing and retrieving data.
{{Tip|A simple and efficient way to make a variable known to the server and clients is to use setElementData on the [[root]] element.}}
{{Note|See [[Script security]] for tips on preventing cheaters when using events and element data}}
{{Note|For performance reasons, never use setElementData in events that fire often (like [[onClientRender]]) without further optimization or conditions. In fact, using element data in general, can take such a toll on performance that not using it unless strictly necessary (e.g use alternatives such as storing data in tables) is recommended.}}

{{New items|5.0157|1.5.7-9.20477|A subscription mode has been introduced for [[setElementData]] serverside. When setting data in subscription mode, only clients that are added through [[addElementDataSubscriber]] will receive the data, which is good for performance.
Note this mode only works when setting element data serverside. Setting data clientside still sends the update to all clients if 'synchronize' is set to true.
}}

==Syntax==

<syntaxhighlight lang="lua">
bool setElementData ( element theElement, string key, var value [, bool synchronize = true ] )
</syntaxhighlight>
{{OOP||[[element]]:setData||getElementData}}

===Required Arguments===
*'''theElement:''' The [[element]] you wish to attach the data to.
*'''key:''' The key you wish to store the data under. (Maximum 128 characters.)
*'''value:''' The value you wish to store. See [[element data]] for a list of acceptable datatypes.

===Optional Arguments===
*'''synchronize:''' Determines whether or not the data will be synchronized with the clients(server-side variation) or server(client-side variation)

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

{{New items|5.0157|1.5.7-9.20477|
==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool setElementData ( element theElement, string key, var value [, string syncMode="broadcast", string clientChangesPolicy="default" ] )
</syntaxhighlight>
{{OOP||[[element]]:setData||getElementData}}

===Required Arguments===
*'''theElement:''' The [[element]] you wish to attach the data to.
*'''key:''' The key you wish to store the data under. (Maximum 31 characters.)
*'''value:''' The value you wish to store. See [[element data]] for a list of acceptable datatypes.

===Optional Arguments===
*'''syncMode:''' Synchronisation mode.
**''"broadcast"'' - Synchronise to all clients (default behavior). You can also parse ''true'' for this option.
**''"local"'' - Don't synchronise. You can also parse ''false'' for this option.
**''"subscribe"'' - Only synchronise to specific clients. See [[addElementDataSubscriber]] and [[removeElementDataSubscriber]].
{{New items|6.0160|1.6.0-22790|
*'''clientChangesPolicy:''' Client changes policy.
**''"default"'' - Use '''elementdata_whitelisted''' setting from [[Server_mtaserver.conf|'''mtaserver.conf''']]
**''"allow"'' - Trust changes from clients.
**''"deny"'' - Deny client changes. The server will trigger the [[onPlayerChangesProtectedData]] event when the client attempts to change the value.
}}
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool setElementData ( element theElement, string key, var value [, bool synchronize = true ] )
</syntaxhighlight>
{{OOP||[[element]]:setData||getElementData}}

===Required Arguments===
*'''theElement:''' The [[element]] you wish to attach the data to.
*'''key:''' The key you wish to store the data under. (Maximum 31 characters.)
*'''value:''' The value you wish to store. See [[element data]] for a list of acceptable datatypes.

===Optional Arguments===
*'''synchronize:''' Determines whether or not the data will be synchronized with the server.
</section>

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

==Example==
Example 1
<section name="Server" class="server" show="true">
This example allows a player to add a custom tag onto their nickname, and also reverts it back to normal if they wish.
<syntaxhighlight lang="lua">
function addPlayerCustomTag ( thePlayer, command, newTag )
--Let's make sure the newTag param has been entered...
if ( newTag ) then
--Grab their current playername for saving.
local sPlayerNickname = getPlayerName ( thePlayer )
--Create their new nickname with their tag
local sNewPlayerNickname = newTag .. " " .. sPlayerNickname

--Let's first load the element data, see if it's there already
--The reason for this is that if a player were to do /addtag twice,
--the tag would be prepended a second time
local sOldNick = getElementData( thePlayer, "tempdata.originalnick" )
if ( sOldNick == false ) then
--Save their orignal nickname in their element data
setElementData ( thePlayer, "tempdata.originalnick", sPlayerNickname )
end

--Set their new nickname globally
setPlayerName ( thePlayer, sNewPlayerNickname )

--Tell them it's done
outputChatBox ( "Your new nickname has been set, to put it back to its original state you can use /deltag", thePlayer )
else
--The newTag param was not entered, give an error message
outputChatBox ( "/addtag - Incorrect syntax, Correct: /addtag <newtag>", thePlayer )
end
end
addCommandHandler ( "addtag", addPlayerCustomTag )

function removePlayerCustomTag ( thePlayer, command )
--We first need to check that they have already used /addtag, let's do that now
local sOldNick = getElementData( thePlayer, "tempdata.originalnick" )
if ( sOldNick ) then
--Great, they have a tag added, let's reset them

--First we will want to reset the element data back to its default (that being false)
setElementData ( thePlayer, "tempdata.originalnick", false )

--Now set the client name back
setPlayerName( thePlayer, sOldNick )

--Notify them
outputChatBox ( "Your old nickname has been set", thePlayer )
end
end
addCommandHandler ( "deltag", removePlayerCustomTag )
</syntaxhighlight>
</section>
[[tr:setElementData]]

==See Also==
[[pt-br:SetElementData]]
{{Element_functions}}

Template:Vehicle functions

2024-10-15T13:42:30Z

TheNormalnij: Add spawnVehicleFlyingComponent

<includeonly>
<ul>
{{#if: {{{1|}}}
| {{#ifeq: {{lc:{{{1}}}}} | client
|

<li>[[areVehicleLightsOn]]</li>
<li>[[getHeliBladeCollisionsEnabled]]</li>
<li>[[getHelicopterRotorSpeed]]</li>
{{New feature/item|3.0161|1.6.0|22344|
<li>[[getVehicleRotorSpeed]]</li>
}}
<li>[[getVehicleAdjustableProperty]]</li>
<li>[[getVehicleComponentPosition]]</li>
<li>[[getVehicleComponentRotation]]</li>
<li>[[getVehicleComponents]]</li>
<li>[[getVehicleComponentScale]]</li>
<li>[[getVehicleComponentVisible]]</li>
<li>[[getVehicleCurrentGear]]</li>
<li>[[getVehicleDummyPosition]]</li>
{{New items|3.0161|1.6.0|
<li>[[getVehicleEntryPoints]]</li>
|22649}}
<li>[[getVehicleGravity]]</li>
<li>[[getVehicleLandingGearDown]]</li>
<li>[[getVehicleModelDummyDefaultPosition]]</li>
<li>[[getVehicleModelDummyPosition]]</li>
<li>[[getVehicleModelExhaustFumesPosition]]</li>
<li>[[getVehicleModelWheelSize]]</li>
<li>[[getVehicleNitroCount]]</li>
<li>[[getVehicleNitroLevel]]</li>
<li>[[getVehicleWheelFrictionState]]</li>
<li>[[getVehicleWheelScale]]</li>
<li>[[isTrainChainEngine]]</li>
<li>[[isVehicleNitroActivated]]</li>
<li>[[isVehicleNitroRecharging]]</li>
<li>[[isVehicleOnGround]]</li>
<li>[[isVehicleWheelOnGround]]</li>
<li>[[isVehicleWindowOpen]]</li>
<li>[[resetVehicleComponentPosition]]</li>
<li>[[resetVehicleComponentRotation]]</li>
<li>[[resetVehicleComponentScale]]</li>
<li>[[resetVehicleDummyPositions]]</li>
<li>[[setHeliBladeCollisionsEnabled]]</li>
<li>[[setHelicopterRotorSpeed]]</li>
{{New items|3.0161|1.6.0|
<li>[[setVehicleRotorSpeed]]</li>
|22344}}
<li>[[setVehicleAdjustableProperty]]</li>
<li>[[setVehicleComponentPosition]]</li>
<li>[[setVehicleComponentRotation]]</li>
<li>[[setVehicleComponentScale]]</li>
<li>[[setVehicleComponentVisible]]</li>
<li>[[setVehicleDummyPosition]]</li>
<li>[[setVehicleGravity]]</li>
<li>[[setVehicleLandingGearDown]]</li>
<li>[[setVehicleModelDummyPosition]]</li>
<li>[[setVehicleModelExhaustFumesPosition]]</li>
<li>[[setVehicleModelWheelSize]]</li>
<li>[[setVehicleNitroActivated]]</li>
<li>[[setVehicleNitroCount]]</li>
<li>[[setVehicleNitroLevel]]</li>
<li>[[setVehicleWheelScale]]</li>
<li>[[setVehicleWheelStates]]</li>
<li>[[setVehicleWindowOpen]]</li>
{{New items|3.0161|1.6.0|
<li>[[setVehicleWheelsRotation]]</li>
|22592}}
| {{#ifeq: {{lc:{{{1}}}}} | server
|

<li>[[addVehicleSirens]]</li>
<li>[[getModelHandling]]</li>
<li>[[getVehicleIdleRespawnDelay]]</li>
<li>[[getVehicleRespawnDelay]]</li>
<li>[[getVehicleRespawnPosition]]</li>
<li>[[getVehicleRespawnRotation]]</li>
<li>[[getVehiclesOfType]]</li>
<li>[[isVehicleRespawnable]]</li>
<li>[[removeVehicleSirens]]</li>
<li>[[resetVehicleExplosionTime]]</li>
<li>[[resetVehicleIdleTime]]</li>
<li>[[respawnVehicle]]</li>
<li>[[setModelHandling]]</li>
<li>[[setVehicleIdleRespawnDelay]]</li>
<li>[[setVehicleRespawnDelay]]</li>
<li>[[setVehicleRespawnPosition]]</li>
<li>[[setVehicleRespawnRotation]]</li>
<li>[[spawnVehicle]]</li>
<li>[[toggleVehicleRespawn]]</li>
}}
}}

<li style="list-style: none; margin-left: -1.6em;">'''Shared'''</li>
}}


<li>[[addVehicleUpgrade]]</li>
<li>[[attachTrailerToVehicle]]</li>
<li>[[blowVehicle]]</li>
<li>[[createVehicle]]</li>
<li>[[detachTrailerFromVehicle]]</li>
<li>[[fixVehicle]]</li>
<li>[[getOriginalHandling]]</li>
<li>[[getTrainDirection]]</li>
<li>[[getTrainPosition]]</li>
<li>[[getTrainSpeed]]</li>
<li>[[getTrainTrack]]</li>
<li>[[getVehicleColor]]</li>
<li>[[getVehicleCompatibleUpgrades]]</li>
<li>[[getVehicleController]]</li>
<li>[[getVehicleDoorOpenRatio]]</li>
<li>[[getVehicleDoorState]]</li>
<li>[[getVehicleEngineState]]</li>
<li>[[getVehicleHandling]]</li>
<li>[[getVehicleHeadLightColor]]</li>
<li>[[getVehicleLandingGearDown]]</li>
<li>[[getVehicleLightState]]</li>
<li>[[getVehicleMaxPassengers]]</li>
<li>[[getVehicleModelFromName]]</li>
<li>[[getVehicleName]]</li>
<li>[[getVehicleNameFromModel]]</li>
<li>[[getVehicleOccupant]]</li>
<li>[[getVehicleOccupants]]</li>
<li>[[getVehicleOverrideLights]]</li>
<li>[[getVehiclePaintjob]]</li>
<li>[[getVehiclePanelState]]</li>
<li>[[getVehiclePlateText]]</li>
<li>[[getVehicleSirenParams]]</li>
<li>[[getVehicleSirens]]</li>
<li>[[getVehicleSirensOn]]</li>
<li>[[getVehicleTowedByVehicle]]</li>
<li>[[getVehicleTowingVehicle]]</li>
<li>[[getVehicleTurretPosition]]</li>
{{Deprecated items|3.0156|1.5.6|
<li>[[getVehicleTurnVelocity]]</li>
}}
<li>[[getVehicleType]]</li>
<li>[[getVehicleUpgradeOnSlot]]</li>
<li>[[getVehicleUpgradeSlotName]]</li>
<li>[[getVehicleUpgrades]]</li>
<li>[[getVehicleVariant]]</li>
<li>[[getVehicleWheelStates]]</li>
<li>[[isTrainDerailable]]</li>
<li>[[isTrainDerailed]]</li>
<li>[[isVehicleBlown]]</li>
<li>[[isVehicleDamageProof]]</li>
<li>[[isVehicleFuelTankExplodable]]</li>
<li>[[isVehicleLocked]]</li>
<li>[[isVehicleOnGround]]</li>
<li>[[isVehicleTaxiLightOn]]</li>
<li>[[removeVehicleUpgrade]]</li>
<li>[[setTrainDerailable]]</li>
<li>[[setTrainDerailed]]</li>
<li>[[setTrainDirection]]</li>
<li>[[setTrainPosition]]</li>
<li>[[setTrainSpeed]]</li>
<li>[[setTrainTrack]]</li>
<li>[[setVehicleColor]]</li>
<li>[[setVehicleDamageProof]]</li>
<li>[[setVehicleDoorOpenRatio]]</li>
<li>[[setVehicleDoorState]]</li>
<li>[[setVehicleDoorsUndamageable]]</li>
<li>[[setVehicleEngineState]]</li>
<li>[[setVehicleFuelTankExplodable]]</li>
<li>[[setVehicleHandling]]</li>
<li>[[setVehicleHeadLightColor]]</li>
<li>[[setVehicleLandingGearDown]]</li>
<li>[[setVehicleLightState]]</li>
<li>[[setVehicleLocked]]</li>
<li>[[setVehicleOverrideLights]]</li>
<li>[[setVehiclePaintjob]]</li>
<li>[[setVehiclePanelState]]</li>
<li>[[setVehiclePlateText]]</li>
<li>[[setVehicleSirens]]</li>
<li>[[setVehicleSirensOn]]</li>
<li>[[setVehicleTaxiLightOn]]</li>
{{Deprecated items|3.0156|1.5.6|
<li>[[setVehicleTurnVelocity]]</li>
}}
<li>[[setVehicleTurretPosition]]</li>
<li>[[setVehicleVariant]]</li>
<li>[[setVehicleWheelStates]]</li>
{{New items|3.0161|1.6.0|
<li>[[spawnVehicleFlyingComponent]]</li>
|22771}}
</ul>
</includeonly>

<noinclude>
{{Functions list info}}
[[Category:Functions templates]]</noinclude>

EngineStreamingRequestModel

2024-08-29T10:55:45Z

TheNormalnij: References counter

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.1|22676|This function sends a loading request to the game model streamer.}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineStreamingRequestModel( number modelID [, boolean addRef = false, boolean isBlocking = false ] )
</syntaxhighlight>

===Required Arguments===
* '''modelID''': ID of the model you want to load

===Optional Arguments===
{{OptionalArg}}
* '''addRef''': increase references counter to prevent the model from unloading.
* '''isBlocking''': load model immediately or use async loading.

===Returns===
Returns ''true'' if a new request was created, '''false''' otherwise.

===References counter===
This function has individual references counter for each resource. If you called '''engineStreamingRequestModel''' with increasing the counter twice, you should call '''engineStreamingReleaseModel''' twice to decrease the counter.
MTA resets the counter after stopping a resource and calling [[engineFreeModel]].

==Example==
<section name="Simple example" class="client" show="true">
This example draws a model
<syntaxhighlight lang="lua">
local modelId = 1337

local function drawMyModel()
dxDrawModel3D(modelId, 0, 0, 4, 0, 0, 0)
end

local function startDraw()
engineStreamingRequestModel(modelId, true, true)
addEventHandler("onClientPreRender", root, drawMyModel)
end

local function stopDraw()
engineStreamingReleaseModel(modelId, true)
removeEventHandler("onClientPreRender", root, drawMyModel)
end
</syntaxhighlight>
</section>

==See Also==
{{Engine_functions}}

EngineStreamingReleaseModel

2024-08-29T09:59:25Z

TheNormalnij: Created page with "__NOTOC__ {{Client function}} {{New feature/item|4|1.6.1|22676|This function sends a unloading request to the game model streamer.}} ==Syntax== <syntaxhighlight lang="lua"> boolean engineStreamingReleaseModel( number modelID [, boolean removeRef = false ] ) </syntaxhighlight> ===Required Arguments=== * '''modelID''': ID of the model you want to unload. ===Optional Arguments=== {{OptionalArg}} * '''removeRef''': decrease references counter. ===Returns=== Returns ''tr..."

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.1|22676|This function sends a unloading request to the game model streamer.}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineStreamingReleaseModel( number modelID [, boolean removeRef = false ] )
</syntaxhighlight>

===Required Arguments===
* '''modelID''': ID of the model you want to unload.

===Optional Arguments===
{{OptionalArg}}
* '''removeRef''': decrease references counter.

===Returns===
Returns ''true'' if the model was unloaded, '''false''' otherwise.

==Example==
<section name="Simple example" class="client" show="true">
This example draws a model
<syntaxhighlight lang="lua">
local modelId = 1337

local function drawMyModel()
dxDrawModel3D(modelId, 0, 0, 4, 0, 0, 0)
end

local function startDraw()
engineStreamingRequestModel(modelId, true, true)
addEventHandler("onClientPreRender", root, drawMyModel)
end

local function stopDraw()
engineStreamingReleaseModel(modelId, true)
removeEventHandler("onClientPreRender", root, drawMyModel)
end
</syntaxhighlight>
</section>

==See Also==
{{Engine_functions}}

EngineStreamingRequestModel

2024-08-29T09:48:25Z

TheNormalnij:

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.1|22676|This function sends a loading request to the game model streamer.}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineStreamingRequestModel( number modelID [, boolean addRef = false, boolean isBlocking = false ] )
</syntaxhighlight>

===Required Arguments===
* '''modelID''': ID of the model you want to load

===Optional Arguments===
{{OptionalArg}}
* '''addRef''': increase references counter to prevent the model from unloading.
* '''isBlocking''': load model immediately or use async loading.

===Returns===
Returns ''true'' if a new request was created, '''false''' otherwise.

==Example==
<section name="Simple example" class="client" show="true">
This example draws a model
<syntaxhighlight lang="lua">
local modelId = 1337

local function drawMyModel()
dxDrawModel3D(modelId, 0, 0, 4, 0, 0, 0)
end

local function startDraw()
engineStreamingRequestModel(modelId, true, true)
addEventHandler("onClientPreRender", root, drawMyModel)
end

local function stopDraw()
engineStreamingReleaseModel(modelId, true)
removeEventHandler("onClientPreRender", root, drawMyModel)
end
</syntaxhighlight>
</section>

==See Also==
{{Engine_functions}}

EngineStreamingRequestModel

2024-08-29T09:47:04Z

TheNormalnij: Created page with "__NOTOC__ {{Client function}} {{New feature/item|4|1.6.1|22676|This function sends a loading request to the game model streamer.}} ==Syntax== <syntaxhighlight lang="lua"> boolean engineStreamingRequestModel( number modelID [, boolean addRef = false, boolean isBlocking = false ] ) </syntaxhighlight> ===Required Arguments=== * '''modelID''': ID of the model you want to get flags. ===Optional Arguments=== {{OptionalArg}} * '''addRef''': increase references counter to pr..."

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.1|22676|This function sends a loading request to the game model streamer.}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineStreamingRequestModel( number modelID [, boolean addRef = false, boolean isBlocking = false ] )
</syntaxhighlight>

===Required Arguments===
* '''modelID''': ID of the model you want to get flags.

===Optional Arguments===
{{OptionalArg}}
* '''addRef''': increase references counter to prevent the model from unloading.
* '''isBlocking''': load model immediately or use async loading.

===Returns===
Returns ''true'' if a new request was created, '''false''' otherwise.

==Example==
<section name="Simple example" class="client" show="true">
This example draws a model
<syntaxhighlight lang="lua">
local modelId = 1337

local function drawMyModel()
dxDrawModel3D(modelId, 0, 0, 4, 0, 0, 0)
end

local function startDraw()
engineStreamingRequestModel(modelId, true, true)
addEventHandler("onClientPreRender", root, drawMyModel)
end

local function stopDraw()
engineStreamingReleaseModel(modelId, true)
removeEventHandler("onClientPreRender", root, drawMyModel)
end
</syntaxhighlight>
</section>

==See Also==
{{Engine_functions}}

EngineStreamingGetModelLoadState

2024-08-29T09:16:31Z

TheNormalnij: Created page with "__NOTOC__ {{Client function}} {{New feature/item|4|1.6.1|22676|This function returns load state of model.}} ==Syntax== <syntaxhighlight lang="lua"> string engineStreamingGetModelLoadState( number modelID ) </syntaxhighlight> ===Required Arguments=== * '''modelID''': ID of the model you want to get flags. ===Returns=== Returns ''string'' with model load state. Possible load states: * unloaded - model is not loaded. * loaded - model is loaded. * requested - model is wa..."

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.1|22676|This function returns load state of model.}}

==Syntax==
<syntaxhighlight lang="lua">
string engineStreamingGetModelLoadState( number modelID )
</syntaxhighlight>

===Required Arguments===
* '''modelID''': ID of the model you want to get flags.

===Returns===
Returns ''string'' with model load state.
Possible load states:
* unloaded - model is not loaded.
* loaded - model is loaded.
* requested - model is waiting for loading.
* reading - model is being read
* finishing - second reading state for big models.

==See Also==
{{Engine_functions}}

Template:Engine functions

2024-08-28T11:21:42Z

TheNormalnij: Add model streaming functions

<ul>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineAddImage]]</li>
}}
<li>[[engineApplyShaderToWorldTexture]]</li>
<li>[[engineFreeModel]]</li>
{{Added feature/item|1.6.1|1.6.0|22190|
<li>[[engineFreeTXD]]</li>
}}
{{Added feature/item|1.6.0|1.5.9|21695|
<li>[[engineGetModelFlags]]</li>
}}
<li>[[engineGetModelIDFromName]]</li>
<li>[[engineGetModelLODDistance]]</li>
<li>[[engineGetModelNameFromID]]</li>
<li>[[engineGetModelPhysicalPropertiesGroup]]</li>
<li>[[engineGetModelTextureNames]]</li>
<li>[[engineGetModelTextures]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineGetModelTXDID]]</li>
}}
{{Added feature/item|1.5.9|1.5.8|20704|
<li>[[engineGetModelVisibleTime]]</li>
}}
<li>[[engineGetObjectGroupPhysicalProperty]]</li>
<li>[[engineGetSurfaceProperties]]</li>
<li>[[engineGetVisibleTextureNames]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineImageGetFilesCount]]</li>
<li>[[engineImageGetFiles]]</li>
<li>[[engineImageGetFile]]</li>
<li>[[engineImageLinkDFF]]</li>
<li>[[engineImageLinkTXD]]</li>
}}
<li>[[engineImportTXD]]</li>
<li>[[engineLoadCOL]]</li>
<li>[[engineLoadDFF]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineLoadIMG]]</li>
}}
<li>[[engineLoadIFP]]</li>
<li>[[engineLoadTXD]]</li>
{{New items|3.0161|1.6.0|
<li>[[enginePreloadWorldArea]]</li>
|22678}}
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineRemoveImage]]</li>
}}
<li>[[engineRemoveShaderFromWorldTexture]]</li>
<li>[[engineReplaceAnimation]]</li>
<li>[[engineReplaceCOL]]</li>
<li>[[engineReplaceModel]]</li>
<li>[[engineRequestModel]]</li>
{{Added feature/item|1.6.1|1.6.0|22190|
<li>[[engineRequestTXD]]</li>
}}
{{Added feature/item|1.6.0|1.5.9|21695|
<li>[[engineResetModelFlags]]</li>
}}
<li>[[engineResetModelLODDistance]]</li>
{{Added feature/item|1.6.1|1.6.0|22190|
<li>[[engineResetModelTXDID]]</li>
}}
<li>[[engineResetSurfaceProperties]]</li>
<li>[[engineRestoreAnimation]]</li>
<li>[[engineRestoreCOL]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineRestoreDFFImage]]</li>
}}
<li>[[engineRestoreModel]]</li>
<li>[[engineRestoreModelPhysicalPropertiesGroup]]</li>
<li>[[engineRestoreObjectGroupPhysicalProperties]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineRestoreTXDImage]]</li>
}}
{{Added feature/item|1.5.9|1.5.8|20704|
<li>[[engineRestreamWorld]]</li>
}}
<li>[[engineSetAsynchronousLoading]]</li>
{{Added feature/item|1.6.0|1.5.9|21695|
<li>[[engineSetModelFlag]]</li>
<li>[[engineSetModelFlags]]</li>
}}
<li>[[engineSetModelLODDistance]]</li>
<li>[[engineSetModelPhysicalPropertiesGroup]]</li>
{{Added feature/item|1.6.1|1.6.0|22190|
<li>[[engineSetModelTXDID]]</li>
}}
{{Added feature/item|1.5.9|1.5.8|20704|
<li>[[engineSetModelVisibleTime]]</li>
}}
<li>[[engineSetObjectGroupPhysicalProperty]]</li>
<li>[[engineSetSurfaceProperties]]</li>
{{Added feature/item|1.5.9|1.5.8|20901|
<li>[[engineStreamingFreeUpMemory]]</li>
<li>[[engineStreamingGetUsedMemory]]</li>
}}

{{Added feature/item|1.6.1|1.6.0|21874|
<li>[[engineStreamingSetMemorySize]]</li>
<li>[[engineStreamingGetMemorySize]]</li>
<li>[[engineStreamingRestoreMemorySize]]</li>
<li>[[engineStreamingSetBufferSize]]</li>
<li>[[engineStreamingGetBufferSize]]</li>
<li>[[engineStreamingRestoreBufferSize]]</li>
}}

{{Added feature/item|1.6.1|1.6.0|21947|
<li>[[engineStreamingSetModelCacheLimits]]</li>
}}

{{Added feature/item|1.6.1|1.6.0|22471|
<li>[[engineGetPoolCapacity]]</li>
<li>[[engineSetPoolCapacity]]</li>
<li>[[engineGetPoolDefaultCapacity]]</li>
<li>[[engineGetPoolUsedCapacity]]</li>
}}

{{Added feature/item|1.6.1|1.6.0|22676|
<li>[[engineStreamingRequestModel]]</li>
<li>[[engineStreamingReleaseModel]]</li>
<li>[[engineStreamingGetModelLoadState]]</li>
}}
</ul>

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

CreateBuilding

2024-08-28T11:08:08Z

TheNormalnij:

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6.0|22410|Creates a [[building]] [[element]] at a given position and rotation.}}

==Syntax==
<syntaxhighlight lang="lua">building createBuilding ( int modelId, float x, float y, float z [, float rx, float ry, float rz, int interior = 0 ] )</syntaxhighlight>
{{OOP||[[Building]]||}}

===Required Arguments===
*'''modelId:''' A whole integer specifying the GTA:SA object model ID.
*'''x:''' A floating point number representing the X coordinate on the map.
*'''y:''' A floating point number representing the Y coordinate on the map.
*'''z:''' A floating point number representing the Z coordinate on the map.

===Optional Arguments===
{{OptionalArg}}
*'''rx:''' A floating point number representing the rotation about the X axis in degrees.
*'''ry:''' A floating point number representing the rotation about the Y axis in degrees.
*'''rz:''' A floating point number representing the rotation about the Z axis in degrees.
*'''interior:''' The interior you want to set the building to. Valid values are 0 to 255.

===Returns===
* Returns the [[building]] element if the creation was successful, throws an error otherwise.

==Example==
<section name="Simple example" class="client" show="true">
This example creates a building when the resource starts:
<syntaxhighlight lang="lua">
function loadMap()
-- create a *building* at a specified position with a specified rotation
createBuilding(4550, 1985, -2544, 94, 0,0,0) -- Maze Bank Tower in LS airport
end
addEventHandler("onClientResourceStart", resourceRoot, loadMap)
</syntaxhighlight>
</section>

==See Also==
{{Building functions}}

EngineImageLinkTXD

2024-07-21T20:32:47Z

TheNormalnij:

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.0|21695|This function links TXD file with an IMG container. This function does not change a model immediately. You should use [[engineRestreamWorld]] to reload models.}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineImageLinkTXD ( img img_file, string file_path, int txdID )
</syntaxhighlight>

{{OOP||[[img]]:linkTXD}}
===Required Arguments===
* '''img_file''': The [[IMG]] file you want to link.
* '''file_path''': Path to the [[TXD]] file you want to link.
* '''txdID''': ID of the texture dictionary you want to link to. Use [[engineGetModelTXDID]] or [[engineRequestTXD]] to get this value.

===Returns===
Returns ''true'' if [[IMG]] file was successfully linked, ''false'' otherwise.

==Example==

You could use the following code:
<syntaxhighlight lang="lua">
-- Load IMG
local img = engineLoadIMG( "file.img" )

-- Enable streaming from this IMG
engineAddImage( img )

-- Get model TXD id
local infernusModelID = 411
local infernusModelTxdID = engineGetModelTXDID( infernusModelID )

-- Link DFF and TXD to IMG files
engineImageLinkDFF( img, "infernus.dff", infernusModelID )
engineImageLinkTXD( img, "infernus.txd", infernusModelTxdID )

-- Reload game models
engineRestreamWorld()
</syntaxhighlight>

==See Also==
{{Engine_functions}}

EngineImageLinkDFF

2024-07-21T20:32:29Z

TheNormalnij:

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.0|21695|This function links DFF file with an IMG container. This function does not change a model immediately. You should use [[engineRestreamWorld]] to reload models.}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineImageLinkDFF ( img img_file, string file_path, int modelID )
</syntaxhighlight>

{{OOP||[[img]]:linkDFF}}
===Required Arguments===
* '''img_file''': The [[IMG]] file you want to link.
* '''file_path''': Path to the [[DFF]] file you want to link.
* '''modelID''': ID of the model you want to link to.

===Returns===
Returns ''true'' if [[IMG]] file was successfully linked, ''false'' otherwise.

==Example==

You could use the following code:
<syntaxhighlight lang="lua">
-- Load IMG
local img = engineLoadIMG( "file.img" )

-- Enable streaming from this IMG
engineAddImage( img )

-- Get model TXD id
local infernusModelID = 411
local infernusModelTxdID = engineGetModelTXDID( infernusModelID )

-- Link DFF and TXD to IMG files
engineImageLinkDFF( img, "infernus.dff", infernusModelID )
engineImageLinkTXD( img, "infernus.txd", infernusModelTxdID )

-- Reload game models
engineRestreamWorld()
</syntaxhighlight>

==See Also==
{{Engine_functions}}

EngineImageLinkDFF

2024-07-21T20:31:31Z

TheNormalnij:

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.0|21695|This function links DFF file with an IMG container. This function does not change a model immediately. You should use [[engineRestreamWorld]] to reload a model}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineImageLinkDFF ( img img_file, string file_path, int modelID )
</syntaxhighlight>

{{OOP||[[img]]:linkDFF}}
===Required Arguments===
* '''img_file''': The [[IMG]] file you want to link.
* '''file_path''': Path to the [[DFF]] file you want to link.
* '''modelID''': ID of the model you want to link to.

===Returns===
Returns ''true'' if [[IMG]] file was successfully linked, ''false'' otherwise.

==Example==

You could use the following code:
<syntaxhighlight lang="lua">
-- Load IMG
local img = engineLoadIMG( "file.img" )

-- Enable streaming from this IMG
engineAddImage( img )

-- Get model TXD id
local infernusModelID = 411
local infernusModelTxdID = engineGetModelTXDID( infernusModelID )

-- Link DFF and TXD to IMG files
engineImageLinkDFF( img, "infernus.dff", infernusModelID )
engineImageLinkTXD( img, "infernus.txd", infernusModelTxdID )

-- Reload game models
engineRestreamWorld()
</syntaxhighlight>

==See Also==
{{Engine_functions}}

EngineImageLinkDFF

2024-07-21T20:31:10Z

TheNormalnij:

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.0|21695|This function links DFF file with an IMG container. This function does not change model immediately. You should use [[engineRestreamWorld]] to reload a model}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineImageLinkDFF ( img img_file, string file_path, int modelID )
</syntaxhighlight>

{{OOP||[[img]]:linkDFF}}
===Required Arguments===
* '''img_file''': The [[IMG]] file you want to link.
* '''file_path''': Path to the [[DFF]] file you want to link.
* '''modelID''': ID of the model you want to link to.

===Returns===
Returns ''true'' if [[IMG]] file was successfully linked, ''false'' otherwise.

==Example==

You could use the following code:
<syntaxhighlight lang="lua">
-- Load IMG
local img = engineLoadIMG( "file.img" )

-- Enable streaming from this IMG
engineAddImage( img )

-- Get model TXD id
local infernusModelID = 411
local infernusModelTxdID = engineGetModelTXDID( infernusModelID )

-- Link DFF and TXD to IMG files
engineImageLinkDFF( img, "infernus.dff", infernusModelID )
engineImageLinkTXD( img, "infernus.txd", infernusModelTxdID )

-- Reload game models
engineRestreamWorld()
</syntaxhighlight>

==See Also==
{{Engine_functions}}

EngineImageLinkTXD

2024-07-21T20:27:26Z

TheNormalnij: /* Example */

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.0|21695|This function links TXD file with an IMG container.}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineImageLinkTXD ( img img_file, string file_path, int txdID )
</syntaxhighlight>

{{OOP||[[img]]:linkTXD}}
===Required Arguments===
* '''img_file''': The [[IMG]] file you want to link.
* '''file_path''': Path to the [[TXD]] file you want to link.
* '''txdID''': ID of the texture dictionary you want to link to. Use [[engineGetModelTXDID]] or [[engineRequestTXD]] to get this value.

===Returns===
Returns ''true'' if [[IMG]] file was successfully linked, ''false'' otherwise.

==Example==

You could use the following code:
<syntaxhighlight lang="lua">
-- Load IMG
local img = engineLoadIMG( "file.img" )

-- Enable streaming from this IMG
engineAddImage( img )

-- Get model TXD id
local infernusModelID = 411
local infernusModelTxdID = engineGetModelTXDID( infernusModelID )

-- Link DFF and TXD to IMG files
engineImageLinkDFF( img, "infernus.dff", infernusModelID )
engineImageLinkTXD( img, "infernus.txd", infernusModelTxdID )

-- Reload game models
engineRestreamWorld()
</syntaxhighlight>

==See Also==
{{Engine_functions}}

EngineImageLinkDFF

2024-07-21T20:26:59Z

TheNormalnij: /* Example */

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.0|21695|This function links DFF file with an IMG container.}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineImageLinkDFF ( img img_file, string file_path, int modelID )
</syntaxhighlight>

{{OOP||[[img]]:linkDFF}}
===Required Arguments===
* '''img_file''': The [[IMG]] file you want to link.
* '''file_path''': Path to the [[DFF]] file you want to link.
* '''modelID''': ID of the model you want to link to.

===Returns===
Returns ''true'' if [[IMG]] file was successfully linked, ''false'' otherwise.

==Example==

You could use the following code:
<syntaxhighlight lang="lua">
-- Load IMG
local img = engineLoadIMG( "file.img" )

-- Enable streaming from this IMG
engineAddImage( img )

-- Get model TXD id
local infernusModelID = 411
local infernusModelTxdID = engineGetModelTXDID( infernusModelID )

-- Link DFF and TXD to IMG files
engineImageLinkDFF( img, "infernus.dff", infernusModelID )
engineImageLinkTXD( img, "infernus.txd", infernusModelTxdID )

-- Reload game models
engineRestreamWorld()
</syntaxhighlight>

==See Also==
{{Engine_functions}}

EngineSetPoolCapacity

2024-06-22T14:16:44Z

TheNormalnij: Created page with "__NOTOC__ {{Client function}} {{New feature/item|4|1.6.0|22471|This function changes the capacity of the provided pool.}} ==Syntax== <syntaxhighlight lang="lua"> boolean engineSetPoolCapacity( string pool, number capacity ) </syntaxhighlight> ===Required Arguments=== * '''pool''': Name of the pool * '''capacity ''': New size ===Returns=== '''true''' if the pool capacity was changed and '''false''' if not. Throws an error if the pool is invalid. {{Engine_pools}} ==S..."

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.0|22471|This function changes the capacity of the provided pool.}}

==Syntax==
<syntaxhighlight lang="lua">
boolean engineSetPoolCapacity( string pool, number capacity )
</syntaxhighlight>

===Required Arguments===
* '''pool''': Name of the pool
* '''capacity ''': New size

===Returns===
'''true''' if the pool capacity was changed and '''false''' if not. Throws an error if the pool is invalid.

{{Engine_pools}}

==See Also==
{{Engine_functions}}

EngineGetPoolCapacity

2024-06-22T14:11:00Z

TheNormalnij: Created page with "__NOTOC__ {{Client function}} {{New feature/item|4|1.6.0|22471|This function returns the capacity of the provided pool.}} ==Syntax== <syntaxhighlight lang="lua"> number engineGetPoolCapacity( string pool ) </syntaxhighlight> ===Required Arguments=== * '''pool''': Name of the pool ===Returns=== The capacity of the provided pool as positive number {{Engine_pools}} ==See Also== {{Engine_functions}}"

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.0|22471|This function returns the capacity of the provided pool.}}

==Syntax==
<syntaxhighlight lang="lua">
number engineGetPoolCapacity( string pool )
</syntaxhighlight>

===Required Arguments===
* '''pool''': Name of the pool

===Returns===
The capacity of the provided pool as positive number

{{Engine_pools}}

==See Also==
{{Engine_functions}}

EngineGetPoolUsedCapacity

2024-06-22T14:08:57Z

TheNormalnij: Created page with "__NOTOC__ {{Client function}} {{New feature/item|4|1.6.0|22471|This function returns the used capacity of the provided pool.}} ==Syntax== <syntaxhighlight lang="lua"> number engineGetPoolUsedCapacity( string pool ) </syntaxhighlight> ===Required Arguments=== * '''pool''': Name of the pool ===Returns=== The used capacity of the provided pool as positive number {{Engine_pools}} ==See Also== {{Engine_functions}}"

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.0|22471|This function returns the used capacity of the provided pool.}}

==Syntax==
<syntaxhighlight lang="lua">
number engineGetPoolUsedCapacity( string pool )
</syntaxhighlight>

===Required Arguments===
* '''pool''': Name of the pool

===Returns===
The used capacity of the provided pool as positive number

{{Engine_pools}}

==See Also==
{{Engine_functions}}

EngineGetPoolDefaultCapacity

2024-06-22T14:08:05Z

TheNormalnij: Created page with "__NOTOC__ {{Client function}} {{New feature/item|4|1.6.0|22471|This function returns the default capacity of the provided pool.}} ==Syntax== <syntaxhighlight lang="lua"> number engineGetPoolDefaultCapacity( string pool ) </syntaxhighlight> ===Required Arguments=== * '''pool''': Name of the pool ===Returns=== The default capacity of the provided pool as positive number {{Engine_pools}} ==See Also== {{Engine_functions}}"

__NOTOC__
{{Client function}}

{{New feature/item|4|1.6.0|22471|This function returns the default capacity of the provided pool.}}

==Syntax==
<syntaxhighlight lang="lua">
number engineGetPoolDefaultCapacity( string pool )
</syntaxhighlight>

===Required Arguments===
* '''pool''': Name of the pool

===Returns===
The default capacity of the provided pool as positive number

{{Engine_pools}}

==See Also==
{{Engine_functions}}

Template:Engine pools

2024-06-22T13:59:01Z

TheNormalnij: Created page with "===Engine pools=== {|class="wikitable sortable" |- ! Name || Default size || Resizable || Description |- | building || 13000 || yes || Static world objects. Terrain, roads, buildings... |- | dummy|| 2500 || no || Dynamic world objects. Doors, fences, boxes |- | ped || 140 || no || Peds |- | object || 1200 || no || Scriptable objects |- | vehicle || 110 || no || Vehicles |- | col-model || 12000 || no || |- | task || 5000 || no || |- | event || 5000 || no || |- | task-allo..."

===Engine pools===
{|class="wikitable sortable"
|-
! Name || Default size || Resizable || Description
|-
| building || 13000 || yes || Static world objects. Terrain, roads, buildings...
|-
| dummy|| 2500 || no || Dynamic world objects. Doors, fences, boxes
|-
| ped || 140 || no || Peds
|-
| object || 1200 || no || Scriptable objects
|-
| vehicle || 110 || no || Vehicles
|-
| col-model || 12000 || no ||
|-
| task || 5000 || no ||
|-
| event || 5000 || no ||
|-
| task-allocator || 16 || no ||
|-
| ped-intelligence || 64 || no ||
|-
| ped-attractor || 64 || no ||
|-
| entry-info-node || 72600 || no ||
|-
| node-route || 64 || no ||
|-
| patrol-route || 32 || no ||
|-
| point-route || 64 || no ||
|-
| pointer-double-link-pool || 74800 || no ||
|-
| pointer-single-link-pool || 90000 || no ||
|-
| env-map-material || 16000 || no ||
|-
| env-map-atomic || 4000 || no ||
|-
| spec-map-material || 16000 || no ||
|}

Changes in 1.6

2024-06-17T17:31:31Z

TheNormalnij: Vladislav Nikolaevich and Uladzislau Nikalayevich and TheNormalnij is me

<pageclass class="#39dd57" subcaption="Current release"></pageclass>
{{Changelogs}}
__NOTOC__
1.6.0 was released on June 16, 2023. Beta was initially released on April 7, 2023.

* GitHub commit log: https://github.com/multitheftauto/mtasa-blue/compare/1.5.9...1.6.0
* GitHub milestone: https://github.com/multitheftauto/mtasa-blue/milestone/9
* Resources GitHub commit log: https://github.com/multitheftauto/mtasa-resources/compare/1.5.9...1.6.0
* Pre-release announcement on forums: https://forum.multitheftauto.com/topic/140285-multi-theft-auto-san-andreas-16-is-ready-for-testing/
* Release announcement on forums: https://forum.multitheftauto.com/topic/140935-multi-theft-auto-san-andreas-16-is-released/

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

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

== 12 Backwards Incompatible Changes ==
These changes will take effect in this version and scripts may need to be manually upgraded when updating:

:* Bloodring Banger (504) is now defined as doorless, to fix animations to be consistent with single player, this also causes [[setVehicleLocked]] to not lock the vehicle anymore, as entry happens through the window.
:* [[callRemote]] callbacks currently set the error code to ''nil'' when there is no error. In this version, to be consistent with [[fetchRemote]], the error code reported will be '''0''' ([https://github.com/multitheftauto/mtasa-blue/issues/294 #294]).
:* Since Aug 2015, we replaced the custom ''mtalocal://'' URL scheme with '''http://mta/resourceName/blah.html'''. The ''mtalocal://'' URL scheme will now be removed ([https://github.com/multitheftauto/mtasa-blue/issues/1071 #1071]).
:* Since Jul 2016 if you provide an invalid string like ''"randomstring"'' when a function expects a number, the string will be treated as '''0''' and raise a script warning. This will be now an error. You will still be able to provide strings containing numbers (e.g. ''"100"'' and ''"12.34"''), this change only affects invalid strings ([https://github.com/multitheftauto/mtasa-blue/issues/1043 #1043]).
:* Some functions expect only unsigned integers (positive numbers), and since Jan 2016 providing negative numbers would be a warning. This will now be an error ([https://github.com/multitheftauto/mtasa-blue/issues/1070 #1070]).
:* When providing a width and height of ''(0, 0)'' to [[createBrowser]] or [[guiCreateBrowser]] you will encounter a script error instead of a warning, introduced in Feb 2019 ([https://github.com/multitheftauto/mtasa-blue/issues/1069 #1069]).
:* The previously unused ''z'' argument in [[getElementsWithinRange]] now calculates elements in 3D space instead of 2D space ([https://github.com/multitheftauto/mtasa-blue/pull/1994 #1994]).
:* Flamethrower ammo is no longer multiplied by 10 ([https://github.com/multitheftauto/mtasa-blue/issues/481 #481]).
:* Server-side [[createBlip]] now syncs blip size and color regardless of icon ID, previously only icon ID 0 had its size and color synced to clients ([https://github.com/multitheftauto/mtasa-blue/issues/1399 #1399]).
:* Server-side [[givePlayerMoney]] and [[setPlayerMoney]] cap has been raised from 99.999.999 (8 digits) to 999.999.999 (9 digits) to match the maximum native UI value ([https://github.com/multitheftauto/mtasa-blue/issues/2654 #2654]).
:* Players are now synced when exiting vehicle ([https://github.com/multitheftauto/mtasa-blue/pull/2084 #2084]).
:* Server-side objects that were unbreakable by default, but would have been breakable client-side by default, are now breakable by default also server-side ([https://github.com/multitheftauto/mtasa-blue/compare/d701fbe15b4cece7a6cd6242c3819e68deb7aae2...57d5be3d3e323394a8926a79f3da9cd3814e44a2 commit]).

== 5 Deprecations ==
These changes will take effect in this version and scripts may need to be manually upgraded when updating:

:* Changed [[getCameraShakeLevel]], [[setCameraShakeLevel]] to throw a warning on use, please upgrade to [[getCameraDrunkLevel]] and [[setCameraDrunkLevel]] instead ([https://github.com/multitheftauto/mtasa-blue/commit/2651903e6a03c78a0571089b142b175f11f41bab 2651903] by '''Unde-R''')
:* Changed [[givePedJetPack]], [[removePedJetPack]] and [[doesPedHaveJetPack]] to throw a warning on use, please upgrade to [[setPedWearingJetpack]] and [[isPedWearingJetpack]] instead ([https://github.com/multitheftauto/mtasa-blue/commit/804c66b88e0324eb6b2d9c83fdf7606ba05566c6 804c66b] by '''qaisjp''')

== Notable Changes ==
This update is primarily focused on fixes and changes rather than new features, but there are a lot of features planned for the next release!

:* Many high FPS related inconsistency issues have been fixed by Merlin!
:* Script support for custom IMG containers, and ability to set model flags. Thanks to TheNormalnij!
:* A number of graphical effects
::* Added support for vehicle sun glare effect. Thanks to gta191977649 and TheNormalnij.
::* Added corona rain reflections. Thanks to lopezloo.
::* Added big sun lens flare effect. Thanks to gta191977649.
::* Added dynamic ped shadows. Thanks to lopezloo.
::* Grass should now render correctly. Thanks to TFP-dev.
:* ARM support for MTA server is here! This support should still considered experimental. Thanks to botder.
:* Added new ''Default 2023'', ''GWEN Blue'' and ''GWEN Orange'' GUI skins. Thanks to Haxardous.
:* Added missing GTA special [[Character Skins|character skins]] (3, 4, 5, 6, 8, 42, 65, 86, 119, 273, 289). Thanks to Allerek.
:* Pictures taken with the camera weapon are now saved in higher quality. Thanks to lopezloo.
:* Many stability improvements
:* Many synchronization improvements
:* Many varying size fixes, quality of life improvements, updates and security enhancements to both core and resources!
:* Updates to all language translations from our [https://multitheftauto.crowdin.com Crowdin]

== Statistics ==
<section show="true">
These are some statistics since the [[Changes in 1.5.9|previous release]].
:* This is the '''27th''' 1.x.x release
:* '''{{date difference|2021|10|01|2023|06|16}}''' days of which '''{{date difference|2021|10|01|2023|04|07}}''' for beta release
:* '''12''' backwards incompatible changes
:* '''26''' new functions
:* '''1''' new event
:* '''5''' deprecations
:* '''289+''' bug fixes and changes
:* '''956+''' commits ([https://github.com/multitheftauto/mtasa-blue/compare/1.5.9...1.6.0 mtasa-blue]) ([https://github.com/multitheftauto/mtasa-resources/compare/1.5.9...1.6.0 mtasa-resources])
:* '''199''' new open GitHub issues ([https://github.com/multitheftauto/mtasa-blue/issues?q=is%3Aopen+is%3Aissue+created%3A2021-10-01..2023-06-16 see list])
:* '''102''' resolved GitHub issues ([https://github.com/multitheftauto/mtasa-blue/issues?q=is%3Aclosed+is%3Aissue+milestone%3A%221.6.0%22 see list])
:* '''92''' closed GitHub issues ([https://github.com/multitheftauto/mtasa-blue/issues?q=is%3Aclosed+is%3Aissue+closed%3A2021-10-01..2023-06-16+no%3Amilestone+-label%3Ainvalid see list])
:* '''44''' new open GitHub pull requests ([https://github.com/multitheftauto/mtasa-blue/pulls?q=is%3Aopen+is%3Apr+created%3A2021-10-01..2023-06-16 see list])
:* '''219''' merged GitHub pull requests ([https://github.com/multitheftauto/mtasa-blue/pulls?q=is%3Apr+is%3Amerged+milestone%3A%221.6.0%22 see list])
:* '''107''' closed GitHub pull requests ([https://github.com/multitheftauto/mtasa-blue/pulls?q=is%3Apr+is%3Aunmerged+closed%3A2021-10-01..2023-06-16 see list])
:* '''45+''' contributors of which '''17+''' are new ([https://github.com/multitheftauto/mtasa-blue/graphs/contributors?from=2021-10-01&to=2023-06-16&type=c see list])
:* '''100+''' total contributors ([https://github.com/multitheftauto/mtasa-blue/graphs/contributors see list])
:* '''23''' vendor updates

'''Note:''' Last update to these statistics was made {{date difference human friendly|2023|06|17}}.
</section>

== 15 New Features ==
=== Shared ===
:* Added RSA support on [[encodeString]], along with a new function ([https://github.com/multitheftauto/mtasa-blue/commit/e7e3ba5b337f791203ef977bd083a28226614da7 e7e3ba5], [https://github.com/multitheftauto/mtasa-blue/commit/39bc23f136d82a4849a7b09edfa65fc927b52acc 39bc23f] and [https://github.com/multitheftauto/mtasa-blue/commit/83185ef2fbc1ee086cc7acb1a97b4b15bf939a88 83185ef] by '''Inder00''', '''Pirulax''' and '''TheNormalnij''')
:** [[generateKeyPair]]
:* Added HMAC support on [[encodeString]] ([https://github.com/multitheftauto/mtasa-blue/commit/eebf228224860eed030d59d629e905dc9a79b13c eebf228] by '''Inder00''')
:* Added [[getProcessMemoryStats]] ([https://github.com/multitheftauto/mtasa-blue/commit/dd571b4793ac6773c634a1cdc6b28bfa00891127 dd571b4] by '''botder''')

=== Client ===
:* Added support for loading custom IMG containers ([https://github.com/multitheftauto/mtasa-blue/commit/075dfeeac88ddf52063f9ec38a68669ce7c9a948 075dfee] by '''TheNormalnij''')
:** [[engineLoadIMG]]
:** [[engineImageLinkDFF]]
:** [[engineImageLinkTXD]]
:** [[engineRestoreDFFImage]]
:** [[engineRestoreTXDImage]]
:** [[engineAddImage]]
:** [[engineRemoveImage]]
:** [[engineImageGetFilesCount]]
:** [[engineImageGetFiles]]
:** [[engineImageGetFile]]
:** [[engineGetModelTXDID]]
:* Added support for model flags ([https://github.com/multitheftauto/mtasa-blue/commit/ec314df0362829ed52a52aa3ac0b1302c2097c3a ec314df] by '''TheNormalnij''')
:** [[engineSetModelFlags]]
:** [[engineGetModelFlags]]
:** [[engineResetModelFlags]]
:** [[engineGetModelFlag]]
:** [[engineSetModelFlag]]
:* Added vehicle sun glare effect to [[setWorldSpecialPropertyEnabled]] and [[isWorldSpecialPropertyEnabled]] ([https://github.com/multitheftauto/mtasa-blue/commit/1fac28795ece272f0a7fe0b697c793b315ac3459 1fac287] by '''gta191977649''' and '''TheNormalnij''' and [https://github.com/multitheftauto/mtasa-blue/commit/3068896767976610332272a35ceda28fd33bb75f 3068896] and [https://github.com/multitheftauto/mtasa-blue/commit/da49960feb6651e1cb6efb8a63408eb8ad89c30e da49960] by '''gta191977649''')
:* Added support for WebM files to [[playSound]] and [[playSound3D]] ([https://github.com/multitheftauto/mtasa-blue/commit/545a22a531b9f4eee01e3d502cbb38b0d95b4c4f 545a22a] by '''theSarrum''')
:* Added corona rain reflections ([https://github.com/multitheftauto/mtasa-blue/commit/c4caa4b7e82291aca67056fc0f2e9835322f7db9 c4caa4b] by '''lopezloo''')
:* Added [[isCapsLockEnabled]] function ([https://github.com/multitheftauto/mtasa-blue/commit/e84a15e1ea4d47769e14917243ddb2eac54ae5ee e84a15e] by '''Lpsd''')
:* Added [[isMTAWindowFocused]] and [[onClientMTAFocusChange]] ([https://github.com/multitheftauto/mtasa-blue/commit/2438e4f9e7fbdeb67a8013fc17f268e6d19f2044 2438e4f] by '''Lpsd''')
:* Added [[getElementLighting]] ([https://github.com/multitheftauto/mtasa-blue/commit/bc54720421d0dcfa188a9e418d36fb732f061002 bc54720] by '''samr46''')
:* Added [[setChatboxCharacterLimit]] and [[getChatboxCharacterLimit]], and increased character limit to 255 ([https://github.com/multitheftauto/mtasa-blue/commit/82801ab353a5ea50f69c16904d7e678f620729c3 82801ab] by '''Lpsd''')
:* Added [[getAllElementData]] ([https://github.com/multitheftauto/mtasa-blue/commit/0ff6607a6f8196c3b82d1289a315a53fa709da32 0ff6607] by '''Unde-R''' and '''StrixG''')

=== Server ===
:* Added ARM support for the server executable ([https://github.com/multitheftauto/mtasa-blue/commit/8fc9004ec945a2ab74f4262ed0de267752f66675 8fc9004] and [https://github.com/multitheftauto/mtasa-blue/commit/d01bf2eafc3059d4eff764c228dc6b82d5af7ffe d01bf2e] by '''botder''')
:* Added [[isObjectBreakable]] and [[setObjectBreakable]], also added support for the ''breakable'' map object attribute ([https://github.com/multitheftauto/mtasa-blue/compare/d701fbe15b4cece7a6cd6242c3819e68deb7aae2...57d5be3d3e323394a8926a79f3da9cd3814e44a2 commit] by '''patrikjuvonen''')

== 192+ Changes and Bug Fixes ==
=== Shared ===
:* '''[Breaking change]''' Change bad numberstring warning to error ([https://github.com/multitheftauto/mtasa-blue/commit/9baf6a5b6b3fdeb5abaf76c1e2863354aa88e36a 9baf6a5] by '''patrikjuvonen''')
:* '''[Breaking change]''' Change unsigned type check from warning to error ([https://github.com/multitheftauto/mtasa-blue/commit/1cd1b61b4b45e4fcfe2e0e1cb36bf09d74419618 1cd1b61] by '''patrikjuvonen''')
:* '''[Breaking change]''' Added proper 3D radius check to [[getElementsWithinRange]] ([https://github.com/multitheftauto/mtasa-blue/commit/3b2b8fa9017fa27f47af0c6c3090c881a8a44327 3b2b8fa] by '''Pirulax''')
:* Added [[cancelEvent]] support for [[onElementModelChange]] and [[onClientElementModelChange]] ([https://github.com/multitheftauto/mtasa-blue/commit/7e7255280d3c42f7a36329f496d72c2b9efafe57 7e72552] by '''TheNormalnij''')
:* Fixed calling of [[onClientColShapeLeave]], [[onClientElementColShapeLeave]], [[onColShapeLeave]] and [[onElementColShapeLeave]] even if the element was destroyed ([https://github.com/multitheftauto/mtasa-blue/commit/f6177e43408053bf8d01fd9b55c478d770945340 f6177e4] by '''Inder00''')
:* Fixed [[getCameraTarget]] returning the player instead of their vehicle, if available ([https://github.com/multitheftauto/mtasa-blue/commit/05b7ea2d9c936b727ac057d3307d40a434f40352 05b7ea2] by '''botder''')
:* Fixed several code warnings ([https://github.com/multitheftauto/mtasa-blue/commit/e43aa1ba1dfd5c27fec50924938ac14444ff045e e43aa1b] by '''botder''')
:* Fixed a crash in CLatentTransferManager ([https://github.com/multitheftauto/mtasa-blue/commit/6220faa318c076d1fbd79050edf6eb53aa43819d 6220faa] by '''botder''')
:* Implemented ped far sync interval ([https://github.com/multitheftauto/mtasa-blue/commit/3c49beb6d36067a884e534140e31cae3297d2c2d 3c49beb] by '''Zangomangu''')
:* Improved [[addEvent]] when sharing events over multiple resources ([https://github.com/multitheftauto/mtasa-blue/commit/f3811cb47633589ec5f1b0dd409045eb8c4133a0 f3811cb] by '''Pieter-Dewachter''')
:* Improved player sync when exiting vehicle ([https://github.com/multitheftauto/mtasa-blue/commit/e5026e7b71449042449ae3ce19af7e91a3166cdc e5026e7] by '''Zangomangu''')
:* Removed leftover Discord integration ([https://github.com/multitheftauto/mtasa-blue/commit/9708440462cd5ee815769bf5dfbdbe90d704cd26 9708440] by '''Lpsd''')
:* Removed protocol error 14 ([https://github.com/multitheftauto/mtasa-blue/commit/828ec464d3c761143af749720fe94f9e17712ccb 828ec46] by '''botder''')
:* Updated source translations

=== Client ===
:* '''[Breaking change]''' Error out when creating a browser with size smaller than 1x1 ([https://github.com/multitheftauto/mtasa-blue/commit/a26417f2f4f313f23cf96add09c75fd8d0256b6d a26417f] by '''patrikjuvonen''')
:* '''[Breaking change]''' Removed ''mtalocal://'' URL scheme and error out on bad usage ([https://github.com/multitheftauto/mtasa-blue/commit/c4c01e29d29d214e51c7d689d8753e37e31c5e27 c4c01e2] by '''patrikjuvonen''')
:* '''[Breaking change]''' Fixed incorrect Bloodring Banger enter/exit animation ([https://github.com/multitheftauto/mtasa-blue/commit/2c6058d3772ef8dae77df6ad0b2421a86abbe746 2c6058d] by '''lopezloo''')
:* '''[Deprecation]''' Changed [[getCameraShakeLevel]], [[setCameraShakeLevel]] to throw a warning on use, please upgrade to [[getCameraDrunkLevel]] and [[setCameraDrunkLevel]] instead ([https://github.com/multitheftauto/mtasa-blue/commit/2651903e6a03c78a0571089b142b175f11f41bab 2651903] by '''Unde-R''')
:* Added hook to change vehicle damage debris to the vehicle color ([https://github.com/multitheftauto/mtasa-blue/commit/952448d46c9ac6066dc9d51e26b9da41808077e9 952448d] by '''Merlin''')
:* Added missing chat_text_outline CVAR to [[getChatboxLayout]] function ([https://github.com/multitheftauto/mtasa-blue/commit/5cc419ca173301b03db15b0ae122fe970e96c2ef 5cc419c] by '''Pieter-Dewachter''')
:* Added missing getType method for [[camera]] element ([https://github.com/multitheftauto/mtasa-blue/commit/a89d975d7b959fe6c9b0af73ef6261cdb3763715 a89d975] by '''TheNormalnij''' and '''StrixG''')
:* Added missing model ids and names scraped from .ide files ([https://github.com/multitheftauto/mtasa-blue/commit/062dea31dc1a918d440bf7c87bd6957a7d9204ad 062dea3] by '''Merlin''')
:* Added new world special property ''coronaztest'' ([https://github.com/multitheftauto/mtasa-blue/commit/093ecf47422f535053f2f4b321bc32ee1c63befd 093ecf4] by '''gta191977649''')
:* Added pthread and x64 files to the uninstall process ([https://github.com/multitheftauto/mtasa-blue/commit/6ae2ff14e966f7792de3b995d7c8e9655cd5bc75 6ae2ff1] by '''patrikjuvonen''')
:* Added ability to enable/disable custom weapons collisions ([https://github.com/multitheftauto/mtasa-blue/commit/e27d97dbc79e7cadc1740211b4fe2e746970d8b5 e27d97d] by '''lopezloo''')
:* Added dynamic ped shadows ([https://github.com/multitheftauto/mtasa-blue/commit/74c359bcaa62fe6a6e8aaa281d247f9ee53778cc 74c359b] and [https://github.com/multitheftauto/mtasa-blue/commit/136e9cf449d4370e5f30090d5adb7783814e02e0 136e9cf] by '''lopezloo''')
:* Added new default GUI skin (''Default 2023'') ([https://github.com/multitheftauto/mtasa-blue/commit/2d9e03324b07e355031ecb3263477477f1a91399 2d9e033] by '''Haxardous''' and [https://github.com/multitheftauto/mtasa-blue/commit/6ae0f657b1aec4c93d823fef3529412cc754631f 6ae0f65] by '''botder''')
:* Added new GUI skins ''GWEN Blue'' and ''GWEN Orange'' ([https://github.com/multitheftauto/mtasa-blue/commit/88a26fe4f35739d8b39ec14361b2ec97bae4b250 88a26fe] by '''Haxardous''')
:* Added missing files to data checks ([https://github.com/multitheftauto/mtasa-blue/commit/8531840ac690ff6534fabe6947b565c0fc59a418 8531840] by '''Dutchman101''')
:* Added ''resource.ip2c'' object to [[Access Control List|acl.xml]] ''RPC'' group ([https://github.com/multitheftauto/mtasa-blue/commit/960a6614c6962ec5a991076a05e7dd59bc87b0d7 960a661] by '''Fernando-A-Rocha''')
:* Added missing GTA special skins (3, 4, 5, 6, 8, 42, 65, 86, 119, 273, 289) ([https://github.com/multitheftauto/mtasa-blue/commit/b10b2bfc4b73493f7143542a7158b00384d4a1a9 b10b2bf] by '''Allerek''')
:* Added ability to get debug setting ''(SettingDebugMode)'' in [[dxGetStatus]] ([https://github.com/multitheftauto/mtasa-blue/commit/e628e402a8d9817d5a20bbcb4bc6105e99f67609 e628e40] by '''vyn666''')
:* Added ability to restream LOD models in [[engineRestreamWorld]] using new parameter ''includeLODs'' ([https://github.com/multitheftauto/mtasa-blue/commit/39f03949edbf33f9b7c10c1e14ede178a734c515 39f0394] by '''TFP-dev''')
:* Avoid hierarchy in [[engineRequestModel]] ([https://github.com/multitheftauto/mtasa-blue/commit/8e94ec19f8f71ceb0b8eb09e9a7bbc7b33b1cd36 8e94ec1] and [https://github.com/multitheftauto/mtasa-blue/pull/2440/commits/85203a6222dfa989b8877defb0abb8a47891a59e 85203a6] by '''TheNormalnij''' and '''Lpsd''')
:* Allow allocation of ''timed-object'' models using [[engineRequestModel]] ([https://github.com/multitheftauto/mtasa-blue/commit/f0a2424dd411f5eb454b554addf1eb217090f55b f0a2424] by '''TheNormalnij''')
:* Changed ''Enter a domain...'' text from web settings into a placeholder ([https://github.com/multitheftauto/mtasa-blue/commit/dc8241903184cf889502925b78c4d48d3413f0f4 dc82419] by '''patrikjuvonen''')
:* Changed GUI ''relative'' argument to be ''false'' by default ([https://github.com/multitheftauto/mtasa-blue/commit/9b022b632ddcb3989311332b0c9cf41356d54f55 9b022b6] by '''ghostkc12''')
:* Changed [[setVehiclesLODDistance]] and [[setPedsLODDistance]] to be able to override client setting ([https://github.com/multitheftauto/mtasa-blue/commit/a44db243df08cd729c850652e44994de1ceedcb1 a44db24] by '''samr46''')
:* Changed max ''fpslimit'' to 32767 ([https://github.com/multitheftauto/mtasa-blue/commit/50d80403182b1ac377502e08e29ec6ef51214c78 50d8040] by '''Merlin''')
:* Changed default vector wrapping from clamp to wrap ([https://github.com/multitheftauto/mtasa-blue/commit/0dcdac3946adb3e318fe92c6f86ebf024cdca045 0dcdac3] by '''Lpsd''')
:* Changed to proxy dll method for loading core.dll into GTA process ([https://github.com/multitheftauto/mtasa-blue/commit/ffd2a4bad56d90b52deab8b55b9cbee65623228b ffd2a4b], [https://github.com/multitheftauto/mtasa-blue/commit/c78d7255861dd18ed9e6ecdf94c02d21e5cda932 c78d725], [https://github.com/multitheftauto/mtasa-blue/commit/80e4078d80504b81c9103f4c8b5c84ff4a40ef7a 80e4078] and [https://github.com/multitheftauto/mtasa-blue/commit/336503042c5d60b53d1e10cd420410bbdd057b71 3365030] by '''botder''' and '''ccw''')
:* Check custom ped models before replacement ([https://github.com/multitheftauto/mtasa-blue/commit/d999e3e97770a11f4df25cd96c8bbe360c1fd4d9 d999e3e] by '''botder''')
:* Cleaned up and refactored server code ([https://github.com/multitheftauto/mtasa-blue/commit/693976b7131a87df71d81256a80cc48b22ab7bcf 693976b] and [https://github.com/multitheftauto/mtasa-blue/commit/cd1d2088a92b685b3b6294acb388fc1154ddbee4 cd1d208] by '''botder''')
:* Cleaned up ''CClientVehicle.cpp'' file ([https://github.com/multitheftauto/mtasa-blue/commit/8b806be300c94bd15f1fa7575322bf31caf5234e 8b806be] by '''botder''')
:* Cleaned up game_sa project ([https://github.com/multitheftauto/mtasa-blue/commit/76b21f7ed5b23f7d734eae20d089bb50336f8518 76b21f7], [https://github.com/multitheftauto/mtasa-blue/commit/e0abb3087a63e79b4273f8185920d00472b1354a e0abb30], [https://github.com/multitheftauto/mtasa-blue/commit/889b6c8ea719cd1a9152ffee9a382a50ee960c51 889b6c8], [https://github.com/multitheftauto/mtasa-blue/commit/90bcdb487ebd9949173186f78de7d2b22b588f96 90bcdb4], [https://github.com/multitheftauto/mtasa-blue/commit/d7082ed1109094e89524cdf4e7d63ad2c2d6c65b d7082ed], [https://github.com/multitheftauto/mtasa-blue/commit/c9c97f1ad4887098b12efd78587b7ec6bed86971 c9c97f1], [https://github.com/multitheftauto/mtasa-blue/commit/3f5b8741b1faae4682942499355ec9a92fcd81a1 3f5b874], [https://github.com/multitheftauto/mtasa-blue/commit/d085fb989e86be9668cd3e9f3f4426eefe55df6d d085fb9], [https://github.com/multitheftauto/mtasa-blue/commit/5e781d51beb923c6f8e3e9f3d904bba3c2d7225e 5e781d5], [https://github.com/multitheftauto/mtasa-blue/commit/4dff64f1803af86a6c9666f0e972136a6d8c4948 4dff64f] by '''Merlin''')
:* Clean up file paths better ([https://github.com/multitheftauto/mtasa-blue/commit/2fb2b35b6aff26f1b2f104a56c4dab04fb5a8366 2fb2b35] by '''patrikjuvonen''')
:* Clear client script memory after load ([https://github.com/multitheftauto/mtasa-blue/commit/ce50b9ee6c9112db0358e3ddba354021ca084588 ce50b9e] by '''Pirulax''' and [https://github.com/multitheftauto/mtasa-blue/commit/cece630440c577f747e9ee890fd1563a542269e7 cece630] by '''botder''')
:* Decreased joystick saturation minimum from 51 to 0 ([https://github.com/multitheftauto/mtasa-blue/commit/4fcf3eb4c8db02b0ebefd580646ff6618c13e127 4fcf3eb] by '''patrikjuvonen''')
:* Detect graphics libraries in MTA directory ([https://github.com/multitheftauto/mtasa-blue/commit/a0645accecc1a6f1288671c988fff79f663e3bde a0645ac] by '''botder''')
:* Disabled camera collisions for detached vehicle parts and projectiles ([https://github.com/multitheftauto/mtasa-blue/commit/1c00ef9b13dae5b8b23abcb94b236790252ecd42 1c00ef9] by '''lopezloo''')
:* Disabled system context menu ([https://github.com/multitheftauto/mtasa-blue/commit/34d61b53c03d974027f3b145ec6090dcf7e9c2b0 34d61b5] by '''lopezloo''')
:* Ensure files are within bounds ([https://github.com/multitheftauto/mtasa-blue/commit/07d0cf77e990e2b25a4f2c99fd110645a3db225a 07d0cf7] by '''patrikjuvonen''')
:* Fixed access violation in [[getVehicleWheelFrictionState]] for vehicles not streamed in ([https://github.com/multitheftauto/mtasa-blue/commit/dde0e59055b5092cac5f16dd8bb06f1ff91ddeed dde0e59] by '''botder''')
:* Fixed a small memory leak for [[engineRequestModel]] ([https://github.com/multitheftauto/mtasa-blue/commit/b2a625b100ff037908b002b586ca81692c24b2ae b2a625b] by '''TheNormalnij''')
:* Fixed broken doors and damage sync for custom vehicles ([https://github.com/multitheftauto/mtasa-blue/commit/51d3288f06b62561837d9e6d5470b1476cbe6c30 51d3288] by '''BCG2000''')
:* Fixed camera to autofocus on new car on [[warpPedIntoVehicle]] ([https://github.com/multitheftauto/mtasa-blue/commit/607b57d36b72db62e976ef04c7bfa1d35f39da9a 607b57d] by '''TheNormalnij''')
:* Fixed chatbox when using ''inputBlocked'' argument ([https://github.com/multitheftauto/mtasa-blue/commit/bd62e563e082533e3c35df877cf99ccdd54f5be8 bd62e56] by '''Pieter-Dewachter''')
:* Fixed crash when pickup has invalid custom model ([https://github.com/multitheftauto/mtasa-blue/commit/1b17869cb58277d596d2865c2a2f777963fe18be 1b17869] by '''TheNormalnij''')
:* Fixed crash when removing key binds while processing a key stroke ([https://github.com/multitheftauto/mtasa-blue/commit/90f757d26f2c49b02cc5f67e7146c2c7db0dcbe0 90f757d] by '''botder''')
:* Fixed [[getVehicleType]] and [[getVehicleMaxPassengers]] not returning specific values and players cannot enter as passengers on vehicles added with [[engineRequestModel]] ([https://github.com/multitheftauto/mtasa-blue/commit/141438fe462795c136f92b4fca9901e03dcec3f2 141438f] by '''BCG2000''')
:* Fixed interiors lacking radio ([https://github.com/multitheftauto/mtasa-blue/commit/e573959da339f9c19eef9f4b8a54e2da50b402ac e573959] by '''lopezloo''')
:* Fixed key binds breaking on resource stop ([https://github.com/multitheftauto/mtasa-blue/commit/8c78fbaca9b837f11fe846792e4a9bf2ca43a8c9 8c78fba] and [https://github.com/multitheftauto/mtasa-blue/commit/280131fd07af4863cb40bad3ae32e1c0f02135e9 280131f] by '''botder''')
:* Fixed mirrored position of ''light_front_second'' vehicle dummy ([https://github.com/multitheftauto/mtasa-blue/commit/32aeb0e67915744402fdac0619b8807db6352957 32aeb0e] by '''botder''')
:* Fixed [[setElementModel]] forcing an element to be streamed in no matter the distance from [[localPlayer]] ([https://github.com/multitheftauto/mtasa-blue/commit/467df061b5fadcee81bb7c0c4fb6cf23e741b3eb 467df06] by '''TheNormalnij''')
:* Fixed sync of damaged light states and wheel states ([https://github.com/multitheftauto/mtasa-blue/commit/fe48d0968042b0bc5e5375c0c2f8f9ee2ed951ba fe48d09] by '''Addlibs''')
:* Fixed unused binds descriptions are always in English ([https://github.com/multitheftauto/mtasa-blue/commit/32962a6a90178dbf4638df83c0985db1826ed8b1 32962a6] by '''patrikjuvonen''')
:* Fixed single player HUD setting affecting MTA ([https://github.com/multitheftauto/mtasa-blue/commit/7ead65dcf207befd0eafadbaff3ac5aae62b0a08 7ead65d] by '''Merlin''')
:* Fixed [[isElementInWater]] returning false if ped or player is in vehicle in water ([https://github.com/multitheftauto/mtasa-blue/commit/29f303860e5404aa98a2a69ca5a3b6e80eebd2df 29f3038] by '''Santi''')
:* Fixed refresh rate limited to 60Hz in full screen mode for some setups ([https://github.com/multitheftauto/mtasa-blue/commit/5207a314272fda9b54443edd30efb11e6e846dd6 5207a31] and [https://github.com/multitheftauto/mtasa-blue/commit/5c77d974c10fc5096b0ecf600343f7c975e8a2c2 5c77d97] by '''samr46''')
:* Fixed water sound level outside of game boundaries on [[setWaterLevel]] ([https://github.com/multitheftauto/mtasa-blue/commit/aed055497e2662119ba178b878c74c28aa5e018f aed0554] by '''samr46''')
:* Fixed muzzle flash not showing for the last bullet in magazine ([https://github.com/multitheftauto/mtasa-blue/commit/80b17d96097c6977915c91f31ae2161a1bce1fdc 80b17d9] by '''Merlin''')
:* Fixed various high FPS related issues
::* Fixed health bar blinking faster on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/df4d35d2a14cba7fc5549b13cc6cf221d2e7132a df4d35d] by '''Merlin''')
::* Fixed walking while aiming on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/e64d311f62de2bd848c07b59f4f53a30826c1bed e64d311] by '''Merlin''')
::* Fixed aircraft and boat lights blinking faster on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/f597c46a45dea26742a680b5a2ab56d6dcb02368 f597c46] by '''Merlin''')
::* Fixed breakable objects decaying faster on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/7c26dddcc4ad68dbd79509494bb560fc3f784766 7c26ddd] by '''Merlin''')
::* Fixed rocket launcher spawning too many effects on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/167addab6694e76d177989fb4caf3c5bf252dfc7 167adda] by '''Merlin''')
::* Fixed wheels spawning too many surface effects on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/d2b2c45789747d8412a207e6c7b3094e8556ac73 d2b2c45] by '''Merlin''')
::* Fixed stuntplane and cropduster spawning too many smoke trail particles on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/e9cc0a3d515165072863a6b1d3b1652814c24924 e9cc0a3] by '''Merlin''')
::* Fixed water cannon decaying much faster on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/32c04f0b25c959007b96d42cdbfefbadca22ca64 32c04f0] by '''Merlin''')
::* Fixed [[setCameraShakeLevel]] shaking too fast on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/893858ddc5a768194b435da40230fca8ef7da752 893858d] by '''Merlin''')
::* Fixed [[setPedHeadless]] spawning too many particles on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/2e1042fd67b4438cf2f8e207af241ad98a4e1a88 2e1042f] by '''Merlin''')
::* Fixed more high FPS issues ([https://github.com/multitheftauto/mtasa-blue/commit/bcc56b5ee6df43697069f38977d09eae23f7e62c bcc56b5] by '''Merlin''')
:::* Fixed money animation playing faster on high FPS
:::* Fixed walking through water spawn too many particles on high FPS
:::* Fixed spawning too many weather particles on high FPS
:::* Fixed airplane spawning too many damage particles on high FPS
:::* Fixed vehicles spawning too much sand and water particles on high FPS
:::* Fixed boats spawning too many particles on high FPS
:::* Fixed spawning too many rain particles on vehicles on high FPS
:::* Fixed airplanes spawning too many particles when damaged on high FPS
:::* Fixed vehicles spawning too many exhaust particles on high FPS
:::* Fixed spawning too many particles while swimming on high FPS
::* Fixed helicopters taking off faster on high FPS ([https://github.com/multitheftauto/mtasa-blue/commit/40c178ed787b50ef3fc1d878d794b6b885bc00b9 40c178e] by '''Merlin''')
::* Fixed more high FPS issues ([https://github.com/multitheftauto/mtasa-blue/commit/7c8a1ab93d091b06262749b482d6c8142ca69eea 7c8a1ab] by '''Merlin''')
:::* Fixed fog moving too fast on high FPS
:::* Fixed glass shards spinning and expanding too fast on high FPS
:::* Fixed boats being slow on high FPS
:* Fixed camera drunk/shake level not resetting on server disconnect ([https://github.com/multitheftauto/mtasa-blue/commit/3f71f1b64f0359ea2309224d46e1aa65d2d7c3c3 3f71f1b] by '''Lpsd''')
:* Fixed grass not rendering ([https://github.com/multitheftauto/mtasa-blue/commit/52798a2d923bdb4e29f6fb9c63178e30e40479b6 52798a2] by '''TFP-dev''')
:* Fixed server browser search input disappearing at times ([https://github.com/multitheftauto/mtasa-blue/commit/7c750151a1f5ee11330fec23664359f4d2c535e9 7c75015] by '''lopezloo''')
:* Fixed interior radio crash ([https://github.com/multitheftauto/mtasa-blue/commit/d00336070f6f726b66445213f43b50e605aefcd4 d003360] by '''TheNormalnij''' and [https://github.com/multitheftauto/mtasa-blue/commit/7eb36134dab77b2edf28d6efe6ef9c82c1e9d3f0 7eb3613] by '''Lpsd''')
:* Fixed installer overwriting MTA shortcuts ([https://github.com/multitheftauto/mtasa-blue/commit/d55710491940a5023545208ce14c087a78aa37e4 d557104] by '''se16n''')
:* Fixed a typo in fakelag command text ([https://github.com/multitheftauto/mtasa-blue/commit/39e726857ec7b9a146323d63200d3e1c8031478d 39e7268] by '''JessePinkman''')
:* Fixed zoom_in/out binds being inverted & fix ability to control zoom by weapon_next/previous binds ([https://github.com/multitheftauto/mtasa-blue/commit/4a4bcbc413ad33b56acd7284c81361187c7df8d6 4a4bcbc] by '''darkdrifter''')
:* Fixed a game crash if FxEmitterBP_c::LoadTextures failed to load main texture ([https://github.com/multitheftauto/mtasa-blue/commit/5a598d70161a85a961de462f28279d38df70aae3 5a598d7] and [https://github.com/multitheftauto/mtasa-blue/commit/9667cbea40a2b834107c781411a2c9658fec5073 9667cbe] by '''botder''')
:* Fixed a crash in FxPrim_c::Enable ([https://github.com/multitheftauto/mtasa-blue/commit/05c639c05faf2b01ab001adaff33b503ce2d36b7 05c639c] by '''botder''')
:* Fixed model replacement for unstreamed models ([https://github.com/multitheftauto/mtasa-blue/commit/c667e2ad05c97511e7b5cf63d223f762eea41e10 c667e2a] and [https://github.com/multitheftauto/mtasa-blue/commit/7d8718cde378787818637936a9873dfab689638c 7d8718c] by '''botder''')
:* Fixed desktop shortcut creation in installer script ([https://github.com/multitheftauto/mtasa-blue/commit/1c043468b52348589d0ae379f914e490c0630cdf 1c04346] and [https://github.com/multitheftauto/mtasa-blue/commit/3f6dac669b5aed51a695cc59e13e3b552e0340e3 3f6dac6] by '''botder''')
:* Fixed broken client Windows GDF file and updated its hardcoded version and URLs ([https://github.com/multitheftauto/mtasa-blue/commit/d54afd76ed67ba80cfb2fb221229ca01a4f42508 d54afd7] and [https://github.com/multitheftauto/mtasa-blue/commit/579775d79b166c82c1c2a3c1b020eb2febfff202 579775d] by '''patrikjuvonen''')
:* Fixed a client crash caused by buffer overflow issues in ''GetNameAndDamage'' ([https://github.com/multitheftauto/mtasa-blue/commit/1129399a129f44d6c729064603d5e84578290411 1129399] and [https://github.com/multitheftauto/mtasa-blue/commit/1fc700f5030b21d1c4f6ef65d76a3a3c9d987fd4 1fc700f] by '''Pirulax''' and [https://github.com/multitheftauto/mtasa-blue/commit/29dfe4bd095170a131b27f9687262995ad301489 29dfe4b] by '''Pieter-Dewachter''')
:* Fixed a client crash caused by GOOGLE_API_KEY, GOOGLE_DEFAULT_CLIENT_ID and GOOGLE_DEFAULT_CLIENT_SECRET environment variables ([https://github.com/multitheftauto/mtasa-blue/commit/9f8e6cd2c588ff4516572707cffe943175937ae5 9f8e6cd] by '''TEDERIs''')
:* Fixed a client crash on disconnect after using [[engineSetModelPhysicalPropertiesGroup]] on custom models ([https://github.com/multitheftauto/mtasa-blue/commit/047f709a2b71e08cb8d1362c0387882b6db886dd 047f709] by '''TheNormalnij''')
:* Fixed launching MTA with ARM emulation ([https://github.com/multitheftauto/mtasa-blue/commit/9fa2d19ed77987df89b02ea39cc742dcbcc08cca 9fa2d19] by '''botder''')
:* Fixed a client crash after resetting bind ([https://github.com/multitheftauto/mtasa-blue/commit/0454e3c0420c57ef22b241738d7f7a1463223cb5 0454e3c] by '''Dutchman101''')
:* Fixed CEF crashing on Wine ([https://github.com/multitheftauto/mtasa-blue/commit/ca04b07cd87dd192e60e8df236f314e86b8b108f ca04b07] by '''vahook''')
:* Fixed download progress calculation ([https://github.com/multitheftauto/mtasa-blue/commit/74c2a5d1295af626a0fa77252de5fbd5123c5af9 74c2a5d] by '''Lpsd''')
:* Fixed random foliage on replaced collisions ([https://github.com/multitheftauto/mtasa-blue/commit/0a1cbb88b93727416b88b845546d36295f2651e2 0a1cbb8] by '''TFP-dev''')
:* Fixed get/set vehicle model wheel size memory leak ([https://github.com/multitheftauto/mtasa-blue/commit/de3dc70e406b08b7bccf92294e178ebbfc9abda9 de3dc70] by '''TheNormalnij''')
:* Fixed camera tilt not working when camera is fading ([https://github.com/multitheftauto/mtasa-blue/commit/bda150604931e334968349acc1c61db0fd05f2c1 bda1506] by '''patrikjuvonen''')
:* Fixed visit news button text overflow with localized string ([https://github.com/multitheftauto/mtasa-blue/commit/1e1d3d5ba39bf2aeabaec692cf57dd30e362cbe9 1e1d3d5] by '''theSarrum''')
:* Fixed various issues with the uninstaller, it now does a better job at cleaning up leftover files and registry entries (multiple commits by '''patrikjuvonen''')
:* Fixed 'Offline' checkbox label autosizing in the server browser ([https://github.com/multitheftauto/mtasa-blue/commit/0291f82bd104a89d7d9d2ce3d54a57e5ea8e5d1d 0291f82] by '''patrikjuvonen''')
:* Fixed shortcuts created by the installer ([https://github.com/multitheftauto/mtasa-blue/commit/741103df4d5ab6f068415ebbd56f1511f9806907 741103d] by '''patrikjuvonen''')
:* Fixed [[dxSetShaderTransform]] affecting other shaders ([https://github.com/multitheftauto/mtasa-blue/commit/2bb50548b3a18e9998c721aeb670980dc220d727 2bb5054] by '''tederis''')
:* Fixed crash when streamed in object with custom model is deleted (on disconnect) ([https://github.com/multitheftauto/mtasa-blue/commit/5df6d1f9e3c9bf5568150f206062ae4f276ac36b 5df6d1f] by '''botder''')
:* Fixed a crash related to when ped weapon slot is being set ([https://github.com/multitheftauto/mtasa-blue/commit/87644f5fd4340a6f381e4f08342a0d2b39c626b2 87644f5] by '''botder''')
:* Fixed a crash related to providing an empty string in [[executeBrowserJavascript]] ([https://github.com/multitheftauto/mtasa-blue/commit/2cd578402eb2197154abded0cab29a4b450a7b27 2cd5784] by '''CrosRoad95''')
:* Fixed various cursor alpha issues ([https://github.com/multitheftauto/mtasa-blue/commit/87e3dce37ca2fde416be90df9693e712985047e0 87e3dce] by '''Lpsd''')
:* Group windows under a single taskbar button on Windows ([https://github.com/multitheftauto/mtasa-blue/commit/56fbfc3b69400a86dd682dfbb86ee02bc2e3f3ca 56fbfc3] by '''botder''')
:* Implemented ''delete'' control character handling in chatbox ([https://github.com/multitheftauto/mtasa-blue/commit/0648e9c56e2e607e399ee3305751d5873a68614e 0648e9c] by '''patrikjuvonen''')
:* Improved [[setSoundEffectParameter]] error messages ([https://github.com/multitheftauto/mtasa-blue/commit/cf5d16630f8e0ffa560e1abd1a83b03892d2274e cf5d166] by '''Pirulax''' and '''botder''')
:* Improved CEF DX utilization & thread-safety fixes ([https://github.com/multitheftauto/mtasa-blue/commit/8863f603fb9cfa50ffc3822e378b5af6b1090cf9 8863f60] by '''TEDERIs''')
:* Improved SVG stability ([https://github.com/multitheftauto/mtasa-blue/commit/403df24fce070b630ac2f474933daaab62efbc44 403df24] by '''TEDERIs''')
:* Improved unescape safety ([https://github.com/multitheftauto/mtasa-blue/commit/ed5e6c4fc06a9ecef21897dbcbe323fa0550e976 ed5e6c4] by '''Jusonex''')
:* Improved http error safety ([https://github.com/multitheftauto/mtasa-blue/commit/88b623ec72da363f83544f540287514fcf8e3bbe 88b623e] by '''Jusonex''')
:* Improved camera weapon picture quality ([https://github.com/multitheftauto/mtasa-blue/commit/2acf0cda21c3d4c489c5b1f888a48dc2d647994e 2acf0cd] by '''lopezloo''')
:* Massively increase quality of splash image ([https://github.com/multitheftauto/mtasa-blue/commit/ab2a1b974fc29f9ae8fc009b633283a77a3c4825 ab2a1b9] and [https://github.com/multitheftauto/mtasa-blue/commit/4a82776bfccd8ecd91caf9972bd686dfd0ff05a7 4a82776] by '''botder''' and [https://github.com/multitheftauto/mtasa-blue/commit/11c3116cc29197223b796d7e557907c2fa958c74 11c3116] by '''Dutchman101''')
:* Refactored key binds ([https://github.com/multitheftauto/mtasa-blue/commit/2878168ba2749dfedc8fcc7c5c80637891c7277c 2878168], [https://github.com/multitheftauto/mtasa-blue/commit/5c0afad233bd5ae1a8835356f7de62db8be066fa 5c0afad], [https://github.com/multitheftauto/mtasa-blue/commit/6e8755178780a45c729f8f2d48514f360c63754c 6e87551] and [https://github.com/multitheftauto/mtasa-blue/commit/73e4e420b6948ae1bfda0c80d643e43550da2745 73e4e42] by '''botder''')
:* Removed async tasks in SVG and updated callback usage ([https://github.com/multitheftauto/mtasa-blue/commit/31579051cc046bc5cb55c59fc4e9e70ec1bdce34 3157905] by '''Lpsd''')
:* Removed now unnecessary strafe workaround ([https://github.com/multitheftauto/mtasa-blue/commit/a331072759e69f36062ed1c9b848f6df6f808c9a a331072] by '''Merlin''')
:* Removed dummy window from taskbar ([https://github.com/multitheftauto/mtasa-blue/commit/7dccdf47924299518ef33a57d8c0df9ee8de7405 7dccdf4] by '''lopezloo''')
:* Do not reset handling for custom models on a non-local vehicle ([https://github.com/multitheftauto/mtasa-blue/commit/3c3af040173b66e21bbc587fbca48548866bb2b7 3c3af04] by '''Inder00''')
:* Show dialog for dxgi.dll in GTA install directory ([https://github.com/multitheftauto/mtasa-blue/commit/fb26d72b66a2223237c3f022dfad39230232dc3f fb26d72] by '''botder''')
:* Split grenade collision from weapon collision ([https://github.com/multitheftauto/mtasa-blue/commit/0e2b203aa1d12f15931eb7d9522a5edf987f45ff 0e2b203] by '''Merlin''')
:* Internationalized news window title ([https://github.com/multitheftauto/mtasa-blue/commit/a446f02701b6cd8325c13ab9e71b1e651bd3d827 a446f02] by '''patrikjuvonen''')
:* Updated main menu images ([https://github.com/multitheftauto/mtasa-blue/commit/d38c107372a05d73f5efd8813575c3ac4f740d60 d38c107] by '''patrikjuvonen''')
:* Updated CGUI images ([https://github.com/multitheftauto/mtasa-blue/commit/c1a958c7fc6f7e9f5e1937fb59bbd1fa341da86e c1a958c] by '''patrikjuvonen''')
:* Updated en_US images, added ''latest_news.png'' ([https://github.com/multitheftauto/mtasa-blue/commit/42693d806b132e4299173059f423c61fa13f5c21 42693d8] and [https://github.com/multitheftauto/mtasa-blue/commit/cd0cce740cb63b2b2c6c79a7bd4ebc3fad6ad9aa cd0cce7] by '''patrikjuvonen''')
:* Updated main menu logo ([https://github.com/multitheftauto/mtasa-blue/commit/4b9a3a4a7717db059277a5fdb9f2653bb90b7496 4b9a3a4] and [https://github.com/multitheftauto/mtasa-blue/commit/aa1e1d4336068438b2436efbc71b7a9231199e45 aa1e1d4] by '''patrikjuvonen''')
:* Updated translations ([https://github.com/multitheftauto/mtasa-blue/commit/73c6457b6ccb845c640cb5da738a4d10bc84901d 73c6457] by '''patrikjuvonen''')
:* Updated various non-https links to https ([https://github.com/multitheftauto/mtasa-blue/commit/2722466f0f837151aeae4ab4acba3bff3be19257 2722466] by '''patrikjuvonen''')
:* Updated credits ([https://github.com/multitheftauto/mtasa-blue/commit/894c0f7e2538188fb5d4d7c71fd548ee3a9d92f1 894c0f7] by '''patrikjuvonen''')
:* Fixed inability to warp client-side ped to client-side trailer ([https://github.com/multitheftauto/mtasa-blue/commit/4e7fd058f0b8600660d60d8a0d69abdadef98032 4e7fd05] by '''Tracer''')

=== Server ===
:* '''[Breaking change]''' Changed [[callRemote]] to return 0 as ''errno'' upon successful request to be consistent with [[fetchRemote]] ([https://github.com/multitheftauto/mtasa-blue/commit/507de5fc63fe207bb4f9d77706f7c54e1ffb3ba1 507de5f] by '''patrikjuvonen''')
:* '''[Breaking change]''' Fixed flamethrower ammo to not be multiplied by 10 ([https://github.com/multitheftauto/mtasa-blue/commit/35ea5e48fb7de6ce729961cfd24b68f3a2fd1c78 35ea5e4] by '''patrikjuvonen''')
:* '''[Breaking change]''' Fixed [[createBlip]] to sync blip size and color regardless of icon ID ([https://github.com/multitheftauto/mtasa-blue/commit/049e9762777828a416d9331d671250a267dc4fc5 049e976] by '''patrikjuvonen''')
:* '''[Breaking change]''' Server-side objects that were unbreakable by default, but would have been breakable client-side by default, are now breakable by default also server-side. Also added server-side support for [[isObjectBreakable]], [[setObjectBreakable]], and the ''breakable'' map object attribute ([https://github.com/multitheftauto/mtasa-blue/compare/d701fbe15b4cece7a6cd6242c3819e68deb7aae2...57d5be3d3e323394a8926a79f3da9cd3814e44a2 commit])
:* '''[Deprecation]''' Changed [[givePedJetPack]], [[removePedJetPack]] and [[doesPedHaveJetPack]] to throw a warning on use, please upgrade to [[setPedWearingJetpack]] and [[isPedWearingJetpack]] instead ([https://github.com/multitheftauto/mtasa-blue/commit/804c66b88e0324eb6b2d9c83fdf7606ba05566c6 804c66b] by '''qaisjp''')
:* Added a space between quit reasons when redirecting ([https://github.com/multitheftauto/mtasa-blue/commit/84e6e901754b80603a938d97e0b350d2c35f1f54 84e6e90] by '''patrikjuvonen''')
:* Added ''persist'' parameter to [[setElementSyncer]] ([https://github.com/multitheftauto/mtasa-blue/commit/3485fd3ac770dd0e0a0be3c0258aad1784c1b700 3485fd3] by '''MegadreamsBE''')
:* Added limits to ehs form fields ([https://github.com/multitheftauto/mtasa-blue/commit/7642b05138f23cc35b5b5e01021dafa33506ff90 7642b05] by '''botder''' and '''patrikjuvonen''')
:* Added limits to acl object length ([https://github.com/multitheftauto/mtasa-blue/commit/c497e23fb818103764b6cb6d457d201de6e82afa c497e23] by '''patrikjuvonen''')
:* Consider only affected players for element data stats ([https://github.com/multitheftauto/mtasa-blue/commit/2b549e49c7a3456cb668debdf6b02db9a981281c 2b549e4] by '''TEDERIs''')
:* Fixed server executable name for x64 on Windows ([https://github.com/multitheftauto/mtasa-blue/commit/a11758c71cbbdd4eea9362aba255e324b374c20c a11758c] by '''botder''')
:* Fixed [[onPedDamage]] not working ([https://github.com/multitheftauto/mtasa-blue/commit/143102a38acdabba8d7837252fd8c95f704d4ef8 143102a] by '''xLive''')
:* Fixed kicking player while redirecting ([https://github.com/multitheftauto/mtasa-blue/commit/c56add86d36034b1f32c5ef010b28156c022246e c56add8] by '''TeteX1''')
:* Fixed [[banPlayer]] not kicking all players with the same IP address ([https://github.com/multitheftauto/mtasa-blue/commit/d073b61877fb106d2d681c09816ef034cdb6454f d073b61] by '''patrikjuvonen''')
:* Fixed a crash caused by latent events ([https://github.com/multitheftauto/mtasa-blue/commit/934967ffcf3840dd9f16450bd718e87e1919ce9d 934967f] by '''tederis''')
:* Fixed server console history not working right with utf ([https://github.com/multitheftauto/mtasa-blue/commit/1813cb4f92cbe68a2f04732e3e52407a78b304c8 1813cb4] by '''patrikjuvonen''')
:* Improved ehs authentication checking ([https://github.com/multitheftauto/mtasa-blue/commit/2a8470135b6b5a36ce159e6f62561cc333b2abe8 2a84701] by '''patrikjuvonen''')
:* The vehicle "Street Clean Trailer (611)" now uses the same default color from its truck "Utility Van (552)" instead of being always fully black ([https://github.com/multitheftauto/mtasa-blue/commit/6e5cd4a61338d8cb1851c9ad54d683b978aecc98 6e5cd4a] by '''Lord-Henry''')
:* Updated and fixed server launcher icon ([https://github.com/multitheftauto/mtasa-blue/commit/8729c9f0a6fb2d396cd057abd0b7815be318aa0f 8729c9f] by '''patrikjuvonen''')
:* Updated default FPS limit to 74 in ''mtaserver.conf'' ([https://github.com/multitheftauto/mtasa-blue/commit/6c1f3184764aca0655b5b64fe88ca0a73b2b69c8 6c1f318] by '''Dutchman101''')
:* Use vector length method instead of manual distance calculation when using [[removeWorldModel]] server-side ([https://github.com/multitheftauto/mtasa-blue/commit/a3c83c8927c709ca1999f2664d791274c3a7b969 a3c83c8] by '''NanoBob''')
:* Fixed [[warpPedIntoVehicle]] causing a C++ runtime assertion failure ([https://github.com/multitheftauto/mtasa-blue/commit/eba619db22c515ad32e48052ee8c5d9d2c3303c8 eba619d] by '''Tracer''')

=== More Technical Changes and Bug Fixes ===
<section show="true">
:* Added null-pointer checks in CWorld::FindObjectsKindaCollidingSectorList ([https://github.com/multitheftauto/mtasa-blue/commit/8e8aa3ab41928bd01c09c231679e0ecbc9bf7c97 8e8aa3a] by '''Merlin''')
:* Added a weak crash fix for CPed::GetBonePosition ([https://github.com/multitheftauto/mtasa-blue/commit/3d1b87a7c11ef1cdde0c1475923f4a1b80b7f3fb 3d1b87a] by '''botder''')
:* Added null-pointer check for a few RpClump functions ([https://github.com/multitheftauto/mtasa-blue/commit/3e348d140618346c9dfadbbd752f450f5535a6cf 3e348d1] and [https://github.com/multitheftauto/mtasa-blue/commit/4582f8a81d5dee0713067a5f3ea71948264d077b 4582f8a] by '''botder''')
:* Added check for active resource in CLuaDefs::CanUseFunction ([https://github.com/multitheftauto/mtasa-blue/commit/4a94343ed44ff66c75d3c04ed2d45fae842054d5 4a94343] by '''Lpsd''')
:* Fixed a bug with ErrorPrintf for server-side modules ([https://github.com/multitheftauto/mtasa-blue/commit/29e11deb2db248856ab7992379ead5fc0966bcad 29e11de] by '''theSarrum''')
:* Various code clean ups and refactors
::* Refactored CBufferRef to use std::shared_ptr ([https://github.com/multitheftauto/mtasa-blue/commit/49fa84851caf21458809d955a8131edb61ff4086 49fa848] by '''Pirulax''')
::* Removed non-existent vendor from include ([https://github.com/multitheftauto/mtasa-blue/commit/9616ae131b1583682612b41a4f52fc35eb83db06 9616ae1] by '''patrikjuvonen''')
:* Got rid of ''std::function'' in ''AsyncTaskSched'' ([https://github.com/multitheftauto/mtasa-blue/commit/c372dc38ff76ca8ff33f853e4384ab4a9d657881 c372dc3] by '''Pirulax''')
:* Improved performance of CClientObjectManager::UpdateLimitInfo ([https://github.com/multitheftauto/mtasa-blue/commit/0160e1828127b0f183425074401d8bab6391dc9b 0160e18] by '''Merlin''')
:* Initialized ''lastSyncType'' variable in [[addElementDataSubscriber]] ([https://github.com/multitheftauto/mtasa-blue/commit/ca3b0b778e9695ce7da6391eda14429aa055d1f2 ca3b0b7] by '''botder''')
:* Removed CRefCountableST ([https://github.com/multitheftauto/mtasa-blue/commit/4482f133eff87396029ee1c1d71a02125fbb0834 4482f13] by '''Pirulax''')
:* Updated GitHub issue templates ([https://github.com/multitheftauto/mtasa-blue/commit/9b2dbbb8ad81edfc0d0837d43e2a9af57bfb8e8a 9b2dbbb], [https://github.com/multitheftauto/mtasa-blue/commit/70e59bb576dad330de243243791a1cb5bf441f91 70e59bb] and [https://github.com/multitheftauto/mtasa-blue/commit/07204d2a989ad882950bcb66d0bb8ef5293089d5 07204d2] by '''patrikjuvonen''')
:* Updated launchers ([https://github.com/multitheftauto/mtasa-blue/commit/5b4ce8a741fefb09980c3f4ff998d79218c4aef4 5b4ce8a] by '''patrikjuvonen''', [https://github.com/multitheftauto/mtasa-blue/commit/368864b1bd61d5c7eabf14e13014dea7f01e57bd 368864b] and [https://github.com/multitheftauto/mtasa-blue/commit/11c3116cc29197223b796d7e557907c2fa958c74 11c3116] by '''Dutchman101''')
:* Upgraded l10n scripts to use python3 and automate pot file generation ([https://github.com/multitheftauto/mtasa-blue/commit/583f2b94c3d1039fab249843781fa42a8cea1782 583f2b9] by '''darkdreamingdan''' and '''patrikjuvonen''')
:* Upgraded to Visual Studio 2022 and v143 toolset ([https://github.com/multitheftauto/mtasa-blue/commit/3d94c21db1780c0f35148492ff6cc59dba3892bc 3d94c21], [https://github.com/multitheftauto/mtasa-blue/commit/bbd0c4244cc2d93809ed2d892c9110fa54e3d5e3 bbd0c42], [https://github.com/multitheftauto/mtasa-blue/commit/d3079d5b9f2b837a91d5f503df7f03f55c6a66fc d3079d5] and [https://github.com/multitheftauto/mtasa-blue/commit/5a7bb84fe5dab7a18415f07000ff22d4f77cc594 5a7bb84] by '''Dutchman101''' and [https://github.com/multitheftauto/mtasa-blue/commit/96e690ed8f04bf044d2d561b7ef5d4671a7691fc 96e690e], [https://github.com/multitheftauto/mtasa-blue/commit/d8cfdea9a6068481a0a31cf1e3e5c1520b03af68 d8cfdea] and [https://github.com/multitheftauto/mtasa-blue/commit/f2dda37aba06f1394c3495a5717365d37df449b4 f2dda37] by '''botder''')
:* Overhauled game launch logic (various commits by '''botder''')
:* Overhauled loader (various commits by '''botder''')
:* Overhauled updater (various commits by '''botder''')
:* Decoupled Windows 7, 8 and 8.1 into their own branch to support Windows 10+ CEF updates (by '''patrikjuvonen''')
:* Refactor BitStream to use std::string_view ([https://github.com/multitheftauto/mtasa-blue/commit/66ff543986f65db1e51235bef2647df1d6e397bc 66ff543] by '''Pirulax''')
:* Various Docker related improvements and tweaks by '''botder'''
</section>

== 23 Vendor Updates ==
=== Client ===
:* Updated BASS libraries (various commits, [https://github.com/multitheftauto/mtasa-blue/commit/c557f77a1330df432622fb9cd1921970f24a3699 c557f77] by '''Dutchman101''')
:* Updated CEF from Chromium 94.0.4606.61 (CEF 94.4.2+g6a963ca)
:** Windows 7, 8 and 8.1 only: to Chromium 109.0.5414.120 (CEF 109.1.18+gf1c41e4) (various commits by '''Dutchman101''', '''patrikjuvonen''' and '''Lpsd''')
:** Windows 10+: to Chromium 114.0.5735.110 (CEF 114.2.10+g398e3c3) ([https://github.com/multitheftauto/mtasa-blue/commit/28544e4881bf06b1a8966eacab8e9c073eb757e7 28544e4] by '''Dutchman101''')
:* Updated freetype from 2.10.4 to 2.13.0 ([https://github.com/multitheftauto/mtasa-blue/commit/bce4ae768ab4075fc08e2919787e58591899eee5 bce4ae7] and [https://github.com/multitheftauto/mtasa-blue/commit/68cc67513cac6ed99f71f2522e686c3750e384e7 68cc675] by '''patrikjuvonen''')
:* Updated libspeex from 1.2rc2 to 1.2 and libspeexdsp from 1.2rc2 to 1.2rc3 ([https://github.com/multitheftauto/mtasa-blue/commit/deef8dcb534991376f51bd27c5293a78bb2e80ee deef8dc] by '''patrikjuvonen''')
:* Updated lunasvg from 2.2.0 to 2.3.8 ([https://github.com/multitheftauto/mtasa-blue/commit/929b3eef88caff448f5aed224bcfde0929003019 929b3ee] by '''Lpsd''' and '''patrikjuvonen''')
:* Updated libpng from 1.6.37 to 1.6.39 ([https://github.com/multitheftauto/mtasa-blue/commit/94bab0928f776a86bf77cab612d4d58a4549ec7b 94bab09] by '''patrikjuvonen''')
:* Updated nvapi to r530 ([https://github.com/multitheftauto/mtasa-blue/commit/6d5bb39b4b8ea753cc9d3dfc367bb9f993176d00 6d5bb39] by '''patrikjuvonen''')
:* Updated libjpeg from 9d to 9e ([https://github.com/multitheftauto/mtasa-blue/commit/c6aafc659bf93fa9875c25683b63c27379ec2a0c c6aafc6] by '''patrikjuvonen''')
:* Updated unifont from 13.0.06 to 15.0.06 ([https://github.com/multitheftauto/mtasa-blue/commit/b81eec8a9a999c080a0e59f4f669f00c7e59ebc3 b81eec8] by '''patrikjuvonen''')

=== Server ===
:* Updated sqlite from 3.36.0 to 3.42.0 ([https://github.com/multitheftauto/mtasa-blue/commit/0f072bc9ba2c65ff85634faca8f1e60bcd7b6804 0f072bc] by '''patrikjuvonen''')
:* Updated mysql-connector-c from 6.0.2 to 6.1.11 ([https://github.com/multitheftauto/mtasa-blue/commit/9f88f41909780e914879dd385f5975006a8b818c 9f88f41] by '''patrikjuvonen''')
:* Updated minizip from 1.01e to 1.1 ([https://github.com/multitheftauto/mtasa-blue/commit/76ce14e9cc97c6d357e962d38c07743d922c4b96 76ce14e] by '''patrikjuvonen''')

=== Shared ===
:* Updated curl from 7.79.1 to 8.1.2 ([https://github.com/multitheftauto/mtasa-blue/commit/602e91866bda621c03bd2e1fe3da2e992e8d7167 602e918] by '''patrikjuvonen''')
:* Updated mbedtls from 2.27.0 to 2.28.3 ([https://github.com/multitheftauto/mtasa-blue/commit/d8e29bea30d46098ea2da170c4aae24564c5b44a d8e29be] and [https://github.com/multitheftauto/mtasa-blue/commit/b233b85eed85d2e0246daaed85a4ae47900b32ae b233b85] by '''patrikjuvonen''')
:* Updated cryptopp from 8.6.0 to 8.7.0 ([https://github.com/multitheftauto/mtasa-blue/commit/c10ca9249cb027598dac99dff19f65b95641d58d c10ca92] by '''patrikjuvonen''')
:* Updated zlib from 1.2.11 to 1.2.13 ([https://github.com/multitheftauto/mtasa-blue/commit/6df121b676811b62deca5a55cd0a6bbacc149f6c 6df121b] by '''patrikjuvonen''' and [https://github.com/multitheftauto/mtasa-blue/commit/e467585d70058551ba9e69beaf86c782c374115c e467585] by '''Lpsd''')
:* Updated unrar from 6.02 to 6.21 ([https://github.com/multitheftauto/mtasa-blue/commit/66a16ff78331f5b632be63d010ee666d01681ba0 66a16ff] and [https://github.com/multitheftauto/mtasa-blue/commit/e816959ff511e2a6cca1c067ec1d3c413589d2f3 e816959] by '''patrikjuvonen''' and [https://github.com/multitheftauto/mtasa-blue/commit/66017cd0ec47b7bcc64dc7be8d27234517dccc17 66017cd] by '''Lpsd''')
:* Updated json-c from 0.15 to 0.16 ([https://github.com/multitheftauto/mtasa-blue/commit/4cfbaa76ca834a0bac8d97f873e5bfde844834ff 4cfbaa7] by '''patrikjuvonen''')
:* Updated NSIS from nsis-2.46.5-unicode to nsis-3.08 and 4 plugins and scripts ([https://github.com/multitheftauto/mtasa-blue/commit/423b55d7aca79bc9c8b59574bf7dde780b239c10 423b55d] by '''patrikjuvonen''' and [https://github.com/multitheftauto/mtasa-blue/compare/11feb0411152213594e342c54f21dc2375216cf5...a30df1b23fd11dc4977380d672694cb18cc92b99 commits] by '''Dutchman101''')

== Resources ==
=== 61+ Changes and Bug Fixes ===
:* Added a new "restore" button within Editor's "Current Elements" window ([https://github.com/multitheftauto/mtasa-resources/commit/15fbc95f61f493e96a927f8f4fa483f25be2cd13 15fbc95] by '''Haxardous''' and '''Fernando-A-Rocha''')
:* Fixed empty if branches ([https://github.com/multitheftauto/mtasa-resources/commit/2660580de2750ca617a86f7e3ccb8235331935a8 2660580] by '''ArranTuna''')
:* Fixed inconsistent indentation ([https://github.com/multitheftauto/mtasa-resources/commit/49d325928a8de114587568196d2ad4f1207f5d8d 49d3259] and [https://github.com/multitheftauto/mtasa-resources/commit/2d684707648b13c028d386a27abbcc08b22f3945 2d68470] by '''ArranTuna''')
:* Fixed lines containing trailing whitespaces ([https://github.com/multitheftauto/mtasa-resources/commit/555a8ba0caf188fa6a0bdc755530ba4e9e9b121a 555a8ba] by '''ArranTuna''')
:* Fixed lint errors ([https://github.com/multitheftauto/mtasa-resources/commit/ccf98a117cd57d9459036bc227d3499a66a10b19 ccf98a1] and [https://github.com/multitheftauto/mtasa-resources/commit/7ee88903da99c837f268a13c7281fdf9476ea9ed 7ee8890] by '''ArranTuna''')
:* Fixed lint warnings ([https://github.com/multitheftauto/mtasa-resources/commit/b139dd9f878a89f6de01f9416b81605705af30ba b139dd9], [https://github.com/multitheftauto/mtasa-resources/commit/372a8fab81e6a367ab3c2531885966617b563f9b 372a8fa], [https://github.com/multitheftauto/mtasa-resources/commit/ad1522f221aecee76fe42ed5f15b77785a299589 ad1522f], [https://github.com/multitheftauto/mtasa-resources/commit/386801682dc437e8527def6ece63d607b95ae775 3868016], [https://github.com/multitheftauto/mtasa-resources/commit/a7fbea7a549328a7a3aa074b635cb2638252b027 a7fbea7], [https://github.com/multitheftauto/mtasa-resources/commit/a474c544bd8d01b799addb84d91e98b606e93081 a474c54] and [https://github.com/multitheftauto/mtasa-resources/commit/18a495cefa6b5fb343f5576f54bce19e75a412f8 18a495c] by '''ArranTuna''')
:* Fixed "shadowing definition of loop variable" lint warnings ([https://github.com/multitheftauto/mtasa-resources/commit/02233dbc7d20205c2ce28da06a93d1637d841b7b 02233db] by '''ArranTuna''')
:* Fixed elementbrowser and resourcemanager not working by removing legacy JSON library and some ajax refactoring ([https://github.com/multitheftauto/mtasa-resources/commit/bde31f8a890057f2a7e02940f37489037b3de9a8 bde31f8] by '''4O4''')
:* Removed some unused variables ([https://github.com/multitheftauto/mtasa-resources/commit/0d424d13eabd9ef68c5282c46fc24c4f880b1c95 0d424d1] by '''ArranTuna''')
:* Replaced [[getLocalPlayer]] with [[localPlayer]] across multiple resources ([https://github.com/multitheftauto/mtasa-resources/commit/01f7695d3a49ce97639666773c274b747a7a158d 01f7695] by '''ArranTuna''')
:* Replaced [[getResourceRootElement]] with [[resourceRoot]] across multiple resources ([https://github.com/multitheftauto/mtasa-resources/commit/0dee4961826feaad364fcb1565cba0824a4e1849 0dee496] by '''ArranTuna''')
:* Replaced [[getRootElement]] with [[root]] across multiple resources ([https://github.com/multitheftauto/mtasa-resources/commit/9582a82ea92d9e8f89a958dd7b33d82698ed1c9f 9582a82] by '''ArranTuna''')
:* Upgraded admin2, interiors, parachute and freeroam resources to use the new jetpack functions ([https://github.com/multitheftauto/mtasa-resources/commit/c618a18c6698839074014b747c3826f60feae0c6 c618a18] by '''xLive''')
:* [admin] Fixed "previously defined" warnings ([https://github.com/multitheftauto/mtasa-resources/commit/4ffc5d067f48a83d2df7c375a512fb0de83e576c 4ffc5d0] and [https://github.com/multitheftauto/mtasa-resources/commit/3ed3219498813e130650231ff10a9fbe99c30fd9 3ed3219] by '''ArranTuna''')
:* [admin] Removed non-existent functions ([https://github.com/multitheftauto/mtasa-resources/commit/a5941740d3ee16b42ad883e7eecdb30266f692d5 a594174] by '''ghostkc12''')
:* [admin] Removed serial validation ([https://github.com/multitheftauto/mtasa-resources/commit/c6259f627936cea2743a40201a04a23dc78d5e7a c6259f6] by '''srslyyyy''')
:* [admin] Improved admin to use a newly added server event instead of a client script ([https://github.com/multitheftauto/mtasa-resources/commit/0cb4877b2770666f95c01ba75f208315f1edc4bf 0cb4877] by '''srslyyyy''')
:* [admin] Updated ip2c mirror link ([https://github.com/multitheftauto/mtasa-resources/commit/9ad4c366ae5704ee7d79d64912ee0ec9f12e977d 9ad4c36] by '''Dutchman101''')
:* [admin] Updated ''IpToCountryCompact.csv'' ([https://github.com/multitheftauto/mtasa-resources/commit/310c59f0c94013dc258e68d9e82dd84e4da05ea4 310c59f] by '''Dutchman101''')
:* [admin] Fixed "No map selected!" message box when clicking search map editbox ([https://github.com/multitheftauto/mtasa-resources/commit/0b7d576607b62759ad7c2dd21ff0259e6358b4a8 0b7d576] by '''Mkl21''')
:* [admin2] Fixed spectator player action buttons ([https://github.com/multitheftauto/mtasa-resources/commit/01af273a6664c0db152a743a972a6f5fa02f8851 01af273] by '''Dark-Dragon''')
:* [admin2] Fixed various sorting related gridlist issues ([https://github.com/multitheftauto/mtasa-resources/commit/e0d1642b8a6fea3a822786c9a7cc7f8e4e1145e9 e0d1642] by '''Dark-Dragon''')
:* [admin2] Added missing set nick functionality ([https://github.com/multitheftauto/mtasa-resources/commit/39c40e61360579f9eb44d038f17712495b0022d6 39c40e6] by '''Dark-Dragon''')
:* [ajax] Use ''application/json'' request header when sending a JSON POST request ([https://github.com/multitheftauto/mtasa-resources/commit/11c466a102556369887eba944128cd0641ff018a 11c466a] by '''Xenius97''')
:* [ctf] Various fixes, cleanups and refactoring ([https://github.com/multitheftauto/mtasa-resources/commit/609ac0cc614944ec7e53292ad705b046134cc41f 609ac0c] by '''IIYAMA12''')
:* [deathmatch] Major refactor ([https://github.com/multitheftauto/mtasa-resources/commit/9f57aa898b214a8fd3d5d1cad94c793d49d8c804 9f57aa8] by '''jlillis''')
:* [editor] Fixed some debug warnings ([https://github.com/multitheftauto/mtasa-resources/commit/5e9f2220b645c369e9654c577403530c076e1749 5e9f222] by '''ArranTuna''')
:* [editor] Improved some debug outputs ([https://github.com/multitheftauto/mtasa-resources/commit/be3477dc310f0f77a33531cc59ccdd7e1cd0e6ec be3477d] by '''ArranTuna''')
:* [editor] Small improvements in editor_main ([https://github.com/multitheftauto/mtasa-resources/commit/7816898d991a072b35e62ccf06c73775f39cb3eb 7816898] by '''srslyyyy''')
:* [editor] Updated gamemodestopper.lua in editor_main ([https://github.com/multitheftauto/mtasa-resources/commit/bfad62487c08237f6227546b98878fd05ec08474 bfad624], [https://github.com/multitheftauto/mtasa-resources/commit/3063712ac88d489eecae0263bf6ae086959ff6b5 3063712] and [https://github.com/multitheftauto/mtasa-resources/commit/7955351e58844bdbefa76d8e82102a6c829f4496 7955351] by '''srslyyyy''')
:* [editor] Fixed a typo in text ([https://github.com/multitheftauto/mtasa-resources/commit/8722f2b1ea85acca225dd700779ea18d2ffd0fac 8722f2b] by '''Dutchman101''')
:* [editor] Rotation improvements ([https://github.com/multitheftauto/mtasa-resources/commit/ced470eb0ead7c48df948a17533fda8cbe656b0d ced470e] by '''Zangomangu''')
:* [editor] Fixed delete button not restoring element ([https://github.com/multitheftauto/mtasa-resources/commit/f0d0285faf853c47133eab106c05ccad5fc9ce71 f0d0285] by '''Haxardous''')
:* [editor] Removed breakable workaround in favour of the now native support for it ([https://github.com/multitheftauto/mtasa-resources/commit/33e54e445fed5b1ebec31f4a2ff993ff91186b40 33e54e4], [https://github.com/multitheftauto/mtasa-resources/commit/17981673c602baeecfd5a508c45c7bc711e8e02b 1798167] and [https://github.com/multitheftauto/mtasa-resources/commit/006eefb63bbe3ea1d4cf500942860f40ae481cbd 006eefb] by '''patrikjuvonen''')
:* [editor_main] Improved scripting extensions ([https://github.com/multitheftauto/mtasa-resources/commit/7a8ae063c127fcb62a7d50d565355e1bb2bd7038 7a8ae06] by '''srslyyyy''')
:* [editor_main] Disabled unused OOP in ''meta.xml'' for scripting extensions ([https://github.com/multitheftauto/mtasa-resources/commit/95f3c36307512bb35e7efb727e101c1bbc136564 95f3c36] by '''srslyyyy''')
:* [editor_main] Fixed version warning ([https://github.com/multitheftauto/mtasa-resources/commit/29e1ae023b2746c4528c1064e6743d40877c9518 29e1ae0] by '''srslyyyy''')
:* [freecam] Added support for changing field of view ([https://github.com/multitheftauto/mtasa-resources/commit/a960ba478a72996456376da23aaac538e0572e18 a960ba4] by '''Xenius97''')
:* [freecam] Fixed freecam mouse & key input by ignoring it when MTA window not focused ([https://github.com/multitheftauto/mtasa-resources/commit/316f536eb4816a6993e5690e730211c4cabb55e7 316f536] by '''Fernando-A-Rocha''')
:* [gameplay] Added button to delete handlings in hedit ([https://github.com/multitheftauto/mtasa-resources/commit/0835ecd1f77fe98b1dcc84130d068f8fadb6af0d 0835ecd] and [https://github.com/multitheftauto/mtasa-resources/commit/6509b7424c3c2d6b38054e86904cc5b9a9c7fa78 6509b74] by '''ricksterhd123''', '''Inder00''', '''Disinterpreter''' and '''Dutchman101''')
:* [gameplay] Fixed a debug warning in freeroam ([https://github.com/multitheftauto/mtasa-resources/commit/36b4f00181e804111a83b4bd8083be88325fded3 36b4f00] by '''ArranTuna''')
:* [gameplay] Fixed steering lock glitch on bikes and motorcycles in hedit ([https://github.com/multitheftauto/mtasa-resources/commit/f76952b7606a7121d26eea086b7382554d5247e0 f76952b] and [https://github.com/multitheftauto/mtasa-resources/commit/d252b9f7a849ddacb0dd84b72c51b80899c33c76 d252b9f] by '''Dutchman101''')
:* [gameplay] Fixed typos in hedit and sfxbrowser ([https://github.com/multitheftauto/mtasa-resources/commit/814437b19d05924373810f3961e6768744f45b90 814437b] by '''TheNormalnij''')
:* [gameplay] Settings support and code refactor for joinquit ([https://github.com/multitheftauto/mtasa-resources/commit/bbd536d18abb27850bb4ec0895031558a2c90501 bbd536d] by '''itslewiswatson''')
:* [gameplay] Small fixes for defaultstats ([https://github.com/multitheftauto/mtasa-resources/commit/b09bd68c960644e339a1e74f6002e3822f13191b b09bd68] by '''srslyyyy''')
:* [gameplay] Small optimization on servers that use a lot of element data in parachute ([https://github.com/multitheftauto/mtasa-resources/commit/7b9d047fae1c3163aa7b2a380be87a149bf51906 7b9d047] and [https://github.com/multitheftauto/mtasa-resources/commit/d252b9f7a849ddacb0dd84b72c51b80899c33c76 d252b9f] by '''Dutchman101''')
:* [gameplay] Some improvements in deathpickups ([https://github.com/multitheftauto/mtasa-resources/commit/aa9782ea996bbe684587c8e9cf542a575a23779f aa9782e] by '''srslyyyy''')
:* [hay] Fixed hay not resetting ([https://github.com/multitheftauto/mtasa-resources/commit/036ff6142b48b97d47456d8cb16d40e71b7ca57b 036ff61] by '''Dark-Dragon''')
:* [hedit] Added translations for delete button ([https://github.com/multitheftauto/mtasa-resources/commit/2b7439d8eba579f4f8fb21ddf1301454aface76a 2b7439d] by '''ricksterhd123''' and '''Disinterpreter''')
:* [ip2c] Added new '''ip2c''' default resource (decoupled from admin resource) ([https://github.com/multitheftauto/mtasa-resources/commit/f64d65737bdefc300a0744592562455afdc3338b f64d657] by '''Fernando-A-Rocha''' and '''srslyyyy''')
:* [play] Refactored code ([https://github.com/multitheftauto/mtasa-resources/commit/7b66c7855735a4d43845863802814952d45773ab 7b66c78] by '''srslyyyy''')
:* [playerblips] Various improvements ([https://github.com/multitheftauto/mtasa-resources/commit/9e79974593c08f44266bf75279db1537a1f05d69 9e79974] by '''jlillis''')
:* [rustlerbombs] Added new '''rustlerbombs''' default resource ([https://github.com/multitheftauto/mtasa-resources/commit/49961eb6b907774fdd7d56e53bc050dacd118434 49961eb] by '''Dutchman101''')
:* [scoreboard] Trigger events improvements ([https://github.com/multitheftauto/mtasa-resources/commit/9be00d67a73bb66a04218668c85e26c7eff6db5c 9be00d6] by '''srslyyyy''')
:* [scoreboard] Performance improvements ([https://github.com/multitheftauto/mtasa-resources/commit/3d3c592b4522d5dcb33f9eb22e09bceaa29fb058 3d3c592] and [https://github.com/multitheftauto/mtasa-resources/commit/89f122497a9771923391276e432b1b449a79dd5e 89f1224] by '''srslyyyy''')
:* [scoreboard] Make ''/setcountry'' command available to all players, rather than just admins ([https://github.com/multitheftauto/mtasa-resources/commit/d8cff2da8745de34a4d0d6812e32920d98abbb8b d8cff2d] by '''Dutchman101''')
:* [scoreboard] Add 'fake ping' (''/setping'') command, to complement ''/setcountry'' and make it more believable for users ([https://github.com/multitheftauto/mtasa-resources/commit/7aea1cc503c3b500f1f8beb00e63a44de2376e47 7aea1cc] and [https://github.com/multitheftauto/mtasa-resources/commit/d06f1d56a462d9c48e97c8da4d473635f5c88b0c d06f1d5] by '''Dutchman101''')
:* [voice_local] Added new '''voice_local''' default resource ([https://github.com/multitheftauto/mtasa-resources/commit/25d4a4f91f2277816819506a6e7fc62e727e6ef8 25d4a4f] by '''Dutchman101''')
:* [web] Fixed resourcemanager ([https://github.com/multitheftauto/mtasa-resources/commit/37348cecb60a6c999c316398a17f866d54569953 37348ce] by '''ArranTuna''')
:* [webadmin] Fixed a typo in CSS ([https://github.com/multitheftauto/mtasa-resources/commit/70361a4b19fb2773903de3431c37ab34a3252a03 70361a4] by '''RatajVaver''')
:* [webmap] Switched to assets.multitheftauto.com domain for loading map tiles ([https://github.com/multitheftauto/mtasa-resources/commit/218f2c7ff17884f6905593ab716c52a38f2e90ed 218f2c7] by '''patrikjuvonen''')

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

[[Category:Changelog]]

Template:Building functions

2024-06-12T21:14:10Z

TheNormalnij: Fix mta version

<ul>
{{New feature/item|3.0162|1.6.0|22410|
<li>[[createBuilding]]</li>
}}
{{New feature/item|3.0162|1.6.0|22420|
<li>[[removeAllGameBuildings]]</li>
<li>[[restoreAllGameBuildings]]</li>
}}
</ul>

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

CreateBuilding

2024-06-09T18:31:29Z

TheNormalnij: Fix position

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6.0|22410|Creates a [[building]] [[element]] at a given position and rotation.}}

==Syntax==
<syntaxhighlight lang="lua">building createBuilding ( int modelId, float x, float y, float z, float rx, float ry, float rz, [ int interior = 0 ] )</syntaxhighlight>
{{OOP||[[Building]]||}}

===Required Arguments===
*'''modelId:''' A whole integer specifying the GTA:SA object model ID.
*'''x:''' A floating point number representing the X coordinate on the map.
*'''y:''' A floating point number representing the Y coordinate on the map.
*'''z:''' A floating point number representing the Z coordinate on the map.
*'''rx:''' A floating point number representing the rotation about the X axis in degrees.
*'''ry:''' A floating point number representing the rotation about the Y axis in degrees.
*'''rz:''' A floating point number representing the rotation about the Z axis in degrees.

===Optional Arguments===
{{OptionalArg}}
*'''interior:''' The interior you want to set the building to. Valid values are 0 to 255.

===Returns===
* Returns the [[building]] element if the creation was successful, throws an error otherwise.

==Example==
<section name="Simple example" class="client" show="true">
This example creates a building when the resource starts:
<syntaxhighlight lang="lua">
function loadMap()
-- create a *building* at a specified position with a specified rotation
createBuilding(1337, 100.5, 30.6, 4.0, 90, 0, 0)
end
addEventHandler("onClientResourceStart", resourceRoot, loadMap)
</syntaxhighlight>
</section>

==See Also==
{{Building functions}}

Template:Engine functions

2024-06-08T14:51:17Z

TheNormalnij: Pool functions added

<ul>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineAddImage]]</li>
}}
<li>[[engineApplyShaderToWorldTexture]]</li>
<li>[[engineFreeModel]]</li>
{{Added feature/item|1.6.1|1.6.0|22190|
<li>[[engineFreeTXD]]</li>
}}
{{Added feature/item|1.6.0|1.5.9|21695|
<li>[[engineGetModelFlags]]</li>
}}
<li>[[engineGetModelIDFromName]]</li>
<li>[[engineGetModelLODDistance]]</li>
<li>[[engineGetModelNameFromID]]</li>
<li>[[engineGetModelPhysicalPropertiesGroup]]</li>
<li>[[engineGetModelTextureNames]]</li>
<li>[[engineGetModelTextures]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineGetModelTXDID]]</li>
}}
{{Added feature/item|1.5.9|1.5.8|20704|
<li>[[engineGetModelVisibleTime]]</li>
}}
<li>[[engineGetObjectGroupPhysicalProperty]]</li>
<li>[[engineGetSurfaceProperties]]</li>
<li>[[engineGetVisibleTextureNames]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineImageGetFilesCount]]</li>
<li>[[engineImageGetFiles]]</li>
<li>[[engineImageGetFile]]</li>
<li>[[engineImageLinkDFF]]</li>
<li>[[engineImageLinkTXD]]</li>
}}
<li>[[engineImportTXD]]</li>
<li>[[engineLoadCOL]]</li>
<li>[[engineLoadDFF]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineLoadIMG]]</li>
}}
<li>[[engineLoadIFP]]</li>
<li>[[engineLoadTXD]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineRemoveImage]]</li>
}}
<li>[[engineRemoveShaderFromWorldTexture]]</li>
<li>[[engineReplaceAnimation]]</li>
<li>[[engineReplaceCOL]]</li>
<li>[[engineReplaceModel]]</li>
<li>[[engineRequestModel]]</li>
{{Added feature/item|1.6.1|1.6.0|22190|
<li>[[engineRequestTXD]]</li>
}}
{{Added feature/item|1.6.0|1.5.9|21695|
<li>[[engineResetModelFlags]]</li>
}}
<li>[[engineResetModelLODDistance]]</li>
{{Added feature/item|1.6.1|1.6.0|22190|
<li>[[engineResetModelTXDID]]</li>
}}
<li>[[engineResetSurfaceProperties]]</li>
<li>[[engineRestoreAnimation]]</li>
<li>[[engineRestoreCOL]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineRestoreDFFImage]]</li>
}}
<li>[[engineRestoreModel]]</li>
<li>[[engineRestoreModelPhysicalPropertiesGroup]]</li>
<li>[[engineRestoreObjectGroupPhysicalProperties]]</li>
{{Added feature/item|1.6.0|1.5.9|21708|
<li>[[engineRestoreTXDImage]]</li>
}}
{{Added feature/item|1.5.9|1.5.8|20704|
<li>[[engineRestreamWorld]]</li>
}}
<li>[[engineSetAsynchronousLoading]]</li>
{{Added feature/item|1.6.0|1.5.9|21695|
<li>[[engineSetModelFlag]]</li>
<li>[[engineSetModelFlags]]</li>
}}
<li>[[engineSetModelLODDistance]]</li>
<li>[[engineSetModelPhysicalPropertiesGroup]]</li>
{{Added feature/item|1.6.1|1.6.0|22190|
<li>[[engineSetModelTXDID]]</li>
}}
{{Added feature/item|1.5.9|1.5.8|20704|
<li>[[engineSetModelVisibleTime]]</li>
}}
<li>[[engineSetObjectGroupPhysicalProperty]]</li>
<li>[[engineSetSurfaceProperties]]</li>
{{Added feature/item|1.5.9|1.5.8|20901|
<li>[[engineStreamingFreeUpMemory]]</li>
<li>[[engineStreamingGetUsedMemory]]</li>
}}

{{Added feature/item|1.6.1|1.6.0|21874|
<li>[[engineStreamingSetMemorySize]]</li>
<li>[[engineStreamingGetMemorySize]]</li>
<li>[[engineStreamingRestoreMemorySize]]</li>
<li>[[engineStreamingSetBufferSize]]</li>
<li>[[engineStreamingGetBufferSize]]</li>
<li>[[engineStreamingRestoreBufferSize]]</li>
}}

{{Added feature/item|1.6.1|1.6.0|21947|
<li>[[engineStreamingSetModelCacheLimits]]</li>
}}

{{Added feature/item|1.6.1|1.6.0|22471|
<li>[[engineGetPoolCapacity]]</li>
<li>[[engineSetPoolCapacity]]</li>
<li>[[engineGetPoolDefaultCapacity]]</li>
<li>[[engineGetPoolUsedCapacity]]</li>
}}
</ul>

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

RestoreAllGameBuildings

2024-05-25T15:11:08Z

TheNormalnij:

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6.0|22420|This function cancels [[removeAllGameBuildings]] effect}}
{{Note|This function can destroy some scripted buildings if the building pool does not have enough free space for game buildings.}}
==Syntax==
<syntaxhighlight lang="lua">nil restoreAllGameBuildings ( )</syntaxhighlight>

===Returns===
Nothing

==See Also==
{{Building functions}}

RestoreAllGameBuildings

2024-05-25T15:10:56Z

TheNormalnij:

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6.0|22420|This function cancels [[removeAllGameBuildings]] efffect}}
{{Note|This function can destroy some scripted buildings if the building pool does not have enough free space for game buildings.}}
==Syntax==
<syntaxhighlight lang="lua">nil restoreAllGameBuildings ( )</syntaxhighlight>

===Returns===
Nothing

==See Also==
{{Building functions}}

RestoreAllGameBuildings

2024-05-25T15:10:38Z

TheNormalnij: Created page with "__NOTOC__ {{Client function}} {{New feature/item|3.0161|1.6.0|22420|This function cancels RemoveAllGameBuildings efffect}} {{Note|This function can destroy some scripted buildings if the building pool does not have enough free space for game buildings.}} ==Syntax== <syntaxhighlight lang="lua">nil restoreAllGameBuildings ( )</syntaxhighlight> ===Returns=== Nothing ==See Also== {{Building functions}}"

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6.0|22420|This function cancels [[RemoveAllGameBuildings]] efffect}}
{{Note|This function can destroy some scripted buildings if the building pool does not have enough free space for game buildings.}}
==Syntax==
<syntaxhighlight lang="lua">nil restoreAllGameBuildings ( )</syntaxhighlight>

===Returns===
Nothing

==See Also==
{{Building functions}}

RemoveAllGameBuildings

2024-05-25T15:05:49Z

TheNormalnij: Add note

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6.0|22420|This function is used to remove all world buildings and frees building pool.}}
{{Note|This function does not affect buildings created using the [[createBuilding]] function}}
==Syntax==
<syntaxhighlight lang="lua">nil removeAllGameBuildings ( )</syntaxhighlight>

===Returns===
Nothing

==See Also==
{{Building functions}}

Template:Building functions

2024-05-25T15:01:38Z

TheNormalnij: Fix build number

<ul>
{{New feature/item|3.0162|1.6.1|22410|
<li>[[createBuilding]]</li>
}}
{{New feature/item|3.0162|1.6.1|22420|
<li>[[removeAllGameBuildings]]</li>
<li>[[restoreAllGameBuildings]]</li>
}}
</ul>

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

RemoveAllGameBuildings

2024-05-25T14:59:04Z

TheNormalnij: Created page with "__NOTOC__ {{Client function}} {{New feature/item|3.0161|1.6.0|22420|This function is used to remove all world buildings and frees building pool.}} ==Syntax== <syntaxhighlight lang="lua">nil removeAllGameBuildings ( )</syntaxhighlight> ===Returns=== Nothing ==See Also== {{Building functions}}"

__NOTOC__
{{Client function}}
{{New feature/item|3.0161|1.6.0|22420|This function is used to remove all world buildings and frees building pool.}}

==Syntax==
<syntaxhighlight lang="lua">nil removeAllGameBuildings ( )</syntaxhighlight>

===Returns===
Nothing

==See Also==
{{Building functions}}

EngineRestoreObjectGroupPhysicalProperties

2024-05-17T22:02:08Z

TheNormalnij: There is no "property" argument

__NOTOC__
{{Client function}}
{{New feature/item|3.0157|1.5.7|19626|This function restores all physical properties of given properties group.}}

==Syntax==
<syntaxhighlight lang="lua">bool engineRestoreObjectGroupPhysicalProperties ( int groupID )</syntaxhighlight>
===Required Arguments===
*'''groupID''': the id of physical properties group which you wish to restore.

===Returns===
Returns '''true''' if everything went well, error is raised otherwise.

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function restorePhysicalGroup(_, group)
engineRestoreObjectGroupPhysicalProperties(tonumber(group))
end
addCommandHandler ( "restorePhysicalGroup", restorePhysicalGroup )
--restorePhysicalGroup(120)
</syntaxhighlight>
</section>

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

==See Also==
{{Client_object_functions}}

EngineSetObjectGroupPhysicalProperty

2024-05-17T21:54:31Z

TheNormalnij: Use engine functions

__NOTOC__
{{Client function}}
{{New feature/item|3.0157|1.5.7|19626|This function sets physical property of given properties group.}}

==Syntax==
<syntaxhighlight lang="lua">bool engineSetObjectGroupPhysicalProperty ( int groupID, objectgroup-modifiable property, var newValue )</syntaxhighlight>
===Required Arguments===
*'''groupID''': the id of physical properties group which you wish to set a property of.
*'''objectgroup-modifiable''': the property which you wish to set, as per table below.
*'''newValue''': new value of the property, with proper type as specified in table below

===Returns===
Returns '''true''' if everything went well, error is raised otherwise.

===Properties===
{{Physical_Properties}}

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

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function lamppostCollision()
engineSetObjectGroupPhysicalProperty(111, "cause_explosion", true)
end
addEventHandler("onClientResourceStart", resourceRoot, lamppostCollision)

--Every time you hit a lamppost, an explosion will be created
</syntaxhighlight>
</section>

==See Also==
{{Engine_functions}}

Template:Physical Properties

2024-05-17T21:38:45Z

TheNormalnij: Add turn_mass

===Physical properties===
{|class="wikitable sortable"
|-
! Property || Type || Description
|-
| mass || float || Mass of an object
|-
| turn_mass || float || Turn mass (kg m^3) of an object
|-
| air_resistance || float || Air resistance of an object
|-
| elasticity || float || Elasticity of an object
|-
| buoyancy || float || Buoyancy of an object
|-
| uproot_limit || float || How much force is needed to uproot the object
|-
| col_damage_multiplier || float || Force multiplier used when colliding with object
|-
| col_damage_effect || DamageEffect || Dictates which damage effect is applied to object on collision
|-
| special_col_response || CollisionResponse || Dictates how object responds to being collided with
|-
| avoid_camera || bool || Dictates whether camera passes throught the object
|-
| cause_explosion || bool || Dictates whether objects exploded upon collision
|-
| fx_type || FxType || Dictates when particles will be created when colliding with object
|-
| fx_offset || Vector3D || Offset from center of mass where particles will be created upon collision
|-
| fx_system || FxEffect(string) || Effect that will be used upon collision
|-
| smash_multiplier || float || Force multiplier when destroying object
|-
| break_velocity || Vector3D || Velocity and direction in which the object is destroyed
|-
| break_velocity_randomness || float || Randomness of velocity and direction in which the object is destroyed, 0 means that object uses break_velocity without any randomness
|-
| break_mode || BreakMode || Dictates how object can be damaged
|-
| sparks_on_impact || bool || Dictates whether object creates sparks upon impact
|}

===Damage effect===
{|class="wikitable sortable"
! Effect || Description
|-
| none || Object doesn't change at all once it's damaged
|-
| change_model || Some of the objects change model on collision, those use this
|-
| smash || Object is smashed
|-
| change_smash || First CHANGE_MODEL, afterwards smash on collision
|-
| breakable || Object is breakable normally
|-
| breakable_remove || object.dat says: '(ie. never regenerated after destroyed)'
|}

===Collision Response===
{|class="wikitable sortable"
! Response || Description
|-
| none || Object doesn't respond in any special way
|-
| lamppost || Objects acts like an lamp post
|-
| small_box || -
|-
| big_box || -
|-
| fence_part || -
|-
| grenade || -
|-
| swingdoor || -
|-
| lockdoor || -
|-
| hanging || -
|-
| poolball || -
|}

===Fx Type===
{|class="wikitable sortable"
! Type || Description
|-
| none || No particles effect played on collision
|-
| play_on_hit || Particles effect is played on collision, even if object isn't destroyed
|-
| play_on_destroyed || Particles effect is played only once object is destroyed
|-
| play_on_hitdestroyed || Particles effect is played both when hit and destroyed
|}

===Break Mode===
{|class="wikitable sortable"
! Mode || Description
|-
| not_by_gun || not breakable by gun
|-
| by_gun || -
|-
| smashable || -
|}

===Fx Effect===
{|class="wikitable sortable"
! effect || Description
|-
| wallbust || -
|-
| shootlight || -
|-
| puke || Puke effect
|-
| explosion_door || -
|-
| explosion_crate || Crate break
|-
| explosion_barrel || Barrel explosion
|-
| blood_heli || Heli cutting peds
|-
| tree_hit_palm || -
|-
| tree_hit_fir || -
|-
| water_swim || Water ripples
|-
| water_splsh_sml || -
|-
| water_splash_big || -
|-
| water_splash || -
|-
| water_hydrant || -
|-
| tank_fire || -
|-
| riot_smoke || -
|-
| gunsmoke || Gun smoke when firing
|-
| gunflash || Gun flash when firing
|-
| explosion_tiny || -
|-
| explosion_small || -
|-
| explosion_molotov || Molotov explosion
|-
| explosion_medium || -
|-
| explosion_large || -
|-
| explosion_fuel_car || -
|-
| exhale || -
|-
| camflash || Camera photo flash
|-
| prt_wake || Wake on water behind boats
|}