RemovePlayerClothes: Difference between revisions

Latest revision as of 09:09, 4 November 2020

	This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.
	Please use removePedClothes instead.

This function is used to remove the current clothes of a certain type on a player. It will remove them if the clothesTexture and clothesModel aren't specified, or if they match the current clothes on that slot.

Syntax

bool removePlayerClothes ( player thePlayer, int clothesType, [ string clothesTexture, string clothesModel ] )

Required Arguments

thePlayer: The player whose clothes you want to remove.
clothesType: A integer representing the clothes slot/type to remove. See the clothes catalog.

Optional Arguments

clothesTexture: A string determining the clothes texture that will be removed. See the clothes catalog.
clothesModel: A string determining the clothes model that will be removed. See the clothes catalog.

Returns

This function returns true if the clothes were successfully removed from the player, false otherwise.

Example

This example adds a 'moto' helmet to a player when he gets on a nrg bike, and removes it when he gets off.

function addHelmetOnEnter ( vehicle, seat, jacked )
    if ( getVehicleID ( vehicle ) == 522 ) then            -- if its a nrg
        addPlayerClothes ( source, "moto", "moto", 16 )    -- add the helmet
    end
end
addEventHandler ( "onPlayerVehicleEnter", root, addHelmetOnEnter )

function addHelmetOnExit ( vehicle, seat, jacked )
    if ( getVehicleID ( vehicle ) == 522 ) then            -- if its a nrg
        removePlayerClothes ( source, 16, "moto", "moto" ) -- remove that helmet
    end
end
addEventHandler ( "onPlayerVehicleExit", root, addHelmetOnExit )

@@ Line 1: / Line 1: @@
 __NOTOC__
-{{Server function}}
+{{Server client function}}
+{{Deprecated|removePedClothes}}
 This function is used to remove the current clothes of a certain type on a [[player]]. It will remove them if the clothesTexture and clothesModel aren't specified, or if they match the current clothes on that slot.
@@ Line 27: / Line 29: @@
      end
 end
-addEventHandler ( "onPlayerVehicleEnter", getRootElement(), addHelmetOnEnter )
+addEventHandler ( "onPlayerVehicleEnter", root, addHelmetOnEnter )
 function addHelmetOnExit ( vehicle, seat, jacked )
@@ Line 34: / Line 36: @@
      end
 end
-addEventHandler ( "onPlayerVehicleExit", getRootElement(), addHelmetOnExit )
+addEventHandler ( "onPlayerVehicleExit", root, addHelmetOnExit )
 </syntaxhighlight>
 ==See Also==
 {{Clothes and body functions}}