Um guia sobre como baixar e instalar mods em Valheim no PC, cobrindo mod managers e instalação manual no Windows, Linux e macOS.
Valheim roda em Unity e seus mods são plugins de BepInEx. A comunidade mantém sua própria build do BepInEx em vez de usar a upstream, e essa é a primeira coisa a acertar.
Nosso exemplo é o EpicLoot, um overhaul de loot e itens mágicos de longa data. É um bom caso de demonstração porque traz dependências reais e porque precisa ser instalado tanto no servidor quanto no cliente.
Requisitos
- Um PC com Windows 10 ou superior, Linux, ou macOS. Valheim possui builds nativas para os três.
- Valheim, idealmente a versão Steam. Veja a próxima seção para entender o motivo.
- Alguns centenas de MB livres. Overhauls grandes como o EpicLoot ocupam mais.
- 7-Zip ou qualquer ferramenta de arquivo caso instale manualmente.
- Um backup dos seus mundos e personagens antes de começar. Eles ficam em
%userprofile%\AppData\LocalLow\IronGate\Valheimno Windows.
AVISO - Leve esse backup a sério. Mods que adicionam itens e progressão, incluindo o EpicLoot, gravam dados no seu save. Remover um mod desses depois pode deixar você com um personagem carregando itens que o jogo não reconhece mais.
Qual Versão Do Valheim Você Possui Importa
Valheim é vendido na Steam, na Microsoft Store e em consoles Xbox.
- A Steam é a versão que este guia assume em tudo, e a versão que toda a cena de mods tem como alvo.
- Instalações da Microsoft Store e Game Pass ficam em
C:\XboxGames\Valheim\Contente são muito mais difíceis de modificar. O BepInEx precisa gravar arquivos na pasta do jogo, e essas instalações são protegidas de formas que geralmente atrapalham. Não há um caminho suportado aqui e você não deve esperar que gerenciadores de mods funcionem. - Consoles Xbox não podem ser modados de jeito nenhum. O crossplay permite que um jogador de Xbox entre em um servidor de PC, mas o cliente Xbox continua vanilla e não consegue carregar nada.
BepInExPack Valheim
BepInExPack Valheim é o loader, e não é o BepInEx puro. É uma build específica para Valheim mantida por Azumatt, Vapok e Margmas, com um BepInEx.cfg pré-configurado, scripts de inicialização para Linux e para o servidor dedicado, mudanças no preloader das quais vários mods dependem, e suporte a versionamento semântico que o BepInEx 5 oficial descarta.
Instale esse pack, não o BepInEx genérico.
NOTA - Por ser um fork da comunidade, o Discord oficial do BepInEx não pode ajudar com problemas de Valheim, e eles mesmos vão dizer isso. Leve questões sobre Valheim para a comunidade de modding de Valheim.
Além do BepInEx, o EpicLoot depende de duas bibliotecas compartilhadas:
- Jötunn, a biblioteca de modding de Valheim sobre a qual a maioria dos mods substanciais é construída.
- JsonDotNET, uma cópia empacotada do Newtonsoft.Json.
Gerenciadores de mods instalam ambos automaticamente.
Instalando Com Um Mod Manager Do Thunderstore
Este é o caminho mais percorrido e o que as páginas de mods costumam linkar.
Três gerenciadores funcionam com Valheim e todos os três lêem o mesmo formato de perfil:
| Manager | Plataformas |
|---|---|
| Gale | Windows, Linux |
| Thunderstore Mod Manager | Windows |
| r2modman | Windows, Linux, macOS |
Os passos são os mesmos independentemente do que você escolher:
- Instale o gerenciador e selecione Valheim.
- Crie um perfil.
- Navegue ou pesquise por EpicLoot.
- Clique em Install ou Download with dependencies. O BepInExPack Valheim, o Jötunn e o JsonDotNET vêm junto.
- Inicie o jogo pelo gerenciador usando Start modded ou Launch game (modded).
Iniciar Valheim diretamente pela Steam roda o jogo vanilla, já que o gerenciador anexa o BepInEx no momento da inicialização.
Instalando Com Vortex
Vortex suporta Valheim e busca conteúdo do Nexus Mods em vez do Thunderstore. O catálogo de Valheim no Nexus é muito menor e a maioria dos autores publica primeiro no Thunderstore, então use esta opção se o Vortex já for sua ferramenta preferida e você tiver encontrado o que procura lá.
- Instale o Vortex e faça login.
- Em Games, procure por Valheim, passe o mouse sobre o tile e clique em Manage.
- Instale o BepInExPack Valheim você mesmo usando os passos manuais abaixo. O Vortex não configura o loader para você.
- Baixe mods do Nexus com Mod Manager Download, depois Install e Enable.
- Inicie pelo Steam normalmente. O Vortex grava arquivos permanentemente na pasta do jogo, então nenhum lançamento especial é necessário assim que o BepInEx estiver instalado.
AVISO - Não execute o Vortex e um gerenciador do Thunderstore na mesma instalação. Ambos querem ter controle sobre BepInEx/plugins e vão desfazer o trabalho um do outro.
Instalando Manualmente
Primeiro, encontre a pasta do jogo. Clique com o botão direito em Valheim na Steam, depois em Manage e Browse local files:
C:\Program Files (x86)\Steam\steamapps\common\Valheim
Baixe o BepInExPack Valheim com Manual Download, extraia em algum lugar que não seja a pasta do jogo, depois mova o conteúdo da pasta BepInExPack_Valheim para dentro da sua pasta do Valheim. Feito corretamente, você verá BepInEx, winhttp.dll e doorstop_config.ini ao lado de valheim.exe.
Depois baixe EpicLoot, Jötunn e JsonDotNET, extraia cada um, e copie seus arquivos .dll para Valheim\BepInEx\plugins.
O que fazer em seguida depende da sua plataforma.
Windows
Nada mais a fazer. Inicie o jogo e uma janela de console do BepInEx deve aparecer junto com ele.
Linux
- Torne o script de inicialização executável:
chmod u+x start_game_bepinex.sh
- Na Steam, abra as Properties de Valheim e defina as opções de inicialização como:
./start_game_bepinex.sh %command%
- Inicie pela Steam.
Você também pode indicar o caminho completo para o script em vez de um caminho relativo, o que permite manter o pack totalmente fora da pasta do jogo.
macOS
Valheim tem uma build nativa para macOS, mas o BepInEx 5 não roda nativamente em Apple Silicon, porque depende do MonoMod, e o MonoMod ainda não tem suporte a arm64. A solução é forçar o jogo a rodar pelo Rosetta.
- Torne o script executável:
chmod u+x start_game_bepinex.sh
- Defina as opções de inicialização de Valheim na Steam como:
/usr/bin/arch -x86_64 /bin/bash ./start_game_bepinex.sh %command%
- Inicie pela Steam.
Se você deixar de fora a parte arch -x86_64 num Mac com chip M, o jogo ainda inicia, só que sem o BepInEx e sem carregar nenhum dos seus mods. Macs com Intel não precisam disso.
Instalando Com O TMC App
Valheim é um dos jogos que o TMC App já suporta, então, diferente da maioria dos nossos guias, isto é uma opção real e não apenas uma promessa. O app é nosso próprio mod manager e navegador de servidores, e ele instala mods de Valheim em BepInEx/plugins como tudo mais aqui.
Instalando-o:
- Linux: uma linha, sem root e sem gerenciador de pacotes.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows: o
setup.exeousetup.msida página de releases. Há também uma build portátil, embora ela não registre a entrada no launcher nem o handler de linktmc://. - macOS: o
.dmgda mesma página de releases.
Depois de instalado:
- Abra o app e adicione Valheim, apontando para a sua pasta de instalação da Steam.
- Crie um sandbox. Sandboxes são perfis de mods nomeados com sua própria ordem de carregamento e método de implantação, e alternar entre eles não baixa nada novamente.
- Instale os mods que você quer nesse sandbox.
- Inicie o jogo.
AVISO - Por favor, leia esta parte antes de depender dele. O app está em estágio muito inicial de desenvolvimento e preferimos avisar do que fazer você descobrir isso no meio de uma jogatina. O próprio README lista todos os jogos suportados como não testados, Valheim incluso, então trate-o como algo para experimentar junto com o Gale ou o r2modman, e não como substituto deles. Mantenha o backup que mencionamos nos requisitos.
Dito isso, é exatamente nesta fase que testá-lo é mais útil. Se funcionar, gostaríamos de saber. Se ele instalar na pasta errada ou bagunçar sua ordem de carregamento, gostaríamos muito de saber, e esse tipo de relato vale mais para o projeto agora do que quase qualquer outra coisa.
O app é open source sob a licença GPL-3.0 em github.com/modcommunity/tmc-app. Relatos de bugs e pedidos de funcionalidades vão no issue tracker, pull requests são bem-vindos, e o repositório documenta como funcionam as regras específicas de cada jogo, caso você queira melhorar o lado de Valheim você mesmo.
Mods No Lado Do Servidor E Multiplayer
Esta é a parte que pega os jogadores de Valheim de surpresa, porque funciona diferente da maioria dos jogos cooperativos.
Os mods de Valheim se dividem basicamente em três tipos:
- Apenas cliente. Ajustes de interface, mudanças de câmera, mods visuais. Instale na sua máquina e mais nada importa.
- Cliente e servidor. Qualquer coisa que adicione itens, receitas, criaturas ou progressão. O EpicLoot se encaixa exatamente aqui, e precisa ser instalado tanto no servidor dedicado quanto no cliente de cada jogador.
- Apenas servidor. Ferramentas de administração, backups, gerenciamento do mundo.
Errar nisso geralmente aparece como ser expulso ao conectar por incompatibilidade de versão, ou como itens sumindo porque o servidor não reconhece o que são.
Para um servidor dedicado, o BepInExPack Valheim vem com um script start_server_bepinex.sh exatamente para isso. Torne-o executável com chmod u+x start_server_bepinex.sh, edite seus parâmetros de inicialização da mesma forma que editaria o próprio script de servidor do Valheim, e execute-o no lugar de start_server.sh.
Se você está configurando um servidor do zero, nosso guia de servidor de Valheim separado cobre esse lado.
DICA - Vários hosts gerenciados de Valheim instalam o BepInEx para você com um simples botão. Se você preferir não mexer com o shell, esse é um atalho legítimo.
Configurando Mods
Os mods escrevem seus arquivos de configuração aqui na primeira execução:
Valheim\BepInEx\config
São arquivos de texto simples .cfg. O EpicLoot coloca muito de seus ajustes ali, junto com arquivos JSON para tabelas de loot e efeitos mágicos, e vale muito a pena dar uma olhada se você quiser ajustar em vez de aceitar os padrões.
O BepInEx Configuration Manager adiciona uma janela de configurações dentro do jogo que edita esses mesmos valores sem precisar alternar entre janelas. Gale e r2modman também incluem editores de configuração.
Verificando Se Tudo Carregou
No Windows, o BepInEx abre uma janela de console junto com o jogo. Ela aparece na barra de tarefas e você pode acompanhar a sequência de inicialização nela.
O que você quer ver é texto cinza e branco, que é saída informativa. Cores indicam problema:
| Cor | Significado |
|---|---|
| Vermelho | Erro fatal |
| Vermelho escuro | Erro |
| Amarelo | Aviso |
| Cinza escuro | Saída de debug |
O pack também exibe no console sua própria versão do Thunderstore, que é separada da versão do BepInEx por baixo.
Especificamente para o EpicLoot, carregue um mundo e verifique no seu inventário as abas de itens mágicos e as receitas da estação de aprimoramento.
Atualizando E Desinstalando
Mod managers indicam mods desatualizados e os atualizam com um clique. Faça suas atualizações entre sessões de jogo, e não no meio de uma jogatina, já que um mod que escreve no seu save pode se comportar mal quando as versões mudam sob ele.
Para remover um mod, desinstale-o no seu gerenciador ou apague seu .dll de BepInEx/plugins. Para voltar ao vanilla, apague BepInEx, winhttp.dll, doorstop_config.ini e os scripts de inicialização da pasta do jogo. A verificação de arquivos do Steam não vai removê-los, porque o Steam não os instalou.
AVISO - Antes de remover um mod que adicionou itens ao seu mundo, considere se você ainda quer esse personagem e esse mundo depois. É para isso que serve o backup.
Solução De Problemas
Nenhum console do BepInEx e nenhum mod carregado. No Windows, verifique se o winhttp.dll está diretamente ao lado do valheim.exe. No Linux, verifique se suas opções de inicialização incluem ./start_game_bepinex.sh %command%. No macOS, verifique se o prefixo arch -x86_64 está presente.
Expulso de um servidor por incompatibilidade de versão. Seus mods e os mods do servidor não coincidem. Instale as mesmas versões que o servidor roda, ou peça ao host para exportar a lista dele.
Os mods pararam de funcionar depois de uma atualização de Valheim. Esperado. As atualizações da Iron Gate quebram mods do BepInEx e os autores precisam de tempo. Verifique as páginas dos seus mods no Thunderstore em busca de versões atualizadas.
O jogo trava na inicialização. Retire tudo de BepInEx/plugins, confirme que ele inicia limpo e depois adicione os mods de volta aos poucos para descobrir o culpado.
Os mods funcionam no single player mas não no meu próprio servidor. Os mods do lado do servidor também precisam ser instalados no servidor, não só no cliente que o hospeda. Use start_server_bepinex.sh.
A versão da Microsoft Store não modda. Em geral não modda mesmo, e não há forma suportada de contornar isso. A versão da Steam é a que deve ser usada.
Nada carrega em um Mac com chip M. Falta o prefixo do Rosetta nas suas opções de inicialização.
Conclusão
A versão resumida para a maioria das pessoas: instale o Gale ou o r2modman, escolha Valheim, instale o EpicLoot com as dependências, e inicie no modo modded. O BepInExPack Valheim vem junto e você nunca precisa se preocupar com ele.
As duas coisas específicas de Valheim que vale a pena lembrar são que o pacote BepInEx é um fork da comunidade, com suas próprias particularidades e canais de suporte próprios, e que qualquer coisa que mexa em itens ou progressão precisa ser instalada no servidor além do cliente.
Valheim é um dos poucos jogos que o nosso próprio TMC App já suporta. É open source e está em um estágio muito inicial de desenvolvimento, então vale a pena experimentar em vez de depender dele, e feedback sobre ele seria genuinamente apreciado.
Veja Também
- Valheim no Thunderstore
- Valheim no Nexus Mods
- Discord de Modding de Valheim
- Wiki de Modding de Valheim
- FAQ Oficial de Modding de Valheim - As próprias notas da Iron Gate sobre o sistema de asset bundle com o qual os mods precisam funcionar.
- Documentação do Jötunn
- TMC App
Mantemos este guia o mais atualizado possível, mas Valheim, o BepInEx e as bibliotecas de mods são atualizados separadamente. Se alguma instrução aqui não corresponder mais ao que você está vendo, por favor reporte ou abra um pull request no repositório GitHub deste guia.
Junte-se ao nosso servidor do Discord se tiver alguma dúvida ou quiser ajuda com qualquer coisa relacionada a modding!