La mayoría de las experiencias permiten que los jugadores usen su propio avatar de Roblox, aunque algunas implementan un sistema de personalización en la experiencia como el modelo UGC Homestore.Otras experiencias hacen limitadas modificaciones a los avatares de los jugadores como cascos, alas o accesorios que coincidan con el género.
Para crear una experiencia única que cambie la apariencia de tus usuarios, puedes personalizar las propiedades predeterminadas del personaje con lo siguiendo:
- Configura el Avatar Opciones del juego para establecer los valores predeterminados de apariencia de avatar global básico para todos los usuarios.
- Usa Descripción humanoide en cualquier momento para aplicar una amplia gama de personalizaciones de caracteres específicos a uno o más usuarios en tu experiencia.
Configuración del juego
La sección Avatar en el menú Configuración del juego te permite establecer rápidamente varias propiedades de personajes globales en tu experiencia.Al editar las configuraciones del juego de avatares, tu avatar se muestra en el espacio de trabajo como una vista previa visual.

Puedes ajustar las siguientes propiedades de personajes en tu experiencia usando las configuraciones del juego de avatares:
Configuración | Descripción |
---|---|
Predefinidos | Aplica un conjunto común de BodyTypeScale y ProportionScale combinaciones. Puedes ajustar aún más estas propiedades con HumanoidDescription después de seleccionar una predeterminada. |
Tipo de avatar | Establece el tipo de avatar predeterminado a cualquiera de R15 o R6 . |
Animación | El conjunto de Animations a los que un usuario tiene acceso. |
Colisión | Establece los límites de colisión para los personajes en la experiencia. |
Partes del cuerpo | Las ID de activos de la Face , Head , Torso , RightArm , LeftArm , RightLeg y LeftLeg partes de un personaje. |
Ropa | Las ID de activos de las texturas de imagen clásicas Shirt , Pants y ShirtGraphic que puedes aplicar al personaje. |
Tipos de avatar
La configuración de tipo de avatar establece tu experiencia para que solo se carguen los modelos de personajes R15 o R6 de R15.
R15 es el avatar moderno predeterminado con 15 extremidades. Este avatar permite una personalización más flexible, opciones accesorias y animaciones.
R6 es un avatar simple clásico con 6 extremidades.Este tipo de avatar proporciona un sentimiento retro, pero está limitado en las animaciones y la personalización adicional.Los cambios en la propiedad de escala del cuerpo no afectan a los caracteres R6.


