From Multi Theft Auto: Wiki
Jump to navigation Jump to search

This function is used to change the height of an existing colshape polygon. By default, a colshape polygon is infinitely tall.


bool setColPolygonHeight( colshape shape, float floor, float ceil )  

OOP Syntax Help! I don't understand this!

Method: colshape:setHeight(...)

Required Arguments

  • shape: The colshape polygon.
  • floor: The polygon floor (lowest Z coordinate). Parse false to reset this value to 0.
  • ceil: The polygon ceiling (highest Z coordinate). Parse false to reset this value to infinitely tall.


Returns true if the polygon was changed, false if invalid arguments were passed.


This example sets every polygon colshape's max heigh to 50 units once resource starts.

Click to collapse [-]
function setPolygonsHeight ()
    for i, v in ipairs (getElementsByType ("colshape")) do
        if (getColShapeType (v) == 4) then -- if it's a polygon colshape do it otherwise don't
            setColPolygonHeight (v, false, 50)
addEventHandler ("onResourceStart", resourceRoot, setPolygonsHeight)


Minimum server version 1.5.8-9.20807
Minimum client version 1.5.8-9.20807

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version server="1.5.8-9.20807" client="1.5.8-9.20807" />

See Also