Quando um relatório de erro do Minecraft Java Edition indicar uma exceção IndexOutOfBoundsException , comece com o relatório de erro mais recente e, em seguida, teste um perfil limpo que utilize a mesma versão do jogo. A exceção significa que o código tentou ler um item em uma posição inválida em uma lista, array ou estrutura similar. Ela não identifica o mod com defeito por si só e não é automaticamente um sinal de que seu mundo está corrompido ou que você precisa de mais RAM. Faça um backup do seu mundo antes de testar, use o rastreamento de pilha para restringir a causa e altere uma variável por vez.
Em Java, `IndexException`IndexOutOfBoundsException é uma exceção de tempo de execução lançada quando um índice está fora do intervalo válido para uma estrutura de dados. Por exemplo, uma lista com 12 entradas possui posições de 0 a 11; tentar ler a posição 12 está fora desse intervalo. A redação exata em um relatório do Minecraft pode variar de acordo com a versão do Java e o código que lança a exceção.
O nome descreve a falha, não a sua origem. Um bug do Minecraft, um mod, uma combinação incompatível de mods, dados carregados de um mundo ou um caminho de carregamento de recursos podem estar envolvidos. Trate afirmações como "adicione RAM", "exclua o mundo" ou "atualize o Java" como suposições até que o relatório ou um teste controlado as confirme.
Feche o jogo e copie a pasta do mundo afetado antes de reabri-lo. Mantenha a cópia fora do savesdiretório ativo e não execute ferramentas de reparo de mundo na única cópia. Anote o que aconteceu imediatamente antes da falha: iniciar o jogo, entrar em um servidor, abrir um mundo, mudar de dimensão, carregar uma área específica ou recarregar um pacote de recursos. Esses detalhes ajudarão você a reproduzir a falha posteriormente.
Os relatórios de falhas geralmente são armazenados na crash-reportspasta dentro do diretório do jogo. Os locais padrão comuns são %appdata%\.minecraft\crash-reportsno Windows, ~/Library/Application Support/minecraft/crash-reportsno macOS e ~/.minecraft/crash-reportsno Linux. Um diretório de jogo personalizado ou um inicializador de terceiros pode usar um local diferente; abra a pasta da instância a partir desse inicializador. Se nenhum relatório de falha foi gerado, preserve-o, logs/latest.logassim como a saída do console do inicializador.
No relatório de falha , encontre a linha da exceção e leia os frames da pilha próximos. Procure também pelo Caused by:nome da thread ou tarefa mencionados no relatório e por qualquer classe ou método que inclua um ID de módulo. Essas pistas podem indicar o código envolvido na falha, mas um módulo mencionado no rastreamento nem sempre é a única causa subjacente; outro módulo pode ter fornecido dados incompatíveis ou alterado o mesmo caminho de código.
Inicie um perfil sem mods com a mesma versão exata do Minecraft e reproduza o mesmo tipo de ação em um novo mundo de teste. Mantenha o perfil e o arquivo de salvamento originais intactos. Se o perfil sem mods funcionar enquanto o perfil com mods apresentar falhas, investigue um possível conflito de mods , o carregador, as dependências e a configuração. Se ambos os perfis apresentarem falhas, o problema pode estar na instalação do jogo, no caminho de carregamento de gráficos ou recursos, ou em um bug específico da versão do jogo; a exceção por si só não permite distinguir essas possibilidades.
Se o problema ocorrer apenas em um mundo existente, teste uma cópia desse mundo e observe se a falha está relacionada a um local, entidade ou pacote de dados específico. Evite salvar um mundo após abri-lo sem os mods dos quais ele depende: o conteúdo ausente dos mods pode ser removido ou alterado quando um mundo é carregado e salvo.
Verifique se todos os mods são compatíveis com a sua versão exata do Minecraft e com o loader que você usa, como Fabric, Forge ou NeoForge. As APIs e dependências necessárias também devem ser compatíveis. Para testar, mova os arquivos JAR dos mods da modspasta ativa para uma pasta separada, como mods-disabled; não os exclua. Inicie o mesmo perfil e repita a ação. Se o problema parar, restaure os arquivos em pequenos grupos até que o erro retorne e, em seguida, identifique o último grupo. Atualize ou remova apenas o componente incompatível e siga as instruções da página de lançamento do autor ou do mantenedor do pacote de mods.
Não misture mods criados para carregadores diferentes e não assuma que a versão mais recente de um mod seja compatível com uma versão mais antiga do jogo. Se a causa do problema for uma recarga de recursos, desative temporariamente o pacote de recursos relevante em um perfil copiado e compare a seção de recarga do relatório.
| O que você observa | O que verificar a seguir |
|---|---|
| O perfil limpo funciona; o perfil modificado trava. | Carregador, versões dos mods, APIs necessárias e combinações de mods. Reintroduza os mods em pequenos grupos. |
| O acidente ocorre em um mundo, mas não em um novo mundo de testes. | Uma cópia do arquivo de salvamento, pacotes de dados, blocos ou entidades dependentes de mods e a localização indicada perto do contexto da falha. |
| O relatório aponta para problemas de renderização ou recarga de recursos. | Teste os componentes gráficos, de shaders ou de pacotes de recursos um de cada vez em um perfil copiado. |
| Apenas o modo multijogador desencadeia a falha. | Peça ao dono do servidor para inspecionar o relatório do servidor e comparar as versões do cliente, servidor, carregador e mods. |
| Nenhum relatório de acidente foi exibido. | Salve o último registro do jogo e a saída do inicializador; eles podem conter o último erro antes do processo ser encerrado. |
Uma incompatibilidade no ambiente de execução Java pode impedir a inicialização de uma versão do Minecraft ou de um carregador de mods, mas alterar a versão do Java não é uma solução geral para uma exceção de índice. Siga os requisitos específicos da versão e do inicializador. Por exemplo, as notas de lançamento do Minecraft Java Edition 1.20.5 da Mojang indicam que esta versão requer o Java 21 e inclui o Microsoft OpenJDK 21.0.3. Esse é um requisito específico da versão, não uma prova de que todas as versões do Minecraft precisam da mesma instalação separada do Java. Se você usa o inicializador oficial, teste primeiro o ambiente de execução padrão incluído; inicializadores e servidores personalizados devem seguir seus próprios requisitos de versão.
Da mesma forma, alocar memória extra não corrige um índice inválido de lista ou array. Aumente a memória somente quando o log realmente reportar um problema de memória, como por exemplo, ` OutOfMemoryError<exception>`. Não exclua todas as pastas de configuração, remova chunks ou edite dados do player com base apenas no nome da exceção.
Ao pedir ajuda a um autor de mod, mantenedor de pacote de mods ou administrador de servidor, inclua a versão do Minecraft, a versão do carregador, a lista de mods relevantes, os passos para reproduzir a falha e o relatório de falha completo ou o log mais recente. Remova primeiro informações privadas, como tokens de conta, endereços de e-mail e caminhos pessoais. Mantenha uma cópia local intacta para que você possa comparar relatórios posteriormente.
A referência da API Java define a exceção, o guia de solução de problemas do Fabric explica onde os relatórios de falhas são armazenados e como ler suas seções, e as notas da Mojang para a versão 1.20.5 documentam os requisitos do Java para essa versão:
Ative a interface de estatísticas de rede do PUBG para monitorar o ping e a perda de pacotes durante uma partida. Veja onde encontrá-la, o que os números significam e o que ela não permite diagnosticar.
Aprenda como carregar o jogo na rota do meio em League of Legends, organizando as ondas de minions, escolhendo janelas seguras para movimentação, lendo as rotas laterais e convertendo a pressão em objetivos.
Corrija problemas com a magia Evoker do Minecraft com um teste seguro no jogo base, verificação de versões, análise de logs e um método passo a passo para isolar conflitos de mods ou datapacks.
As melhores configurações de filtro visual para Dead by Daylight começam com um pequeno aumento de gama, cores e contraste neutros e uma rápida verificação de cantos escuros, neblina e luzes brilhantes.
Corrija o problema de Brawl Stars travado em 92% de carregamento com uma lista de verificação em ordem para avisos de serviço, testes de rede, atualizações seguras, cache do Android e reinstalação segura da conta.
Encontre os campos de aplicativos Steam e EA para as opções de inicialização do Apex Legends, use o comando FPS documentado da EA e veja por que +exec autoexec.cfg permanece não verificado.
Reduza o atraso de entrada no dock do Nintendo Switch para Smash Ultimate com o Modo Jogo para TV, um teste HDMI direto, verificações de controle e solução de problemas de latência online.
Encontre as melhores configurações de áudio do EA SPORTS FC para um apito do árbitro mais nítido: ajuste o Ambiente do Estádio e os Comentários e, em seguida, resolva problemas de saída ou sincronização.
Encontre a melhor configuração de proporção de tela para Clash Royale em tablets, compare as opções de ajuste de tela do Android e verifique o enquadramento em tela cheia no iPad sem cortar a arena.
Corrija o erro 6068 do Warzone Dev na inicialização com verificações seguras do PC para atualizações, overlays, drivers gráficos, reparo de arquivos do jogo e solução de problemas de inicialização limpa.
