Este guia vai te ensinar a adicionar mods a um servidor de Minecraft Java Edition. Ele foi feito pensando em quem está começando agora com servidores de jogos, então vamos manter tudo simples e prático.

Visão geral rápida: Loaders de mods/plugins

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 amplamente compatível. 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 essa opção se ela 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 alto desempenho 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 rodar. Com base na versã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 o painel 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 as versões em "Meus Servidores" e depois instalar o mod.
   
   Exemplos:

        

    

6. Reinicie o servidor:

   Reinicie o servidor clicando na opção Ações novamente 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 de mods ou plugins manualmente de um site (por exemplo, CurseForge ou 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 se conectando 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:

   Assim que você criar o servidor com o Paper, ele gerará uma pasta plugins em vez disso. Localize-a em /Server / plugins /

   

    

3. Transfira o seu arquivo:
    Basta arrastar e soltar o mod/plugin desejado 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 será necessário instalá-los no seu cliente, pois são modificações que rodam apenas no lado do servidor (server-side).

    

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

   

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

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

Importante: Os jogadores que se conectarem a um servidor com mods precisam ter os mesmos mods e loader instalados em seu cliente do Minecraft (com as versões correspondentes). Se eles não tiverem os mods necessários no lado do cliente, não conseguirão entrar ou verão erros.
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

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 mod loader ou Fabric API). Certifique-se de que todos os arquivos .jar de dependência exigidos também estejam instalados em Server / mods /.
   
• Diretório incorreto de mod/plugin: Os mods devem ficar em Server / mods /. Os 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 coincidir. Se o mod for voltado para o Minecraft 1.19.4 e seu servidor estiver na 1.20.x, ele não funcionará. Use mods criados para as mesmas versões de Minecraft e loader.
   
• O servidor crasha ao iniciar: Verifique os logs do servidor (geralmente na pasta logs ou no console) para encontrar mensagens de erro indicando qual mod causou o crash. Remova o mod problemático, corrija as dependências ou mude para uma versão compatível.
   
• Os jogadores não conseguem se conectar: Confirme se os clientes têm a mesma lista e versões de mods. Verifique também os mods do lado do servidor que exigem equivalentes no lado do cliente (alguns mods rodam apenas no servidor, mas muitos exigem mods correspondentes no cliente).
   
• Problemas na instalação de modpacks: Se um modpack falhar ao ser instalado 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 fazer 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 localizar 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 ver se há instruções especiais (alguns mods exigem alterações de configuração no servidor ou etapas extras).
• Sempre que possível, use o painel de Mods da PingPlayers, pois ele simplifica a busca e a instalação de versões compatíveis diretamente do CurseForge ou Modrinth.

Se você tiver alguma dúvida ou precisar de ajuda, 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!