AddPlayerClothes: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
 
(18 intermediate revisions by 13 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
This function is used to set the current clothes of a certain type on a [[player]].
{{Server client function}}
{{Deprecated|addPedClothes|}}
 
This function is used to set the current clothes of a certain type on a [[player]]. It can only be used on players with the CJ skin (id 0).


==Syntax==
==Syntax==
Line 8: Line 11:


===Required Arguments===
===Required Arguments===
*'''thePlayer''': The [[player]] whose clothes you want to retrieve.
*'''thePlayer''': The [[player]] whose clothes you want to change.
*'''clothesTexture''': A string determining the clothes texture that will be added.
*'''clothesTexture''': A string determining the clothes texture that will be added. See the [[CJ Clothes|clothes catalog]].
*'''clothesModel''': A string determining the clothes model that will be added.
*'''clothesModel''': A string determining the clothes model that will be added. See the [[CJ Clothes|clothes catalog]].
*'''clothesType''': A integer representing the clothes slot/type the clothes should be added to.
*'''clothesType''': A integer representing the clothes slot/type the clothes should be added to. See the [[CJ Clothes|clothes catalog]].


==Returns==
==Returns==
Line 17: Line 20:


==Example==
==Example==
This example prints the model and texture of the current clothing on a player's torso.
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">
addCommandHandler ( "clothes?", "getClothes" )
function onEnterVehicle ( theVehicle, seat, jacked )
function getClothes ( source, key, clothesType )
  if ( getVehicleID ( theVehicle ) == 522 ) then      -- if it's an nrg
  texture, model = getPlayerClothes ( source, clothesType )
    addPlayerClothes ( source, "moto", "moto", 16 )   -- add the helmet
   if ( texture and model ) then
  end
     outputChatBox ( getClientName ( source ) .. " is wearing " .. texture .. " " .. model .. " on his " .. getClothesTypeName ( clothesType ) )
end
addEventHandler ( "onPlayerVehicleEnter", root, onEnterVehicle )
 
function onExitVehicle ( theVehicle, seat, jacked )
   if ( getVehicleID ( theVehicle ) == 522 ) then     -- if it's an nrg
     removePlayerClothes ( source, 16 )               -- remove the helmet
   end
   end
end
end
addEventHandler ( "onPlayerVehicleExit", root, onExitVehicle )
</syntaxhighlight>
</syntaxhighlight>


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

Latest revision as of 08:46, 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 addPedClothes instead.


This function is used to set the current clothes of a certain type on a player. It can only be used on players with the CJ skin (id 0).

Syntax

bool addPlayerClothes ( player thePlayer, string clothesTexture, string clothesModel, int clothesType )

Required Arguments

  • thePlayer: The player whose clothes you want to change.
  • clothesTexture: A string determining the clothes texture that will be added. See the clothes catalog.
  • clothesModel: A string determining the clothes model that will be added. See the clothes catalog.
  • clothesType: A integer representing the clothes slot/type the clothes should be added to. See the clothes catalog.

Returns

This function returns 'true' if the clothes were successfully added to 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 onEnterVehicle ( theVehicle, seat, jacked )
  if ( getVehicleID ( theVehicle ) == 522 ) then      -- if it's an nrg
    addPlayerClothes ( source, "moto", "moto", 16 )   -- add the helmet
  end
end
addEventHandler ( "onPlayerVehicleEnter", root, onEnterVehicle )

function onExitVehicle ( theVehicle, seat, jacked )
  if ( getVehicleID ( theVehicle ) == 522 ) then      -- if it's an nrg
    removePlayerClothes ( source, 16 )                -- remove the helmet
  end
end
addEventHandler ( "onPlayerVehicleExit", root, onExitVehicle )

See Also