Adicionar mods ao seu servidor de Minecraft Java Edition abre um leque de possibilidades infinitas, seja para adicionar novas dimensões, árvores de tecnologia personalizadas, chefes perigosos ou melhorias de qualidade de vida. Embora gerenciar um servidor modificado de MC Java possa parecer complicado se você for iniciante, as ferramentas modernas tornam todo o processo muito simples e direto!

Este guia vai te ensinar a adicionar mods a um servidor de Minecraft Java Edition. Ele foi feito pensando em quem é iniciante no assunto, então vamos manter as coisas simples e práticas.

Nota importante sobre Modpacks e downloads automáticos

O Gerenciador de Mods automático baixa os arquivos diretamente do CurseForge e do Modrinth. Por padrão, ele busca a versão mais recente disponível. No entanto, alguns criadores de modpacks lançam versões beta experimentais ou não disponibilizam os arquivos específicos para servidores dedicados nessas plataformas. Por exemplo, com modpacks como o Linggango, se o criador lançar uma versão beta (como a versão 6.6.5b2) ou omitir os arquivos de servidor no CurseForge, o Gerenciador de Mods acabará baixando arquivos do lado do cliente (client-side), voltados para gráficos e ajustes de renderização. Isso fará com que o servidor caia (crash) ao iniciar. Nesses casos, será necessário instalar uma versão estável comprovada (como a versão 6.6.4 do Linggango) ou enviar manualmente os arquivos oficiais do servidor via FTP.

Visão geral rápida: Mod/plugin loaders

Os mods de Minecraft precisam de um "mod loader" no servidor para funcionar. Ao criar o seu servidor, você pode escolher uma destas opções comuns:

• Forge: O mod loader clássico e mais amplamente suportado. A maioria dos mods antigos e muitos dos modernos usam o Forge.
• Fabric: Um mod loader leve e rápido. Muitos mods modernos e focados em desempenho usam o Fabric.
• NeoForge: Uma opção moderna e focada em compatibilidade que visa rodar mods do Forge em versões mais recentes; escolha-o se ele aparecer na tela de criação do servidor e se seus mods forem compatíveis.
• Paper: Não é um mod loader. O Paper é uma implementação de servidor de alta performance que roda plugins (no estilo Bukkit/Spigot), e não mods de Forge/Fabric. Use o Paper se você quiser plugins (como Economia, Permissões, etc.) em vez de mods.

Important: Players usually need the same mods and the correct versions installed in their Minecraft client to connect to a modded server.

Como adicionar mods

Ao criar o seu servidor, escolha o tipo de servidor que corresponda aos mods que você planeja usar. Com base na opção selecionada, siga os passos abaixo:

Usando o painel de Mods

Compatível com Forge, Fabric ou NeoForge.

Após a criação, abra o painel de configuração do seu servidor em Meus Servidores > Gerenciar Servidor. Você verá uma seção de Mods no painel esquerdo.

1. Desligue o servidor:
   Clique na opção Ações no painel esquerdo para desligar o servidor.

   

    

2. Clique no painel de Mods:

   O painel de Mods permite que você busque e instale mods ou modpacks de duas fontes: CurseForge ou Modrinth. Escolha a que preferir.

   

    

3. Selecione a aba de instalação:
   Selecione a aba Modpack ou Mod, dependendo se você vai instalar um modpack completo ou mods individuais.

   

    

4. Busque pelo mod:
   Você pode usar a barra de pesquisa no canto superior direito para digitar o nome do mod ou uma palavra-chave para encontrá-lo mais facilmente.
    

5. Clique em Instalar para baixar o mod no servidor:

   

   Assim que clicar em Instalar, o sistema verificará a compatibilidade do mod com o servidor. Caso não sejam compatíveis, você pode alterar a versão do servidor em "Meus Servidores" e depois instalar o mod.
   
   Exemplos:

        

    

6. Reinicie o servidor:

   Reinicie o servidor clicando novamente na opção Ações e, desta vez, selecione Reiniciar.

   

Observações:

• Se você instalar um modpack, o painel geralmente instalará a combinação correta de mods e a versão certa do loader de forma automática.
• Sempre verifique a versão do Minecraft e o loader (Forge/Fabric) exigidos pelo mod antes de instalar.

Instalação manual

Compatível com Paper, Forge, Fabric ou NeoForge.

Você também pode baixar os arquivos dos mods ou plugins manualmente de um site (como o CurseForge ou o Modrinth) e enviá-los para o seu servidor.

1. Desligue o servidor:
   Clique na opção Ações no painel esquerdo para desligar o servidor.

1. Localize as pastas de instalação do servidor:
   Você pode acessar os arquivos do servidor usando o painel do Gerenciador de Arquivos em nosso site ou conectar-se via SFTP.
    