Límites de colisión
La configuración de Colisión establece los límites de colisión para los personajes en la experiencia.Esto no afecta la apariencia física de los personajes en tu experiencia.
Establecer esta opción en Caja exterior dinamiza las cajas de colisión de los personajes en función de sus modelos individuales.Esta es la configuración predeterminada y recomendada para la mayoría de las experiencias.
Establecer esta opción en Caja interna proporciona límites de colisión fijos para todos los personajes de tu experiencia.
Descripción humanoide
Los modelos de personajes jugables contienen un objeto Humanoid que permite las características especiales del modelo, como caminar, saltar, equipar artículos y interactuar con el entorno, ambiente.Para personalizar la aspecto, lookde un personaje Humanoid , puedes aplicar un nuevo HumanoidDescription para cambiar las propiedades del personaje.
Puedes ajustar las siguientes propiedades de personajes en tu experiencia usando HumanoidDescription :
Propiedad de personaje | Descripción |
---|---|
Escala | Valores numéricos para rasgos físicos height , width , head , body type y proportion . Esto no afecta a los tipos de cuerpo R6. |
Accesorios | Las ID de activos de accessories equipados por un personaje. |
Ropa clásica | Las ID de activos de la Shirt, Pants y ShirtGraphic texturas de imagen que puedes aplicar al personaje. |
Parte del cuerpo | Las ID de activos de la Face , Head , Torso , RightArm , LeftArm , RightLeg y LeftLeg partes de un personaje. |
Colores del cuerpo | El BodyColors de las partes individuales del personaje. |
Animaciones | Los ID de activos de Animations que puedes usar en un personaje. |
Puedes personalizar un personaje con HumanoidDescription usando los siguientes pasos:
- Crear una descripción desde el personaje del usuario, un ID de atuendo específico o desde un ID de usuario específico.
- Modifica la descripción para personalizar las propiedades que quieres aplicar al personaje Humanoid.
- Aplica la descripción en un solo personaje, todos los personajes de los jugadores o incluso en todos los personajes generados.
Crear Descripción Humanoide
Puedes crear una nueva instancia HumanoidDescription directamente dentro de la jerarquía del explorador o dentro de una Script con el siguiente código:
local humanoidDescription = Instance.new("HumanoidDescription")
En la mayoría de los casos, deberías usar un existente HumanoidDescription en lugar de un nuevo predeterminado HumanoidDescription al referenciar un personaje de jugador existente , atuendo de avatar o ID de usuario .
Desde el personaje del jugador
Usa el siguiente ejemplo de código para crear un nuevo HumanoidDescription basado en las propiedades actuales del personaje del jugador:
local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")local humanoidDescription = Instance.new("HumanoidDescription")if humanoid thenhumanoidDescription = humanoid:GetAppliedDescription()end
Desde un traje existente
Usa el siguiente código de muestra para crear un HumanoidDescription de un ID de atuendo usando Players.GetHumanoidDescriptionFromOutfitID :
local Players = game:GetService("Players")local outfitId = 480059254local humanoidDescriptionFromOutfit = Players:GetHumanoidDescriptionFromOutfitId(outfitId)
Desde un usuario específico
Usa el siguiente código de muestra para crear un HumanoidDescription de un ID de usuario usando Players:GetHumanoidDescriptionFromUserId() :
local Players = game:GetService("Players")local userId = 491243243local humanoidDescriptionFromUser = Players:GetHumanoidDescriptionFromUserId(userId)
Modificar la descripción humanoide
Para personalizar las propiedades HumanoidDescription , configúrelas directamente en el HumanoidDescription o use un método especificado antes de aplicar el HumanoidDescription a un personaje.
El siguiente ejemplo de código proporciona ejemplos de establecer los diferentes tipos de propiedades HumanoidDescription:
local humanoidDescription = Instance.new("HumanoidDescription")humanoidDescription.HatAccessory = "2551510151,2535600138"humanoidDescription.BodyTypeScale = 0.1humanoidDescription.ClimbAnimation = 619521311humanoidDescription.Face = 86487700humanoidDescription.GraphicTShirt = 1711661humanoidDescription.HeadColor = Color3.new(0, 1, 0)
Establecer múltiples accesorios
Para cambios accesorios en capas o en masa, puedes usar HumanoidDescription:SetAccessories() para hacer actualizaciones relacionadas con accesorios.El siguiente ejemplo de código añade un suéter y una chaqueta en ese orden a 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)
Aplicar Descripción Humanoide
Aplica HumanoidDescription a caracteres específicos Humanoid en tu experiencia con Humanoid:ApplyDescription() o Humanoid.LoadCharacterWithHumanoidDescription .
En un solo personaje
ApplyDescription() puede dirigirse a cualquier Humanoid . Use el siguiente código para agregar un nuevo par de gafas de sol y un nuevo torso al personaje del jugador:
local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")if humanoid thenlocal descriptionClone = humanoid:GetAppliedDescription()descriptionClone.Torso = 86500008-- Se permiten varios accesorios de cara en una cadena separada por comasdescriptionClone.FaceAccessory = descriptionClone.FaceAccessory .. ",2535420239"-- Aplicar "descriptionClone" modificado a humanoidhumanoid:ApplyDescription(descriptionClone)end
En todos los personajes de jugador
Usa el siguiente código de muestra para aplicar un HumanoidDescription a todos los jugadores actuales en el juego:
local Players = game:GetService("Players")for _, player in Players:GetPlayers() dolocal humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")if humanoid then-- Crear una descripción humanoidelocal humanoidDescription = Instance.new("HumanoidDescription")humanoidDescription.HatAccessory = "2551510151,2535600138"humanoidDescription.BodyTypeScale = 0.1humanoidDescription.ClimbAnimation = 619521311humanoidDescription.Face = 86487700humanoidDescription.GraphicTShirt = 1711661humanoidDescription.HeadColor = Color3.new(0, 1, 0)humanoid:ApplyDescription(humanoidDescription)endend
En todos los personajes de generación
Usa el siguiente código de muestra para establecer un específico HumanoidDescription para todos los personajes jugadores que se generan:
local Players = game:GetService("Players")
-- Detener la aparición automática para que se pueda hacer en la llamada de devolución "PlayerAdded"
Players.CharacterAutoLoads = false
local function onPlayerAdded(player)
-- Crear una descripción humanoide
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)
-- Generar personaje con la descripción humanoide
player:LoadCharacterWithHumanoidDescription(humanoidDescription)
end
-- Conectar el evento "PlayerAdded" a la función "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)
Si la instancia HumanoidDescription se creó en el explorador y se asignó al espacio de trabajo, use el siguiente código de muestra en un Script para acceder a la instancia del espacio de trabajo:
local Players = game:GetService("Players")
-- Detener la aparición automática para que se pueda hacer en la llamada de devolución "PlayerAdded"
Players.CharacterAutoLoads = false
local function onPlayerAdded(player)
-- Genera un personaje con "workspace.StudioHumanoidDescription"
player:LoadCharacterWithHumanoidDescription(workspace.StudioHumanoidDescription)
end
-- Conectar el evento "PlayerAdded" a la función "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)