Como instalar mods no Forge, Fabric e NeoForge

Os mods mudam o próprio jogo: novos blocos, mobs, máquinas e mundos. Um servidor com mods roda um carregador de mods, que é um destes: Fabric, Forge, NeoForge ou Quilt. Cada mod é feito para um carregador e uma versão do Minecraft, e todo jogador que entrar precisa dos mesmos mods no próprio computador. Se você quer extras só do servidor, como homes ou ranks, use plugins. Veja Como instalar plugins no Paper, Spigot e Purpur.

Os mods podem impedir um servidor de iniciar, e alguns mudam o mundo de formas que você não consegue desfazer. Faça backup antes de adicionar um. Veja Como fazer backup, restaurar e resetar seu mundo de Minecraft.

Combine primeiro o carregador e a versão

Os mods não funcionam entre carregadores. Um mod do Fabric não carrega no Forge, e vice-versa. O Forge e o NeoForge compartilham uma história, mas se separaram, então um mod de um não carrega no outro nas versões atuais. O carregador Quilt foi feito para rodar mods do Fabric, então um mod do Fabric é aceito no Quilt.

Para ver o que seu servidor roda, abra Visão geral, onde o card de identidade mostra o tipo e a versão do servidor. A aba Mods também tem um filtro chamado Roda em com o nome do seu carregador. Para trocar de carregador ou de versão, use Editar tipo de servidor, que apaga os arquivos do servidor por padrão. Veja Como mudar a versão do Minecraft ou o tipo de servidor. A maioria dos mods é publicada para um punhado de versões do Minecraft, então escolha a versão que seus mods favoritos suportam antes de escolher qualquer outra coisa.

Instale um mod pela aba Modding

A aba busca no Modrinth e no CurseForge ao mesmo tempo e coloca cada arquivo na pasta mods para você.

1. Abra seu servidor no painel e clique em Modding e depois na aba Mods. Se não houver aba Mods, seu tipo de servidor não roda mods. Paper, Purpur, Spigot e Folia rodam plugins, e o Vanilla não roda nem plugins nem mods. A aba diz isso e informa para quais tipos mudar. Um servidor Vanilla ainda mostra as abas Modpacks, Mundos e Datapacks.
2. Digite o nome do mod em Buscar mods e pressione Enter. Fonte pode ser Todas as fontes, Modrinth ou CurseForge. Versão do Minecraft começa na versão do seu próprio servidor.
3. Clique em Instalar na linha que você quer. O painel instala a build mais nova para a versão mostrada no filtro Versão do Minecraft, que começa na versão do seu servidor. Para pegar uma build mais antiga, mude esse filtro ou baixe o jar você mesmo e envie, como descrito abaixo. Escolha só uma versão que seu servidor consiga carregar.
4. Se o mod precisar de bibliotecas, como o Fabric API, uma janela abre listando-as, e o botão dela diz Instalar 2 arquivos ou algo parecido. Clique nele para instalá-los juntos.
5. Reinicie o servidor para ele carregar o mod. O painel não o reinicia por você depois de uma única instalação.

O painel confere algumas coisas antes de instalar e para com uma mensagem em vez de deixar você com um servidor que não consegue iniciar:

• Um mod feito para outro carregador mostra Não roda aqui na linha dele.
• Uma biblioteca obrigatória sem build para a sua versão impede a instalação.
• Um mod que precisa de um Java mais novo do que o seu servidor roda impede a instalação, e a mensagem diz qual Java ele precisa. Siga a mensagem, ou mude o filtro Versão do Minecraft para achar uma build mais antiga, ou envie um jar mais antigo manualmente.

Um mod cuja listagem não cita a sua versão simplesmente instala, sem aviso, e ainda pode funcionar. Acompanhe o Console depois do reinício.

Instale um mod enviando o arquivo

Use isto para um mod que você mesmo baixou.

1. Baixe o arquivo .jar na página oficial do mod, para o carregador certo e a versão certa do Minecraft. Baixe também qualquer biblioteca que ele peça, como o Fabric API.
2. Abra Files e depois a pasta mods. Se ela não estiver lá, inicie o servidor uma vez e pare.
3. Clique em Enviar e escolha os arquivos. Para muitos arquivos, use SFTP. Veja Como conectar aos arquivos do seu servidor com SFTP.
4. Reinicie o servidor.

Para um pacote inteiro de mods, um modpack é mais fácil. Veja Como instalar um modpack no seu servidor de Minecraft.

Confira se os mods carregaram

1. Abra a aba Console e acompanhe a inicialização. Um mod que carregou aparece na saída, e o filtro Erros mostra o que falhou. O primeiro erro costuma citar o mod e o que ele precisa. Veja Como usar o console e executar comandos.
2. Entre no servidor com os mods correspondentes e procure os novos blocos ou itens.

Se o servidor parar durante a inicialização, remova o mod mais novo ou restaure seu backup e inicie de novo. Veja Como consertar um servidor que não inicia.

Prepare seus jogadores

Os jogadores precisam do mesmo carregador, da mesma versão do Minecraft e dos mods que adicionam conteúdo. Eles instalam tudo no próprio computador.

1. Diga a eles a versão do Minecraft e o carregador do seu servidor.
2. Eles instalam esse carregador. Os sites do Fabric, do Forge e do NeoForge têm cada um um instalador para o seu carregador.
3. Eles adicionam os mesmos mods à pasta mods do jogo deles, ou usam um launcher que faz isso por eles, como o Modrinth App ou o app do CurseForge.
4. Eles entram com o seu Endereço do servidor da Visão geral. Veja Como entrar no seu servidor de Minecraft.

Nem todo mod precisa estar dos dois lados. O Modrinth marca cada mod como client side, server side ou ambos. Um mod que só muda a tela do jogador, como um mapa ou um auxiliar de shaders, fica só no computador do jogador. Um mod marcado só como server side não precisa de nada instalado nos computadores dos jogadores. Um mod que adiciona blocos ou mobs fica nos dois lados. Leia o ambiente na página do mod antes de instalá-lo, porque colocar um mod só de cliente no servidor pode travá-lo.

Atualize e remova mods

1. Abra Modding, depois Mods e depois a visualização Instalados.
2. Um mod com uma build mais nova mostra as duas versões e um botão Atualizar. Atualizar substitui o arquivo do mod e remove o antigo.
3. Para remover um mod, abra o menu ... dele e clique em Desinstalar. Marque Excluir também a configuração e os dados só se tiver certeza.
4. Reinicie o servidor.

Remover um mod que adicionou blocos ou itens ao seu mundo pode deixar buracos ou itens faltando nos mundos que o usavam. Faça um backup antes e teste em uma cópia se o mundo for importante.

Se uma atualização mudar a versão do Minecraft de que seus mods precisam, atualize todos os mods que importam antes de mover o servidor. Os jogadores precisam das mesmas atualizações.

Servidores híbridos

Magma e Ketting tentam rodar mods do Forge e plugins do Bukkit juntos. O painel os marca como avançados e menos estáveis que um carregador normal. A maioria dos servidores se dá melhor com Fabric, Forge ou NeoForge para mods, ou Paper para plugins. Veja Tipos de servidor de Minecraft explicados.

Relacionados

• Como reduzir o lag no seu servidor de Minecraft
• Quanta RAM um servidor de Minecraft precisa
• Problemas de servidor de Minecraft e como resolver