GetProjectileTarget: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Added OOP syntax)
(Updated the page according to r6990)
Line 13: Line 13:


==Returns==
==Returns==
Returns the element which is the projectile's target if the projectile is valid and a HS Rocket Projectile, ''false'' otherwise.
Returns the [[element]] which is the projectile's target if the projectile is valid and can have a target (like a heat-seeking rocket), ''false'' otherwise.
 
{{New feature/item|3.0141|1.4.0|6990|If the projectile is a satchel charge, returns the [[element]] at which it is glued to (or ''nil'' if it isn't glued to any).}}


==Example==
==Example==
This example allows a player to send projectiles at other players
This example allows a player to send projectiles at other players.


<syntaxhighlight lang="lua">function projectileCreating(command,targetPlayer)
<syntaxhighlight lang="lua">function projectileCreating(command,targetPlayer)

Revision as of 10:49, 31 December 2014

This function returns the target of the specified projectile.

Syntax

element getProjectileTarget ( projectile theProjectile )

OOP Syntax Help! I don't understand this!

Method: projectile:getTarget(...)
Variable: .target


Required Arguments

  • theProjectile: The projectile element which target you want to retrieve.

Returns

Returns the element which is the projectile's target if the projectile is valid and can have a target (like a heat-seeking rocket), false otherwise.

If the projectile is a satchel charge, returns the element at which it is glued to (or nil if it isn't glued to any).

Example

This example allows a player to send projectiles at other players.

function projectileCreating(command,targetPlayer)
    local x,y,z = getElementPosition(getLocalPlayer()) -- Get the position of the player
    local target = getPlayerFromName(targetPlayer) or nil -- Get the target, or set it to nil if no target specified
    local theProjectile = createProjectile(thePlayer,20,x,y,z+50,1.0,target)
    if (target) then
        outputChatBox("Created projectile's target: "..getPlayerName(getProjectileTarget(theProjectile)))
    else
        outputChatBox("Created projectile with no target")
    end
end
addCommandHandler("rocket",projectileCreating) -- Bind the 'rocket' command to projectileCreating function

See also