Atualizar Manualmente os Cabeçotes do Catálogo | Documentação

O conteúdo a seguir se aplica a criadores com ativos de cabeçote no Marketplace que receberam um aviso de que seus ativos de cabeçote não passam mais na validação de cabeçote dinâmico.

Este documento foi elaborado para ser atualizado com frequência para incluir as informações mais recentes que ajudem a guiá-lo pelo processo de atualização do cabeçote.

Se seu ativo de cabeçote não passa mais na validação de cabeçote dinâmico, você precisa corrigir e re-enviar seu ativo de cabeçote para o Marketplace. Você não precisa atualizar o corpo quando o cabeçote foi publicado como parte de um pacote de corpo. Você só precisa atualizar o ativo de cabeçote.

Este guia fornece informações detalhadas sobre como realizar uma correção manual reencapsulando seu ativo usando um modelo de jaula fornecido, utilizando os seguintes 5 passos principais:

Revalidar seu ativo de cabeçote do catálogo para confirmar problemas.
Exportar seu cabeçote (ou pacote de corpo) do Roblox como um glTF.
Corrigir seu cabeçote no Blender.
Importar seu cabeçote corrigido de volta para o Studio.
Fornecer o ID do ativo do seu cabeçote atualizado ao Roblox.

Embora estas instruções sejam fornecidas para o Blender, é possível realizar etapas equivalentes em seu software de modelagem 3D preferido. É recomendável familiarizar-se com o processo de validação de cabeçotes do Roblox antes de fazer alterações nos seus ativos de cabeçote.

1. Verifique se o ativo de cabeçote do catálogo falha na validação

O Roblox recentemente atualizou os parâmetros de validação de cabeçotes dinâmicos para permitir que mais cabeçotes do catálogo existente passem na validação, enquanto ainda se exige que todos os cabeçotes no catálogo sejam dinâmicos. É importante verificar se seu cabeçote ainda falha na validação antes de prosseguir com os demais passos.

Abra um novo Roblox Studio e verifique se você tem o recurso beta glTF Export habilitado (você pode precisar reiniciar o Studio para capturar a nova configuração)
1. Verifique suas configurações beta em Arquivo > Recursos Beta.

Execute o seguinte script na barra de comandos.

Você tem a opção de fornecer o id do cabeçote (ID do ativo) ou o id do pacote (para um pacote de corpo completo). Basta substituir my_asset_id pelo ID correto e remover o -- inicial para executar.
Descomente createExportFromHeadAssetId(your_asset_id) para recuperar apenas o ativo de cabeçote.
Descomente createExportFromBodyBundleId(your_bundle_id) para recuperar o corpo completo como um pacote (inclui o cabeçote).


local AssetService = game:GetService("AssetService")
local Players = game:GetService("Players")

local function createExportFromHeadAssetId(assetId: number)
  local hd = Instance.new("HumanoidDescription")
  hd.Head = assetId

  local char = Players:CreateHumanoidModelFromDescriptionAsync(hd, Enum.HumanoidRigType.R15)
  local headMesh = char.Head :: MeshPart
  headMesh.Size = headMesh.MeshSize
  headMesh.CFrame = CFrame.identity
  headMesh.Locked = false

  local exportModel = Instance.new("Model", workspace)
  exportModel.Name = "ExportThisAsGLTF"
  headMesh.Parent = exportModel
end

local function getOutfitId(bundleInfo)
  for _, item in pairs(bundleInfo.Items) do
    if item.Type == "UserOutfit" then
      return item.Id
    end
  end
  error("Não foi possível encontrar o ID do traje")
end
local function createExportFromBodyBundleId(bundleId: number)
  local bundleInfo = AssetService:GetBundleDetailsAsync(bundleId)
  local outfitId = getOutfitId(bundleInfo)
  local hd = Players:GetHumanoidDescriptionFromOutfitIdAsync(outfitId)
  local char = Players:CreateHumanoidModelFromDescriptionAsync(hd, Enum.HumanoidRigType.R15)
  char:PivotTo(CFrame.identity)
  char.Name = "ExportThisAsGLTF"
  char.Parent = workspace
end

-- createExportFromHeadAssetId(your_asset_id)
-- createExportFromBodyBundleId(your_bundle_id)

Uma vez que o script é executado, você verá um modelo "ExportThisAsGLTF" no espaço de trabalho. Clique com o botão direito e selecione Salvar para Roblox. Isso abrirá a janela de publicação:
1. No Tipo de conteúdo, selecione Item de Avatar.
2. Na Categoria de Ativos, selecione Cabeça ou Corpo (caso tenha utilizado um pacote de corpo).
  1. Aguarde o resultado da validação.
3. Se a validação de cabeçote dinâmico passar, você não precisa atualizar este ativo.
4. Cancele a operação de publicação (para não incorrer em taxas).

Se seu ativo falhou na validação de cabeçote dinâmico, você precisa continuar com os próximos passos.

2. Exporte seu Cabeçote do Roblox

Exporte seu cabeçote ou corpo inteiro do Blender como um arquivo glTF:

No explorador, clique com o botão direito no modelo "ExportThisAsGLTF" e selecione Salvar/Exportar > Salvar como glTF.

3. Corrija seu Ativo de Cabeçote no Blender

Corrija seu ativo no Blender, ou no software de modelagem 3D preferido. Em muitos casos, você pode economizar tempo usando uma nova jaula de cabeçote e encaixando a jaula sobre a cabeça do seu personagem. Você também pode ver outros problemas de validação que precisam ser abordados na primeira etapa.

