Element/Building

The building class represents static 3D models in the GTA world.

The element type of this class is "building".

Important information about 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 Buildings can contain glass and shadows, unlike those created as Objects(which can be created in any dimension).

• Using buildings for exterior 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 cannot be created with dynamic object model IDs (like a door that opens when you push it), they are meant to be used for static objects, mainly buildings as the name suggests. For example, object ID 1502 (Gen_doorINT04) is a dynamic object model, which can be spawned using createObject. On the other hand, object ID 3556 (compmedhos3_LAe) is non-dynamic, you can use it with createBuilding.

• 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.

• Created buildings can have LOD models, which is possible using createBuilding to spawn the LOD building, then setLowLODElement to associate it with a non-LOD building element created beforehand. LOD model distance changed with engineSetModelLODDistance affects buildings too.

• Buildings cannot be created outside dimension 0. Function setElementDimension will return false on any building.

Object Models

List of Object Model IDs

Related scripting functions

ADDED/UPDATED IN VERSION 1.6.0 r22410:
createBuilding
ADDED/UPDATED IN VERSION 1.6.0 r22420:
removeAllGameBuildings
restoreAllGameBuildings