CreateObject

Description

Creates an object at specified coordinates in the game world.

Name	Description
modelid	The model to create.
Float:x	The X coordinate to create the object at.
Float:y	The Y coordinate to create the object at.
Float:z	The Z coordinate to create the object at.
Float:rotationX	The X rotation of the object.
Float:rotationY	The Y rotation of the object.
Float:rotationZ	The Z rotation of the object.
Float:drawDistance	(optional) The distance that San Andreas renders objects at. 0.0 will cause objects to render at their default distances.

Returns

The ID of the object that was created, or INVALID_OBJECT_ID if the object limit (MAX_OBJECTS) was reached.

Examples

public OnGameModeInit()
{
    CreateObject(2587, 2001.195679, 1547.113892, 14.283400, 0.0, 0.0, 96.0); // Object will render at its default distance.
    CreateObject(2587, 2001.195679, 1547.113892, 14.283400, 0.0, 0.0, 96.0, 300.0); // Object will render at 300.0 units.
    return 1;
}

Notes

note

• Objects that emit light (lampposts, police lights, bollard lights, neons etc.) that have a greater rotation than 16.26 degrees (or -16.26) on either the X or Y axis will stop shining. This effect also applies to light objects attached to other objects, players and vehicles. If a light object is attached to a car and the car is rotated over 16.26 degrees (like in a rollover), the object will also stop emitting light. This is a GTA:SA issue, not a server bug.
• In case the light is attached to another object, one fix for this is to set syncRotation to false in AttachObjectToObject. This will ensure the light stays at 0 rotation. This would only really work for objects that consist ONLY of light, so it wouldn't work for the police light for example.
• There is a limit of 1000 objects (MAX_OBJECTS). To circumvent this limit, you can use the streamer plugin.

Related Functions

• DestroyObject: Destroy an object.
• IsValidObject: Checks if a certain object is vaild.
• MoveObject: Move an object.
• StopObject: Stop an object from moving.
• SetObjectPos: Set the position of an object.
• SetObjectRot: Set the rotation of an object.
• GetObjectPos: Locate an object.
• GetObjectRot: Check the rotation of an object.
• AttachObjectToPlayer: Attach an object to a player.
• SetObjectMaterialText: Replace the texture of an object with text.
• SetObjectMaterial: Replace the texture of an object with the texture from another model in the game.
• CreatePlayerObject: Create an object for only one player.
• DestroyPlayerObject: Destroy a player object.
• IsValidPlayerObject: Checks if a certain player object is vaild.
• MovePlayerObject: Move a player object.
• StopPlayerObject: Stop a player object from moving.
• SetPlayerObjectPos: Set the position of a player object.
• SetPlayerObjectRot: Set the rotation of a player object.
• GetPlayerObjectPos: Locate a player object.
• GetPlayerObjectRot: Check the rotation of a player object.
• AttachPlayerObjectToPlayer: Attach a player object to a player.
• SetPlayerObjectMaterialText: Replace the texture of a player object with text.
• SetPlayerObjectMaterial: Replace the texture of a player object with the texture from another model in the game.