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

isElementCollidableWith

Client-side
Server-side
Shared

Pair: setElementCollidableWith

This function can be used to check whether specified element is collidable with another element. This can be a player, ped, vehicle or object.

OOP Syntax Help! I don't understand this!

  • Method:element:isCollidableWith(...)

Syntax 

​bool isElementCollidableWith ( ​element theElement, ​element withElement )
Required arguments
  • theElement: The element which colliding you want to get.
  • withElement: The other element which colliding with the first entity you want to get.

Returns

Returns true if the elements collide with each other, false otherwise.

  • bool: result

Code Examples

client

This example adds the command togglecol which toggles the collision between the player and ped.

local tPed = {}
addEventHandler("onClientPlayerSpawn", localPlayer, function()
    local x, y, z = getElementPosition(source)
    if isElement(tPed["thePed"]) then
        destroyElement(tPed["thePed"])
    end
    -- Creates a random ped near player
    tPed["thePed"] = createPed(math.random(209, 238), x + 1, y + 1, z)
end)


function toggleColisionFunc()
    if not isElement(tPed["thePed"]) then return end
    -- Is the local player collidable with the ped?
    local isCollidable = isElementCollidableWith(localPlayer, tPed["thePed"])
    -- Toggles the colision with the ped.
    setElementCollidableWith(localPlayer, tPed["thePed"], not isCollidable)
end
-- Adds a command handler to enable/disable colisions with the ped
addCommandHandler("togglecol", toggleColisionFunc)

See Also

Element Functions
Element Events
Reference