Mods e plugins expandem o teu servidor Minecraft, mas não funcionam da mesma forma: plugins são feitos para Paper ou Spigot e normalmente funcionam sem instalação no cliente, enquanto mods com Forge ou Fabric muitas vezes precisam estar presentes de forma idêntica no servidor e no PC dos jogadores. O que importa é a versão do Minecraft, o software do servidor, as dependências e um teste limpo após cada reinício.
Plugins ou mods: escolher a base certa
Antes de enviares ficheiros, define o objetivo que queres alcançar. Se queres adicionar permissões, pontos de home, regiões protegidas, economia, moderação ou ferramentas de administração, os plugins Paper/Spigot são, na maioria das vezes, o caminho certo. Se queres adicionar novos blocos, biomas, sistemas técnicos, mobs ou mecânicas de jogo mais profundas, normalmente precisas de mods Forge ou Fabric.
| Recurso | Plugins (Paper/Spigot) | Mods (Forge/Fabric) |
|---|---|---|
| Instalação | Simples: JAR em /plugins | JAR em /mods |
| Cliente necessário? | Não | Sim, mesmos mods necessários |
| Desempenho | Melhor | Variável |
| Compatibilidade | Alta | Pode haver conflitos |
| Exemplos | EssentialsX, WorldEdit | OptiFine, Biomes O Plenty |
A documentação oficial do Paper descreve o Paper como software de servidor para Minecraft: Java Edition e, para plugins, remete entre outros para o ecossistema PaperMC. Uma fonte primária óbvia para plugins Paper é, por isso, o Hangar da PaperMC. Para gestão adicional de plugins, também combina bem o guia interno aprofundado Instalar e gerir plugins do Minecraft no painel.
Requisitos antes da instalação
Verifica primeiro a versão do Minecraft instalada no teu servidor. Um plugin ou mod tem de ser compatível com essa versão e com o software de servidor escolhido. Um ficheiro para outra versão major às vezes até pode iniciar, mas não deve ser considerado estável.
Para o servidor antes de trocares ficheiros JAR. Cria ou verifica um backup atual do mundo, da configuração e da pasta de plugins ou mods. Especialmente em setups Forge e Fabric, um único conflito de versão pode impedir que o servidor arranque completamente.
Presta também atenção às dependências. Alguns plugins precisam de libraries adicionais ou plugins base como Vault. Alguns mods precisam de Fabric API, Cloth Config ou outras mod libraries. Estas indicações normalmente estão na página do projeto da respetiva extensão.
Instalar plugins com Paper ou Spigot
- Transfere o plugin a partir do Hangar ou do Modrinth.
- Vai ao teu dashboard do servidor na game-serverhosting.
- Navega até à aba Mods & Plugins.
- Procura o plugin pretendido e clica em Instalar, se estiver disponível no painel.
- Reinicia o servidor.
Em alternativa, podes enviar manualmente o ficheiro JAR para a pasta /plugins. Depois do reinício, o plugin normalmente cria automaticamente um ficheiro de configuração na sua própria subpasta. Abre esse ficheiro apenas depois de o servidor ter iniciado uma vez com o plugin, caso contrário muitas vezes faltam valores padrão.
Plugins recomendados para iniciantes continuam a ser ferramentas base típicas, mas instala apenas o que realmente precisas:
EssentialsX – Funções básicas (Home, Warp, Kits)
LuckPerms – Sistema de permissões
WorldGuard – Proteção de regiões
Vault – Sistema de economia
CoreProtect – Registo de blocos / anti-grief
Depois da instalação, não testes apenas se o servidor arranca. Verifica no jogo pelo menos um comando do plugin, a atribuição de permissões e a saída da consola. Se um plugin for carregado, mas os comandos estiverem bloqueados, o problema muitas vezes está nas permissões ou em dependências em falta.
Instalar mods com Forge ou Fabric
- Garante que o teu servidor está a correr com Forge ou Fabric.
- Transfere o mod a partir do Modrinth ou do CurseForge.
- Envia o JAR para a pasta
/mods. - Importante: Todos os jogadores precisam de ter os mesmos mods instalados.
- Reinicia o servidor.
Com mods, a igualdade de versões é especialmente importante. Servidor, cliente dos jogadores, modloader e ficheiros dos mods têm de combinar. Se um jogador vir uma lista de mods ou uma mensagem de erro de registry ao ligar, normalmente falta um mod no cliente, está instalada outra versão ou o cliente usa o loader errado.
Instala novos mods passo a passo. Inicia o servidor após poucas alterações e verifica a consola. Assim encontras conflitos mais rapidamente, em vez de já não saberes, depois de 30 ficheiros novos, qual mod impede o arranque. Se trabalhas com modloaders com frequência, fluxos semelhantes também te ajudam noutros jogos, por exemplo no guia Instalar mods do Valheim com BepInEx ou em Mods do V Rising com BepInEx.
Verificar o resultado
Depois do reinício, a consola é o teu primeiro ponto de verificação. Procura mensagens como ERROR, WARN, Could not load, Missing dependency ou indicações de versão. Nem todos os avisos são críticos, mas tens de corrigir falhas de arranque, plugins desativados e classes em falta.
No jogo, verifica em seguida funções concretas: o mundo carrega corretamente? Os jogadores conseguem entrar? Os novos comandos funcionam? Novos blocos, itens ou menus são apresentados? Em plugins, testa também permissões e grupos. Em mods, pelo menos um jogador deve conseguir ligar com exatamente o mesmo modpack.
Troubleshooting de erros frequentes
O plugin não carrega: Verifica a versão do Minecraft e se o plugin é adequado para Paper/Spigot. Um mod Forge não funciona como plugin Paper, mesmo que ambos os ficheiros sejam JAR.
O servidor não arranca: Verifica a consola à procura de mensagens de erro. Frequentemente faltam dependências, um ficheiro foi criado para outra versão do Minecraft ou duas extensões substituem a mesma função.
Conflito de mods: Remove mods individualmente ou em pequenos grupos para encontrar o conflito. Começa pelos ficheiros instalados por último e reinicia após cada alteração.
Os jogadores não conseguem ligar: Compara o modloader, a versão do Minecraft e os ficheiros dos mods entre servidor e cliente. Com Forge/Fabric, o lado do cliente normalmente tem de usar os mesmos mods.
Lag após a instalação: Usa /spark profiler, caso o Spark esteja instalado, para verificar se um plugin ou mod consome uma quantidade anormal de tempo. Desativa extensões de que não precisas e testa novamente com ações realistas dos jogadores.
Verificação, limites e retorno seguro
O guia “Instalar mods e plugins do Minecraft - Guia simples” aplica-se ao tipo de servidor descrito no artigo e ao estado das versões visível no momento da verificação. Nomes de menus, versões disponíveis, compatibilidade de mods ou plugins e recursos necessários podem mudar após atualizações. Por isso, não transfiras valores sem verificação para outra versão de jogo, loader ou servidor.
Cria um backup dos ficheiros afetados antes de fazer alterações no mundo, no save, na configuração ou nas extensões. Depois altera apenas um passo relacionado de cada vez e verifica-o com a mesma versão de cliente e servidor com que pretendes jogar mais tarde.
| Ponto de verificação | Resultado esperado | Interrupção e retorno |
|---|---|---|
| Arranque do servidor | O servidor chega ao estado operacional sem novas mensagens de erro. | Em caso de erros de arranque, reverte a alteração e restaura o último backup. |
| Teste de ligação | Uma conta de teste consegue ligar através do endereço mostrado no painel. | Em caso de erros de versão ou ligação, compara novamente versão, porta e liberações. |
| Teste funcional | A função alterada em concreto funciona sem danificar dados existentes do mundo ou do jogo. | Em caso de efeitos colaterais, para o servidor e restaura os ficheiros guardados. |
Um teste individual bem-sucedido não é garantia de desempenho ou disponibilidade. Tamanho do mundo, mods, plugins, número de jogadores, caminho de rede e carga simultânea podem alterar o resultado. Documenta versão, alteração e resultado do teste, para conseguires compreender desvios futuros.
FAQ
Posso usar plugins Paper e mods Forge ao mesmo tempo?
Não num setup padrão normal. Plugins Paper/Spigot e mods Forge/Fabric pertencem a ecossistemas de servidor diferentes. Decide-te pela plataforma que combina com o teu objetivo.
Os jogadores têm de instalar plugins?
Com plugins clássicos de Paper ou Spigot, normalmente não. Os jogadores ligam-se com um cliente Minecraft normal. Exceções podem ser funções adicionais do lado do cliente ou resourcepacks que um plugin use opcionalmente.
Porque é que o meu servidor já não arranca depois de um mod?
Na maioria das vezes, uma versão não corresponde, falta uma dependência ou dois mods são incompatíveis. Lê a primeira mensagem de erro relevante na consola e remove temporariamente o mod instalado por último.
Onde devem ficar os ficheiros JAR?
Plugins ficam em /plugins, mods ficam em /mods. A pasta correta não depende apenas do tipo de ficheiro, mas sim do software do servidor: Paper/Spigot usa plugins, Forge/Fabric usa mods.
Devo instalar muitas extensões de uma só vez?
Não. Instala-as em pequenos passos e testa depois de cada reinício. Isso torna os erros rastreáveis e evita que tenhas de verificar todos os ficheiros ao mesmo tempo em caso de conflitos.