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

getPedContactElement

Client-side
Server-side
Shared

Manual Review Required

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

This function detects the element a ped is standing on. This can be a vehicle or an object.

OOP Syntax Help! I don't understand this!

  • Method:ped:getContactElement(...)
  • Variable: .contactElement

Syntax 

​element getPedContactElement ( ​ped thePed )
Required arguments
  • thePed: The ped of which you want to get the element he is standing on.

Returns

Returns an object or a vehicle if the ped is standing on one, false if he is touching none or an invalid element was passed.

  • element: value

Code Examples

shared

This clientside function outputs the name of the vehicle the specified player is standing on, or a message saying he isn't on one.

function outputContactVehicleMessage ( thePlayer )
    local elementStandingOn = getPedContactElement ( thePlayer )
    if elementStandingOn and getElementType ( elementStandingOn ) == "vehicle" then
        local vehicleName = getVehicleName ( elementStandingOn )
        outputChatBox( "You're standing on a " .. vehicleName .. "." )
    else
        outputChatBox( "You're not standing on any vehicle." )
    end
end

See Also

Ped Functions
Ped Events
Reference