Mods do Valheim: como instalar BepInEx no servidor

Resumo: os mods do Valheim funcionam com o BepInExPack_Valheim de denikson no Thunderstore, uma versão do BepInEx 5 pré-configurada para o Valheim. A versão atual, 5.4.2351, saiu em 24 de setembro de 2026, ou seja, depois do Valheim 1.0. Em um servidor dedicado, você copia o conteúdo da pasta BepInExPack_Valheim para o diretório onde está o valheim_server.x86_64 e inicia o servidor com start_server_bepinex.sh ou com as variáveis do Doorstop desse script. Os mods vão como .dll em BepInEx/plugins. No multiplayer, todos os jogadores precisam dos mesmos mods, e um servidor com mods roda sem crossplay, ou seja, só para jogadores de PC.

Seu próprio servidor Valheim? Na HostValues a partir de €5,60 por mês, online em poucos minutos. Ver planos →

Seu servidor está na HostValues? Na parte sobre a HostValues, mais abaixo, você vê como ativar os mods em um servidor de Valheim da HostValues com a opção BepInEx mods da aba Startup.

Antes de começar: Valheim 1.0 e mods

Sem suporte oficial. Segundo o FAQ da Iron Gate sobre o Valheim 1.0, o jogo não tem suporte oficial a mods: nada garante que eles funcionem, e depois de uma atualização sempre leva um tempo até serem adaptados. Não existe Steam Workshop, e os mods não são suportados nos consoles.
O pack está pronto para a 1.0. A versão 5.4.2350 saiu em 9 de setembro de 2026, dia do lançamento do Valheim 1.0, e a 5.4.2351 em 24 de setembro de 2026. O Thunderstore coloca o pack na categoria Deep North Update. O patch mais recente do Valheim é o 1.0.20, de 15 de outubro de 2026; até 16 de outubro de 2026 não saiu nenhum mais novo.
Primeiro, um backup. O Valheim 1.0 usa um novo sistema de save que divide os dados do mundo em muitas partes (chunks). Antes de cada mudança nos seus mods, salve o mundo inteiro, de preferência pelo painel de jogos.

O que vem no BepInExPack_Valheim

Baixe o pack na página do Thunderstore e extraia no seu computador, não na pasta do jogo ou do servidor. A pasta BepInExPack_Valheim contém:

BepInEx/core com o carregador e BepInEx/config/BepInEx.cfg com a configuração básica;
winhttp.dll e doorstop_config.ini, que carregam o BepInEx no Windows;
doorstop_libs com as bibliotecas para Linux e macOS;
start_server_bepinex.sh e start_game_bepinex.sh, os scripts de inicialização para Linux.

O download ainda não traz uma pasta plugins. Segundo a descrição, o pack traz um BepInEx.cfg pré-configurado com o ponto de entrada correto para os mods do Valheim e os scripts para Linux. Por isso, use este pack e não a versão genérica do BepInEx do GitHub.

Instalação no seu próprio servidor Linux

Pare o servidor e faça um backup.
Copie o conteúdo de BepInExPack_Valheim (não a pasta em si) para o diretório do servidor onde está o valheim_server.x86_64. Os caminhos do script de inicialização são relativos, então BepInEx, doorstop_libs e o script precisam ficar logo ao lado.
Torne o script executável: chmod u+x start_server_bepinex.sh.
Na última linha do script, ajuste -name, -port, -world e -password, do mesmo jeito que no script de inicialização normal do Valheim. A senha precisa ter pelo menos cinco caracteres e não pode aparecer no nome do servidor.
Inicie o servidor com ./start_server_bepinex.sh. Se tudo der certo, as mensagens de inicialização do BepInEx aparecem no terminal e o BepInEx cria o arquivo de log BepInEx/LogOutput.log.

Se a sua ferramenta de gerenciamento inicia o valheim_server.x86_64 diretamente em vez de usar o script, o BepInEx não carrega. Nesse caso, estas variáveis de ambiente do start_server_bepinex.sh precisam estar definidas antes da inicialização:

export DOORSTOP_ENABLED=1
export DOORSTOP_TARGET_ASSEMBLY=./BepInEx/core/BepInEx.Preloader.dll
export LD_LIBRARY_PATH="./doorstop_libs:$LD_LIBRARY_PATH"
export LD_PRELOAD="libdoorstop_x64.so:$LD_PRELOAD"

Na HostValues

Em um servidor de Valheim alugado na HostValues, siga os passos que também estão na página do produto:

Pare o servidor no painel de jogos e crie um backup.
Envie o conteúdo de BepInExPack_Valheim via SFTP ou pelo gerenciador de arquivos para a pasta onde está o valheim_server.x86_64, e seus mods para BepInEx/plugins.
Abra a aba Startup do painel e defina a opção BepInEx mods como 1.
Deixe a opção Crossplay em 0. Ela vem desativada por padrão, e com o crossplay ativado os mods do BepInEx não são suportados.
Reinicie o servidor e confira se o BepInEx/LogOutput.log foi criado.

Lembre-se: seu servidor instala a versão mais recente do Valheim a cada reinício. Depois de um patch, confira primeiro se o BepInExPack_Valheim e seus mods já foram atualizados.

