Como instalar um modpack em um servidor Valheim

Você pode instalar um modpack no servidor Valheim da RazeHost usando um perfil exportado do Thunderstore Mod Manager ou do r2modman. Este procedimento continua válido após o lançamento do Valheim 1.0, mas os mods do perfil precisam ser compatíveis com a versão atual do jogo.

Antes de começar

Faça um backup do mundo e dos arquivos do servidor.
Atualize os mods e suas dependências no gerenciador de mods.
Confira se o perfil contém mods compatíveis com servidor dedicado. Mods exclusivos do cliente não devem ser instalados no servidor.
Verifique se o servidor está usando a versão com BepInEx. Se essa opção não estiver disponível no painel, solicite a instalação à nossa equipe de suporte.

Atenção: o Valheim não oferece suporte oficial a mods. Após atualizações do jogo, alguns mods podem precisar de uma nova versão antes de voltar a funcionar.

1. Exporte o perfil de mods

Abra o Thunderstore Mod Manager ou o r2modman e selecione o perfil que deseja instalar.
Acesse as configurações do perfil.
Escolha Exportar perfil como arquivo. O gerenciador criará um arquivo com a extensão .r2z.

Guarde esse arquivo. Você precisará enviá-lo ao servidor.

2. Envie o arquivo ao servidor

Acesse o painel de jogos da RazeHost.
Pare o servidor antes de alterar os arquivos.
Abra a aba Arquivos.
Envie o arquivo .r2z para o diretório principal do servidor.

Por exemplo, se o arquivo se chama MeuModpack.r2z, ele deve aparecer no diretório principal, e não dentro da pasta BepInEx/plugins.

3. Configure a importação

No painel, abra a aba Inicialização.
Confirme que a opção BepInEx está ativada.
Encontre o campo Exportação R2Z.
Informe o nome do arquivo enviado sem a extensão .r2z.

No exemplo acima, digite apenas:

MeuModpack

Salve a alteração, se o painel solicitar, e inicie o servidor.

4. Confira se os mods carregaram

Aguarde a importação e a inicialização do servidor. Depois:

Acesse Arquivos → BepInEx → plugins para conferir se os mods foram instalados.
Consulte o console do servidor ou o arquivo BepInEx/LogOutput.log.
Verifique se o BepInEx iniciou e se há mensagens de erro ou plugins que falharam ao carregar.

A presença de arquivos em BepInEx/plugins confirma a instalação, mas não garante que os mods estejam funcionando. A confirmação deve ser feita pelo log e por um teste no jogo.

Preciso instalar os mods no meu computador também?

Depende dos mods utilizados. Alguns funcionam apenas no servidor; outros exigem instalação também no jogo de cada jogador. Consulte a página de cada mod e, quando necessário, use no computador o mesmo perfil e as mesmas versões instaladas no servidor.

O servidor não iniciou ou os mods não funcionam

Confira os pontos abaixo:

BepInEx desativado ou desatualizado: confirme a opção na aba Inicialização e solicite ao suporte uma atualização, se necessário.
Nome incorreto em Exportação R2Z: informe somente o nome do arquivo, sem .r2z.
Arquivo no local errado: o .r2z deve estar no diretório principal do servidor.
Mod incompatível com o Valheim 1.0: atualize o mod ou remova-o temporariamente do perfil.
Mod exclusivo do cliente no servidor: retire-o do perfil usado para o servidor.
Dependência ausente ou versões diferentes: confira os requisitos de cada mod e mantenha as versões necessárias alinhadas entre servidor e jogadores.

Se o problema continuar, envie ao suporte o nome do modpack, o arquivo BepInEx/LogOutput.log e uma descrição do que acontece ao iniciar o servidor. Isso permite identificar qual mod ou dependência está causando a falha.