SetPedArmor: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(re-added the second example, now tested & fixed.)
Line 27: Line 27:
end
end
addCommandHandler ( "removearmor", removePlayerArmor )
addCommandHandler ( "removearmor", removePlayerArmor )
</syntaxhighlight>
In this, adds an amount of armor that the player defined in command 'addarmor'.
<syntaxhighlight lang="lua">
function givePlayerArmor( player, command, amount )
if getPedArmor(player) == 100 then
return
outputChatBox("Your armor already is complete!", player, 220, 0, 0 ) -- Inform the player if your armor already is complete.
end
if amount and tonumber(amount) >= 1 or tonumber(amount) <= 100 then -- If amount is between 1 and 100.
setPedArmor( player, tonumber(amount) )    -- Set amount armor that player chosen on the command.
else
return
end
if not amount then
outputChatBox( "sintax: /addarmor [armor-amount]", player, 220, 0, 0 ) -- Inform the player if 'amount' argument is missing.
end
end
addCommandHandler( "addarmor", givePlayerArmor )
</syntaxhighlight>
</syntaxhighlight>



Revision as of 04:06, 18 August 2012

This function allows you to set the armor value of a ped.

Syntax

bool setPedArmor ( ped thePed, float armor )

Required Arguments

  • thePed: the ped whose armor you want to modify.
  • armor: the amount of armor you want to set on the ped. Valid values are from 0 to 100.

Returns

Returns true if the armor was changed succesfully. Returns false if an invalid ped was specified, or the armor value specified is out of acceptable range.

Example

This example removes the armor of a player.

function givePlayerArmor ( player, command )
	setPedArmor ( player, 100 )    -- Set player's armor to 100 when he types the command 'addarmor'
end
addCommandHandler ( "addarmor", givePlayerArmor )

function removePlayerArmor ( player, command )
	setPedArmor ( player, 0 )      -- Set player's armor to 0 when he types the command 'removearmor'
end
addCommandHandler ( "removearmor", removePlayerArmor )

In this, adds an amount of armor that the player defined in command 'addarmor'.

function givePlayerArmor( player, command, amount )
	if getPedArmor(player) == 100 then
		return
		outputChatBox("Your armor already is complete!", player, 220, 0, 0 ) -- Inform the player if your armor already is complete.
	end
	if amount and tonumber(amount) >= 1 or tonumber(amount) <= 100 then -- If amount is between 1 and 100.
		setPedArmor( player, tonumber(amount) )    -- Set amount armor that player chosen on the command.
	else
		return
	end
	if not amount then
		outputChatBox( "sintax: /addarmor [armor-amount]", player, 220, 0, 0 ) -- Inform the player if 'amount' argument is missing.
	end
end
addCommandHandler( "addarmor", givePlayerArmor )

See Also