Apparence du personnage

La plupart des expériences permettent aux joueurs d'utiliser leur propre avatar Roblox, bien que certaines mettent en œuvre un système de personnalisation en expérience comme le modèle UGC Homestore.D'autres expériences apportent des modifications limitées aux avatars des joueurs comme des casques, des ailes ou des accessoires qui correspondent au genre.

Pour créer une expérience unique qui modifie l'apparence de vos utilisateurs, vous pouvez personnaliser les propriétés de caractère par défaut avec ce qui suivre:

• Configurez les paramètres de jeu de l'avatar pour définir les apparences d'avatar globales de base pour tous les utilisateurs.
• Utilisez la description humanoïde à tout moment pour appliquer une large gamme de personnalisations de caractères spécifiques à un ou plusieurs utilisateurs dans votre expérience.

Paramètres de jeu

La section Avatar dans le menu Paramètres du jeu vous permet de définir rapidement plusieurs propriétés de personnage globales dans votre expérience.Lors de l'édition des paramètres du jeu d'avatar, votre avatar s'affiche dans l'espace de travail en tant que prévisualisation visuelle.

Vous pouvez ajuster les propriétés de caractère suivantes dans votre expérience en utilisant les paramètres du jeu d'Avatar :

Types d'avatar

Le paramètre type d'avatar défini votre expérience pour ne charger que les modèles de personnage R15 ou R6 .

• R15 est l'avatar moderne par défaut avec 15 membres. Cet avatar permet une personnalisation plus flexible, des options d'accessoires et des animations.

• R6 est un avatar simple classique avec 6 membres.Ce type d'avatar fournit un sentiment rétro, mais est limité en animations et en personnalisation supplémentaire.Les modifications de la propriété échelle du corps n'affectent pas les caractères R6.

>

>

Bordures de collision

Le paramètre Collision défini les limites de collision pour les personnages dans l'expérience.Cela n'a pas d'incidence sur l'apparence physique des personnages dans votre expérience.

Définir cette option à boîte extérieure dynamise les boîtes de collision des personnages en fonction de leurs modèles individuels.C'est le paramètre par défaut et recommandé pour la plupart des expériences.

Définir cette option sur boîte intérieure fournit des limites de collision fixes pour tous les personnages de votre expérience.

Description humanoïde

Les modèles de personnages jouables contiennent un objet Humanoid qui permet les caractéristiques spéciales du modèle, telles que la marche, le saut, l'équipement d'objets et l'interaction avec l'environnement.Pour personnaliser l'apparence d'un caractère Humanoid, vous pouvez appliquer un nouveau HumanoidDescription pour modifier les propriétés du personnage.

Vous pouvez ajuster les propriétés de caractère suivantes dans votre expérience en utilisant HumanoidDescription :

Vous pouvez personnaliser un personnage avec HumanoidDescription en suivant les étapes suivantes :

1. Créer une description à partir du personnage de l'utilisateur, d'un ID de tenue spécifique ou d'un ID d'utilisateur spécifique.
2. Modifiez la description pour personnaliser les propriétés que vous voulez appliquer au personnage Humanoid.
3. Appliquer la description sur un seul personnage, tous les personnages des joueurs ou même sur tous les personnages générés.

Créer une description humanoïde

Vous pouvez créer une nouvelle instance HumanoidDescription directement dans la hiérarchie Explorer ou dans un Script avec le code suivant :

local humanoidDescription = Instance.new("HumanoidDescription")

Dans la plupart des cas, vous devez utiliser un existant HumanoidDescription au lieu d'un nouveau par défaut HumanoidDescription en référençant un personnage de joueur existant , tenue d'avatar ou ID utilisateur .

Du personnage joueur

Utilisez l'exemple de code suivant pour créer un nouveau HumanoidDescription basé sur les propriétés actuelles du personnage du joueur :

local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")

local humanoidDescription = Instance.new("HumanoidDescription")

if humanoid then
	humanoidDescription = humanoid:GetAppliedDescription()
end

D'une tenue existante

Utilisez le code d'exemple suivant pour créer un HumanoidDescription à partir d'un ID de tenue en utilisant Players.GetHumanoidDescriptionFromOutfitID :

local Players = game:GetService("Players")

local outfitId = 480059254

local humanoidDescriptionFromOutfit = Players:GetHumanoidDescriptionFromOutfitId(outfitId)

D'un utilisateur spécifique

Utilisez le code d'exemple suivant pour créer un HumanoidDescription à partir d'un ID d'utilisateur en utilisant Players:GetHumanoidDescriptionFromUserId() :

local Players = game:GetService("Players")

local userId = 491243243

local humanoidDescriptionFromUser = Players:GetHumanoidDescriptionFromUserId(userId)

Modifier la description humanoïde

