GetPlayerTarget: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Visual improvement)
 
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
==Description==
{{Server client function}}
This function is used to get the current entity a [[player]] is targeting.
{{Deprecated|getPedTarget}}
 
This function is used to get the element a [[player]] is currently targeting.


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
float getPlayerTarget ( player thePlayer )
element getPlayerTarget ( player thePlayer )
</syntaxhighlight>
</syntaxhighlight>


===Required Arguments===
===Required Arguments===
*'''player''': The [[player]] whose target you want to retrieve.
*'''thePlayer:''' The [[player]] whose target you want to retrieve.


===Returns===
===Returns===
Returns the [[element]] that's being targeted, or ''false'' if there isn't one.
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==
==Example==
This example blows up any vehicle a specified player targets (aims at)
This example blows up any vehicle a player targets (aims at).
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function playerTargetCheck ( thePlayer ) -- called on a timer
function playerTargetCheck ( )
  target = getPlayerTarget ( thePlayer ) -- get the current target of the player
    local target
  if ( target ) then -- if there was a target
    for i, thePlayer in ipairs ( getElementsByType("player") ) do  -- iterate over all players
    if ( getElementType ( target ) == "vehicle" ) then -- if the target is a vehicle
        target = getPlayerTarget ( thePlayer )                     -- get the target of the current player
      blowVehicle ( target ) -- blow the vehicle
        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
  end
end
end
setTimer ( playerTargetCheck, 1000, 0 )                            -- call the check function every second
</syntaxhighlight>
</syntaxhighlight>
''Note: A more efficient way to do this would be to use the [[onPlayerTarget]] event.''


==See Also==
==See Also==
{{Player functions}}
{{Player functions}}

Latest revision as of 11:02, 26 June 2014

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use getPedTarget instead.


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