Configuração de Avatar ajuda a acelerar o processo de criação de personagens, roupas e acessórios de avatar, processando automaticamente modelos personalizados em ativos de avatar. Se seus personagens, acessórios e roupas não tiverem todos os componentes essenciais para publicação na Marketplace, a Configuração de Avatar pode realizar o seguinte para seus modelos 3D:
- Rigging — Adiciona um armature R15 ao seu modelo de corpo para permitir movimento e animação.
- Skinning — Adiciona pesos e influências a várias superfícies da sua malha, garantindo uma flexibilidade orgânica e natural durante o movimento.
- Animação facial — Gera as poses do FACS, rigging facial, skinning e dados de animação necessários para animação facial e chat de avatar.
- Caging — Adiciona as gaiolas necessárias ao seu ativo, permitindo que suporte roupas em camadas.
- Particionamento — Separa a malha do corpo nas partes R15 apropriadas.
- Criar anexos — Adiciona os pontos de anexo apropriados permitindo que o personagem use acessórios rígidos.

Importar um ativo 3D
A ferramenta Importador permite que você importe ativos 3D personalizados que você fez em ferramentas de modelagem de terceiro, como Blender ou Maya diretamente para o Studio. Se seus ativos 3D personalizados não incluírem todos os componentes de avatar essenciais para a Marketplace, a Configuração de Avatar adicionará quaisquer componentes ausentes enquanto processa os ativos.
Para importar um ativo 3D personalizado usando a ferramenta Importador:
- Navegue até a aba Home e selecione Importar. Um navegador de arquivos será exibido.
- Selecione o modelo .fbx, .obj ou .gltf que você deseja importar. Após alguns momentos, a janela de Pré-visualização de Importação será aberta com uma pré-visualização do seu ativo.
- Na seção Geral do Arquivo, desabilite a opção Fazer Upload para Roblox. Esta configuração impede que o ativo seja salvo imediatamente em sua Toolbox, evitando cópias indesejadas de ativos semelhantes.
- OPCIONALPara criar um preset de importação para este fluxo de trabalho,
- No canto superior direito da janela de Pré-visualização de Importação, clique na seta de dropdown ⋯.
- No menu contextual, clique em Salvar como Novo.
- Verifique a pré-visualização e quaisquer avisos ou erros em seu modelo. Certos avisos e erros podem exigir que você reajuste o modelo no software de terceiros que você usou para criar o ativo.
- Clique no botão Importar para adicionar o modelo ao seu espaço de trabalho. Após um momento, ele será exibido como um objeto Model na janela Explorer.
Executar a Configuração de Avatar
Quando seu projeto tiver o objeto Model apropriado em seu espaço de trabalho, você pode executar a Configuração de Avatar para ver se seu ativo 3D requer quaisquer componentes adicionais de avatar antes que você possa publicá-lo na Marketplace como um corpo de personagem, acessório ou item de roupa. A Configuração de Avatar suporta a conversão dos seguintes tipos de ativos 3D a partir de um Model base:
| Tipo de ativo | Objeto de entrada | Objeto de saída |
|---|---|---|
| Corpo de avatar | Model contendo um ou mais objetos MeshPart que atendem às entradas de corpo suportadas pela Configuração de Avatar. | Model com paisagem de 15 objetos MeshPart associados e outros componentes de avatar esperados. |
| Acessório | Model contendo um ou mais objetos MeshPart que atendem às entradas de acessório suportadas pela Configuração de Avatar. Deve embalar com um Model de corpo de avatar para a Configuração de Avatar. | Accessory que inclui todos os componentes de acessório rígido esperados. |
| Roupas em camadas | Model contendo um ou mais objetos MeshPart que atendem às entradas de acessório suportadas pela Configuração de Avatar. Pode opcionalmente embalar com um Model de corpo de avatar para a Configuração de Avatar. | Accessory que inclui todos os componentes de acessório em camadas esperados. |
| Múltiplos acessórios e roupas com um único corpo | Folder embalar contendo um ou mais Model que atendem às entradas suportadas para acessórios, roupas ou corpo. Deve embalar com um Model de corpo de avatar para a Configuração de Avatar. | Model de corpo de personagem e quaisquer itens Accessory equipáveis. Todos os ativos gerados incluem os esperados componentes de itens de avatar. |
Para executar a Configuração de Avatar:
Na janela Explorer, selecione o modelo ou as malhas específicas do modelo. Se você quiser selecionar várias malhas de uma vez, expanda o objeto Model, mantenha shift pressionado e clique nos objetos de malha individuais que você deseja processar como ativos de avatar.
Para um ativo que atenda a todos esses requisitos de modelo, baixe um dos seguintes templates de Configuração de Avatar para sua própria referência e teste:
Garota da Natureza 
Uma pasta completa .zip de um modelo de personagem pronto para Configuração de Avatar, incluindo ativos de roupa e acessórios rígidos e ativos de textura PBR.
Este template não é compatível com o fluxo de trabalho tradicional de criação de avatares.
Masculino Estiloso 
Uma pasta completa .zip de um modelo de personagem pronto para Configuração de Avatar, incluindo o corpo base e texturas PBR associadas.
Este template não é compatível com o fluxo de trabalho tradicional de criação de avatares.
Com o modelo ou as malhas selecionadas, navegue até a aba Avatar e selecione Configuração de Avatar.
Na seção Configurar Modelos,
Defina Preset para a categoria apropriada.
- Se você deseja publicar seus ativos na Marketplace para que usuários possam comprar e usar em todo o Roblox, selecione Avatar de Plataforma. Esta opção gera uma configuração mais restritiva que é necessária para passar na validação e moderação.
- Se você deseja fazer upload de seus ativos para seu inventário para personagens não jogáveis (NPCs) ou personagens iniciais para seus jogos, selecione Avatar de Desenvolvimento. Esta opção gera uma configuração menos restritiva.

