Compatibilidade de plugins

Esta página ajuda a resolver erros do tipo UnsupportedClassVersionError,InvalidPluginException, "plugin não carrega", "incompatible", "unsupported" ou plugin que fica desativado (disabled).

Sintomas comuns

• UnsupportedClassVersionError
• has been compiled by a more recent version of the Java Runtime
• InvalidPluginException: Unsupported major.minor version
• Cannot load class ...
• Plugin ... is not compatible with this server version

Causas mais comuns

1. Java do servidor está antigo para o plugin instalado.
2. Plugin é para outra versão do Minecraft.
3. Plugin é para outro core ou exige dependência.
4. Dependência não instalada/atualizada.
5. Arquivo .jar corrompido.

Checklist rápido (ordem recomendada)

1) Confirme versões do servidor

No console (ou via comando), pegue:

• Versão do Minecraft
• Tipo do servidor (Paper/Spigot/Purpur)
• Build/versão do core

Dica: rode /version no console (se disponível).

2) Confirme versão do Java

Veja no log de boot ou no painel do host qual Java está em uso. Se o erro for UnsupportedClassVersionError, a causa quase sempre é Java antigo.

3) Isole qual plugin está falhando

• O stacktrace geralmente cita o plugin ou o .jar.
• Se você instalou vários plugins de uma vez: remova todos e recoloque um por vez.

4) Resolva a incompatibilidade

• Opção A (recomendada): atualize o Java do servidor.
• Opção B: use uma versão do plugin compatível com seu Java/Minecraft.

Evite "forçar" plugin antigo em servidor novo (ou o contrário).

5) Verifique dependências

Alguns plugins exigem outros (Placeholder API, ProtocolLib, Vault etc.).

Como prevenir

• Antes de instalar plugin novo, valide "Supported Minecraft versions" e "Java required".
• Atualize em lote pequeno (1–3 plugins por vez).
• Se for atualizar o Minecraft/Paper, planeje junto com Java e plugins principais.

O que enviar no suporte

1. Mensagem completa do erro (stacktrace inteiro).
2. Versões: Minecraft + tipo do servidor + build e Java em uso.
3. Nome e versão do plugin (e o nome do .jar).
4. Lista de plugins (/plugins).
5. O que você mudou por último.

Links úteis

• Voltar para: Erros comuns
• Se o erro for OutOfMemoryError: OutOfMemory: checklist
• Se o servidor estiver lagando: TPS baixo: checklist