Guia de Instalação de Mods para Valheim

Este guia aborda a instalação do framework de mods BepInEx no seu servidor dedicado de Valheim, a adição de mods do Thunderstore e Nexus Mods, e a configuração de pacotes de mods populares como Valheim Plus. Para configuração básica do servidor e instruções de conexão, consulte o Guia de Configuração do Servidor Dedicado de Valheim.

Framework de Mods BepInEx

BepInEx é o carregador de mods padrão para Valheim. Praticamente todos os mods de Valheim o requerem. Ele deve ser instalado no diretório raiz do servidor.

Instalando o BepInEx no Seu Servidor

1. Baixe a versão mais recente do BepInEx para Valheim na página do Thunderstore ou na página de releases do GitHub do BepInEx. Use a versão Unix/Linux x64 para servidores dedicados.
2. Extraia o arquivo baixado. Você deverá ver uma pasta BepInEx/ e uma pasta doorstop_libs/ junto com alguns arquivos no nível raiz.
3. Conecte-se ao seu servidor via SFTP (veja Como Enviar Arquivos via SFTP).
4. Envie todos os arquivos e pastas extraídos para o diretório raiz do servidor (o mesmo diretório que contém valheim_server.x86_64).
5. Reinicie o servidor pelo GPanel. O BepInEx gerará sua estrutura de pastas na primeira execução.

Verificando se o BepInEx Está Funcionando

Após reiniciar, verifique a saída do console do servidor no GPanel para mensagens de inicialização do BepInEx. Você deverá ver linhas semelhantes a:

[Message:   BepInEx] BepInEx 5.x.x.x - valheim_server
[Info   :   BepInEx] Loading [BepInEx.Chainloader]

Se essas mensagens não aparecerem, consulte o guia de Solução de Problemas do Valheim para soluções.

Instalando Mods

Após a instalação do BepInEx, adicionar mods segue o mesmo processo para a maioria dos plugins:

1. Baixe o mod do Thunderstore.io ou do Nexus Mods.
2. Extraia o arquivo baixado.
3. Copie o arquivo .dll do mod (e quaisquer arquivos de configuração ou assets necessários) para o diretório BepInEx/plugins/ do seu servidor via SFTP.
4. Reinicie o servidor.

Estrutura de Diretórios dos Mods

Após instalar alguns mods, o diretório BepInEx do seu servidor deve ficar assim:

/ (server root)
  BepInEx/
    config/         ← mod configuration files (auto-generated on first run)
    plugins/        ← place mod .dll files here
    patchers/       ← preloader patchers (rarely used)
  doorstop_libs/    ← BepInEx doorstop library

Valheim Plus

Valheim Plus é um dos pacotes de modificação de servidor mais populares. Ele oferece opções de configuração extensivas para mecânicas de jogo, atributos de jogadores, construção e muito mais.

Instalando o Valheim Plus

1. Baixe a versão mais recente da build para servidor do Valheim Plus na página do Thunderstore ou na página de releases do GitHub. Certifique-se de baixar a versão Unix/Linux para servidor.
2. Extraia o arquivo. Ele inclui o BepInEx e o plugin Valheim Plus juntos.
3. Envie todo o conteúdo para o diretório raiz do seu servidor via SFTP, sobrescrevendo os arquivos existentes do BepInEx se solicitado.
4. Reinicie o servidor. O arquivo de configuração será gerado em:

   BepInEx/config/valheim_plus.cfg

5. Edite o valheim_plus.cfg via SFTP para ativar e configurar os recursos desejados. Cada seção possui uma opção enabled no topo.
6. Reinicie o servidor após fazer alterações na configuração.

Mods Populares Compatíveis com Servidor

Artigos Relacionados

• Guia de Configuração do Servidor Dedicado de Valheim — Configuração de inicialização, conexão e saves de mundo
• Solução de Problemas do Valheim — Problemas comuns e soluções
• Como Enviar Arquivos via SFTP