Aparência do personagem

A maioria das experiências permite que os jogadores usem seu próprio avatar do Roblox, embora algumas implementem um sistema de personalização na experiência como o modelo UGC Homestore.Outras experiências fazem modificações limitadas a avatares de jogadores como capacetes, asas ou acessórios que combinam com o gênero.

Para criar uma experiência única que altera a aparência de seus usuários, você pode personalizar as propriedades padrão do personagem com o seguindo:

• Configure o Avatar Jogos de Configurações para definir os padrões globais básicos de aparência de avatar para todos os usuários
• Use Descrição Humanoide em qualquer ponto para aplicar uma ampla gama de personalizações específicas de personagens a um ou mais usuários em sua experiência.

Configurações do jogo

A seção Avatar no menu Configurações do Jogo permite que você defina rapidamente várias propriedades globais de personagens em sua experiência.Ao editar as Configurações do Jogo de Avatar, seu avatar é exibido no espaço de trabalho como uma visualização visual.

Você pode ajustar as seguintes propriedades de personagens em sua experiência usando as Configurações do Jogo de Avatar:

Tipos de avatar

A configuração Tipo de Avatar define sua experiência para carregar apenas R15 ou R6 modelos de personagens.

• R15 é o avatar moderno padrão com 15 membros. Este avatar permite uma personalização mais flexível, opções acessórias e animações.

• R6 é um avatar simples clássico com 6 membros.Este tipo de avatar fornece uma sensação retrô, mas é limitado em animações e personalização adicional.As alterações na propriedade de escala do corpo não afetam os caracteres R6.

>

>

Limites de colisão

A configuração Colisão define os limites de colisão para os personagens na experiência.Isso não afeta a aparência física dos personagens em sua experiência.

Definir essa opção para Caixa externa dinamiza as caixas de colisão de personagens com base em seus modelos individuais.Esta é a configuração padrão e recomendada para a maioria das experiências.

Definir essa opção para Caixa Interna fornece limites de colisão fixos para todos os personagens em sua experiência.

Descrição Humanoide

Modelos de personagens jogáveis contêm um objeto Humanoid que permite as características especiais do modelo, como caminhar, pular, equipar itens e interagir com o ambiente.Para personalizar a aparência de um personagem Humanoid , você pode aplicar um novo HumanoidDescription para alterar as propriedades do personagem.

Você pode ajustar as seguintes propriedades de personagens em sua experiência usando HumanoidDescription :

Você pode personalizar um personagem com HumanoidDescription usando os seguintes passos:

1. Crie uma descrição a partir do personagem do usuário, de um ID de roupa específico ou de um ID de usuário específico.
2. Modifique a descrição para personalizar as propriedades que você deseja aplicar ao personagem Humanoid .
3. Aplique a descrição em um único personagem, todos os personagens dos jogadores ou mesmo em todos os personagens gerados.

Criar Descrição Humanoide

Você pode criar uma nova instância HumanoidDescription diretamente dentro da hierarquia do Explorer ou dentro de uma Script com o seguinte código:

local humanoidDescription = Instance.new("HumanoidDescription")

Na maioria dos casos, você deve usar um existente HumanoidDescription em vez de um novo padrão HumanoidDescription referenciando um personagem de jogador existente , roupa de avatar ou ID do usuário.

Do personagem do jogador

Use o seguinte exemplo de código para criar um novo HumanoidDescription com base nas propriedades atuais do personagem do jogador:

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

local humanoidDescription = Instance.new("HumanoidDescription")

if humanoid then
	humanoidDescription = humanoid:GetAppliedDescription()
end

A partir de uma roupa existente

Use o seguinte código de amostra para criar um HumanoidDescription a partir de um ID de roupa usando Players.GetHumanoidDescriptionFromOutfitID :

local Players = game:GetService("Players")

local outfitId = 480059254

local humanoidDescriptionFromOutfit = Players:GetHumanoidDescriptionFromOutfitId(outfitId)

De um usuário específico

Use o seguinte código de amostra para criar um HumanoidDescription a partir de um ID de usuário usando Players:GetHumanoidDescriptionFromUserId() :

local Players = game:GetService("Players")

local userId = 491243243

local humanoidDescriptionFromUser = Players:GetHumanoidDescriptionFromUserId(userId)

Modificar Descrição Humanoide

Para personalizar HumanoidDescription propriedades, defina-as diretamente no HumanoidDescription ou use um método especificado antes de aplicar o HumanoidDescription a um personagem.

O seguinte exemplo de código fornece exemplos de definir os diferentes tipos de propriedades 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)

Defina vários acessórios

Para alterações acessórias em camadas ou em massa, você pode usar HumanoidDescription:SetAccessories() para fazer atualizações relacionadas a acessórios.O seguinte exemplo de código adiciona um suéter em camadas e jaqueta nessa ordem a um 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 Descrição Humanoide

Aplique HumanoidDescription a caracteres específicos Humanoid na sua experiência com Humanoid:ApplyDescription() ou Humanoid.LoadCharacterWithHumanoidDescription.

Em um único personagem

ApplyDescription() pode alcançar qualquer Humanoid. Use o seguinte código para adicionar um novo par de óculos de sol e um novo torso ao personagem do jogador:

local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")
if humanoid then
	local descriptionClone = humanoid:GetAppliedDescription()
	descriptionClone.Torso = 86500008
	-- Vários recursos de acessórios de rosto são permitidos em uma string / cadeia / textoseparada por vírgula
	descriptionClone.FaceAccessory = descriptionClone.FaceAccessory .. ",2535420239"
	-- Aplique o modificado "descriptionClone" ao humanoide
	humanoid:ApplyDescription(descriptionClone)
end

Em todos os personagens de jogador

Use o seguinte código de amostra para aplicar um HumanoidDescription a todos os jogadores atuais no jogo:

local Players = game:GetService("Players")

for _, player in Players:GetPlayers() do
	local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")
	if humanoid then
		-- Criar uma Descrição 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)
		humanoid:ApplyDescription(humanoidDescription)
	end
end

Em todos os personagens gerados

Use o seguinte código de amostra para definir um código específico HumanoidDescription para todos os personagens de jogador gerados:

local Players = game:GetService("Players")

-- Pare o gerenciamento automático para que possa ser feito no retorno "PlayerAdded"
Players.CharacterAutoLoads = false

local function onPlayerAdded(player)
	-- Criar uma Descrição 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)

	-- Gerar personagem com a Descrição Humanoide
	player:LoadCharacterWithHumanoidDescription(humanoidDescription)
end

-- Conectar evento "JogadorAdicionado" à função "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

Se a instância HumanoidDescription foi criada no Explorer e associada ao espaço de trabalho, use o seguinte código de amostra em um Script para acessar a instância do espaço de trabalho:

local Players = game:GetService("Players")

-- Pare o gerenciamento automático para que possa ser feito no retorno "PlayerAdded"
Players.CharacterAutoLoads = false

local function onPlayerAdded(player)
	-- Gerar personagem com "workspace.StudioHumanoidDescription"
	player:LoadCharacterWithHumanoidDescription(workspace.StudioHumanoidDescription)
end

-- Conectar evento "JogadorAdicionado" à função "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)