Instalando um modpack Forge, Fabric ou CurseForge

Um modpack é um pacote de mods de Minecraft selecionado para funcionar em conjunto. Este guia aborda as duas maneiras de fazê-lo funcionar no ServerPrism — o instalador de um clique e o upload manual — além dos detalhes que costumam confundir as pessoas: a versão Java e a correspondência com o seu cliente.

A regra de ouro: o server pack e o cliente devem corresponder

Um modpack tem um lado de servidor e um lado de cliente, e eles devem ser o mesmo pacote na mesma versão. Se seus amigos entrarem com uma versão diferente, ou com o pacote apenas para cliente, eles receberão "mod mismatch" ou erros de conexão. Sempre anote o nome e a versão exatos do modpack que você está instalando para que todos instalem o mesmo localmente.

Opção 1: Instalador de um clique (mais fácil)

Muitos modpacks populares podem ser instalados diretamente do painel:

1. Abra seu servidor e procure a aba Modpacks (ou Software / Modpack Installer).
2. Procure o modpack pelo nome.
3. Selecione a versão desejada e clique em Install.
4. Espere o download e a configuração — pacotes grandes levam alguns minutos.
5. Inicie o servidor na aba Console.

O instalador escolhe um comando de inicialização e um carregador de mods sensatos para você. Se o seu pacote estiver listado aqui, este é de longe o caminho mais fácil.

Opção 2: Upload manual do server-pack

Se o seu pacote não estiver no instalador, instale-o manualmente:

1. Baixe o server pack (não o client pack) da página do modpack — CurseForge e Modrinth oferecem arquivos de servidor na seção Files ou Additional Files.

2. Faça o upload do zip para o seu servidor via SFTP (recomendado para pacotes grandes) ou pelo File Manager, e depois extraia-o no diretório raiz. Veja Carregando e gerenciando arquivos.

3. Alguns pacotes vêm com um start.sh / run.bat ou um unix_args.txt — geralmente você não os executa diretamente; em vez disso, aponte o comando de inicialização do seu servidor para o arquivo de inicialização do modpack.

4. Na aba Startup, defina o comando de inicialização. Para o Forge moderno, isso geralmente é:

   @libraries/net/minecraftforge/forge/<version>/unix_args.txt
   

   e para NeoForge:

   @libraries/net/neoforged/neoforge/<version>/unix_args.txt
   

5. Inicie o servidor e observe o Console para o progresso do carregamento dos mods.

Escolha a versão Java correta

Modpacks são exigentes quanto ao Java. Defina-o na aba Startup através do seletor de imagem Docker / versão Java:

Se o servidor travar instantaneamente ao iniciar com uma mensagem sobre uma versão de classe não suportada ou "requires Java X", é quase sempre a versão Java errada aqui.

Dê RAM suficiente

Modpacks são pesados. Um pacote pequeno precisa de 4 GB; pacotes grandes "kitchen-sink" (mais de 200 mods) precisam de 6–8 GB ou mais. Se o console mostrar OutOfMemoryError ou o servidor morrer durante a geração do mundo, você provavelmente precisa de um plano maior — veja Como Atualizar ou Rebaixar Seu Plano.

Problemas comuns

• Travamento instantâneo / "unsupported class version": versão Java errada — corrija na aba Startup.
• OutOfMemoryError ou travamento durante a geração do mundo: RAM insuficiente — atualize seu plano.
• Amigos recebem "mod mismatch" / não conseguem entrar: o cliente deles não é exatamente o mesmo pacote + versão do servidor.
• Servidor inicia, mas sem mods: você fez o upload do client pack, ou os mods foram parar na pasta errada — eles devem estar em mods/.

Ainda com dificuldades? Abra um ticket de suporte com o nome e a versão do modpack e nós o faremos funcionar para você — podemos até instalá-lo diretamente no seu servidor para que você veja como ele é configurado.