Solução de problemas
Erros comuns das plataformas
Como corrigir erros nos resultados do Codexe: plugins que não carregam, crashes de mods, datapacks sem efeito, erros do Skript e por que mods usam Java 21 para Java 17.
Atualizado
Nesta página
#Plugins
| Sintoma | Solução |
|---|---|
O plugin não aparece em /plugins | Procure o nome do plugin no log de inicialização. "Invalid plugin.yml" ou "main class not found" significa que o descritor está errado: peça ao chat para corrigir o plugin.yml. |
| "Unsupported API version" | O plugin foi compilado para uma API do Minecraft mais nova que a do seu servidor. Diga a versão do seu servidor e peça um novo build para ela. |
NoClassDefFoundError citando outro plugin | Uma dependência (Vault, PlaceholderAPI, …) não está instalada. |
Funciona depois de reiniciar, quebra depois de /reload | Muitos plugins não suportam /reload. Reinicie o servidor. |
#Mods
| Sintoma | Solução |
|---|---|
| O jogo trava em um servidor dedicado | Código exclusivo do cliente no código comum ou principal. Peça ao chat para separar o código do cliente. |
| "Incompatible mod set" / versão errada do jogo | O mod foi feito para outra versão do Minecraft ou do loader. Informe as duas explicitamente. |
| Dependência ausente na inicialização (Fabric) | Instale a Fabric API (e qualquer outra dependência listada) em mods/. |
#Por que o meu mod compila com Java 21 se ele usa Java 17?
Nas versões do Minecraft anteriores à 1.20.5, um mod usa Java 17. A ferramenta de build do Fabric (Loom), porém, só roda no Java 21 ou mais recente. O Codexe roda o Gradle com Java 21, mas continua compilando o seu mod para Java 17, então o JAR funciona em um servidor ou cliente com Java 17. Isso é esperado, e é por isso que o log de build de um mod Fabric 1.20.1 cita o Java 21.
#Datapacks
| Sintoma | Solução |
|---|---|
/datapack list não mostra o datapack | O ZIP precisa ter o pack.mcmeta no nível mais alto, dentro de world/datapacks/. |
| Carregado, mas uma receita ou função não faz nada | pack_format ou nomes de pastas errados para a sua versão. Diga a versão exata do seu Minecraft. |
#Skript
| Sintoma | Solução |
|---|---|
Erros de análise no /sk reload | Normalmente falta um add-on. Confira quais add-ons o script usa (pergunte ao chat se não tiver certeza) e instale-os. |
Uma expressão como player's balance não existe | Instale o Vault e um plugin de economia. |