Como instalar um plugin de Minecraft

Passo a passo

1. 1.Confira se o seu servidor roda plugins

   Os plugins precisam de um software de servidor baseado em Bukkit: Paper, Spigot, Purpur ou Folia para servidores de jogo, BungeeCord ou Velocity para proxies. Um servidor vanilla, ou um servidor Fabric ou Forge, não carrega plugins.

2. 2.Confira a versão do plugin

   A página ou o arquivo do plugin diz quais versões do Minecraft ele suporta. Um plugin compilado para uma versão mais nova que a do seu servidor normalmente se recusa a carregar.

3. 3.Pare o servidor e copie o .jar

   Coloque o arquivo .jar na pasta plugins/, ao lado do .jar do servidor. Em um painel de hospedagem, envie pelo gerenciador de arquivos ou por SFTP. Não descompacte.

4. 4.Instale as dependências

   Se o plugin precisa de outros plugins (Vault, PlaceholderAPI, ProtocolLib, LuckPerms), coloque os arquivos .jar deles em plugins/ também.

5. 5.Inicie o servidor e leia o console

   Procure o nome do plugin no log de inicialização. "Enabling <Plugin>" sem erro depois significa que ele carregou.

6. 6.Confira no jogo e configure

   Use /plugins: os plugins carregados ficam em verde, os que não conseguiram ser ativados ficam em vermelho. As configurações aparecem em plugins/<PluginName>/config.yml; edite e reinicie.

Onde ficam os arquivos

Uma pasta de servidor típica fica assim depois da primeira inicialização com um plugin:

• paper.jar (ou spigot.jar): o próprio servidor.
• plugins/MyPlugin.jar: o plugin que você adicionou.
• plugins/MyPlugin/: uma pasta que o plugin cria, com o config.yml, as mensagens e os dados salvos.
• logs/latest.log: o log da execução atual, onde os erros de carregamento são escritos.

Reinicie, não use /reload

O /reload descarrega e recarrega todos os plugins sem reiniciar o servidor. Muitos plugins não suportam isso: os listeners são registrados duas vezes, dados se perdem ou há vazamento de memória. Sempre reinicie o servidor depois de adicionar, remover ou atualizar um plugin. Alguns plugins têm um comando de reload próprio (por exemplo /myplugin reload) só para a configuração deles: esse é seguro de usar.

Antes de instalar no servidor em produção

• Faça um backup da pasta do servidor, ou pelo menos de plugins/ e dos mundos.
• Teste antes em uma cópia: o mesmo software, a mesma versão e os mesmos outros plugins do servidor real. Veja como testar um plugin.
• Um plugin por vez: se algo quebrar, você sabe qual foi.
• Baixe da página do autor (SpigotMC, Hangar, Modrinth, GitHub), não de reuploads.

Plugins feitos com o Codexe

Um plugin feito no Codexe vem como um .jar compilado com o nome do projeto, verificado antes de você recebê-lo: ele precisa conter as classes compiladas e um plugin.yml. Você pode testá-lo em um servidor de teste privado antes de instalar em qualquer lugar, de graça em todos os planos; o servidor de teste instala para você os plugins listados como dependências. Baixar o .jar para o seu próprio servidor exige um plano ou um pacote de downloads.

Perguntas