RemovePlayerClothes: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(8 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Server function}}
__NOTOC__
__NOTOC__
This function is used to remove the current clothes of a certain type on a [[player]].
{{Server client function}}
Note: removes if the clothesTexture and clothesModel aren't specified, or if they match the current clothes on that slot.
{{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.


==Syntax==
==Syntax==
Line 11: Line 12:
===Required Arguments===
===Required Arguments===
*'''thePlayer''': The [[player]] whose clothes you want to remove.
*'''thePlayer''': The [[player]] whose clothes you want to remove.
*'''clothesType''': A integer representing the clothes slot/type to remove.
*'''clothesType''': A integer representing the clothes slot/type to remove. See the [[CJ Clothes|clothes catalog]].
{{Clothes_Textures}}


===Optional Arguments===
===Optional Arguments===
*'''clothesTexture''': A string determining the clothes texture that will be removed. See [[clothes textures]].
*'''clothesTexture''': A string determining the clothes texture that will be removed. See the [[CJ Clothes|clothes catalog]].
*'''clothesModel''': A string determining the clothes model that will be removed. See [[clothes models]].
*'''clothesModel''': A string determining the clothes model that will be removed. See the [[CJ Clothes|clothes catalog]].


==Returns==
==Returns==
Line 24: Line 24:
This example adds a 'moto' helmet to a player when he gets on a nrg bike, and removes it when he gets off.
This example adds a 'moto' helmet to a player when he gets on a nrg bike, and removes it when he gets off.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function onEnterVehicle ( vehicle, seat, jacked )
function addHelmetOnEnter ( vehicle, seat, jacked )
     if ( getVehicleID ( vehicle ) == 522 ) then           -- if its a nrg
     if ( getVehicleID ( vehicle ) == 522 ) then           -- if its a nrg
         addPlayerClothes ( source, "moto", "moto", 16 )   -- add the helmet
         addPlayerClothes ( source, "moto", "moto", 16 )   -- add the helmet
     end
     end
end
end
addEventHandler ( "onPlayerEnterVehicle", getRootElement(), onEnterVehicle )
addEventHandler ( "onPlayerVehicleEnter", root, addHelmetOnEnter )


function onExitVehicle ( vehicle, seat, jacked )
function addHelmetOnExit ( vehicle, seat, jacked )
     if ( getVehicleID ( vehicle ) == 522 ) then           -- if its a nrg
     if ( getVehicleID ( vehicle ) == 522 ) then           -- if its a nrg
         removePlayerClothes ( source, 16 )               -- remove the helmet
         removePlayerClothes ( source, 16, "moto", "moto" ) -- remove that helmet
     end
     end
end
end
addEventHandler ( "onPlayerExitVehicle", getRootElement(), onExitVehicle )
addEventHandler ( "onPlayerVehicleExit", root, addHelmetOnExit )
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{Clothes and body functions}}
{{Clothes and body functions}}

Latest revision as of 09:09, 4 November 2020

Emblem-important.png 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 )

See Also