GetElementModel

From Multi Theft Auto: Wiki
Revision as of 16:21, 16 August 2014 by Jaysds (talk | contribs) (→‎Syntax: OOP)
Jump to navigation Jump to search

Returns the model ID of a given element. This can be a player/ped skin, a pickup model, an object model or a vehicle model.

Syntax

int getElementModel ( element theElement )

OOP Syntax Help! I don't understand this!

Note: This function is also a static function underneath the Element class.
Method: element:getModel(...)
Variable: .model


Required Arguments

  • theElement: the element to retrieve the model ID of.

Returns

Returns the model ID if successful, false otherwise.

  • For players/peds: A GTASA player model (skin) ID. See Character Skins.
  • For vehicles: The vehicle ID of the vehicle.
  • For objects: An int specifying the model id.

Example

Click to collapse [-]
Example 1 (Server)

This example destroys a haystack when a player targets it.

function onPlayerTargeted ( targetElem )
    if ( getElementType ( targetElem ) == "object" ) and ( getElementModel ( targetElem ) == 3374 ) then
        destroyElement ( targetElem )
    end
end
addEventHandler ( "onPlayerTarget", getRootElement(), onPlayerTargeted )
Click to collapse [-]
Example 2 (Server)

This example prints out a message when a Shamal or AT-400 is entered by a player.

function planeEnter ( theVehicle, seat, jacked ) -- when someone enters a vehicle
    local id = getElementModel ( theVehicle ) -- get the model ID of the vehicle
    if id == 519 or id == 577 then -- if theVehicle is either Shamal or AT-400
        local vehicleName = getVehicleName ( theVehicle ) -- get the name of theVehicle
        outputChatBox ( "Someone stole a " .. vehicleName .. "!" ) -- announce that someone stole the plane
    end
end
-- add the event handler to the event
addEventHandler ( "onPlayerVehicleEnter", getRootElement(), planeEnter )

See Also