Defina Tipo para cada ativo como o tipo correto de ativo para que ele se mova e anime corretamente no espaço 3D.
- Para a geometria do corpo do personagem, selecione Corpo.
- Para ativos de roupas em camadas, selecione Em Camadas.
- Para ativos de acessórios rígidos, selecione Rígido.
- Para ativos de sobrancelhas e cílios, selecione Camada dos Olhos.

- OPCIONALPróximo ao canto inferior esquerdo, clique no ícone de engrenagem para configurar as configurações especiais para o seu modelo de personagem.
Se o seu personagem tiver um decalque para o rosto e você quiser ativar a conversão da textura em uma cabeça dinâmica, habilite Tratar rosto como decalque 2D. Esse processo permite que você preserve sua intenção criativa enquanto cumpre a política da Marketplace que exige que todos os avatares tenham cabeças dinâmicas.
O processo de conversão de um decalque em uma cabeça dinâmica infere regiões dos olhos e da boca a partir da sua textura existente, gera gaiolas e dados do FACS, e em seguida mapeia o resultado em um template de cabeça dinâmica. Para melhores resultados, revise a orientação abaixo:
Execute a Configuração de Avatar com o corpo e a cabeça do personagem
- Se você apenas executar a Configuração de Avatar com a cabeça do personagem, esta configuração especial falhará.
Verifique se o rosto do avatar está voltado para frente
- Antes de executar a Configuração de Avatar, verifique se o rosto do seu personagem está voltado para frente e visível na pré-visualização. Sempre que você posicionar manualmente o rosto do seu personagem, certifique-se de habilitar Alinhar frontalmente de forma manual nas configurações especiais da janela de Configuração de Avatar.
Delete o objeto FaceControls
- A Configuração de Avatar retém sua configuração atual de rosto sempre que detecta um objeto FaceControls sob o modelo Head do seu personagem. Se existir um em seu personagem, exclua-o antes de executar a Configuração de Avatar.
Use SurfaceAppearance em vez de TextureID
- Quando você tiver apenas objetos TextureID ou tanto TextureID quanto SurfaceAppearance definidos para o seu avatar, remova ou substitua os objetos TextureID por objetos SurfaceAppearance para melhorias significativas na qualidade da textura ao renderizar.
Se seu personagem incluir um rig de maior fidelidade com articulações adicionais, habilite Criar R15 com articulações opcionais.
Se você deseja alinhar manualmente a direção frontal do seu personagem com o eixo Z negativo no espaço mundial, habilite Alinhar Fronteira Manualmente. Embora a configuração automática faça isso automaticamente para você, às vezes pode falhar em determinar corretamente a frente de seu personagem.
Se você deseja adicionar um passo de processamento pós-arquitetura para melhorar significativamente o alinhamento da gaiola da cabeça do seu personagem com o modelo da cabeça e seus recursos faciais, habilite Melhorar gaiolagem facial. Isso é particularmente importante se você planeja usar maquiagem com seu personagem.
Se você está importando um avatar de desenvolvimento e deseja pular a auto-decimação de malhas de entrada com resoluções acima dos orçamentos de triângulos exigidos pela Marketplace, desabilite Reduzir contagem de triângulos.

Próximo ao canto inferior direito, clique no botão Configurar.
- Se seu modelo requer configuração automática para componentes de avatar ausentes, a ferramenta começará a processar seu modelo. Isso pode levar vários minutos. Uma vez que a configuração automática esteja completa, a ferramenta preencherá seu ativo de avatar na janela de Configuração de Avatar.
- Se seu modelo não requer configuração automática, a ferramenta preencherá seu ativo de avatar na janela de Configuração de Avatar.
Ferramentas de teste
Depois de carregar com sucesso seu personagem na janela de Configuração de Avatar, você pode acessar várias ferramentas de teste na navegação lateral da janela para garantir que seu personagem se mova, anime e equipe roupas e acessórios corretamente.

