Como instalar, atualizar e remover plugins com segurança

Plugins são o que tornam cada servidor único. Mas um plugin mal instalado pode causar erros, lag ou até comprometer a segurança do servidor. Siga estas práticas.

Onde baixar

Apenas de fontes confiáveis:

• Modrinth e Hangar (repositório oficial do PaperMC);
• SpigotMC (seção de resources);
• Site oficial / GitHub do desenvolvedor.

Nunca use versões "crackeadas" de plugins pagos — elas são uma das principais formas de instalar backdoors que dão controle do servidor a terceiros.

Antes de instalar

• Confira se o plugin é compatível com a versão do servidor e com o software (Paper, Purpur, Folia);
• Verifique dependências (ex.: Vault, ProtocolLib, PlaceholderAPI);
• Veja a data da última atualização — plugins abandonados podem dar problema;
• Faça backup.

Instalando

1. Pare o servidor (recomendado);
2. Envie o .jar para a pasta plugins/ (gerenciador de arquivos do painel ou SFTP);
3. Inicie o servidor;
4. Verifique no console se o plugin carregou sem erros;
5. Confira com o comando plugins — o plugin deve aparecer em verde;
6. Ajuste o arquivo de configuração criado em plugins/NomeDoPlugin/ e recarregue (muitos plugins têm /plugin reload) ou reinicie.

Evite /reload

O comando /reload do servidor recarrega todos os plugins e pode causar vazamentos de memória e comportamentos estranhos. Prefira:

• O comando de reload do próprio plugin para configs;
• Reiniciar o servidor para instalar/atualizar plugins.

Atualizando

1. Leia o changelog — algumas atualizações mudam configurações;
2. Faça backup da pasta do plugin;
3. Pare o servidor;
4. Substitua o .jar antigo pelo novo (apague o antigo — dois jars do mesmo plugin causam conflito);
5. Inicie e confira o console.

O Paper também suporta a pasta plugins/update/: jars colocados ali substituem os existentes no próximo início.

Removendo

1. Pare o servidor;
2. Apague o .jar em plugins/;
3. (Opcional) Apague a pasta de configuração/dados do plugin;
4. Verifique se nenhum outro plugin dependia dele;
5. Inicie o servidor.

Diagnosticando problemas

• Plugin em vermelho na lista: não carregou — veja o console;
• Servidor não inicia após instalar: remova o último plugin adicionado;
• Lag após instalar: use o spark para confirmar se o plugin é o responsável.

Crie seu servidor com o Minecraft-BR

No Minecraft-BR da VittHost, você instala e atualiza plugins pelo gerenciador de arquivos ou SFTP do painel Pterodactyl/Pelican. Servidores no Brasil, proteção DDoS e planos para Java e Bedrock.