TakeAllWeapons: Difference between revisions

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.

bool takeAllWeapons ( ped thePed )

Returns true if the function succeeded, false otherwise.

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

@@ Line 1: / Line 1: @@
 __NOTOC__
-==Description==
+{{Server function}}
-This function removes every weapons from a specified player, rendering him unarmed. It returns a boolean value (true or false) depending on whether the function passed or failed.
+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.}}
 ==Syntax==
-<syntaxhighlight lang="lua">bool TakeAllWeapons ( player )</syntaxhighlight>
+<syntaxhighlight lang="lua">bool takeAllWeapons ( ped thePed )</syntaxhighlight>
 ===Required Arguments===
-*'''player''': A player object referencing the specified player
+*'''thePed''': A [[ped]] element referencing the specified ped
+===Returns===
+Returns ''true'' if the function succeeded, ''false'' otherwise.
 ==Example==
-<syntaxhighlight lang="lua">player = getPlayerFromID ( 1 )
+This example removes all weapons from every player
-TakeAllWeapons ( player )
+<syntaxhighlight lang="lua">
-serverChat ( "All weapons removed from ", getPlayerName ( player ), "." )</syntaxhighlight>
+takeAllWeapons ( root )  --remove all the weapons
+outputChatBox ( "Weapons are not permitted!" ) --tell the players why they lost their weapons</syntaxhighlight>
+==See Also==
+{{Weapon functions|server}}
+[[ru:takeAllWeapons]]
+[[pl:takeAllWeapons]]