setElementCollisionsEnabled | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

setElementCollisionsEnabled

Client-side
Server-side
Shared

Pair: getElementCollisionsEnabled

Manual Review Required

Please finish this page using the corresponding Old Wiki article. Go to Contribution guidelines for more information.

This function can disable or enable an element's collisions. An element without collisions does not interact with the physical environment and remains static.

Note

Vehicles that are collisionless and have a driver will cause bugs.

Note

Enabling a players collisions when they're inside a vehicle will cause bugs.

Note

Disabling a peds collisions will cause some problems, such as it being unable to move or wrong rotation after creation.

OOP Syntax Help! I don't understand this!

  • Method:element:setCollisionsEnabled(...)
  • Variable: .collisions

Syntax 

bool setElementCollisionsEnabled ( element theElement, bool enabled )
Required Arguments
  • theElement: The element you wish to set the collisions of
  • enabled: A boolean to indicate whether collisions are enabled ( true ) or disabled ( false )

Returns

  • bool: value

Returns true if the collisions were set succesfully, false otherwise.

Code Examples

shared

This example disables collisions for all vehicles within a certain radius of a player:

function disableVehicleCollisionsNearPlayer(thePlayer, maxDistance)
  local playerX, playerY, playerZ = getElementPosition(thePlayer)
  local vehicles = getElementsByType("vehicle")
  for k,v in ipairs(vehicles) do
    local vehicleX, vehicleY, vehicleZ = getElementPosition(v)
    -- get the distance between the player and the vehicle:
    local distance = getDistanceBetweenPoints3D(vehicleX, vehicleY, vehicleZ, playerX, playerY, playerZ)
    if (distance <= maxDistance) then
      -- disable collisions for the vehicle
      setElementCollisionsEnabled(v, false)
    end
  end
end

See Also

Element Functions
Element Events
Reference