Com BepInEx podes expandir servidores de Valheim com mods, desde que os ficheiros do servidor, os mods do cliente e as versões combinem corretamente. O ponto decisivo não é apenas copiar uma DLL, mas seguir um processo controlado: instalar o framework, iniciar o servidor uma vez, adicionar mods de forma seletiva, alinhar os clientes e isolar erros através dos logs ou desativação passo a passo.
O que o BepInEx faz no Valheim
BepInEx é um framework de mods para jogos Unity. Para Valheim, é usado frequentemente o BepInExPack Valheim, disponibilizado na Thunderstore: documentação em thunderstore.io. Esta página do projeto é a fonte primária para o pacote Valheim-BepInEx mencionado em concreto.
BepInEx fornece as pastas onde os mods de Valheim são carregados e configurados. Muitos mods consistem em um ou mais ficheiros DLL que devem ficar em BepInEx/plugins/. Depois do primeiro arranque do servidor, normalmente são criados ficheiros de configuração adicionais em BepInEx/config/. Só alteres estes ficheiros depois de o servidor ter sido iniciado pelo menos uma vez com o framework instalado.
Se, além dos mods, também quiseres planear bem as bases do servidor, a configuração e a progressão dos bosses, o guia interno Alugar um servidor de Valheim: mods, configuração e ordem dos bosses 2026 complementa bem este conteúdo. Para outras configurações Unity ou de frameworks de mods, também é útil comparar com Instalar mods de V Rising com BepInEx Server Mods.
Requisitos
Antes de começares, precisas de acesso ao diretório do servidor de Valheim, da possibilidade de reiniciar o servidor e de uma lista clara de mods. Num hosting multi-game pago como game-serverhosting, é especialmente importante aplicares alterações de forma rastreável: primeiro backup, depois framework, depois mods individuais, por fim verificação. Assim manténs controlo técnico, capacidade de suporte e processos operacionais transparentes.
Define também quais mods correm apenas no servidor e quais cada jogador precisa de instalar localmente. Muitos mods de Valheim exigem componentes correspondentes no servidor e no cliente; o que conta é a indicação na página de cada mod. Por isso, verifica a descrição correspondente na Thunderstore para cada mod antes de o incluíres num modpack partilhado.
Instalar BepInEx no servidor
- Transfere BepInEx da Thunderstore.
- Extrai o conteúdo para o diretório do servidor de Valheim.
- Reinicia o servidor. BepInEx cria automaticamente as pastas de configuração.
Depois disso, a estrutura de destino deve ficar assim:
/valheim/
├── BepInEx/
│ ├── config/ # Configurações dos mods
│ ├── plugins/ # Colocar mods aqui
│ └── patchers/
├── valheim_server.x86_64
└── start_server.sh
O nível correto é importante: a pasta BepInEx/ deve ficar diretamente no diretório do servidor de Valheim, não dentro de uma subpasta adicional do arquivo ZIP. Se, depois do reinício, não surgir nenhuma estrutura config ou plugins, muitas vezes o erro está exatamente aí.
Instalar mods
- Transfere mods da Thunderstore.
- Extrai o ficheiro DLL para a pasta
BepInEx/plugins/. - Reinicia o servidor.
Não instales mods novos às cegas em pacotes grandes. O melhor é um procedimento controlado: adicionar um mod, iniciar o servidor, verificar o log, testar a ligação e só depois instalar o mod seguinte. Com vários jogadores, deves documentar a lista de mods com números de versão, para que todos usem a mesma base.
Se um mod trouxer ficheiros adicionais ou pastas próprias, segue as instruções desse mod. Nem todos os mods consistem apenas numa única DLL. Não movas ficheiros de configuração arbitrariamente entre plugins e config; o BepInEx e o próprio mod esperam caminhos específicos.
Alinhar mods do cliente
A maioria dos mods de Valheim deve estar instalada tanto no servidor como no cliente. Usa o Thunderstore Mod Manager para uma instalação simples no cliente.
Em alternativa, podes usar r2modman:
- Instala r2modman.
- Escolhe "Valheim" como jogo.
- Pesquisa e instala mods com um clique.
- Exporta o teu modpack como código → Partilha com amigos.
A vantagem prática de um gestor de mods está na sincronização: todos os jogadores podem usar o mesmo perfil, em vez de procurar DLLs manualmente. Mesmo assim, deves ter cuidado depois de atualizações. Um mod de cliente atualizado pode ser incompatível com um mod de servidor mais antigo. Por isso, regista quando alteraste o modpack e quais versões estão ativas.
Mods recomendados
A tabela seguinte mostra exemplos populares; verifica cada mod antes da instalação quanto a atualidade e dependências. Ela não é uma promessa de desempenho e não substitui a verificação da respetiva página do mod quanto a compatibilidade, atualidade e dependências necessárias.
| Mod | Descrição | Cliente necessário? |
|---|---|---|
| ValheimPlus | Ajustes extensos | Sim |
| Better UI | Interface de utilizador melhorada | Sim |
| Plant Everything | Plantar em qualquer lugar | Sim |
| Epic Loot | Itens raros com propriedades | Sim |
| Better Wards | Pedras de proteção melhoradas | Sim |
Verificar o resultado
Depois da instalação, o servidor deve iniciar sem crash. Verifica primeiro se o BepInEx é carregado no log e se aparecem mensagens de erro sobre dependências em falta, versões erradas ou DLLs não encontradas. Depois testa com um cliente que use a mesma seleção de mods.
No jogo, deves verificar especificamente uma função de cada mod instalado: alteração de UI visível, nova opção de configuração ativa, novo item disponível ou comportamento esperado ativo. Se tudo funcionar, guarda a lista de mods funcional e os ficheiros de configuração mais importantes. Assim podes compreender alterações futuras ou fazer rollback em caso de problemas.
Troubleshooting
O mod não funciona
Verifica primeiro a versão do BepInEx, a versão do mod e a compatibilidade do mod. Confirma também se a DLL está realmente em BepInEx/plugins/ e não, por engano, numa subpasta extraída duas vezes. Lê a página do mod na Thunderstore, porque muitos mods precisam de dependências adicionais.
O servidor crashed
Remove mods um a um para encontrar o causador. Começa pelo mod instalado mais recentemente ou atualizado por último. Reinicia o servidor após cada alteração e verifica o log. Se o servidor inicia sem mods, mas crasha com um mod específico, a causa costuma ser uma dependência, versão ou configuração.
Dessincronização ou problemas de ligação
Garante que todos os jogadores têm os mesmos mods em versões compatíveis. Especialmente em mods obrigatórios no cliente, não basta alterar apenas o servidor. Um perfil exportado de r2modman ou Thunderstore reduz diferenças e torna casos de suporte mais fáceis de rastrear.
A configuração não é criada
Inicia o servidor uma vez com BepInEx e o respetivo mod instalados. Muitos mods só escrevem a sua configuração no primeiro carregamento bem-sucedido. Se depois disso não aparecer nenhum ficheiro, talvez o mod não tenha sido carregado, esteja na pasta errada ou seja incompatível com o ambiente atual.
Verificação, limites e caminho seguro de retorno
O guia “Instalar mods de Valheim com BepInEx – passo a passo” aplica-se ao tipo de servidor descrito no artigo e ao estado de versões visível no momento da verificação. Nomes de menus, versões disponíveis, compatibilidade de mods ou plugins e recursos necessários podem mudar após atualizações. Por isso, não transfiras valores para outra versão de jogo, loader ou servidor sem os verificar.
Cria um backup dos ficheiros afetados antes de fazer alterações ao mundo, save, configuração ou extensões. Depois altera apenas um passo relacionado de cada vez e verifica-o com a mesma versão de cliente e servidor com que pretendes jogar mais tarde.
| Ponto de verificação | Resultado esperado | Interrupção e retorno |
|---|---|---|
| Arranque do servidor | O servidor atinge o estado operacional sem novas mensagens de erro. | Em caso de erros no arranque, reverte a alteração e restaura o último backup. |
| Teste de ligação | Uma conta de teste consegue ligar através do endereço mostrado no painel. | Em caso de erros de versão ou ligação, verifica novamente versão, porta e permissões. |
| Teste funcional | A função concretamente alterada funciona sem danificar dados existentes do mundo ou do jogo. | Em caso de efeitos secundários, para o servidor e restaura os ficheiros guardados. |
Um teste individual bem-sucedido não é garantia de desempenho ou disponibilidade. Tamanho do mundo, mods, plugins, número de jogadores, rota de rede e carga simultânea podem alterar o resultado. Documenta versão, alteração e resultado do teste para conseguires compreender desvios futuros.
FAQ
O BepInEx precisa de estar instalado no servidor e no cliente?
Para muitos mods de Valheim, sim. Se um mod for obrigatório no cliente, o servidor e os jogadores precisam da mesma versão ou de uma versão compatível. Verifica sempre isso na página do respetivo mod.
Posso instalar mods de Valheim apenas através da Thunderstore?
Não, também podes colocar DLLs manualmente em BepInEx/plugins/. Porém, Thunderstore Mod Manager e r2modman facilitam a sincronização de versões e a distribuição aos outros jogadores.
Porque é que o meu servidor já não inicia depois de um mod?
Causas frequentes são versões erradas do BepInEx, dependências em falta, versões de mods incompatíveis ou ficheiros na pasta errada. Remove mods passo a passo e verifica o log após cada reinício.
Onde ficam as configurações dos mods?
Muitos mods BepInEx criam a sua configuração em BepInEx/config/. Os ficheiros muitas vezes só aparecem depois do primeiro arranque bem-sucedido do servidor com o mod instalado.
Devo instalar todos os mods ao mesmo tempo?
Melhor não. Instala mods um após outro ou em pequenos grupos, para conseguires associar erros de forma clara. Isso poupa tempo se o servidor crashar ou se os clientes não conseguirem ligar.