Plugins em servidores Minecraft; Opera o sistema de autorização, economia, proteção, mercado, evento, reivindicação, anti-cheat e muitos sistemas especiais. Se um dos plugins não estiver instalado, uma parte significativa do servidor poderá não funcionar.

Erros de plug-in geralmente ocorrem no console ou logs/mais recentes.log aparece no arquivo. Os erros mais comuns; Não foi possível carregar o plug-in, Versão da API não suportada, dependência desconhecida, Plugin.yml inválido e incompatibilidades de versão Java.

1. Onde você pode ver o erro do plug-in?

Se o plugin não estiver carregando, o primeiro lugar a procurar é o console do servidor e o arquivo last.log.

tail -n 200 logs/latest.log

Para rastreamento ao vivo:

tail -f logs/latest.log

Para pesquisar pelo nome do plugin:

grep -i "pluginadi" logs/latest.log

2. Erro de versão de API não suportada

Este erro indica que a versão da API do Minecraft suportada pelo plugin é incompatível com a versão do servidor.

Unsupported API version 1.20

Por exemplo, o plugin pode estar preparado para 1.20, mas seu servidor pode estar executando 1.16.5. Neste caso, o plugin pode não carregar ou funcionar incorretamente.

Solução:

• Verifique a versão do Minecraft suportada pelo plugin.
• Baixe a versão do plugin compatível com a versão do seu servidor.
• Não espere que novos plugins funcionem em servidores muito antigos.
• Se necessário, encontre a versão apropriada no arquivo da versão antiga do plugin.

3. Erro de dependência desconhecido

Alguns plugins não funcionam sozinhos. Ele pede que outro plugin seja instalado primeiro. Isso é chamado de dependência.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

Por exemplo, plug-ins econômicos geralmente Cofre quer. Plug-ins de autorização ou mercado também podem precisar de outros plug-ins de biblioteca.

Solução:

• Leia os requisitos na página do plugin.
• Baixe o plugin de dependência ausente.
• Certifique-se de que o plugin de dependência também seja compatível com a versão do seu servidor.
• Reinicie o servidor completamente.

4. Erro plugin.yml inválido

Dentro do arquivo jar do plugin plugin.yml Se o arquivo estiver corrompido, ausente ou incorreto, o plugin não poderá ser instalado.

Invalid plugin.yml
Plugin does not contain a plugin.yml

Isso geralmente ocorre quando:

• O arquivo errado foi baixado.
• Em vez do plugin, o código fonte zip foi colocado na pasta plugins.
• O arquivo jar está corrompido.
• O plugin foi empacotado incorretamente pelo desenvolvedor.

Como solução, o plugin está correto. .jar O arquivo deve ser baixado. O source-code.zip baixado do GitHub não deve ser colocado diretamente na pasta de plugins.

5. Incompatibilidade de versão Java

A versão e os plug-ins do Minecraft requerem versões específicas do Java. Se a versão Java errada for usada, o plugin ou servidor pode não abrir.

java -version

Erro comum:

UnsupportedClassVersionError

Este erro indica que o plugin foi compilado com Java mais recente, mas Java mais antigo é usado no servidor.

Lógica geral:

• Versões mais antigas do Minecraft geralmente exigem Java mais antigo.
• Versões mais recentes do Minecraft requerem Java mais recente.
• O requisito Java na descrição do plugin deve ser verificado.
• A versão Java selecionada no painel de hospedagem deve ser verificada.

6. O arquivo do plugin está na pasta correta?

Arquivos de plug-in em servidores Bukkit, Spigot e Paper plug-ins é jogado na pasta.

ls plugins/

O arquivo do plugin deve ficar assim:

plugins/PluginAdi.jar

Plugins deixados em zip, rar, código-fonte ou pastas geralmente não funcionam.

7. Conflitos de plug-ins

Dois plug-ins que fazem o mesmo trabalho podem entrar em conflito um com o outro. Por exemplo, dois plug-ins de chat diferentes, dois plug-ins de economia diferentes ou dois sistemas de reclamações diferentes podem tentar gerenciar os mesmos eventos.

Sintomas de conflito:

• O plugin está instalado mas seus comandos não funcionam.
• Um plugin sobrecarrega a configuração de outro.
• Ocorre um conflito de evento ou exceção no console.
• Os jogadores não podem usar comandos mesmo que tenham permissão.
• O servidor se comporta de maneira diferente após a reinicialização.

Para encontrar uma solução, os plug-ins podem ser testados desativando-os um por um. No entanto, antes de fazer isso no servidor live, um backup deve ser feito e dar preferência a poucas horas de jogo.

8. Erro de configuração pode impedir a abertura do plug-in

Alguns plugins não serão abertos se houver um erro YAML no arquivo de configuração. Os recuos de espaços em branco são especialmente importantes em arquivos YAML.

Erros comuns:

• Usando caractere de tabulação
• Não deixe espaço após os dois pontos
• Escrever texto que requer citações sem aspas
• Corrupção de arquivo devido a caracteres turcos ou símbolos especiais
• Salvando arquivo de configuração ausente

Se houver um arquivo de configuração incorreto, a pasta do plugin pode ser renomeada temporariamente para fazer backup da pasta do plugin e recriar a configuração.

Erros Comuns

• Instalando plugins que não são compatíveis com a versão do servidor
• Não instalar plug-ins de dependência ausentes
• Confundindo o arquivo zip de origem do GitHub com um plugin
• Não verificando a versão do Java
• Tentando instalar um plugin com /reload
• Usando guias em arquivos de configuração YAML

Perguntas frequentes

O plugin está na pasta plugins mas não funciona, por quê?
Pode ser incompatibilidade de versão, dependência ausente, incompatibilidade de Java ou erro de configuração. O arquivo Latest.log deve ser examinado.

O que significa UnsupportedClassVersionError?
O plugin acaba de ser compilado com Java. A versão Java usada no servidor está desatualizada.

É seguro usar/recarregar?
Não é recomendado para muitos plugins. Uma reinicialização completa é mais segura para instalação, remoção de plugins e grandes alterações de configuração.

Recomendações de segurança e operações

• Baixe plug-ins de fontes confiáveis.
• Antes de adicionar o plugin ao servidor ativo, experimente-o no servidor de teste.
• Faça backup da pasta de plug-ins antes de cada atualização de plug-in.
• Reduza a superfície de ataque removendo plug-ins desnecessários.
• Verifique os logs do plugin regularmente.

Este artigo foi preparado especialmente para PvPServer.