Como instalar plugins no Paper, Spigot e Purpur

Os plugins acrescentam recursos ao seu servidor, como casas, claims, ranks ou minigames, e rodam só no servidor. Seus jogadores entram com o jogo normal e não instalam nada. Os plugins funcionam no Paper, no Purpur, no Spigot e, para os poucos que o suportam, no Folia. Se o seu servidor roda Fabric, Forge ou NeoForge, você precisa de mods. Veja Como instalar mods no Forge, Fabric e NeoForge. Para comparar os dois tipos, leia Tipos de servidor Minecraft explicados.

Os plugins têm acesso total ao seu servidor. Instale só plugins de fontes em que você confia e faça um backup antes. Veja Como fazer backup, restaurar e resetar seu mundo Minecraft.

Instale um plugin a partir da aba Modding

A aba Modding busca em vários catálogos de plugins ao mesmo tempo e coloca o arquivo na pasta certa para você.

1. Abra seu servidor no painel e clique em Modding.
2. Clique na aba Plugins. Se você não a vir, seu tipo de servidor não roda plugins. A aba explica isso e indica os tipos que rodam.
3. Digite o nome do plugin em Buscar plugins e pressione Enter. O menu Ordenar por pode ordenar os resultados por Mais baixados ou Atualizados recentemente.
4. Use os filtros à esquerda se precisar. A Fonte pode ser Todas as fontes, Modrinth, CurseForge, Hangar, SpigotMC ou Polymart. A Versão do Minecraft começa na versão do seu próprio servidor.
5. Clique em Instalar na linha que você quer. O painel instala a build mais recente para a versão mostrada no filtro Versão do Minecraft, que começa na versão do seu servidor. Para obter uma build mais antiga, mude esse filtro, ou baixe você mesmo o jar e envie-o, como descrito abaixo. Escolha só uma versão que o seu servidor consiga carregar.
6. Se o plugin precisar de outros plugins para funcionar, uma janela se abre listando-os e o botão diz Instalar 2 arquivos ou algo parecido. Clique nele para instalar o plugin junto com o que ele precisa.
7. Reinicie o servidor para ele carregar o plugin. O painel não o reinicia por você depois de uma única instalação. Veja Como iniciar, parar, reiniciar e forçar a parada do seu servidor.

Os plugins só são lidos quando o servidor inicia, então um plugin que você instalou não faz nada até a reinicialização.

O que significam os selos

Um plugin cuja listagem não indica a sua versão do Minecraft simplesmente é instalado, sem aviso. Muitas vezes ele funciona do mesmo jeito, mas confira o Console depois da reinicialização.

Um servidor Paper aceita plugins listados para Paper, Spigot ou Bukkit. Um servidor Purpur aceita também esses, mais os plugins listados para Purpur. Um servidor Spigot aceita plugins listados para Spigot ou Bukkit, então um plugin feito só para Paper não se instala nele.

Instale um plugin enviando o arquivo

Use isto para um plugin que você mesmo baixou, como um que não está nos catálogos.

1. Baixe o arquivo .jar do plugin na página oficial dele. O Hangar, o site de plugins do próprio Paper, é o lugar que a documentação do Paper recomenda. O Modrinth é outro bom.
2. Abra seu servidor e clique em Files.
3. Abra a pasta plugins.
4. Clique em Enviar e escolha o arquivo .jar. Para muitos arquivos, use SFTP. Veja Como se conectar aos arquivos do seu servidor por SFTP.
5. Reinicie o servidor.

Coloque o jar diretamente dentro de plugins. A documentação do Paper diz que os plugins em subpastas de plugins não são carregados. Alguns plugins são vendidos em sites que não permitem downloads automáticos. Esses você precisa baixar no seu navegador e enviar você mesmo.

Confira se o plugin carregou

1. Abra a aba Console e acompanhe a inicialização. Procure o nome do plugin e as linhas marcadas como erros. O filtro Erros mostra só essas.
2. Quando o servidor estiver Online, digite plugins no Console e pressione Enter. Ele lista os plugins que o servidor conhece. Veja Como usar o console e executar comandos.

Se o plugin não estiver na lista ou o Console mostrar um erro que o cita, o plugin provavelmente foi feito para outra versão do Minecraft ou precisa antes de outro plugin. Leia a página do próprio plugin para saber o que ele precisa.

Mude as configurações de um plugin

A maioria dos plugins cria uma pasta com o próprio nome dentro de plugins na primeira vez que roda, normalmente com um config.yml. Abra-o em Files, edite, salve e reinicie o servidor. A página Configurações do painel não lista arquivos de plugins. Ela lista os arquivos do próprio servidor, como Bukkit Settings, Spigot Settings e Purpur Settings, quando existem.

Atualize e remova plugins

1. Abra Modding, depois Plugins e depois a visualização Instalados.
2. Um plugin com uma build mais recente mostra as duas versões, como 2.9.1 → 2.12.1, e um botão Atualizar. Uma barra no topo oferece atualizar todos de uma vez. Atualizar substitui só o arquivo do plugin e deixa as configurações em paz. O arquivo antigo é removido quando o novo está no lugar.
3. Para remover um, abra o menu ... dele e clique em Desinstalar. Marque Excluir também a configuração e os dados só se você não for usar o plugin de novo. Isso exclui a pasta do próprio plugin, que guarda as configurações e o que ele salvou, como casas ou claims.
4. Reinicie o servidor para a alteração valer.

Nunca mantenha duas versões do mesmo plugin em plugins. O servidor pode se recusar a carregar qualquer uma. O painel remove o arquivo antigo para você quando você atualiza, mas um arquivo que você enviou manualmente é você quem remove.

Se o servidor não iniciar depois de um plugin

1. Abra Files, depois plugins, e exclua o plugin mais recente que você adicionou. Deixe a pasta de configurações dele em paz, caso queira o plugin de volta.
2. Inicie o servidor. Se ele iniciar, o plugin era a causa.
3. Se continuar falhando, restaure o backup que você fez antes. Veja Como criar, baixar e restaurar backups.

Para uma lista completa, leia Como resolver um servidor que não inicia. Os plugins e o lag estão tratados em Como reduzir o lag no seu servidor Minecraft.

Bons plugins para começar

São plugins antigos e muito usados, cada um com a própria página no Modrinth ou no Hangar:

• O LuckPerms gerencia ranks e permissões. Veja Como se dar op e gerenciar permissões.
• O EssentialsX acrescenta os comandos do dia a dia, como casas e warps. Alguns plugins precisam de outro plugin instalado ao lado. O painel lista esses plugins antes de instalar.
• O WorldEdit edita rapidamente grandes partes do mundo, para construtores.

Leia a página de cada plugin para saber as versões do Minecraft que ele suporta antes de instalá-lo.