Multi Theft Auto: Wiki - User contributions [en]

GetObjectScale

2021-02-02T14:19:03Z

Saint Laurent:

__NOTOC__
{{Server client function}}
This function returns the visible size of an object.

==Syntax==
<syntaxhighlight lang="lua">
float, float, float getObjectScale ( object theObject )
</syntaxhighlight>
{{OOP||[[Object]]:getScale|scale|setObjectScale}}
===Required Arguments===
*'''theObject''': the [[object]] you wish to return the scale of.

===Returns===
* Three [[float]] values indicating the scale of the object on the x, y, and z axis if successful, ''false'' otherwise.

==Example==
<section name="Client-only Example" class="client" show="true">
This example adds a command named ''getscale'' which creates an object and prints out the scale of it.
<syntaxhighlight lang="lua">
addCommandHandler("getscale",
function()
local theObject = createObject(1337, getElementPosition(localPlayer))
local x, y, z = getObjectScale(theObject)
outputChatBox("Object scale: X: "..x..", Y: "..y.." Z: "..z.."")
end
)
</syntaxhighlight>
</section>

==See Also==
{{Object_functions}}

CreateObject

2021-02-02T14:11:29Z

Saint Laurent:

__NOTOC__
{{Server client function}}
Creates an [[object]] [[element]] at a given position and rotation.
{{Note|Dynamic objects do not automatically have physics applied to them. Use [[setElementVelocity]](object, 0, 0, 0) to fix this.}}
{{Note|Creating objects server-side can help for syncing the objects with all clients (for example, if you create a glass object client-side, it will break only for the client that broke the glass. Server-side, it will broke for all clients.}}

==Syntax==
<syntaxhighlight lang="lua">object createObject ( int modelId, float x, float y, float z, [ float rx, float ry, float rz, bool isLowLOD = false ] )</syntaxhighlight>
{{OOP||[[Object]]||}}

===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.
{{New items|3.0120|1.2|
*'''isLowLOD:''' A bool value specifying if the object will be low LOD. A low LOD object has no collision and a longer draw distance.
}}

===Returns===
* Returns the [[object]] element if the creation was successful, ''false'' otherwise.

==Example==
<section name="Server-only Example 1" class="server" show="true">
This example creates an object when the resource starts:
<syntaxhighlight lang="lua">
function loadMapObjects()
-- create an object at a specified position with a specified rotation
createObject(1337, 5540.6654, 1020.55122, 1240.545, 90, 0, 0)
end
addEventHandler("onResourceStart", resourceRoot, loadMapObjects)
</syntaxhighlight>
</section>

<section name="Server-only Example 2" class="server" show="true">
This example creates an object near the player who write /createObject in the chat:
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createObject' in the console:
function createObjectCommand(thePlayer, commandName)
if (thePlayer) then
local x, y, z = getElementPosition(thePlayer)
-- create a object next to the player:
local theObject = createObject(980, x + 2, y + 2, z, 0, 0, 0)
if (theObject) then -- check if the object was created successfully
outputChatBox("Object created successfully.", thePlayer)
else
outputChatBox("Failed to create the object.", thePlayer)
end
end
end
addCommandHandler("createobject", createObjectCommand)
</syntaxhighlight>
</section>

==See Also==
{{Object functions}}

CreateObject

2021-02-02T14:08:29Z

Saint Laurent:

__NOTOC__
{{Server client function}}
Creates an [[object]] [[element]] at a given position and rotation.
{{Note|Dynamic objects do not automatically have physics applied to them. Use setElementVelocity(object, 0, 0, 0) to fix this.}}
{{Note|Creating objects server-side can help for syncing the objects with all clients (for example, if you create a glass object client-side, it will break only for the client that broke the glass. Server-side, it will broke for all clients.}}

==Syntax==
<syntaxhighlight lang="lua">object createObject ( int modelId, float x, float y, float z, [ float rx, float ry, float rz, bool isLowLOD = false ] )</syntaxhighlight>
{{OOP||[[Object]]||}}

===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.
{{New items|3.0120|1.2|
*'''isLowLOD:''' A bool value specifying if the object will be low LOD. A low LOD object has no collision and a longer draw distance.
}}

===Returns===
* Returns the [[object]] element if the creation was successful, ''false'' otherwise.

==Example==
<section name="Server-only Example 1" class="server" show="true">
This example creates an object when the resource starts:
<syntaxhighlight lang="lua">
function loadMapObjects()
-- create an object at a specified position with a specified rotation
createObject(1337, 5540.6654, 1020.55122, 1240.545, 90, 0, 0)
end
addEventHandler("onResourceStart", resourceRoot, loadMapObjects)
</syntaxhighlight>
</section>

<section name="Server-only Example 2" class="server" show="true">
This example creates an object near the player who write /createObject in the chat:
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createObject' in the console:
function createObjectCommand(thePlayer, commandName)
if (thePlayer) then
local x, y, z = getElementPosition(thePlayer)
-- create a object next to the player:
local theObject = createObject(980, x + 2, y + 2, z, 0, 0, 0)
if (theObject) then -- check if the object was created successfully
outputChatBox("Object created successfully.", thePlayer)
else
outputChatBox("Failed to create the object.", thePlayer)
end
end
end
addCommandHandler("createobject", createObjectCommand)
</syntaxhighlight>
</section>

==See Also==
{{Object functions}}

CreateObject

2021-02-02T14:04:40Z

Saint Laurent:

__NOTOC__
{{Server client function}}
Creates an object in the GTA world.
{{Note|Dynamic objects do not automatically have physics applied to them. Use setElementVelocity(object, 0, 0, 0) to fix this.}}
{{Note|Creating objects server-side can help for syncing the objects with all clients (for example, if you create a glass object client-side, it will break only for the client that broke the glass. Server-side, it will broke for all clients.}}

==Syntax==
<syntaxhighlight lang="lua">object createObject ( int modelId, float x, float y, float z, [ float rx, float ry, float rz, bool isLowLOD = false ] )</syntaxhighlight>
{{OOP||[[Object]]||}}

===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.
{{New items|3.0120|1.2|
*'''isLowLOD:''' A bool value specifying if the object will be low LOD. A low LOD object has no collision and a longer draw distance.
}}

===Returns===
* Returns the [[object]] element if the creation was successful, ''false'' otherwise.

==Example==
<section name="Server-only Example 1" class="server" show="true">
This example creates an object when the resource starts:
<syntaxhighlight lang="lua">
function loadMapObjects()
-- create an object at a specified position with a specified rotation
createObject(1337, 5540.6654, 1020.55122, 1240.545, 90, 0, 0)
end
addEventHandler("onResourceStart", resourceRoot, loadMapObjects)
</syntaxhighlight>
</section>

<section name="Server-only Example 2" class="server" show="true">
This example creates an object near the player who write /createObject in the chat:
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createObject' in the console:
function createObjectCommand(thePlayer, commandName)
if (thePlayer) then
local x, y, z = getElementPosition(thePlayer)
-- create a object next to the player:
local theObject = createObject(980, x + 2, y + 2, z, 0, 0, 0)
if (theObject) then -- check if the object was created successfully
outputChatBox("Object created successfully.", thePlayer)
else
outputChatBox("Failed to create the object.", thePlayer)
end
end
end
addCommandHandler("createObject", createObjectCommand)
</syntaxhighlight>
</section>

==See Also==
{{Object functions}}

CreateObject

2021-02-02T13:57:12Z

Saint Laurent:

__NOTOC__
{{Server client function}}
Creates an object in the GTA world.
{{Note|Dynamic objects do not automatically have physics applied to them. Use setElementVelocity(object, 0, 0, 0) to fix this.}}

==Syntax==
<syntaxhighlight lang="lua">object createObject ( int modelId, float x, float y, float z, [ float rx, float ry, float rz, bool isLowLOD = false ] )</syntaxhighlight>
{{OOP||[[Object]]||}}

===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.
{{New items|3.0120|1.2|
*'''isLowLOD:''' A bool value specifying if the object will be low LOD. A low LOD object has no collision and a longer draw distance.
}}

===Returns===
* Returns the [[object]] element if the creation was successful, ''false'' otherwise.

==Example==
<section name="Server-only Example 1" class="server" show="true">
This example creates an object when the resource starts:
<syntaxhighlight lang="lua">
function loadMapObjects()
-- create an object at a specified position with a specified rotation
createObject(1337, 5540.6654, 1020.55122, 1240.545, 90, 0, 0)
end
addEventHandler("onResourceStart", resourceRoot, loadMapObjects)
</syntaxhighlight>
</section>

<section name="Server-only Example 2" class="server" show="true">
This example creates an object near the player who write /createObject in the chat:
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createObject' in the console:
function createObjectCommand(thePlayer, commandName)
if (thePlayer) then
local x, y, z = getElementPosition(thePlayer)
-- create a object next to the player:
local theObject = createObject(980, x + 2, y + 2, z, 0, 0, 0)
if (theObject) then -- check if the object was created successfully
outputConsole("Object created successfully.", thePlayer)
else
outputConsole("Failed to create the object.", thePlayer)
end
end
end
addCommandHandler("createObject", createObjectCommand)
</syntaxhighlight>
</section>

==See Also==
{{Object functions}}

CreateObject

2021-02-02T13:46:47Z

Saint Laurent:

__NOTOC__
{{Server client function}}
Creates an object in the GTA world.
{{Note|Dynamic objects do not automatically have physics applied to them. Use setElementVelocity(object, 0, 0, 0) to fix this.}}

==Syntax==
<syntaxhighlight lang="lua">object createObject ( int modelId, float x, float y, float z, [ float rx, float ry, float rz, bool isLowLOD = false ] )</syntaxhighlight>
{{OOP||[[Object]]||}}

===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.
{{New items|3.0120|1.2|
*'''isLowLOD:''' a bool value specifying if the object will be low LOD. A low LOD object has no collision and a longer draw distance.
}}

===Returns===
* Returns the [[object]] element if the creation was successful, ''false'' otherwise.

==Example==
<section name="Server-only Example 1" class="server" show="true">
This example creates an object when the resource starts:
<syntaxhighlight lang="lua">
function mapLoad(name)
-- create an object at a specified position with a specified rotation
createObject(1337, 5540.6654, 1020.55122, 1240.545, 90, 0, 0)
end
addEventHandler("onResourceStart", resourceRoot, mapLoad)
</syntaxhighlight>
</section>

<section name="Server-only Example 2" class="server" show="true">
This example creates an object near the player who write /createObject in the chat:
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createObject' in the console:
function createObjectCommand( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a Object next to the player:
local theObject = createObject ( 980, x + 2, y + 2, z, 0, 0, 0 )
if ( theObject ) then -- check if the object was created successfully
outputConsole ( "Object created successfully.", thePlayer )
else
outputConsole ( "Failed to create the object.", thePlayer )
end
end
end
addCommandHandler ( "createObject", createObjectCommand )
</syntaxhighlight>
</section>

==See Also==
{{Object functions}}

CreateObject

2021-02-02T13:42:52Z

Saint Laurent:

__NOTOC__
{{Server client function}}
{{Note|Dynamic objects do not automatically have physics applied to them. Use setElementVelocity(object, 0, 0, 0) to fix this.}}
Creates an object in the GTA world.

==Syntax==
<syntaxhighlight lang="lua">object createObject ( int modelId, float x, float y, float z, [ float rx, float ry, float rz, bool isLowLOD = false ] )</syntaxhighlight>
{{OOP||Object||}}

===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.
{{New items|3.0120|1.2|
*'''isLowLOD:''' a bool value specifying if the object will be low LOD. A low LOD object has no collision and a longer draw distance.
}}

===Returns===
* Returns the [[object]] element if the creation was successful, ''false'' otherwise.

==Example==
<section name="Server-only Example 1" class="server" show="true">
This example creates an object when the resource starts:
<syntaxhighlight lang="lua">
function mapLoad ( name )
-- create an object at a specified position with a specified rotation
createObject ( 1337, 5540.6654, 1020.55122, 1240.545, 90, 0, 0 )
end
addEventHandler ( "onResourceStart", resourceRoot, mapLoad )
</syntaxhighlight>
</section>

<section name="Server-only Example 2" class="server" show="true">
This example creates an object near player who write /createObject in the chat:
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createObject' in the console:
function consoleCreateObject ( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a Object next to the player:
local theObject = createObject ( 980, x + 2, y + 2, z, 0, 0, 0 )
if ( theObject ) then -- check if the object was created successfully
outputConsole ( "Object created successfully", thePlayer )
else
outputConsole ( "Failed to create Object", thePlayer )
end
end
end
addCommandHandler ( "createObject", consoleCreateObject )
</syntaxhighlight>
</section>

==See Also==
{{Object functions}}

CreateObject

2021-02-02T13:37:16Z

Saint Laurent:

__NOTOC__
{{Server client function}}
{{Note|Dynamic objects do not automatically have physics applied to them. Use setElementVelocity(object, 0, 0, 0) to fix this.}}
Creates an object in the GTA world.

==Syntax==
<syntaxhighlight lang="lua">object createObject ( int modelId, float x, float y, float z, [ float rx, float ry, float rz, bool isLowLOD = false ] )</syntaxhighlight>
{{OOP||Object||}}
===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.
{{New items|3.0120|1.2|
*'''isLowLOD:''' a bool value specifying if the object will be low LOD. A low LOD object has no collision and a longer draw distance.
}}
===Returns===
* Returns the [[object]] element if the creation was successful, ''false'' otherwise.

==Example==

<section name="Server Example 1" class="server" show="true">
This example creates an object when the resource starts:
<syntaxhighlight lang="lua">
function mapLoad ( name )
-- create an object at a specified position with a specified rotation
createObject ( 1337, 5540.6654, 1020.55122, 1240.545, 90, 0, 0 )
end
addEventHandler ( "onResourceStart", resourceRoot, mapLoad )
</syntaxhighlight>
</section>

<section name="Server Example 2" class="server" show="true">
This example creates an object near player who write /createObject in the chat:
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createObject' in the console:
function consoleCreateObject ( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a Object next to the player:
local theObject = createObject ( 980, x + 2, y + 2, z, 0, 0, 0 )
if ( theObject ) then -- check if the object was created successfully
outputConsole ( "Object created successfully", thePlayer )
else
outputConsole ( "Failed to create Object", thePlayer )
end
end
end
addCommandHandler ( "createObject", consoleCreateObject )
</syntaxhighlight>
</section>

==See Also==
{{Object functions}}

Changes in 1.5.8

2020-11-15T16:22:53Z

Saint Laurent:

<pageclass class="#39dd57" subcaption="Current release"></pageclass>
{{Changelogs}}
__NOTOC__
* GitHub commit log: https://github.com/multitheftauto/mtasa-blue/compare/1.5.7...1.5.8
* GitHub milestone: https://github.com/multitheftauto/mtasa-blue/milestone/2
* Release announcement on forums: https://forum.mtasa.com/topic/127609-multi-theft-auto-san-andreas-158-is-released/

== Main Additions / Changes ==
<section show="true">
* Added [[dxDrawPrimitive3D]] and [[dxDrawMaterialPrimitive3D]] ([https://github.com/multitheftauto/mtasa-blue/pull/760 #760] by '''CrosRoad95''')
* Added functions to modify dynamic objects' behaviour ([https://github.com/multitheftauto/mtasa-blue/pull/784 #784] by '''forkerer''')
* Added dynamic ped ID allocating using [[engineRequestModel]] and [[engineFreeModel]] ([https://github.com/multitheftauto/mtasa-blue/commit/475544f1753ce1af24c4cdff7f0d0be48ede709b #349] by '''lopezloo''' + '''Neproify''' + '''Arran''' + '''qaisjp''')
* Added functions to manipulate colshapes parameters ([https://github.com/multitheftauto/mtasa-blue/pull/1215 #1215] by '''StrixG''')
* Added element data subscription functionality ([https://github.com/multitheftauto/mtasa-blue/pull/1055 #1055] by '''tederis''')
* Added [[engineGetModelTextures]] function ([https://github.com/multitheftauto/mtasa-blue/pull/1058 #1058] by '''Lpsd''')
* Improve trailer sync ([https://github.com/multitheftauto/mtasa-blue/pull/1247 #1247] by '''tederis''')
* Added wheel scaling functions ([https://github.com/multitheftauto/mtasa-blue/pull/1641 #1641], [https://github.com/multitheftauto/mtasa-blue/pull/1644 #1644], and [https://github.com/multitheftauto/mtasa-blue/pull/1648 #1648] by '''AlexTMjugador''')
</section>

== Statistics ==
<section show="true">
These are some statistics since the [[Changes in 1.5.7|previous release]].
* This is the '''25<sup>th</sup>''' 1.x.x release
* '''{{date difference|2019|8|31|2020|10|11}}''' days
* '''1''' deprecation
* '''5''' announced backwards incompatible changes
* '''41''' new functions
* '''68+''' bug fixes and changes
* '''465''' commits ([https://github.com/multitheftauto/mtasa-blue/compare/1.5.7...1.5.8 see comparison])
* '''197''' new open GitHub issues ([https://github.com/multitheftauto/mtasa-blue/issues?q=is%3Aopen+is%3Aissue+created%3A2019-08-31..2020-10-11 see list])
* '''102''' resolved GitHub issues ([https://github.com/multitheftauto/mtasa-blue/issues?q=is%3Aclosed+is%3Aissue+milestone%3A1.5.8 see list])
* '''108''' closed GitHub issues ([https://github.com/multitheftauto/mtasa-blue/issues?q=is%3Aclosed+is%3Aissue+closed%3A2019-08-31..2020-10-11+no%3Amilestone see list])
* '''46''' new open GitHub pull requests ([https://github.com/multitheftauto/mtasa-blue/pulls?q=is%3Aopen+is%3Apr+created%3A2019-08-31..2020-10-11 see list])
* '''194''' merged GitHub pull requests ([https://github.com/multitheftauto/mtasa-blue/pulls?q=is%3Apr+milestone%3A1.5.8+is%3Amerged see list])
* '''36''' closed GitHub pull requests ([https://github.com/multitheftauto/mtasa-blue/pulls?q=is%3Apr+is%3Aunmerged+closed%3A2019-08-31..2020-10-11 see list])
* '''39''' contributors of which '''27''' are new ([https://github.com/multitheftauto/mtasa-blue/graphs/contributors?from=2019-08-31&to=2020-10-11&type=c see list])
* '''98+''' total contributors ([https://github.com/multitheftauto/mtasa-blue/graphs/contributors see list])
* '''4''' vendor updates


<sub>'''Note:''' Last update to these statistics was made
{{#ifeq: {{date difference|2020|10|12}} | 0 | today |
{{#ifeq: {{date difference|2020|10|12}} | 1 | yesterday |
{{date difference|2020|10|12}} days ago
}}
}}.</sub>
</section>

== Scripting ==
<section show="true">
=== 5 Backwards Incompatible Changes ===
These changes will take effect in 1.6:
* [[callRemote]] callbacks currently set the error code to '''nil''' when there is no error. In 1.6, to be consistent with [[fetchRemote]], the error code reported will be '''0'''. See [https://github.com/multitheftauto/mtasa-blue/issues/294 GitHub #294].
* Since July 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. In 1.6 this will be an error. You will still be able to provide strings containing numbers (e.g. '''"100"''' and '''"12.34"'''), this change only affects invalid strings. See [https://github.com/multitheftauto/mtasa-blue/issues/1043 GitHub #1043].
* When providing a width and height of (0, 0) to [[createBrowser]] or [[guiCreateBrowser]] you will encounter a script error instead of a warning. The warning was introduced Feb 2019. See [https://github.com/multitheftauto/mtasa-blue/issues/1069 GitHub #1069].
* 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. See [https://github.com/multitheftauto/mtasa-blue/issues/1070 GitHub #1070].
* Since Aug 2015, we replaced the custom '''mtalocal://''' URL scheme with '''http://mta/resourceName/blah.html'''. This '''mtalocal://''' URL scheme will now be removed. See [https://github.com/multitheftauto/mtasa-blue/issues/1071 GitHub #1071].

This list is inconclusive and we may introduce more changes later.
</section>

== Client ==
<section show="true">
=== 21 New Functions ===
* Added [[setPedFightingStyle]] (previously available server-side only) ([https://github.com/multitheftauto/mtasa-blue/pull/810 #810] by '''StrixG''')
* Added [[setPedArmor]] (previously available server-side only) ([https://github.com/multitheftauto/mtasa-blue/pull/811 #811] by '''StrixG''')
* Added [[areVehicleLightsOn]] ([https://github.com/multitheftauto/mtasa-blue/pull/938 #938] by '''StrixG''')
* Added [[dxDrawPrimitive3D]] and [[dxDrawMaterialPrimitive3D]] ([https://github.com/multitheftauto/mtasa-blue/pull/760 #760] by '''CrosRoad95''')
* Added functions to modify dynamic objects' behaviour ([https://github.com/multitheftauto/mtasa-blue/pull/784 #784] by '''forkerer''')
** [[engineGetModelPhysicalPropertiesGroup]]
** [[engineRestoreModelPhysicalPropertiesGroup]]
** [[engineSetModelPhysicalPropertiesGroup]]
** [[engineGetObjectGroupPhysicalProperty]]
** [[engineRestoreObjectGroupPhysicalProperties]]
** [[engineSetObjectGroupPhysicalProperty]]
* Added dynamic ped ID allocating using [[engineRequestModel]] and [[engineFreeModel]] ([https://github.com/multitheftauto/mtasa-blue/commit/475544f1753ce1af24c4cdff7f0d0be48ede709b #349] by '''lopezloo''' + '''Neproify''' + '''Arran''' + '''qaisjp''')
* Added [[engineResetModelLODDistance]] function ([https://github.com/multitheftauto/mtasa-blue/pull/971 #971] by '''Lpsd''')
* Added [[engineGetModelTextures]] function ([https://github.com/multitheftauto/mtasa-blue/pull/1058 #1058] by '''Lpsd''')
* Added [[resetBlurLevel]] function ([https://github.com/multitheftauto/mtasa-blue/pull/1266 #1266] by '''Luxy.c''')
* Added [[dxGetTextSize]] function ([https://github.com/multitheftauto/mtasa-blue/pull/935 #935] by '''StrixG''')
* Added functions to modify vehicle wheels, visibly and in collision by ([https://github.com/multitheftauto/mtasa-blue/pull/1641 #1641], [https://github.com/multitheftauto/mtasa-blue/pull/1644 #1644], and [https://github.com/multitheftauto/mtasa-blue/pull/1648 #1648] by '''AlexTMjugador''')
** [[getVehicleWheelScale]]
** [[getVehicleModelWheelSize]]
** [[setVehicleWheelScale]]
** [[setVehicleModelWheelSize]]

=== 49 Bug Fixes & Changes ===
* Added new client setting to toggle external sounds ([https://github.com/multitheftauto/mtasa-blue/pull/834 #834] by '''patrikjuvonen''')
* Fix crash when attempting to stream out a sound that's not streamed in (See commit [https://github.com/multitheftauto/mtasa-blue/commit/e1b7c730448d12a5eeb452239e8053e86924294f e1b7c73] by '''sbx320''')
* Fix [[dxDrawCircle]] ''segments'' argument being wrongly offset by one ([https://github.com/multitheftauto/mtasa-blue/pull/1079 #1079] by '''ApeLsiN4eG''')
* Fix potential crash when moving objects (See commit [https://github.com/multitheftauto/mtasa-blue/commit/90895c221549893501f5f717af3ca56878e29b5d 90895c2] by '''botder''')
* Update credits (See commit [https://github.com/multitheftauto/mtasa-blue/commit/39227d795efafe940dc6c317c20b0162b1bd0bb3 39227d7] by '''qaisjp''')
* Don't apply damage to peds without a game entity (See commit [https://github.com/multitheftauto/mtasa-blue/commit/632130e36a96071290593fc3c677a536f7b19e1f 632130e] by '''botder''')
* Fix doors state with setElementModel ([https://github.com/multitheftauto/mtasa-blue/pull/599 #599] by '''FileEX''')
* Added CVAR _beta_qc_rightclick_command allowing you to reconnect by right clicking the "Quick Connect" button on the main menu (See commit [https://github.com/multitheftauto/mtasa-blue/commit/d1c60675fc0f0f62b69707ae81a82e6bbdf36042 d1c60675] by '''qaisjp''')
* Added more data to [[getPedAnimation]] ([https://github.com/multitheftauto/mtasa-blue/pull/892 #892] by '''Dezash''')
* Added missing destroy method to DxFont ([https://github.com/multitheftauto/mtasa-blue/pull/1259 #1259] by '''MegadreamsBE''')
* Increase [[setPedAnimationSpeed]] limit (See commit [https://github.com/multitheftauto/mtasa-blue/commit/4c36d37056d2a1496904f394bf96303dd0f2b4c5 4c36d37] by '''qaisjp''')
* Fix "ancient" weapon fire crash ([https://github.com/multitheftauto/mtasa-blue/pull/1109 #1109] by '''saml1er''')
* Fix [[bitExtract]] (See commit [https://github.com/multitheftauto/mtasa-blue/commit/aa2df39d3e40e5b446ffea376ef96df89916a9d0 aa2df39d] by '''ccw808''')
* Fix texture blending ([https://github.com/multitheftauto/mtasa-blue/pull/1098 #1098] by '''StrixG''')
* Added client setting to toggle internet sound streams ([https://github.com/multitheftauto/mtasa-blue/pull/834 #834] by '''patrikjuvonen''')
* Implement "remember this option" checkbox to NVidia Optimus dialog ([https://github.com/multitheftauto/mtasa-blue/pull/1177 #1177] by '''Lpsd''')
* Fix inability to crouch when player has 1 HP ([https://github.com/multitheftauto/mtasa-blue/pull/1138 #1138] by '''CrosRoad95''')
* Improve trailer sync ([https://github.com/multitheftauto/mtasa-blue/pull/1247 #1247] by '''tederis''')
* Fix driveby for peds ([https://github.com/multitheftauto/mtasa-blue/pull/1290 #1290] by '''Zangomangu''')
* Added "SettingHighDetailPeds" to [[dxGetStatus]] ([https://github.com/multitheftauto/mtasa-blue/pull/1384 #1384] by '''Patrick2562''')
* Added feature to remove server from the "Recent" tab in server browser ([https://github.com/multitheftauto/mtasa-blue/pull/1381 #1381] by '''ecastro98''')
* Fix [[warpPedIntoVehicle]] failure when there are too many vehicles streamed in ([https://github.com/multitheftauto/mtasa-blue/pull/1431 #1431] by '''saml1er''')
* Fix issue with [[engineReplaceModel]] kicking the player out of the vehicle ([https://github.com/multitheftauto/mtasa-blue/pull/1433 #1433] by '''saml1er''')
* Moved exe patching to loader ([https://github.com/multitheftauto/mtasa-blue/pull/1520 #1520] by '''ccw808''')
* Fix various return values when using OOP (e.g: [https://github.com/multitheftauto/mtasa-blue/commit/5110559b7a7f2d258f01be1dce18fe63d8bca400 5110559b], [https://github.com/multitheftauto/mtasa-blue/commit/88379b8ded766b2d35e171b6d11ef33cb2663b96 88379b8d] by '''qaisjp''')
* Fixed incorrect VRAM detection ([https://github.com/multitheftauto/mtasa-blue/pull/1589 #1589] by '''TheNormalnij''')
* Added ability to play sounds from raw data to playSound(3D) ([https://github.com/multitheftauto/mtasa-blue/pull/1234 #1234] by '''Dezash''')
* Allow downloading of files from other resources ([https://github.com/multitheftauto/mtasa-blue/pull/945 #945] by '''TheNormalnij''') - this affects:
** [[downloadFile]]
** [[onClientFileDownloadComplete]]
* Added ability to get raw controller analog value ([https://github.com/multitheftauto/mtasa-blue/pull/1165 #1165] by '''Addlibs''')
* Added user agent workaround for YouTube TV ([https://github.com/multitheftauto/mtasa-blue/pull/1243 #1243] by '''qaisjp''')
* Added missing destroy method to DxFont ([https://github.com/multitheftauto/mtasa-blue/pull/1259 #1259] by '''MegadreamsBE''')
* Fix engineReplaceModel memory leak ([https://github.com/multitheftauto/mtasa-blue/pull/1265 #1265] by '''saml1er''')
* Fix vehicle model memory leaks (See commit [https://github.com/multitheftauto/mtasa-blue/commit/46dbbe7dd2c4621d7564cf272e8a432cf9f57300 46dbbe7] by '''saml1er''')
* Fix texture memory leak (See commit [https://github.com/multitheftauto/mtasa-blue/commit/d5722d5ac5c0ed0210849bf03c263ec88ea98c2a d5722d5] by '''saml1er''')
* Enable enter_exit for peds to fix alternative attack ([https://github.com/multitheftauto/mtasa-blue/pull/1295 #1295] by '''Zangomangu''')
* Fix "Select device" hides under other program without MTA icon on a taskbar (See commit [https://github.com/multitheftauto/mtasa-blue/commit/2c5251a42a640ccc9ffa928cb2844c9295f47c6c 2c5251a] by '''ccw808''')
* Fix primitive colors are always white ([https://github.com/multitheftauto/mtasa-blue/pull/1312 #1312] by '''StrixG''')
* Added analog control sync for accelerate and brake_reverse ([https://github.com/multitheftauto/mtasa-blue/pull/1164 #1164] by '''Addlibs''')
* Fix resetting dummies in vehicles with replaced models ([https://github.com/multitheftauto/mtasa-blue/pull/1059 #1059] by '''forkerer''' and '''saml1er''')
* Return vector3 instead of number at ped's target ([https://github.com/multitheftauto/mtasa-blue/pull/1379 #1379] by '''ecastro98''')
* Fix replaced weapon_crouch anim does not play if retainPedState is true ([https://github.com/multitheftauto/mtasa-blue/pull/1414 #1414] by '''saml1er''')
* Fix nametags are interiorless ([https://github.com/multitheftauto/mtasa-blue/commit/3df58bd435b3c4052fa5e7fe57d534bdca7e0d2b 3df58bd] by '''qaisjp''')
* Remove amx from the installer (See commit [https://github.com/multitheftauto/mtasa-blue/commit/7d4091fac6e41e6d9e199cd0a03c927dc48aac79 7d4091f] by '''qaisjp''')
* Potential fix for vehicle dummies crash ([https://github.com/multitheftauto/mtasa-blue/pull/1524 #1524] by '''saml1er''')
* Added projectiles support for [[getElementModel]] ([https://github.com/multitheftauto/mtasa-blue/pull/1550 #1550] by '''StrixG''')
* Fix getBoundKeys returning a table on empty argument ([https://github.com/multitheftauto/mtasa-blue/pull/1615 #1615] by '''Tete''')
* Fix strange behavior (crashes, flickers, glitches) of Skimmer ([https://github.com/multitheftauto/mtasa-blue/pull/1624 #1624] by '''ccw808''')
* Potential fixes for custom map collision crashes ([https://github.com/multitheftauto/mtasa-blue/pull/1613 #1613] by '''saml1er''')
* Remove client entity check from [[setPedArmor]] ([https://github.com/multitheftauto/mtasa-blue/pull/1638 #1638] by '''qaisjp''')

=== 3 Vendor Updates ===
* Update BASS libraries ([https://github.com/multitheftauto/mtasa-blue/pull/1551 #1551] by '''Dutchman101''')
* Update CEF from 76.1.13+gf19c584 (Chromium 76.0.3809.132) to 85.3.12+g3e94ebf ([https://chromereleases.googleblog.com/2020/09/stable-channel-update-for-desktop_21.html Chromium 85.0.4183.121]) (See commit [https://github.com/multitheftauto/mtasa-blue/pull/1698 #1698] by '''Jusonex''' and '''Dutchman101''')
* Update UnRAR from 5.71 to 5.91 ([https://github.com/multitheftauto/mtasa-blue/pull/1606 #1606] by '''patrikjuvonen''')
</section>

== Server ==
<section show="true">
=== 3 New Functions ===
* Added [[setPlayerScriptDebugLevel]] and [[getPlayerScriptDebugLevel]] ([https://github.com/multitheftauto/mtasa-blue/pull/826 #826] by '''knitz12''')
* Added [[isResourceProtected]] function ([https://github.com/multitheftauto/mtasa-blue/pull/1254 #1254] by '''StrixG''')

=== 10 Bug Fixes & Changes ===
* Fix [[iprint]] to be able to read and output nil arguments properly ([https://github.com/multitheftauto/mtasa-blue/pull/1064 #1064] by '''TheNormalnij''')
* Accept team & table of players in [[outputChatBox]] ([https://github.com/multitheftauto/mtasa-blue/pull/1213 #1213] by '''StrixG''')
* Fix /msg command duplicating when sent by Server Console ([https://github.com/multitheftauto/mtasa-blue/pull/1411 #1411] by '''Dezash''')
* Make colshapes cloneable ([https://github.com/multitheftauto/mtasa-blue/pull/1214 #1214] by '''StrixG''')
* Fix double chat messages if player is in team ([https://github.com/multitheftauto/mtasa-blue/pull/1241 #1241] by '''StrixG''' and '''Luxy.c''')
* Don't queue a resource restart if resource is stopping ([https://github.com/multitheftauto/mtasa-blue/pull/960 #960] by '''StrixG''')
* Added support for more map attributes ([https://github.com/multitheftauto/mtasa-blue/pull/263 #263] by '''patrikjuvonen''')
* Fix server-client inconsistency for isElementAttached failure return ([https://github.com/multitheftauto/mtasa-blue/commit/866506d3f6ebe4a0d4d39664cc4e7d7c0cef1a7c 866506d] by '''qaisjp''')
* Make [[kickPlayer]] accept the Console element as responsiblePlayer ([https://github.com/multitheftauto/mtasa-blue/pull/1427 #1427] by '''qaisjp''')
* Fix stack overflow when attaching elements in maps ([https://github.com/multitheftauto/mtasa-blue/pull/1663 #1663] by '''tederis''')

=== 1 Vendor Update ===
* Update sqlite from 3.31.1 to 3.32.3 ([https://github.com/multitheftauto/mtasa-blue/pull/1561 #1561] by '''patrikjuvonen''')
</section>

== Shared (''Client & Server side'') ==
<section show="true">
=== 17 New Functions ===
* Added [[xmlLoadString]] ([https://github.com/multitheftauto/mtasa-blue/pull/809 #809] by '''Lpsd''')
* Added request info & abort functions for [[fetchRemote]]/[[callRemote]] ([https://github.com/multitheftauto/mtasa-blue/pull/660 #660] by '''Luxy.c''')
** [[getRemoteRequests]]
** [[getRemoteRequestInfo]]
** [[abortRemoteRequest]]
* Added functions to manipulate colshapes parameters ([https://github.com/multitheftauto/mtasa-blue/pull/1215 #1215] by '''StrixG''')
** [[getColShapeRadius]]
** [[setColShapeRadius]]
** [[getColShapeSize]]
** [[setColShapeSize]]
** [[getColPolygonPoints]]
** [[getColPolygonPointPosition]]
** [[setColPolygonPointPosition]]
** [[addColPolygonPoint]]
** [[removeColPolygonPoint]]
* Added [[hasElementData]] function ([https://github.com/multitheftauto/mtasa-blue/pull/1163 #1163] by '''Simi2''')
* Added element data subscription functionality ([https://github.com/multitheftauto/mtasa-blue/pull/1055 #1055] by '''tederis''') - includes 3 new functions:
** [[addElementDataSubscriber]]
** [[removeElementDataSubscriber]]
** [[hasElementDataSubscriber]]
** Adds 1 additional parameter to [[setElementData]]

=== 1 Deprecation ===
* Added deprecation message to [[passwordHash]] when using custom salts ([https://github.com/multitheftauto/mtasa-blue/pull/1208 #1208] by '''Luxy.c''')

=== 9 Bug Fixes & Changes ===
* Added async [[encodeString]]/[[decodeString]] ([https://github.com/multitheftauto/mtasa-blue/pull/1226 #1226] by '''StrixG''')
* Fix colshape and marker hit detection when attaching ([https://github.com/multitheftauto/mtasa-blue/pull/1327 #1327] by '''Lpsd''')
* Fix driveby aiming being inverted in some cases ([https://github.com/multitheftauto/mtasa-blue/pull/1442 #1442] by '''Zangomangu''')
* Added bIncludeWorldSeaLevel and bIncludeOutsideWorldLevel parameters to [[setWaterLevel]] ([https://github.com/multitheftauto/mtasa-blue/pull/1342 #1342] by '''TheNormalnij''')
* Added [[outputDebugString]] level 4 to omit certain debug info ([https://github.com/multitheftauto/mtasa-blue/pull/1167 #1167] by '''Addlibs''')
* Fix incorrect hash capitalisation ([https://github.com/multitheftauto/mtasa-blue/pull/1527 #1527] by '''qaisjp''')
* Fix debugscript setting to 0 when using invalid characters ([https://github.com/multitheftauto/mtasa-blue/pull/1602 #1602] by '''Unde-R''')
* Fix privilege escalation ([https://github.com/multitheftauto/mtasa-blue/pull/1627 #1627] by '''ciber96''')
* Increase Lua integer formatting type from long to long long ([https://github.com/multitheftauto/mtasa-blue/pull/1672 #1672] by '''sbx320''')

=== 3 Vendor Updates ===
* Update curl from 7.68.0 to 7.72.0 ([https://github.com/multitheftauto/mtasa-blue/pull/1562 #1562] by '''patrikjuvonen''')
* Update cryptopp from 8.1.0 to 8.2.0 ([https://github.com/multitheftauto/mtasa-blue/pull/1637 #1637] by '''StrixG''')
* Update json-c from 0.13.1 to 0.15 ([https://github.com/multitheftauto/mtasa-blue/pull/1605 #1605] by '''patrikjuvonen''')
</section>

<section show="true">
== 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]
</section>

[[Category:Changelog]]

Changes in 1.5.8

2020-11-15T16:22:31Z

Saint Laurent:

OnClientObjectDamage

2020-09-03T15:20:59Z

Saint Laurent:

__NOTOC__
{{Client event}}
This event is fired before an object gets damaged.
{{Note|This event is only triggered for objects that are streamed in.}}
==Parameters==
<syntaxhighlight lang="lua">
float loss, element attacker
</syntaxhighlight>
*'''loss:''' the health loss caused by the damage. This parameter contains the theoretical loss, which could be less than 0, if you substract it of the current health. If you want to get the real loss, you have to substract the new health of the old health (use a timer for this).
*'''attacker:''' the vehicle/ped/player who is damaging the object.

==Source==
The source of this event is the object which was damaged.

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the object will not be damaged.

==Example==
This example outputs the theoretical and real loss:
<syntaxhighlight lang="lua">
function outputLoss(loss)
local oldHealth = getElementHealth(source)
setTimer(function(source)
local newHealth = getElementHealth(source)
outputChatBox("Real loss: "..(newHealth-oldHealth))
outputChatBox("Theoretical loss: "..loss)
end,100,1,source)
end
addEventHandler("onClientObjectDamage", root, outputLoss)
</syntaxhighlight>

==Requirements==
{{Requirements|n/a|1.3-9.05086|}}

==See Also==
===Client object events===
{{Client_object_events}}
===Client event functions===
{{Client_event_functions}}