Uploader de arquivos

Quais são as causas de erros ao fazer upload de avatares no VRChat?

No VRChat, utilizamos o Unity e o VRChat SDK para fazer upload de avatares, mas existem casos em que ocorrem erros durante o processo.

As causas dos erros não se limitam a uma única, e podem incluir diferença de versões do Unity, bugs no SDK, erros de configuração do avatar, problemas com Blueprint ID, entre outros.

É importante começar a verificar as causas separadamente.

Lista de verificações para começar

• Verifique se o VRChat Creator Companion (VCC) está atualizado.
• Confirme se está utilizando a versão do Unity recomendada pelo VRChat.
• Veja se não há erros vermelhos exibidos no Console do Unity.
• Certifique-se de que não há erros de validação pendentes antes de Build & Publish.
• Confirme se o Avatar Descriptor está configurado corretamente.
• Desative avatares desnecessários na Hierarchy.
• Tente desanexar o Blueprint ID e fazer o upload novamente.
• Tente usar o mesmo avatar em um novo projeto.

Os erros vermelhos exibidos no Console do Unity são particularmente importantes. Alertas amarelos podem ser ignorados, mas na presença de erros vermelhos, o upload geralmente falha.

Versão do Unity é diferente

Esta é uma das causas mais comuns.

O VRChat tem versões do Unity que são suportadas. Atualizar para a versão mais recente através do Unity Hub pode parecer uma boa ideia à primeira vista, mas pode na verdade dificultar o upload.

Certifique-se de usar a versão do Unity recomendada pelo VRChat.

Atualize o VRChat SDK e o Creator Companion

Usar um SDK antigo pode provocar diversos erros ao fazer upload.

Atualizar o SDK e os pacotes para a versão mais recente através do Creator Companion pode resolver algumas questões.

No entanto, há relatos de que algumas versões do SDK podem exibir uma mensagem de sucesso no upload, mas na realidade não refletem as alterações.

Verifique os erros no Console do Unity

Se ocorrer "Build Failed", o primeiro passo é abrir o Console do Unity.

Se houver erros como "Missing Script" ou de Shader, ou erros de compilação, o upload não será bem-sucedido até que esses problemas sejam resolvidos.

Principalmente, ao adicionar várias ferramentas ou recursos a um avatar adquirido, pode ocorrer conflitos.

Redefina o Blueprint ID

Se o Blueprint ID estiver corrompido, realizar o "Detach Blueprint" e fazer o upload como um novo Blueprint pode ajudar.

Isso também é eficaz se houver Blueprint IDs de outras pessoas que estejam presentes ou duplicados.

Verifique o Avatar Descriptor

Se o Avatar Descriptor não estiver configurado, o Build & Publish não poderá ser realizado.

Selecione o objeto alvo na Hierarchy e verifique se o componente Avatar Descriptor está presente.

Resolva erros de validação

O VRChat SDK possui uma função de validação.

Erros relacionados ao número de polígonos, uso de memória e configurações incorretas são exibidos, assim, você deve corrigir os itens que estão levando a erros.

Recentemente, um "Security Check" foi introduzido no lado do servidor, e avatares problemáticos podem ser impossíveis de usar, mesmo se o upload tiver sido bem-sucedido.

Quando aparecer "Security Checks Failed"

Se, após o upload, aparecer "Security Checks Failed", isso indica uma falha no check de segurança do servidor.

• Atualize o SDK para a versão mais recente.
• Remova ferramentas especiais ou scripts modificados e faça uma nova tentativa.
• Verifique o uso de memória e como está a otimização.

Esses problemas podem ser resolvidos apenas fazendo um novo upload com a versão mais recente do SDK.

Erros relacionados à imagem em miniatura

Recentemente, houve relatos de falhas na geração da imagem em miniatura, que impedem o upload.

Reproduzir a partir da cena usando "Capture From Scene" ou redefinir a imagem pode melhorar a situação.

Tente em um novo projeto

Se você não consegue descobrir a causa, tente criar um novo projeto de Avatar e importe apenas o avatar para fazer o upload.

Se for bem-sucedido, isso pode indicar que há conflitos entre ativos ou ferramentas no projeto existente.

Compartilhar os conteúdos do erro pode acelerar a resolução

Compartilhar o conteúdo do Console do Unity ou capturas de tela facilita a identificação da causa.

Além de imagens, compartilhar registros do Console e Editor.log pode acelerar a resolução do problema.

Nesses casos, recomendamos o UploadF.

É gratuito e pode ser utilizado tanto em PC quanto em dispositivos móveis, permitindo uploads simples via arrastar e soltar. Você pode compartilhar não apenas capturas de tela, mas também arquivos de log, e usar funções para definir senhas ou excluir arquivos, sendo útil para compartilhar informações com a comunidade VRChat ou suporte de maneira segura.

Se você deseja aplicar um desfoque em uma imagem antes de compartilhar, também pode usar a função de edição de imagens online.

Resumo

Erros ao fazer upload de avatares no VRChat podem ocorrer devido a várias razões, como Unity, SDK e configurações do avatar.

Verificar a versão do Unity e do SDK, assim como resolver erros vermelhos no Console do Unity, é fundamental.

Se o problema persistir, tente validar em um novo projeto ou recriar o Blueprint.

Ao compartilhar o conteúdo do erro, é mais fácil receber conselhos ao compartilhar capturas de tela e arquivos de log no UploadF.

Início   Ajuda   Contato   🌐Language