Element/Object

The object class represents dynamic and static 3D models placed in the GTA world. Objects only represent models created by a script, they do not represent models that are part of the GTA's default landscape (these belong to the building pool).

There is a distinction in GTA: San Andreas between static and dynamic models. It is recommended to use buildings for static models to save resources and improve game performance.

The element type of this class is "object".

XML syntax

<object model="" posX="" posY="" posZ="" rotX="" rotY="" rotZ="" interior="" dimension="" scale="" collisions="" alpha="" frozen="" />

Required Attributes

• model: The ID of the object being created. Since GTA has thousands of objects, these are hard to document on the wiki. Instead, they can be found using the object browser in the map editor.
• posX: A float representing the X position of the object.
• posY: A float representing the Y position of the object.
• posZ: A float representing the Z position of the object.

Optional Attributes

• rotX: A float representing the X rotation of the object in degrees.
• rotY: A float representing the Y rotation of the object in degrees.
• rotZ: A float representing the Z rotation of the object in degrees.
• interior: The interior world the object is in.
• dimension: The object's dimension number.

• scale: The object's scale.
• collisions: Enable/Disable object collisions.
• alpha: Changes the object alpha.
• frozen: Sets whether the object should be frozen (also known as static)

Related scripting functions

Client

• getObjectMass
• getObjectProperty
• setObjectMass
• setObjectProperty


• Shared
ADDED/UPDATED IN VERSION 1.6.0 r22489:
breakObject
• createObject
• getObjectScale
• moveObject
ADDED/UPDATED IN VERSION 1.6.0 r22708:
respawnObject
toggleObjectRespawn
isObjectRespawnable
• setObjectScale
ADDED/UPDATED IN VERSION 1.6.0 r22430:
isObjectMoving
ADDED/UPDATED IN VERSION 1.6.0 r21765:
isObjectBreakable
setObjectBreakable
• stopObject