AssetRipper Wikiguia independente de assets Unity
Português
GUIA DE ERRO DE LEITURA

Erro do AssetRipper ao ler o arquivo de assets

O erro do AssetRipper ao ler o arquivo de assets aparece depois que o aplicativo encontra um arquivo candidato, mas não consegue analisá-lo. Essa etapa é diferente de uma varredura que não encontra arquivos e de um fechamento durante a exportação. Comece com uma cópia intacta, confirme que ela está completa e teste a menor entrada autorizada que você consegue descrever. Este guia separa cada verificação para mostrar se o problema acompanha o arquivo, suas dependências, o formato do Unity, a versão do AssetRipper ou a pasta de saída.

O que significa o erro do AssetRipper ao ler o arquivo de assets

Um erro de leitura significa que o importador alcançou um arquivo que parecia relevante e falhou ao ler o cabeçalho, os registros serializados, um fluxo de dados ou um recurso ligado. A mensagem não prova que toda a fonte está corrompida. Ela pode indicar uma cópia truncada, um arquivo de outra build do Unity, um formato sem suporte, um arquivo complementar ausente ou um caminho que aponta para um inicializador ou índice de arquivo, e não para os dados.

Anote primeiro a mensagem exata, o nome do arquivo, a pasta escolhida, a versão do AssetRipper e se o processo parou imediatamente ou depois de mostrar progresso. Não mude a entrada, a pasta de saída e a versão do aplicativo ao mesmo tempo. Um erro depois que um arquivo foi alcançado não é o mesmo que No files loaded, quando a varredura talvez nem tenha exposto dados reconhecíveis do Unity.

A comparação mais rápida usa uma entrada pequena. Preserve a fonte, crie uma cópia de trabalho em uma pasta local gravável e teste um arquivo autorizado. Se um segundo arquivo da mesma fonte abrir, o limite provavelmente está no primeiro arquivo ou na relação dele. Se todos falharem, investigue extração, build, permissões e formato antes de culpar um asset específico.

Estado observadoO que indicaPróxima verificação
O erro de leitura aparece imediatamenteUm arquivo candidato foi alcançado e o parse parouGuardar a mensagem e verificar cópia e tipo
No files loaded após a varreduraO caminho pode não expor dados reconhecidosUsar o guia de no files loaded e revisar o nível da pasta
Somente um arquivo falhaO problema pode acompanhar esse arquivo ou um complementoComparar tamanho, origem e arquivos vizinhos
Todos os arquivos de teste falhamExtração, build, permissões ou formato podem ser a causaExtrair uma build oficial e testar uma entrada pequena
A importação funciona, mas a exportação falhaA etapa do parser terminouUsar as verificações de exportação ou memória

Verifique a integridade do arquivo antes de trocar o AssetRipper

Uma cópia incompleta é uma das causas mais fáceis de eliminar. Compare o arquivo que falha com a fonte autorizada: confirme que a cópia terminou, que não tem zero bytes e que não é menor do que o esperado. Se o download, o extrator, um compartilhamento de rede ou a sincronização informou uma interrupção, faça uma cópia nova em vez de tentar reparar bytes dentro do arquivo.

Se a entrada veio de um ZIP ou outro contêiner, extraia tudo para uma pasta nova antes de selecioná-la. Alguns navegadores mostram o conteúdo comprimido como uma pasta normal, mas o parser precisa dos dados extraídos e dos arquivos vizinhos que eles referenciam. Mantenha o arquivo original para que uma segunda extração seja uma comparação verdadeira.

Não renomeie extensões para fazer um arquivo desconhecido parecer um arquivo de assets. Um inicializador, patch, índice de arquivo ou contêiner próprio pode ter um nome familiar e bytes diferentes. Use tipo, documentação da fonte e estrutura da pasta como evidência. Se a fonte estiver criptografada, protegida ou fora da sua autorização, pare: um erro de leitura não autoriza contornar uma proteção.

01

Preserve o original

Copie a fonte para outra pasta e anote nome e tamanho. Não sobrescreva a única cópia com um arquivo renomeado ou modificado.

02

Extraia para um caminho gravável

Termine a operação do arquivo antes de abrir o AssetRipper. Use uma pasta local com espaço e mantenha arquivos relacionados juntos.

03

Compare a cópia

Verifique tamanho e avisos do extrator. Um tamanho diferente ou erro CRC indica que é preciso obter uma cópia autorizada limpa.

04

Repita com um arquivo

Selecione o mesmo arquivo pequeno a partir da cópia limpa. Mantenha build e destino para interpretar o resultado.

Confirme o tipo de arquivo e a compatibilidade com o Unity

O AssetRipper trabalha com estruturas de dados do Unity, não com todos os arquivos encontrados ao lado de um jogo ou projeto. Uma pasta pode misturar executáveis, imagens, assemblies gerenciadas, patches, recursos, arquivos serializados e bundles em níveis diferentes. Selecione um arquivo que a documentação da fonte identifique como dado do Unity. Se o erro mencionar uma extensão desconhecida, registre-a exatamente e não deduza suporte apenas pelo sufixo.