Instalar mods: plugins, dependências e configuração

Mods: o arquivo .dll de um mod vai na pasta BepInEx/plugins, como também descreve a documentação do BepInEx. Se a pasta não existir, crie-a. Um mod com pasta própria vai inteiro para plugins.
Dependências: na página do mod no Thunderstore, a seção Required mostra de quais outros pacotes ele precisa, por exemplo a biblioteca Jötunn (the Valheim Library). Instale esses pacotes também.
Configuração: depois da primeira inicialização com um mod, o arquivo de configuração dele aparece em BepInEx/config. Segundo a documentação do BepInEx, o nome do arquivo é o GUID do plugin. Pare o servidor, edite o arquivo e inicie de novo.

Adicione os mods um de cada vez e reinicie depois de cada mod novo. Assim você vê na hora qual deles causa problemas.

Servidor, cliente ou os dois?

Nem todo mod precisa ser instalado em todo lugar. Para o Valheim, o Thunderstore tem as categorias Server-side e Client-side, mas o que vale sempre é a descrição do mod.

Tipo	Onde instalar	Casos típicos
Só servidor	Só no servidor	Mods que, segundo a descrição, rodam apenas no servidor; os jogadores não instalam nada
Os dois lados	Servidor e todos os jogadores, mesma versão	Novos itens, receitas, criaturas e peças de construção, e mods que sincronizam configurações ou versões
Só cliente	Só no PC do jogador que quiser	Interface e controles, por exemplo HUD ou mapa; não precisa estar no servidor

Na dúvida, siga a regra simples da nossa página do produto: todos os jogadores precisam dos mesmos mods que o servidor.

Para os jogadores: um gerenciador de mods

As instruções do pack recomendam um gerenciador de mods para o jogo: Gale, Thunderstore Mod Manager ou r2modman. Clique no botão de instalação da página do Thunderstore (Install with App) e depois inicie o Valheim sempre pelo gerenciador. O r2modman trabalha com perfis e consegue exportar um perfil, inclusive como código, para que seus amigos recebam os mesmos mods e configurações.

A instalação manual no PC do jogador (Windows, Linux, macOS) está descrita na página do pack no Thunderstore.

Crossplay e mods

Mods e crossplay não combinam. A Iron Gate não oferece suporte a mods nos consoles, e com o crossplay ativado os mods do BepInEx não são suportados. Em um servidor com mods, o Crossplay fica em 0. Segundo a Iron Gate, um servidor sem o argumento -crossplay (o script do pack não usa esse argumento) roda no backend da Steam: só jogadores de PC na Steam podem entrar, com o endereço IP e a porta do painel e a senha.

Solução de problemas

Nenhum LogOutput.log: o BepInEx não inicia, quase sempre porque o Doorstop não está ativo. Confira se BepInEx, doorstop_libs e os outros arquivos estão logo ao lado do valheim_server.x86_64 e se o servidor inicia pelo script, com as variáveis do Doorstop ou, na HostValues, com BepInEx mods em 1.
Um mod não carrega: no BepInEx/LogOutput.log, cada mod carregado tem uma linha como Loading [Nome 1.0.0] com o GUID. Desde o pack 5.4.2351, a linha Chainloader startup complete termina com o número de mods carregados, ignorados e com falha.
Travamento depois de uma atualização: atualize primeiro o BepInExPack_Valheim, depois bibliotecas como o Jötunn e por último os outros mods. Remova um por um os mods sem atualização para a 1.0 até o servidor voltar a iniciar.
Os jogadores não conseguem conectar: quase sempre falta um mod ou uma versão é diferente. Compare a lista de mods do jogador com a do servidor.

Para entender o que mudou para servidores na 1.0, leia Servidor de Valheim 1.0. Os comandos de administração estão em Comandos do Valheim.

Perguntas frequentes

Qual BepInEx eu preciso para o Valheim 1.0?

O BepInExPack_Valheim de denikson no Thunderstore, atualmente na versão 5.4.2351, de 24 de setembro de 2026, baseada no BepInEx 5.4.23.5. A versão genérica do BepInEx não vem pré-configurada para o Valheim.

Onde ficam os mods do Valheim no servidor?

Os arquivos dos mods vão em BepInEx/plugins, dentro do diretório do servidor. Os arquivos de configuração aparecem depois da primeira inicialização em BepInEx/config.

Jogadores de console podem entrar em um servidor com mods?

Não. A Iron Gate não oferece suporte a mods nos consoles, e sem crossplay só jogadores de PC pela Steam podem entrar.

O Valheim Plus ainda funciona?

O pacote original ValheimPlus está marcado como obsoleto (deprecated) no Thunderstore. A última versão, 9.9.11, é de 7 de dezembro de 2022, muito antes do Valheim 1.0, e o Thunderstore recomenda procurar uma alternativa.

Fontes: Thunderstore (BepInExPack_Valheim, changelog, versões, Jötunn, r2modman, ValheimPlus); documentação do BepInEx (instalação, configuração, solução de problemas, pasta plugins); Iron Gate (Valheim 1.0 FAQ, A Guide to Dedicated Servers); notas de patch na Steam (Valheim 1.0, patch 1.0.20). Atualizado em 16 de outubro de 2026.