Como adicionar mods ao seu servidor Minecraft

O servidor tem de estar num carregador de mods — Fabric, Forge, NeoForge ou Quilt. Se ainda está em Vanilla ou Paper, comece por Como fazer um servidor Minecraft modificado e depois volte aqui.

Opção 1: instale a partir do painel

O separador Mods tem o catálogo CurseForge integrado, por isso para a maioria dos mods nunca sai do painel nem lida com ficheiros. Um mod que é apenas publicado noutro lugar — Modrinth, ou o site do autor — entra com a opção 2.

1. Abra o separador Mods na página do servidor.
2. Procure o mod por nome.
3. Verifique se o mod lista a sua versão Minecraft e carregador — um mod Fabric não vai carregar em Forge, e um mod 1.20 não vai carregar em 1.21.
4. Clique em Instalar. O mod é colocado na pasta mods do servidor.
5. Reinicie o servidor para que carregue o novo ficheiro.

Opção 2: envie um jar

Para um mod que não está em CurseForge, ou uma versão específica que já tem:

1. Transfira o jar do mod para a sua versão exata do Minecraft e carregador a partir da página do autor.
2. Abra o separador Ficheiros e dirija-se para a pasta mods.
3. Use Enviar e selecione o jar.
4. Reinicie o servidor.

Mods ou plugins?

Mods e plugins não são intercambiáveis. Mods (Fabric, Forge, NeoForge, Quilt) alteram o jogo em si e podem adicionar novos blocos, itens e criaturas — o que normalmente significa que os jogadores também precisam deles. Plugins (Paper, Purpur) apenas funcionam no servidor e trabalham com um cliente Minecraft não modificado, por isso qualquer pessoa pode entrar sem instalar nada. Se tudo o que quer é ferramentas de servidor — reivindicações de terras, casas, uma economia — um servidor com plugins é mais simples para todos. Fabric, Forge, NeoForge ou Paper? compara-os.

Mods do cliente vs mods do servidor

Alguns mods têm de ser instalados no Minecraft de cada jogador e no servidor — a maioria dos mods de conteúdo que adicionam blocos, itens ou criaturas funcionam assim. Outros são apenas do lado do servidor. A página do mod diz qual; se é "necessário em ambos", todos os que aderem precisam do mesmo mod e versão ou serão desligados com uma mensagem sobre mods incompatíveis ou em falta.

Um terceiro tipo é apenas do cliente: mods de desempenho e visuais como Sodium, Iris ou shaders tipo OptiFine. Não fazem nada num servidor e alguns bloqueiam o servidor. Instale-os no seu próprio jogo, não no servidor.

Manter os mods de todos sincronizados

A forma mais fácil de dar aos seus amigos o conjunto certo é partilhar uma lista: os nomes dos mods e as versões exatas dos ficheiros da pasta mods do servidor. Ainda melhor, crie o conjunto como um perfil CurseForge ou use um modpack publicado, para que todos instalem a mesma coisa com um clique — veja Como instalar um modpack.

Atualizar e remover mods

Para atualizar um mod, pare o servidor, remova o jar antigo da pasta mods no separador Ficheiros, e instale o novo. Não deixe ambos: duas versões do mesmo mod impedem o servidor de iniciar com um erro "duplicate mods".

Remover um mod que adicionou blocos ou itens também remove esses blocos e itens do mundo quando carrega — não podem ser recuperados reinstalando o mod. Transfira uma cópia do mundo a partir do separador Mundo antes de remover um mod de conteúdo, caso mude de ideias.

Tamanho e mods a evitar

Ficheiros mod até 256 MB podem ser instalados enquanto o servidor está parado. Dois mods merecem ser conhecidos antes de os instalar:

• spark — o profiler não pode ser executado dentro do contentor bloqueado que os servidores livres usam, e impede o servidor de iniciar.
• Pré-geradores de mundo e renderizadores de mapas — úteis, mas pesados. Execute-os quando ninguém está a jogar e depois remova-os ou pause-os.

Se o servidor não iniciar após adicionar um mod

Abra o separador Consola e leia o primeiro erro no rastreamento da pilha. As causas habituais:

• Versão errada — o mod é construído para uma versão Minecraft ou carregador diferente.
• Dependência em falta — o mod precisa de um mod de biblioteca (frequentemente Fabric API, ou um mod de núcleo específico) que não está instalado.
• Mod apenas do cliente — nunca foi pensado para ser executado num servidor; remova-o.
• Dois mods em conflito — remova o último que adicionou e comece novamente para encontrar o par.

Remova o jar problemático da pasta mods no separador Ficheiros e o servidor voltará a iniciar. A lista completa de mensagens de erro e o que cada uma significa está em Por que é que o meu servidor Minecraft não vai iniciar?.