Pistas de versão do Unity ajudam a explicar uma falha, mas não são uma garantia de suporte universal. Uma build pode combinar arquivos serializados, bundles, recursos compartilhados e metadados de etapas diferentes. Compare o tipo e a pista de versão do log com o comportamento documentado da release oficial testada. Evite afirmar que uma versão nova consertará qualquer formato antigo ou personalizado.

A documentação oficial Common Issues também separa assemblies do conteúdo dos bundles. Scripts Mono normalmente ficam em assemblies C#, então importar um bundle sem suas assemblies pode produzir resultado incompleto ou outro aviso. Isso é um problema de dependência, não prova de que o arquivo de assets esteja ilegível. Mantenha o sintoma do parser, o conteúdo ausente e a falha de exportação em notas separadas.

Sintoma

O item é executável, imagem, patch ou índice

Causa provável: O caminho chegou a um arquivo próximo que não era o dado Unity pretendido.

Tente isto: Inspecione a pasta extraída e selecione um arquivo de assets ou bundle documentado sem renomeá-lo.

Sintoma

A extensão é .file ou outro nome genérico

Causa provável: A extensão sozinha não identifica o contêiner Unity e seus complementos.

Tente isto: Use o layout da fonte e as pistas do log, testando o menor grupo autorizado.

Sintoma

O log menciona versão Unity ou tipo sem suporte

Causa provável: O formato serializado ou tipo de objeto pode estar fora da build testada.

Tente isto: Registre a pista, compare notas oficiais e relate o menor arquivo reproduzível.

  • Registre nome e extensão exatos, incluindo maiúsculas e sufixos numerados.
  • Guarde a pista de versão Unity, o backend de scripts e a plataforma quando aparecerem no log.
  • Uma varredura correta da pasta não prova que todos os arquivos possam ser lidos.

Teste dependências, recursos e assemblies em conjunto

Alguns dados Unity só fazem sentido perto de seus arquivos complementares. Um bundle pode referenciar assets serializados, fluxos de recursos, dados compartilhados, texturas ou assemblies guardadas em pastas vizinhas. Mover um único arquivo para uma pasta nova pode transformar uma fonte válida em um teste incompleto. Comece pelo menor grupo que preserve a relação original e reduza depois de criar uma linha de base.

Se o erro aparece depois que o arquivo é encontrado, mas antes que os objetos sejam listados, compare um teste com as dependências conhecidas. Mantenha caminhos locais simples, evite pasta de rede ou sincronizada na primeira comparação e confirme que o processo consegue ler cada arquivo. Um aviso de permissão ou complemento ausente descreve o ambiente; não é motivo para desativar proteções do sistema.

Assemblies merecem uma anotação própria. Common Issues explica que assemblies Mono ficam separadas da maioria dos bundles e precisam ser importadas quando o objetivo é recuperar scripts. Para um erro de leitura, prove primeiro que o dado pode ser analisado. Depois acrescente a assembly ou os recursos autorizados um grupo por vez, associando o novo aviso a uma dependência concreta.

ConfiguraçãoResultado útilO que registrar
Um arquivo de dadosMostra se ele abre sozinhoNome, tamanho, versão e mensagem
Arquivo e vizinhos originaisMostra se uma relação ou fluxo é necessárioQual grupo mudou o resultado
Bundle e assemblies autorizadasSepara recuperação de scripts e parsingLinha do backend e grupo de assemblies
Local de rede ou sincronizadoPode revelar efeitos de bloqueio ou permissãoTipo de local e aviso de acesso

Faça um teste controlado do erro de leitura do AssetRipper

Depois de entender integridade, tipo e dependências, faça um teste controlado. Use uma entrada pequena autorizada, uma build estável oficial e uma pasta de saída vazia. Feche outros programas que possam bloquear o arquivo ou consumir memória. O objetivo não é forçar um resultado, mas tornar o resultado repetível e mostrar qual etapa muda quando apenas uma condição é alterada.

Mantenha a entrada fixa e mude uma variável por vez. Repita o erro a partir de uma cópia extraída limpa e depois compare outra build oficial com a mesma cópia. Se o erro acompanha o arquivo entre builds, examine formato, tamanho e dependências. Se só um local falha, revise permissões ou sincronização. Se um arquivo pequeno funcionar, adicione um vizinho ou grupo de conteúdo por vez.

Um resultado limpo é útil mesmo quando não resolve o projeto completo. Ele mostra que o aplicativo consegue analisar pelo menos uma entrada e leva a investigação ao arquivo ou dependência que falha. Guarde os resultados bons e ruins lado a lado; não sobrescreva a saída de uma comparação com a próxima.

01

Escolha a base

Selecione o menor arquivo ou grupo autorizado que represente o problema. Anote caminho, tamanho e vizinhos.