2. Abra a pasta mods:

   - Para Forge, Fabric ou NeoForge:

   Assim que você criar o servidor com qualquer um desses 3 templates, uma pasta mods será criada automaticamente. Localize-a em /Server / mods /

   

    

   - Para plugins do Paper:

   Ao criar o servidor com o Paper, uma pasta plugins será gerada no lugar. Localize-a em /Server / plugins /

   

    

3. Transfira o seu arquivo:
    Você pode arrastar e soltar o mod/plugin desejado diretamente na pasta ou enviá-lo usando SFTP.

   

    

4. Instale os mods no seu PC:
   Use o mesmo arquivo enviado para aplicar o mod no seu cliente local. No seu PC, vá para: C:\Users\NAME\AppData\Roaming\.minecraft\mods
   
   No caso de plugins, não é necessário instalá-los no seu cliente, pois são modificações que rodam apenas do lado do servidor (server-side).

    

5. Reinicie o servidor:
   Reinicie o servidor clicando novamente na opção Ações e, desta vez, selecione Reiniciar.

   

Após reiniciar, o servidor instalará o mod/plugin e criará as pastas necessárias caso haja configurações adicionais disponíveis.

Pronto! Agora você tem um servidor modificado para curtir uma nova aventura com seus amigos!

Importante: Os jogadores que se conectarem a um servidor modificado precisam ter os mesmos mods e loader instalados em seu cliente de Minecraft (com as versões idênticas). Se eles não tiverem os mods necessários do lado do cliente, não conseguirão entrar ou verão erros de conexão.
O jogo deve baixar os mods automaticamente ao entrar no servidor, a menos que você não esteja usando o cliente oficial do Minecraft.

Solução de problemas (Troubleshooting)

Se algo der errado, aqui estão os problemas mais comuns e como resolvê-los:

• Mods incompatíveis: Alguns mods entram em conflito entre si ou exigem bibliotecas de suporte específicas. Verifique as páginas dos mods para ver as dependências e incompatibilidades. Remova ou substitua os mods conflitantes.
   
• Arquivos de dependência ausentes: Muitos mods exigem outras bibliotecas de mods (exemplo: bibliotecas do Forge ou a API do Fabric). Certifique-se de que todos os arquivos .jar de dependência necessários também estejam instalados em Server / mods /.
   
• Diretório incorreto de mod/plugin: Mods devem ficar em Server / mods /. Plugins devem ficar em Server / plugins /. Colocar um plugin na pasta de mods (ou vice-versa) causará erros ou fará com que o arquivo seja ignorado.
   
• Incompatibilidade de versão: A versão do Minecraft do servidor, a versão do mod loader (Forge/Fabric/NeoForge) e as versões dos mods devem ser compatíveis. Se o mod foi feito para o Minecraft 1.19.4 e o seu servidor está na versão 1.20.x, ele não funcionará. Use mods desenvolvidos para as mesmas versões de Minecraft e loader.
   
• O servidor fecha sozinho ao iniciar (Crash): Verifique os logs do servidor (geralmente na pasta logs ou no console) para encontrar mensagens de erro que indiquem qual mod causou a queda. Remova o mod problemático, corrija as dependências ou mude para uma versão compatível.
   
• Jogadores não conseguem se conectar: Confirme se os clientes possuem a mesma lista de mods e as mesmas versões. Verifique também se há mods no servidor que exigem uma versão correspondente no cliente (alguns mods rodam apenas no servidor, mas muitos exigem mods idênticos no cliente).
   
• Problemas na instalação de modpacks: Se um modpack não for instalado corretamente pelo painel, tente instalá-lo manualmente ou entre em contato com o suporte. Verifique se o pacote exige um launcher personalizado ou etapas adicionais de configuração descritas pelo autor do modpack.
   
• Faça backups constantes: Antes de realizar grandes alterações, faça um backup do mundo/servidor. Se algo quebrar, restaure o backup e tente adicionar os mods um de cada vez para identificar o problema.

Dicas finais

• Instale os mods um por um e teste. Isso facilita muito a identificação de qual mod está causando problemas.
• Leia as páginas dos mods para instruções especiais (alguns mods exigem alterações nas configurações do servidor ou etapas adicionais).
• Use o painel de Mods da PingPlayers sempre que possível: ele simplifica a busca e a instalação de versões compatíveis diretamente do CurseForge ou Modrinth.

Conclusão

Adicionar mods ao seu servidor de Minecraft Java Edition transforma o seu mundo em uma aventura totalmente nova para você e seus amigos. Ao utilizar o Gerenciador de Mods automático para instalações rápidas ou enviar pacotes de servidor personalizados manualmente (como o Linggango) pelo Gerenciador de Arquivos, você tem total liberdade sobre a sua gameplay. Instale seus mods favoritos, inicie o jogo e comece a explorar o seu mundo personalizado!

Se você encontrar qualquer problema ou tiver alguma dúvida, sinta-se à vontade para entrar em contato com a nossa equipe de suporte pelo chat ao vivo ou pelo e-mail support@pingplayers.com!

Bom jogo!