GetPlayerTarget: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
{{Server client function}} | |||
__NOTOC__ | __NOTOC__ | ||
This function is used to get the | This function is used to get the element a [[player]] is currently targeting. | ||
==Syntax== | ==Syntax== | ||
| Line 8: | Line 9: | ||
===Required Arguments=== | ===Required Arguments=== | ||
*'''thePlayer''' | *'''thePlayer:''' The [[player]] whose target you want to retrieve. | ||
===Returns=== | ===Returns=== | ||
| Line 19: | Line 20: | ||
==Example== | ==Example== | ||
This example blows up any vehicle a | This example blows up any vehicle a player targets (aims at). | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
function playerTargetCheck ( thePlayer ) -- | 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 | ||
end | end | ||
setTimer ( playerTargetCheck, 1000, 0 ) -- call the check function every second | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{Player functions}} | {{Player functions}} | ||
Revision as of 13:58, 19 August 2007
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
See Also
- getPlayerTeam
- getPlayerBlurLevel
- setPlayerBlurLevel
- getPlayerSerial
- forcePlayerMap
- getPlayerScriptDebugLevel
- getPlayerFromName
- getPlayerMoney
- getPlayerName
- getPlayerNametagColor
- getPlayerNametagText
- getPlayerPing
- getPlayerWantedLevel
- givePlayerMoney
- isPlayerMapForced
- isPlayerNametagShowing
- setPlayerHudComponentVisible
- setPlayerMoney
- setPlayerNametagColor
- setPlayerNametagShowing
- setPlayerNametagText
- takePlayerMoney
- countPlayersInTeam
- getPlayersInTeam
- isVoiceEnabled
- setControlState
- getControlState