02

Use um destino limpo

Crie uma pasta gravável com espaço livre. Separe cada comparação para que uma saída parcial não esconda o resultado.

03

Mude uma condição

Repita a mesma entrada alterando uma build, localização ou grupo de dependências. Não mude as três juntas.

04

Guarde os dois resultados

Registre estado, linhas do log, arquivos de saída e fase. Um sucesso também delimita a causa.

Guarde logs e compare uma build oficial

Salve o erro exato antes de reiniciar. Inclua a linha que nomeia o arquivo, a fase de importação anterior, a primeira exceção ou aviso e se o aplicativo continuou. Um trecho curto é mais útil do que uma captura que corta o caminho. Remova nomes de conta, diretórios privados, tokens e nomes proprietários antes de compartilhar.

Use a página oficial de releases do AssetRipper para comparar builds. Comece por uma release estável identificável e compare uma build de desenvolvimento apenas quando as notas ou uma issue justificarem. Não use mirror desconhecido ou arquivo renomeado como controle. A mudança de versão só é evidência quando entrada, destino e dependências permanecem iguais.

Issues históricas podem revelar o nome de uma fase ou um padrão de arquivo ausente, mas não provam que a release atual tenha o mesmo defeito. Compare entrada, plataforma, versão e log com a sua reprodução. Se a mensagem for diferente, mantenha os fatos separados e relate a evidência atual em vez de copiar uma correção antiga.

Ilustração editorial de pastas aninhadas e um arquivo Unity selecionado durante uma verificação do AssetRipper
O contexto de pasta e arquivo ajuda a explicar um erro de leitura; layouts Unity reais variam.

Saiba quando relatar o erro de leitura

Relate o problema quando uma entrada pequena e autorizada continuar produzindo o mesmo erro depois de uma cópia limpa, um caminho controlado e uma build estável oficial. Um bom relatório explica o que o importador alcançou, o que era esperado e qual é o menor passo que reproduz a falha. Ele não precisa de uma pasta completa nem da afirmação de que todas as versões Unity são afetadas.

Descreva o ambiente sem expor dados privados: sistema e arquitetura, versão e canal do AssetRipper, tipo e tamanho aproximado, pista do Unity, grupo de dependências, nível da pasta selecionada e trecho exato do log. Diga se outro arquivo da mesma fonte funciona. Isso ajuda os mantenedores a distinguir cópia danificada, formato sem suporte, complemento ausente, permissão e regressão do parser.

Nunca anexe arquivos proprietários, credenciais, caminhos pessoais, conteúdo criptografado ou dados que você não possa compartilhar legalmente. Se a entrada precisar ficar privada, forneça um log redigido e pergunte quais metadados são seguros. O objetivo é um sinal técnico reproduzível, não redistribuir a fonte.

  • Versão do AssetRipper, canal, sistema operacional e arquitetura do processador
  • Extensão exata, tamanho aproximado, tipo da fonte e nível da pasta selecionada
  • Se o arquivo foi extraído completamente e se um segundo arquivo da fonte funciona
  • Primeiras linhas de erro ou aviso, removendo caminhos e identificadores privados
  • Uma comparação controlada: cópia limpa, build oficial, dependências ou destino gravável
  • O esperado, o observado e a menor reprodução autorizada que você consegue descrever
FAQ DE ERRO DE LEITURA

Perguntas sobre o erro do AssetRipper ao ler o arquivo de assets

O que significa o erro do AssetRipper ao ler o arquivo de assets?

O importador alcançou um arquivo candidato, mas não conseguiu analisar uma parte. Pode ser cópia incompleta, tipo errado, dados Unity sem suporte, dependência ausente, permissão ou limite do parser. Preserve arquivo e log antes de mudar o teste.

Devo baixar o arquivo novamente?

Sim, se a cópia estiver truncada, tiver zero bytes, for menor que o esperado ou o extrator tiver informado erro. Faça uma cópia autorizada nova, preserve a original, extraia e compare a mesma entrada pequena.

Posso renomear .file para .assets?

Não. O nome não altera os bytes nem o formato do contêiner. Use o layout da fonte e os logs, sem deduzir suporte pela extensão genérica.

Uma diferença de versão do Unity pode causar o erro?

Pode ser uma pista, não uma prova. Anote a versão, consulte notas oficiais e teste a mesma entrada com outra build oficial, mantendo destino e dependências constantes.

Por que o arquivo funciona apenas com os arquivos vizinhos?

Os dados podem referenciar recursos, fluxos, bundles ou assemblies compartilhadas. Restaure o menor grupo original e adicione uma dependência por vez para identificar o que o parser precisa.

O que devo enviar em uma issue do AssetRipper?

Inclua versão, sistema, tipo e tamanho aproximado, pista Unity, mensagem exata, linhas relevantes, nível do caminho e uma reprodução pequena autorizada ou descrição redigida. Remova caminhos privados e arquivos protegidos.