Como instalar plugins no seu servidor Minecraft Paper, Spigot ou Purpur

Plugins são a forma de estender um servidor Paper, Spigot ou Purpur com novos comandos, mini-jogos, geração de mundo, ferramentas anti-grief, sistemas de economia e quase tudo o que você possa imaginar. O processo de instalação é o mesmo para todos os três: coloque um .jar na pasta plugins/, reinicie o servidor e configure-o. Este guia detalha o fluxo de trabalho no ServerPrism e aponta as armadilhas que os novos proprietários de servidores enfrentam.

Certifique-se de que seu servidor pode executar plugins

Plugins só funcionam em software de servidor que implementa a API Bukkit. Isso inclui Paper, Spigot, Purpur e Folia — mas não o Minecraft vanilla, Forge, NeoForge ou Fabric. Esses servidores de carregadores de mods usam mods (arquivos .jar em mods/), que é um sistema diferente.

No ServerPrism, abra a aba Startup do seu servidor no painel e confirme se a linha Server Jar mostra algo como paper-X.X.jar, spigot-X.X.jar ou purpur-X.X.jar. Se você vir vanilla, forge ou fabric em vez disso, os plugins não carregarão — você precisaria reinstalar como Paper primeiro (Configurações → Reinstalar após trocar o egg).

Verifique também se o plugin que você deseja suporta sua versão exata do Minecraft. Um plugin feito para 1.20 nem sempre funcionará em 1.21.

Encontre um plugin

Estes são os principais lugares para procurar:

• Modrinth — UI limpa, filtragem por versão, o padrão moderno.
• Hangar — o repositório oficial do PaperMC.
• SpigotMC — o maior catálogo, mas a qualidade varia. Leia as avaliações.
• BukkitDev — mais antigo, mas ainda hospeda plugins não republicados em outros lugares.

Em cada site, filtre pela sua versão do Minecraft e baixe o .jar (ou .zip se vier com configurações — extraia primeiro, você quer o .jar).

Faça upload e carregue o plugin

1. Faça login no seu painel ServerPrism e abra seu servidor.
2. Clique em File Manager na barra lateral.
3. Abra a pasta plugins/.
4. Arraste o .jar para a pasta, ou clique em Upload.
5. Reinicie o servidor na aba Console. Plugins são descobertos apenas na inicialização.

Você pode instalar vários plugins de uma vez — basta colocar vários arquivos .jar antes de reiniciar.

Verifique se carregou

Depois que o servidor iniciar, execute /plugins no chat do jogo ou na aba Console do painel. O nome do plugin deve aparecer em verde. Se estiver vermelho, o plugin falhou ao carregar — abra o log mais recente em logs/latest.log e procure pela primeira linha ERROR. Geralmente, ele informa se você tem a versão errada, uma dependência ausente ou um tipo de servidor incompatível.

Configure-o

A maioria dos plugins gera um config.yml dentro de plugins/<plugin-name>/ na primeira inicialização. Edite-o através do File Manager e reinicie o servidor para que as alterações entrem em vigor.

Alguns plugins suportam /reload <plugin-name> para aplicar alterações sem uma reinicialização completa. Use-o apenas quando a própria documentação do plugin o recomendar explicitamente — reload é conhecido por causar bugs sutis (manipuladores de eventos quebrados, tarefas vazadas) em plugins que não o esperam.

Problemas comuns

• Plugin não aparece em /plugins: o software do servidor não é compatível com Bukkit (você tem Forge/Fabric/vanilla), ou o .jar está corrompido ou incompleto — baixe-o novamente.
• UnsupportedClassVersionError no console: o plugin foi compilado para uma versão Java mais recente do que a que seu servidor está executando. Verifique a versão Java necessária do plugin e altere a imagem Docker do seu servidor na aba Startup (java_17, java_21).
• NoClassDefFoundError: um plugin de dependência está faltando. A maioria dos plugins lista suas dependências em sua página de download — instale-as também.
• Avisos de incompatibilidade de versão: um plugin 1.20 em 1.21 pode "funcionar", mas quebrar aleatoriamente. Use a versão feita para sua versão do Minecraft.
• Servidor com lag após a instalação: alguns plugins são pesados. Desative-os um por um (mova o .jar para fora de plugins/, reinicie) para encontrar o culpado.

Plugins populares para começar

• LuckPerms — permissões e ranks, usado por quase todos os servidores.
• EssentialsX — casas, warps, kits, fundamentos de economia. A caixa de ferramentas clássica.
• CoreProtect — registro de blocos e rollback, salva vidas contra griefing.
• WorldEdit + WorldGuard — proteção de região e edição de mundo em massa.
• ViaVersion — permite que jogadores em clientes Minecraft mais antigos entrem no seu servidor mais novo.

Próximos passos

Depois de se sentir confortável instalando plugins, configure um sistema de permissões com LuckPerms e crie o hábito de fazer backup do seu diretório plugins/ antes de adicionar algo novo — um plugin mal configurado pode apagar as configurações ao desligar. Backups estão a um clique de distância na aba Backups do seu painel.