Em cada uma dessas interfaces, você pode ver quais itens estão atualmente equipados ao seu personagem no lado direito da janela de Configuração de Avatar. A partir daqui, você pode:
- Desequipar itens clicando com o botão direito em um item equipado e selecionando Desequipar Item no menu contextual.
- Definir a ordem de uso arrastando e ordenando os vários acessórios equipados.
Se você descobrir quaisquer problemas que não podem ser resolvidos com as ferramentas de teste da Configuração de Avatar, talvez seja necessário atualizar o modelo do seu personagem usando o software de modelagem 3D de terceiros que você usou para criar o ativo, e então tentar novamente o processo de configuração automática.
Verificar Corpo
A interface Verificar Corpo contém várias abas para verificar como seu modelo de personagem anima, emote, usa roupas e acessórios e muda de tom de pele. Para saber mais sobre o que você pode fazer com esta interface, clique pelas seguintes abas.

A aba Animações permite que você teste como seu personagem anima e emote usando cada animação padrão que o Roblox fornece para cada avatar, como a animação de caminhar, pular e nadar.
Se você notar quaisquer problemas com o corpo do seu personagem enquanto ele anima, você pode usar as ferramentas de edição da Configuração de Avatar ou seu aplicativo de modelagem 3D favorito para ajustar o rig do seu personagem até que as animações sejam reproduzidas corretamente.
Verificar Rosto
A interface Verificar Rosto aproxima-se mais do rosto do personagem e permite que você teste várias poses faciais e cosméticos. Para saber mais sobre o que você pode fazer com esta interface, clique pelas seguintes abas.


A aba Animações permite que você teste as animações faciais do seu personagem e a gama de movimento para diferentes partes do rosto, como os olhos, sobrancelhas e boca do personagem.
Se você notar quaisquer problemas com as expressões faciais do seu personagem, você pode usar as ferramentas de edição da Configuração de Avatar ou seu aplicativo de modelagem 3D favorito para ajustar seu personagem até que as animações sejam reproduzidas corretamente.
Testar na Experiência
A aba Testar na Experiência começa o teste de jogo com o modelo do seu personagem. Este botão faz referência ao seu modo de teste ativo e retém as alterações que você faz na janela de Configuração de Avatar.
Adicionar itens de teste
Além das ferramentas de teste na navegação lateral, você pode adicionar ativos personalizados ao palete de teste da Configuração de Avatar que estão ativos no seu projeto atual ou por assetID. Para mais informações sobre qualquer um dos métodos, revise as abas abaixo.
Para adicionar um item personalizado que está ativo no seu projeto atual ao palete de teste da Configuração de Avatar:
Na janela ou viewport do Explorer, selecione um ativo de acessório ou parte do corpo válido.
Na janela da Configuração de Avatar, navegue até a interface Verificar Corpo ou Verificar Rosto, e clique no botão de mais na parte inferior da coluna de seleção ao longo do lado esquerdo da janela. O item aparecerá na seção e subseção apropriadas da interface, como Acessórios → Cabelo.

Ferramentas de Edição
Além da janela da Configuração de Avatar, você pode usar a Ferramenta de Anexo e o Cage Brush da Configuração de Avatar na viewport para fazer ajustes menores a moderados nos pontos de anexo e gaiola do personagem.

Ferramenta de Anexo
A Ferramenta de Anexo exibe todos os pontos de anexo no corpo do personagem. Quando você seleciona um ponto de anexo, a ferramenta de Mover exibe, permitindo que você ajuste a posição do ponto de anexo dentro do corpo do personagem.

Cage Brush
O Cage Brush permite que você modifique a malha da gaiola do corpo do seu personagem e faça ajustes em como as roupas e outros ativos em camadas se adaptam ao seu personagem. Os seguintes controles fornecem controle mais fino nas edições da sua gaiola:

- Edições simétricas e em espelho ao longo do eixo X.
- Escova com controles de raio e queda.
- Visualização da queda da escova sobre os vértices.
- Capacidade de ocultar ou exibir itens de roupas em camadas equipados. As roupas em camadas serão atualizadas em tempo real na janela de pré-visualização da ferramenta Configuração de Avatar.
Publicar na Marketplace
O botão Salvar abre o diálogo de Configuração de Ativo, permitindo que você faça upload do avatar e de quaisquer itens de acessório para seu inventário ou publique tudo configurado como ativos de avatar de plataforma na Marketplace.

Ao publicar seus ativos na Marketplace, você deve pagar uma taxa de upload e passar pela moderação para adicionar seus ativos ao catálogo. Para recursos adicionais sobre o processo de publicação e Marketplace, veja o seguinte: