GetPlayerTarget: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
{{Server client function}}
{{Server client function}}
__NOTOC__
__NOTOC__
{{Deprecated}}
This function is used to get the element a [[player]] is currently targeting.
This function is used to get the element a [[player]] is currently targeting.



Revision as of 14:15, 20 January 2009


Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions, but there should be a more generic way to perform what it does.

This function is used to get the element a player is currently targeting.

Syntax

element getPlayerTarget ( player thePlayer )

Required Arguments

  • thePlayer: The player whose target you want to retrieve.

Returns

Returns the element that's being targeted, or false if there isn't one.

This is only effective on physical GTA elements, namely:

  • Players
  • Vehicles
  • Objects

Example

This example blows up any vehicle a player targets (aims at).

function playerTargetCheck ( )
    local target
    for i, thePlayer in ipairs ( getElementsByType("player") ) do  -- iterate over all players
        target = getPlayerTarget ( thePlayer )                     -- get the target of the current player
        if ( target ) then                                         -- if there was a target
            if ( getElementType ( target ) == "vehicle" ) then     -- and the target is a vehicle
                blowVehicle ( target )                             -- blow it up
            end
        end
    end
end
setTimer ( playerTargetCheck, 1000, 0 )                            -- call the check function every second

Note: A more efficient way to do this would be to use the onPlayerTarget event.

See Also