No Blender, abra uma nova cena vazia e importe o arquivo glTF.
1. Nas configurações de importação do glTF, desative Adivinhar Pose de Bind Original.
Certifique-se de que tudo o que você precisa para o cabeçote esteja presente, incluindo a jaula, pontos de fixação, articulações faciais e animações faciais.
O Roblox Studio inverte os avatares em 180 graus na importação, então você precisa rotacionar seu ativo de volta em 180 no Blender (Atalhos: R+Z e digite 180).
Com frequência, os cabeçotes falham na validação devido a problemas na jaula. Por exemplo, a jaula pode estar completamente dentro do cabeçote, ter UVs incorretos ou parecer completamente deslocada no modelo. Na maioria dos casos, recomendamos que você não gaste tempo editando a jaula original e, em vez disso:
1. Exclua-a do ativo.
2. Selecione a jaula do modelo de cabeçote nesta pasta que melhor combina com a forma do seu ativo de cabeçote. Estes são Modelos de jaula fornecidos pela Roblox com as configurações de UV corretas.
Certifique-se de que o valor inicial da animação no Blender está definido como 0.
Remova as cores de vértices. No Blender, isso pode ser feito clicando na malha e, em seguida, na aba de dados, selecionando atributos de cor e removendo qualquer um que exista.
Se necessário, remova os nós de sombreamento de cores de vértices para exportação fbx. O exportador fbx do Blender é mais exigente que o glTF e não aceitará nós entre a entrada da textura e o shader.
Modifique seu ativo de cabeçote para passar na validação:
1. Alinhe as regiões dos olhos e da boca da jaula com a cabeça.
2. Certifique-se de que seu cabeçote inclua um rig, com poses keyframed e mapeadas ao padrão FACS para que:
  1. Os olhos devem piscar.
  2. A boca deve abrir e fechar.
  3. O rosto deve expressar felicidade e tristeza.
Exporte seu ativo de cabeçote atualizado para o formato de arquivo FBX usando as configurações corretas explicadas aqui (se você tiver PBR, pode querer usar glTF).
1. Configure texturas para exportação FBX (se necessário). O Blender importará as texturas glTF de tal forma que não poderão ser exportadas em um arquivo FBX por padrão. Para corrigir isso, vá por cada imagem e salve-a em seu disco local.

4. Importar seu Cabeçote Corrigido de Volta para o Studio

Importe seu cabeçote de volta para o Studio e verifique se ele passa na validação. Se a validação falhar, verifique as mensagens de erro e resolva os problemas em seu software de modelagem 3D novamente. Se a validação passar, use os seguintes passos para fazer o upload como um Item de Desenvolvimento (não Item de Avatar).

Importe o arquivo FBX/glTF com seu ativo de cabeçote (corrigido) de volta para o Studio.
1. Seu cabeçote corrigido deve conter: malha de cabeçote, malha de jaula, rig facial e texturas atualizadas (se você as modificou).
2. Em seguida, você salvará esses ativos como um Model no Studio (não como um ativo individual, como a malha de cabeçote).
Certifique-se de que seu ativo de cabeçote passa na validação.
1. A maneira mais fácil de conseguir isso é:
  1. Selecione Salvar para Roblox em seu ativo.
  2. Selecione Item de Avatar.
  3. Defina sua Categoria de Ativo para Cabeça.
  4. Aguarde o resultado da validação do Cabeçote Dinâmico (passar ou falhar).
  5. Cancele a operação de salvamento para que você não incorra em taxas de publicação por enquanto.
2. Se seu cabeçote não passar na validação, você precisará voltar ao Blender ou Maya e fazer as correções apropriadas para passar na validação.
Se seu cabeçote passar na validação, publique seu ativo como um Item de Desenvolvimento.
1. No Explorador, selecione o Model do seu avatar, certifique-se de que inclui a malha de cabeçote, o rig facial e os dados da jaula.
  1. Se você salvar o modelo para o corpo inteiro do personagem, o processo de upload extrairá automaticamente os dados do cabeçote.
2. Selecione Salvar para Roblox em seu ativo.
3. Selecione Item de Desenvolvimento.
4. Defina sua Categoria de Ativo para Modelo.
5. Defina a Privacidade do Ativo para Pública.
  1. Se você estiver inscrito na beta de Privacidade de Ativos, desative o beta antes de enviar seu ativo corrigido.
6. Salve o modelo no Roblox (nenhuma taxa de publicação é incorrida).
7. Após salvar no Roblox, salve o ID do ativo fornecido.
  1. Embora você possa enviar tanto o ativo de cabeçote quanto o de corpo, não há distinção entre ativo de cabeçote e de corpo ao salvar como um item de desenvolvimento.
  2. Para envio ao formulário da web, preferimos que você obtenha o ID do ativo do cabeçote, mas pode usar tanto o ID do cabeçote quanto do corpo e o Roblox substituirá o cabeçote conforme necessário.

5. Fornecer o assetID do seu cabeçote atualizado

Use os seguintes passos para fornecer ao Roblox o ID de ativo atualizado para substituir seu cabeçote:

Use o link para o formulário da web no e-mail de notificação correspondente ao seu ativo para se comunicar de volta o ID do ativo do seu cabeçote atualizado.
1. Você será solicitado a inserir sua data de nascimento para cada atualização. Este é um requisito legal que não podemos contornar.
2. Você pode enviar várias vezes. Usaremos sua última submissão como a versão "final" para a atualização.
O Roblox completará a atualização do seu ativo do catálogo com as modificações que você forneceu.

Recursos Adicionais

O Roblox publicou uma série de documentações e tutoriais em vídeo sobre as melhores práticas para criar ativos de cabeçotes dinâmicos.