Guia

Como instalar plugins num servidor de Minecraft.

Os plugins acrescentam funcionalidades a um servidor de Minecraft sem que os jogadores tenham de instalar nada. Este guia explica o software de que precisas, onde obter plugins em segurança, duas formas de os instalar e o que verificar quando um se recusa a carregar.

Confirma que o teu servidor aceita plugins

Os plugins precisam de software de servidor feito para eles. O Paper e o Purpur correm plugins. O servidor vanilla da Mojang não, e o Fabric corre mods, que são outra coisa: os mods normalmente têm de ser instalados também por cada jogador, enquanto os plugins vivem apenas no servidor.

Se o teu servidor é vanilla, muda-o primeiro para Paper. O teu mundo mantém-se. Na StormNodes o software do servidor muda-se a partir do painel.

  • Paper ou Purpur: os plugins funcionam
  • Vanilla: sem plugins, muda para Paper para os usar
  • Fabric: mods em vez de plugins

Transfere plugins de sítios de confiança

Um plugin corre com acesso total ao teu servidor, por isso a origem importa. Fica pelos sites estabelecidos, onde os ficheiros estão associados a um autor identificado e a uma página pública do projeto: SpigotMC, Modrinth e Hangar, que é o site de plugins gerido pelo projeto Paper.

Antes de instalar, confirma que o plugin suporta a tua versão do Minecraft e que foi atualizado recentemente. Evita cópias de plugins pagos publicadas noutros sites. São a forma mais comum de um servidor ficar com uma backdoor instalada.

Instalar a partir do painel da StormNodes

O painel da StormNodes tem um navegador de plugins que pesquisa no SpigotMC e instala diretamente no teu servidor, por isso não tens de transferir nada primeiro para o teu computador.

  • Abre o teu servidor no painel e vai à página de plugins
  • Pesquisa o plugin pelo nome
  • Escolhe instalar e depois reinicia o servidor
  • Escreve plugins na consola para confirmar que carregou

Instalar um plugin à mão

A instalação manual funciona em qualquer alojamento e num servidor gerido por ti. Um plugin é um único ficheiro terminado em .jar.

  • Transfere o ficheiro .jar para a tua versão do Minecraft
  • Pára o servidor, ou prepara-te para o reiniciar a seguir
  • Envia o ficheiro para a pasta plugins através do gestor de ficheiros
  • Arranca o servidor e espera que acabe de carregar
  • Escreve plugins na consola: os plugins carregados aparecem a verde, os que falharam a vermelho

Configurar o plugin

No primeiro arranque, a maioria dos plugins cria uma pasta com o seu próprio nome dentro da pasta plugins, com um ficheiro config.yml lá dentro. Edita esse ficheiro no gestor de ficheiros, guarda e reinicia o servidor, ou usa o comando de reload do próprio plugin, se existir.

Os ficheiros YAML são rigorosos com o espaçamento. Usa espaços, nunca tabulações, e mantém a indentação exatamente como a encontraste. Um único espaço fora do sítio é o motivo mais comum para uma configuração deixar de funcionar.

Um conjunto inicial sensato

Não precisas de muitos plugins. Um servidor pequeno fica bem servido com meia dúzia que são mantidos há anos e usados em dezenas de milhares de servidores.

  • LuckPerms, para cargos e permissões
  • EssentialsX, para homes, warps, kits e comandos do dia a dia
  • WorldEdit, para construir e reparar grandes áreas
  • CoreProtect, para ver quem alterou um bloco e reverter griefing
  • Vault, uma pequena biblioteca de que muitos outros plugins precisam
  • Chunky, para pré-gerar o mundo e evitar lag de exploração

Quando um plugin não carrega

Lê a consola desde o momento em que o servidor arranca. O plugin quase sempre diz o que está errado nas primeiras linhas, e a causa costuma ser uma de quatro.

Reinicia o servidor em vez de usares o comando reload depois de adicionar ou remover plugins. O reload é conhecido por causar fugas de memória e erros estranhos, e os autores de plugins geralmente não lhe dão suporte.

  • Versão errada: o plugin foi feito para outra versão do Minecraft
  • Dependência em falta: precisa de outro plugin, como o Vault, que não está instalado
  • Plataforma errada: o ficheiro é um mod de Fabric ou Forge, não um plugin
  • Configuração estragada: um erro de YAML depois de uma edição; repõe o ficheiro anterior

Atualizar e remover plugins

Para atualizar, substitui o .jar antigo pelo novo e reinicia. Faz um backup primeiro quando atualizares vários de uma vez, para que uma má atualização seja uma reversão de dois minutos e não uma noite perdida.

Para remover um plugin, apaga o seu .jar e reinicia. A pasta de configuração fica, para que as tuas definições sobrevivam se o voltares a instalar. Apaga também essa pasta se tiveres a certeza de que já não precisas dela.

Perguntas frequentes

Plugins de Minecraft: perguntas frequentes

Posso usar plugins num servidor vanilla de Minecraft?
Não. O servidor vanilla da Mojang não tem suporte para plugins. Muda o software do servidor para Paper ou Purpur, que correm os mesmos mundos e acrescentam suporte para plugins.
Qual é a diferença entre um plugin e um mod?
Um plugin corre apenas no servidor e os jogadores entram com o jogo sem modificações. Um mod altera o próprio jogo e normalmente tem de ser instalado por cada jogador, além do servidor. Os plugins correm em Paper e Purpur; os mods correm em loaders como o Fabric.
Os jogadores precisam de instalar os plugins?
Não. Os plugins são instalados apenas no servidor. Os jogadores ligam-se com o Minecraft Java normal e veem logo as novas funcionalidades.
Onde se colocam os plugins num servidor de Minecraft?
Na pasta plugins, no diretório principal do servidor. Envia o ficheiro .jar para lá e reinicia o servidor. Na StormNodes também podes instalar diretamente a partir do navegador de plugins do painel.
Porque é que o meu plugin aparece a vermelho na lista?
Vermelho significa que o plugin não carregou. Verifica a consola desde o arranque do servidor: as causas habituais são um plugin feito para outra versão do Minecraft, uma dependência em falta, como o Vault, ou um erro no ficheiro de configuração.