Como resolver o erro de carregamento do plugin Minecraft? Guia de plug-ins Bukkit, Spigot e Paper

versão da API não suportada, O Minecraft não conseguiu carregar o plugin, erro de plug-in spigot, erro plugin.yml, plugin de papel não funciona, Plugin do minecraft não carrega, dependência do plugin minecraft 0 9

Yazdır

Como resolver o erro de carregamento do plugin Minecraft?

Guia detalhado para erros de Bukkit, Spigot, Paper, dependência e versão de API não suportada.

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.

Os erros de plug-in geralmente ocorrem na consola ou logs/mais recentes. log aparece no ficheiro. 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.

Explicação simples: Plugin é um pacote de recursos adicionado posteriormente ao servidor. Para que o plugin funcione, deve existir a versão correta do Minecraft, a versão correta do Java e as dependências necessárias.

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

Se o plugin não estiver a carregar, o primeiro lugar a procurar é a consola do servidor e o ficheiro Latest.log.

tail -n 200 logs/latest.log

Para rastreio ao vivo:

tail -f logs/latest.log

Para pesquisar pelo nome do plugin:

grep -i "pluginadi" logs/latest.log

2. Erro de versão da 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 o 1.20, mas o seu servidor pode estar a correr o 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.
Descarregue a versão do plugin compatível com a versão do seu servidor.
Não espere que os novos plugins funcionem em servidores muito antigos.
Se necessário, encontre a versão apropriada no ficheiro da versão antiga do plugin.

3. Erro de dependência desconhecido

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

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

Por exemplo, os plug-ins económicos geralmente Cofre quer. Os plug-ins de autorização ou de mercado também podem necessitar de outros plug-ins de biblioteca.

Solução:

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

Importante: O comando /reload pode causar problemas com alguns plugins. Uma reinicialização completa é melhor após a instalação e remoção do plugin.

4.º Erro plugin.yml inválido

Dentro do ficheiro jar do plugin plugin.yml Se o ficheiro estiver corrompido, em falta ou incorreto, o plugin não pode ser instalado.

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

Isto ocorre geralmente quando:

O ficheiro errado foi descarregado.
Em vez do plugin, foi colocado o código fonte zip na pasta plugins.
O ficheiro jar está corrompido.
O plugin foi empacotado incorretamente pelo programador.

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

5. Incompatibilidade de versão Java

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

java -version

Erro comum:

UnsupportedClassVersionError

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

Lógica geral:

As versões mais antigas do Minecraft requerem frequentemente Java mais antigo.
As 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 alojamento deve ser verificada.

6.º O ficheiro do plugin está na pasta correta?

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

ls plugins/

O ficheiro do plugin deve ficar assim:

plugins/PluginAdi.jar

Os 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 entre si. Por exemplo, dois plug-ins de chat diferentes, dois plug-ins de poupança diferentes ou dois sistemas de reclamações diferentes podem tentar gerir os mesmos eventos.

Sintomas de conflito:

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

Para encontrar uma solução, os plug-ins podem ser testados desativando-os um a um. No entanto, antes de o fazer no servidor live, deve ser feito um backup 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 existir um erro YAML no ficheiro de configuração. Os recuos de espaços em branco são especialmente importantes nos ficheiros YAML.

Erros comuns:

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

Se existir um ficheiro de configuração incorreto, a pasta do plugin pode ser renomeada temporariamente para fazer uma cópia de segurança da pasta do plugin e recriar a configuração.

Erros Comuns

Instalação de plugins que não são compatíveis com a versão do servidor
Não instalar plug-ins de dependência em falta
Confundir o ficheiro zip de origem do GitHub com um plugin
Não verificar a versão do Java
A tentar instalar um plugin com /reload
Utilização de separadores em arquivos de configuração YAML

Perguntas frequentes

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

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

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

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

Descarregue plug-ins de fontes fidedignas.
Antes de adicionar o plugin ao servidor ativo, experimente-o no servidor de teste.
Faça uma cópia de segurança da pasta de plug-ins antes de cada atualização de plug-in.
Reduza a superfície de ataque removendo os plug-ins desnecessários.
Verifique os logs do plugin regularmente.

Este artigo foi preparado especialmente para o PvPServer.

Bu cevap yeterince yardımcı oldu mu?

Oyla