Instalar um plugin no Minecraft é copiar um arquivo para dentro do servidor e reiniciar. O que costuma dar errado não é o upload — é a pasta errada, a versão errada ou o protocolo errado no programa de FTP.
Este guia resolve os três, para servidores Java hospedados no nosso painel.
Antes de tudo: plugin e mod não são a mesma coisa
Essa confusão é a causa da maior parte dos servidores que não sobem depois de uma instalação. O arquivo é .jar nos dois casos, mas eles não são intercambiáveis:
| Plugin | Mod | |
|---|---|---|
| Roda em | Paper, Spigot, Purpur, Bukkit | Forge, NeoForge, Fabric |
| Pasta | plugins/ |
mods/ |
| O jogador precisa instalar algo? | Não | Sim — o cliente precisa do mesmo mod |
Um plugin colocado na pasta mods/ não carrega. Um mod na pasta plugins/ também não. E se o seu servidor é Paper, ele não roda mods — nem se você criar a pasta.
Não sabe qual é o seu? Abra o servidor no painel e olhe o tipo dele. Paper, Purpur e Spigot são plugins. Forge, NeoForge e Fabric são mods.
Conectando por SFTP
É SFTP, não FTP. Este é o erro número um. O painel usa SFTP (SSH File Transfer Protocol) na porta 2022 — não o FTP comum da porta 21. Se você escolher "FTP" no FileZilla, a conexão vai falhar e a mensagem não vai explicar por quê.
Onde pegar os dados
Entre no painel em pelican.vitthost.com.br, abra o seu servidor e procure os dados de SFTP. O painel mostra o endereço e o usuário já prontos — copie de lá, não digite de cabeça. O endereço muda conforme o nó em que a sua máquina está, e o usuário tem o identificador do servidor no fim.
O que você vai usar:
| Campo | Valor |
|---|---|
| Protocolo | SFTP — SSH File Transfer Protocol |
| Host | o que o painel mostrar (nossos nós são node-01.br.vitthost.com.br e node-02.br.vitthost.com.br) |
| Porta | 2022 |
| Usuário | o que o painel mostrar — tem o formato seu-usuario.identificador |
| Senha | a mesma senha que você usa para entrar no painel |
A senha não é gerada nem exibida em lugar nenhum: é a do painel. Se você trocar a senha do painel, a do SFTP muda junto.
No FileZilla
- Abra Arquivo → Gerenciador de sites → Novo site.
- Em Protocolo, escolha SFTP - SSH File Transfer Protocol.
- Preencha host, porta 2022, usuário e senha.
- Clique em Conectar.
Na primeira conexão aparece um aviso sobre a chave do servidor — é normal, aceite. Se quiser, marque a opção de confiar sempre para não ver de novo.
Enviando o arquivo
Conectado, você cai na raiz do servidor. É a pasta onde ficam server.jar, server.properties, eula.txt e as demais.
Para plugin (Paper, Spigot, Purpur):
- Entre na pasta
plugins/. - Arraste o
.jarpara dentro. - Reinicie o servidor pelo painel — não pelo comando
/reload.
Para mod (Forge, NeoForge, Fabric):
- Entre na pasta
mods/. - Arraste o
.jarpara dentro. - Reinicie pelo painel.
- Instale o mesmo mod no seu cliente, na mesma versão. Sem isso você não consegue entrar.
Se a pasta plugins/ ou mods/ não existir, é sinal de que o servidor ainda não subiu nenhuma vez com esse tipo. Ligue o servidor uma vez, desligue, e a pasta aparece.
Três conferências que evitam a maioria dos problemas
1. A versão do Minecraft bate? Um plugin feito para a 1.20 normalmente não carrega na 1.21. A página de download sempre diz para quais versões ele serve.
2. Fabric precisa da Fabric API. Quase todo mod de Fabric depende dela. É um arquivo separado, vai na mesma pasta mods/, e sem ele o servidor derruba na inicialização.
3. O arquivo é .jar mesmo? Se você baixou um .zip, provavelmente é um modpack ou um pacote de recursos — não vai na pasta de mods do jeito que está.
Quando o servidor não sobe depois
Não fique adivinhando: o console do painel diz o motivo. Ligue o servidor, abra o console e leia as últimas linhas antes de ele parar.
As mensagens mais comuns:
Unsupported class file major version— o Java do servidor é mais antigo que o exigido pelo plugin. Troque a versão do Java nas configurações do servidor no painel.Could not load pluginou o plugin some da lista — a versão do plugin não combina com a do servidor.Mixin apply failed(Fabric) — falta a Fabric API ou dois mods estão brigando.- Cai sem mensagem clara — tire o último arquivo que você colocou, suba de novo e confirme que era ele.
Regra prática: um de cada vez. Instale um plugin, suba o servidor, confirme que funcionou, e só então instale o próximo. Quando cinco entram juntos e o servidor quebra, você perde mais tempo descobrindo qual foi do que teria perdido testando um a um.
Para um ou dois arquivos, nem precisa de FTP
O painel tem um gerenciador de arquivos embutido, com upload direto pelo navegador. Para subir um plugin ou editar um .yml rapidinho, é mais rápido que abrir o FileZilla.
O SFTP compensa quando você vai mover muita coisa de uma vez, baixar o mundo inteiro para backup ou trabalhar com uma pasta grande de mods.
Antes de mexer, tenha cópia
Plugin novo pode corromper mundo, apagar configuração ou conflitar com outro. Baixe uma cópia da pasta do mundo antes de instalar qualquer coisa que mexa com geração de terreno ou com dados de jogador.
A responsabilidade pela cópia de segurança é sua, conforme a cláusula 14 dos Termos de Uso.
Outros tutoriais desta série:
- Minecraft Bedrock: como enviar addons
- MTA:SA: como enviar resources
- open.mp: como enviar gamemodes e plugins
Precisa de um servidor? Veja os planos de Minecraft. Se a dúvida for específica da sua máquina, abra um ticket que a gente olha junto.