Pour personnaliser les propriétés HumanoidDescription, définissez-les directement sur le HumanoidDescription ou utilisez une méthode spécifiée avant d'appliquer le HumanoidDescription à un caractère.

L'exemple de code suivant fournit des exemples de définition des différents types de propriétés HumanoidDescription :

local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "2551510151,2535600138"
humanoidDescription.BodyTypeScale = 0.1
humanoidDescription.ClimbAnimation = 619521311
humanoidDescription.Face = 86487700
humanoidDescription.GraphicTShirt = 1711661
humanoidDescription.HeadColor = Color3.new(0, 1, 0)

Définir plusieurs accessoires

Pour les modifications d'accessoires en couches ou en vrac, vous pouvez utiliser HumanoidDescription:SetAccessories() pour effectuer des mises à jour relatives à l'accessoire.L'exemple de code suivant ajoute un cardigan et une veste en plusieurs couches dans cet ordre à un HumanoidDescription :

local humanoidDescription = Instance.new("HumanoidDescription")
local accessoryTable = {
	{
		Order = 1,
		AssetId = 6984769289,
		AccessoryType = Enum.AccessoryType.Sweater
	},
	{
		Order = 2,
		AssetId = 6984767443,
		AccessoryType = Enum.AccessoryType.Jacket
	}
}

humanoidDescription:SetAccessories(accessoryTable, false)

Appliquer la description humanoïde

Appliquez HumanoidDescription à des caractères spécifiques Humanoid dans votre expérience avec Humanoid:ApplyDescription() ou Humanoid.LoadCharacterWithHumanoidDescription .

Sur un seul caractère

ApplyDescription() peut cibler n'importe quel Humanoid. Utilisez le code suivant pour ajouter une nouvelle paire de lunettes de soleil et un nouveau torse au personnage joueur :

local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")
if humanoid then
	local descriptionClone = humanoid:GetAppliedDescription()
	descriptionClone.Torso = 86500008
	-- Plusieurs ressources d'accessoires de visage sont autorisées dans une chaîne séparée par une virgule
	descriptionClone.FaceAccessory = descriptionClone.FaceAccessory .. ",2535420239"
	-- Appliquer le "descriptionClone" modifié à l'humanoïde
	humanoid:ApplyDescription(descriptionClone)
end

Sur tous les personnages de joueur

Utilisez le code d'exemple suivant pour appliquer un HumanoidDescription à tous les joueurs actuels dans le jeu :

local Players = game:GetService("Players")

for _, player in Players:GetPlayers() do
	local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")
	if humanoid then
		-- Créer une description humanoïde
		local humanoidDescription = Instance.new("HumanoidDescription")
		humanoidDescription.HatAccessory = "2551510151,2535600138"
		humanoidDescription.BodyTypeScale = 0.1
		humanoidDescription.ClimbAnimation = 619521311
		humanoidDescription.Face = 86487700
		humanoidDescription.GraphicTShirt = 1711661
		humanoidDescription.HeadColor = Color3.new(0, 1, 0)
		humanoid:ApplyDescription(humanoidDescription)
	end
end

Sur tous les personnages générés

Utilisez le code d'échantillon suivant pour définir un code spécifique HumanoidDescription pour tous les personnages joueurs générés :

local Players = game:GetService("Players")

-- Arrêter la génération automatique afin qu'elle puisse être effectuée dans le rappel "PlayerAdded"
Players.CharacterAutoLoads = false

local function onPlayerAdded(player)
	-- Créer une description humanoïde
	local humanoidDescription = Instance.new("HumanoidDescription")
	humanoidDescription.HatAccessory = "2551510151,2535600138"
	humanoidDescription.BodyTypeScale = 0.1
	humanoidDescription.ClimbAnimation = 619521311
	humanoidDescription.Face = 86487700
	humanoidDescription.GraphicTShirt = 1711661
	humanoidDescription.HeadColor = Color3.new(0, 1, 0)

	-- Générer un personnage avec la description humanoïde
	player:LoadCharacterWithHumanoidDescription(humanoidDescription)
end

-- Relier l'événement "Joueur ajouté" à la fonction "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

Si l'instance HumanoidDescription a été créée dans l'Explorateur et parentée à l'espace de travail, utilisez le code d'échantillon suivant dans un Script pour accéder à l'instance de l'espace de travail :

local Players = game:GetService("Players")

-- Arrêter la génération automatique afin qu'elle puisse être effectuée dans le rappel "PlayerAdded"
Players.CharacterAutoLoads = false

local function onPlayerAdded(player)
	-- Générer un personnage avec "workspace.StudioHumanoidDescription"
	player:LoadCharacterWithHumanoidDescription(workspace.StudioHumanoidDescription)
end

-- Relier l'événement "Joueur ajouté" à la fonction "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)