Guia

Como corrigir erros de plugins de Minecraft

Atualizado em 18 de outubro de 2026

Quando um plugin não carrega, o servidor quase sempre diz o motivo: ele está no console durante a inicialização, algumas linhas acima ou abaixo do nome do plugin. Aprenda a ler essa parte do log e a maioria dos erros se resolve em um minuto. Estes são os mais comuns e o que eles significam.

Diga a versão do seu servidor e o que o plugin deve fazer.

Gere isto com o Codexe

Passo a passo

1.Abra o log da inicialização
Leia o console, ou o logs/latest.log na pasta do servidor. Em um painel de hospedagem, use o console ou o gerenciador de arquivos dele.
2.Procure o nome do plugin
Encontre o primeiro erro que o menciona. As linhas que começam com [ERROR] ou [WARN], com um stack trace embaixo, são as que importam.
3.Leia a primeira linha e as linhas "Caused by"
A primeira linha diz o que falhou; a última linha Caused by: normalmente diz o porquê. As linhas com o nome do pacote do próprio plugin mostram em que parte do código dele.
4.Compare com a lista abaixo
A maioria dos erros de inicialização é um problema de versão, de Java ou de dependência, e a mensagem diz qual.
5.Corrija uma coisa e reinicie
Mude uma coisa, reinicie (sem /reload) e leia o log de novo. Erros de um plugin podem causar erros em outros.

Os erros mais comuns

O que você vê	O que significa	Correção
`Unsupported API version 1.21`	O `api-version` do plugin é mais novo que o seu servidor.	Pegue a versão para o seu servidor ou atualize o servidor.
`Could not load 'plugins/X.jar'` com `Invalid plugin.yml` ou `Jar does not contain plugin.yml`	O descritor do plugin está faltando ou tem um erro de YAML, ou o arquivo não é um plugin.	Confira se você baixou o plugin e não o código-fonte, um mod ou um zip. Se foi você que o compilou, corrija o `plugin.yml`.
`UnsupportedClassVersionError`, "class file version 65.0"	O plugin precisa de um Java mais novo que o do servidor (61 = Java 17, 65 = Java 21, 69 = Java 25).	Rode o servidor com esse Java ou recompile o plugin para o seu Java.
`NoClassDefFoundError` ou `ClassNotFoundException`	Falta uma classe de que o plugin precisa: um plugin de dependência não está instalado, uma biblioteca não foi empacotada no .jar ou a API não existe nesta versão.	Instale o plugin citado no erro (Vault, ProtocolLib) ou use um build para a sua versão.
`Unknown/missing dependency plugins`	Um plugin listado em `depend` não está instalado.	Instale-o em `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	O plugin carregou, mas crashou no `onEnable`.	Leia a linha `Caused by`: muitas vezes é um erro de configuração ou uma dependência faltando.
`Ambiguous plugin name`	Há dois arquivos .jar do mesmo plugin em `plugins/`.	Apague o antigo.

Erros que não são de carregamento

O plugin está verde, mas um comando diz "Unknown command": o comando não está no plugin.yml, ou outro plugin usa o mesmo nome.
"I'm sorry, but you do not have permission": o jogador não tem o nó de permissão. Veja o nó na página do plugin e dê a permissão com o seu plugin de permissões.
Erros depois de editar o config.yml: o YAML precisa de espaços, não de tabs, e de aspas em volta de textos que começam com : ou &.
Funciona depois de reiniciar, quebra depois do /reload: o plugin não suporta /reload. Reinicie em vez disso.

Qual Java o seu servidor precisa

O Minecraft 1.20.5 e mais recentes precisam do Java 21, e a 26.x precisa do Java 25; da 1.18 à 1.20.4, do Java 17. Rode java -version com o mesmo Java que o servidor usa (em um painel de hospedagem, normalmente é uma opção chamada imagem Docker ou versão do Java). Um plugin compilado para um Java mais antigo roda em um mais novo, mas não o contrário.

Corrigindo plugins feitos com o Codexe

Os plugins feitos no Codexe são compilados para a versão que você escolheu e têm o plugin.yml verificado antes de ficarem Prontos. Em um servidor de teste, a aba Logs mostra o log ao vivo com os erros destacados, e Exportar logs o salva como arquivo. Descreva o que você vê no chat do projeto ("o plugin está vermelho no /plugins e o log diz ...") e o Codexe muda o código e compila de novo. Se um Compilar falhar em arquivos exatamente como o Codexe os entregou, Corrigir com IA os conserta de graça.

Perguntas

Onde fica o log do servidor?

Em logs/latest.log, na pasta do servidor, para a execução atual. As execuções anteriores ficam na mesma pasta como arquivos .log.gz.

Um plugin pode quebrar outro?

Sim: uma dependência faltando ou quebrada impede todos os plugins que precisam dela. Corrija o primeiro erro do log antes dos outros.

É seguro compartilhar o meu log?

Em geral sim, mas confira antes: os logs podem conter endereços IP e, com alguns plugins, senhas de banco de dados vindas de erros.

Recrie um plugin quebrado para o seu servidor

Este prompt abre pronto para enviar:

“Um plugin para Paper 1.21.4 chamado SimpleWarps que substitui o meu antigo, que não carrega mais: /setwarp, /warp e /delwarp com um nome, /warps lista os warps em uma GUI, permissão warps.admin para criar e apagar, warps salvos entre reinícios, mensagens no config.yml.”