TakeAllWeapons: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(7 intermediate revisions by 7 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server function}}
{{Server function}}
This function removes every weapons from a specified player, rendering him unarmed.
This function removes every weapons from a specified [[ped]], rendering it unarmed.
 
{{Note|Weapons are removed when a ped dies by default. This means that it is only appropriate to use this function while a ped is alive.}}
''Note: weapons are removed when a player dies by default. This means that it is only appropriate to use this function while a player is alive.''


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">takeAllWeapons ( player thePlayer )</syntaxhighlight>
<syntaxhighlight lang="lua">bool takeAllWeapons ( ped thePed )</syntaxhighlight>


===Required Arguments===
===Required Arguments===
*'''thePlayer''': A [[player]] object referencing the specified player
*'''thePed''': A [[ped]] element referencing the specified ped


===Returns===
===Returns===
Line 17: Line 16:
This example removes all weapons from every player
This example removes all weapons from every player
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
takeAllWeapons ( getRootElement() )  --remove all the weapons
takeAllWeapons ( root )  --remove all the weapons
outputChatBox ( "Weapons are not permitted!" ) --tell the players why they lost their weapons</syntaxhighlight>
outputChatBox ( "Weapons are not permitted!" ) --tell the players why they lost their weapons</syntaxhighlight>


==See Also==
==See Also==
{{Weapon functions}}
{{Weapon functions|server}}
[[ru:takeAllWeapons]]
[[ru:takeAllWeapons]]
[[pl:takeAllWeapons]]

Latest revision as of 22:39, 6 September 2024

This function removes every weapons from a specified ped, rendering it unarmed.

[[{{{image}}}|link=|]] Note: Weapons are removed when a ped dies by default. This means that it is only appropriate to use this function while a ped is alive.

Syntax

bool takeAllWeapons ( ped thePed )

Required Arguments

  • thePed: A ped element referencing the specified ped

Returns

Returns true if the function succeeded, false otherwise.

Example

This example removes all weapons from every player

takeAllWeapons ( root )  --remove all the weapons
outputChatBox ( "Weapons are not permitted!" ) --tell the players why they lost their weapons

See Also