Guia de Administração de Servidor Valheim — Argumentos de Inicialização, Arquivos de Permissões e Comandos In-Game

Pré-requisitos: leia o guia de instalação antes

Esta página cobre o que acontece depois que o seu servidor dedicado do Valheim já está rodando. Se você ainda não configurou o seu servidor, comece pelo guia de servidor dedicado — ele aborda a instalação headless, o encaminhamento de portas e o script de inicialização start_headless_server.sh / .bat.

Argumentos de inicialização — a referência completa da 1.0

O Valheim não tem arquivo de configuração. Cada configuração do servidor é passada como uma flag de linha de comando na inicialização. O script de inicialização vem com padrões razoáveis — edite uma cópia antes do original para que as atualizações do Steam não sobrescrevam suas mudanças.

Flags essenciais (todo servidor precisa destas)

Flag	Padrão	O que faz
-name "texto"	obrigatório	Nome do servidor exibido no navegador de servidores Steam / crossplay
-world "texto"	obrigatório	Nome do arquivo do mundo. Um novo mundo é gerado automaticamente se o arquivo não existir.
-password "texto"	obrigatório	Mínimo de 5 caracteres e não pode aparecer dentro do nome ou da seed do mundo. O Valheim se recusa a subir com uma senha inválida — verifique isto primeiro se o seu servidor morrer na inicialização.
-port N	2456	Porta do jogo. O Valheim faz bind nessa porta e na próxima seguinte (2457 para consulta Steam / A2S). Seu painel de hospedagem normalmente cuida disso — não adicione você mesmo a menos que saiba que precisa.
-nographics	—	Obrigatório para servidores headless. Desabilita o pipeline de renderização do jogo. Não remova isto de um servidor dedicado — ele vai crashar.
-batchmode	—	Roda o motor Unity em modo batch (headless). Também obrigatório para servidores dedicados.

Flags de crossplay e visibilidade

Flag	Padrão	O que faz
-crossplay	desativado	Habilita a rede PlayFab para crossplay. Sem esta flag, apenas jogadores Steam conseguem ver e entrar no seu servidor. Jogadores de console (Xbox / PS5 / Switch 2) não conseguem conectar em um servidor com backend Steam de forma alguma — isto é uma restrição de arquitetura, não um bug.
-public 1 ou 0	1	1 lista o servidor no navegador da comunidade; 0 significa que jogadores entram apenas por IP ou código de entrada.

O que -crossplay realmente muda

A Iron Gate documenta isso no guia oficial de servidor dedicado:

Se você usar o backend de Crossplay (-crossplay), o servidor transmite dados via um servidor relay e portanto não precisa de encaminhamento de portas para ser acessível fora da sua rede local. Você pode conectar usando o endereço IP público + porta, um código de entrada, ou pela lista de servidores. Não é possível conectar usando um endereço IP local ou um endereço de loopback.

Então: crossplay = relay PlayFab = sem necessidade de encaminhamento de portas. Backend Steam = conexão direta = encaminhamento de portas obrigatório. Escolha um e se comprometa antes de convidar jogadores. Você pode trocar depois, mas mudar -crossplay requer reinício.

⚠️ Importante para servidores com mods: Se você quer usar mods, remova -crossplay do seu script de inicialização. Mods BepInEx usam o hook de rede Steam e não conseguem carregar em um backend PlayFab. Isso não tem correção — é assim que as duas camadas de rede foram projetadas. Veja o nosso guia de ecossistema de mods para detalhes completos.

O template padrão de inicialização para Linux

#!/bin/sh
export templdpath=$LD_LIBRARY_PATH
export LD_LIBRARY_PATH=./linux64:$LD_LIBRARY_PATH
export SteamAppId=892970
./valheim_server.x86_64 \
  -nographics -batchmode \
  -name "MyServer" \
  -port 2456 \
  -world "MyWorldFilename" \
  -password "ChangeMeNow" \
  -crossplay -public 1
export LD_LIBRARY_PATH=$templdpath

Copie isto, salve como start_server.sh, rode chmod +x, e execute.

Os três arquivos de permissões — adminlist, bannedlist, permittedlist

O Valheim não tem botão de “adicionar admin” dentro do jogo. Todas as permissões de servidor são controladas por três arquivos de texto simples armazenados no diretório de dados do jogo:

• Windows: %UserProfile%\AppData\LocalLow\IronGate\Valheim\
• Linux / macOS: ~/.config/unity3d/IronGate/Valheim/

Estes arquivos ficam fora da pasta de instalação do seu servidor dedicado — eles estão no diretório de dados do jogador porque o servidor headless compartilha o mesmo contexto de conta da Iron Gate. Provedores de servidores hospedados normalmente expõem essa pasta pelo painel de gerenciamento de arquivos.

adminlist.txt — conceder poderes de admin

// Platform User ID — um por linha
76561198012345678
76561198087654321

Os Platform User IDs seguem o formato [Plataforma]_[ID de Usuário] e são case sensitive. Você os pega no log do console do servidor (quando um jogador conecta) ou no painel de jogadores F2 dentro do jogo (visível apenas para admins após digitar admin). O formato:

• Jogadores Steam: Steam_1234567890
• Jogadores Xbox: XBox_1234567890 (confirmado 2024; o formato exato do Xbox na 1.0 está sendo verificado)
• Jogadores PS5: ID de PlayStation no formato que o seu painel de hospedagem expõe
• Jogadores Switch 2: igual — consulte no log do servidor

Uma entrada no adminlist = um admin em todos os personagens daquele jogador. Você não precisa adicionar cada personagem que ele fizer.

bannedlist.txt — banir permanentemente

// Campo de motivo do ban é opcional; formato da linha: [Platform]_[User ID]
Steam_1234567890
XBox_9876543210

Um jogador banido não consegue entrar mesmo que saiba a senha ou o código de entrada. Idealmente, as decisões de ban devem ser feitas pelo console do servidor (veja abaixo) porque o comando ban grava o motivo e o nome do jogador, facilitando desfazer depois.

permittedlist.txt — modo whitelist

Qualquer entrada no permittedlist.txt bane todo mundo que não esteja na lista. Este é o modo whitelist do Valheim — útil para servidores privados, de guilda ou de torneios. Deixe o arquivo completamente vazio (não apague, só deixe vazio) se você quiser que qualquer pessoa que tenha a senha possa entrar.

// Deixe vazio para permitir que qualquer pessoa com a senha entre
Steam_1234567890
XBox_9876543210

A Iron Gate avisa: “Adicionar uma pessoa na lista permitted vai banir todo o resto do servidor.” Isto é intencional e documentado — não coloque acidentalmente o seu próprio Steam ID aqui enquanto estiver testando.

Comandos de admin in-game — a lista completa para servidores dedicados

Apenas jogadores listados em adminlist.txt podem executar estes. Pressione F5 para abrir o console. O formato é command name sem pontuação extra.

Comandos de admin de escopo global

Comando	Efeito
kick NOME_DO_JOGADOR	Remove um jogador do servidor. Não bane — ele pode reconectar imediatamente.
ban NOME_DO_JOGADOR	Expulsa e bane. O ban é escrito em bannedlist.txt.
unban NOME_DO_JOGADOR	Remove o ban. Equivalente a editar bannedlist.txt manualmente.
banned	Lista todos os jogadores atualmente banidos.
admin	Mostra quais admins estão conectados no momento.
recall NOME_DO_JOGADOR	Teletransporta um jogador (ou recall all) para a sua localização atual. Útil para resgatar jogadores presos em terrenos.
save	Força o servidor a salvar imediatamente, em vez de esperar o intervalo de auto-save (~20 minutos).

Comandos de cliente disponíveis para admins

Estes funcionam no seu próprio personagem, não nos outros jogadores:

Comando	Efeito
god	Alternância de invencibilidade.
ghost	Mobs inimigos te ignoram. Bom para inspecionar terrenos ou testar pontos de spawn.
nocost	Sem custo de recursos ao construir. Ligue para montar uma base, desligue antes dos amigos entrarem.
freefly	Câmera desacoplada do personagem — use para screenshots ou vídeos cinematográficos.
exploremap	Revela o seu mapa pessoal completamente. Afeta apenas o save do seu personagem.
pos	Imprime as suas coordenadas atuais — útil para orientar um amigo preso.

devcommands vs comandos de admin vanilla: Comandos como god, spawn, freefly, findbiome e o cinematic da 1.0 requerem devcommands no seu cliente antes do início da sessão. Esta flag marca permanentemente o seu personagem e o seu mundo contra a obtenção de conquistas — patches recentes da Iron Gate removeram a flag devcommands da elegibilidade para conquistas, então se você já marcou o seu mundo precisa rodar yesiuseddevcommandsbutiwantmyachievementsanyway para optar de volta. Os comandos de servidor kick, ban, save, admin funcionam sem devcommands no cliente de qualquer admin.

Desligando corretamente

Pressione CTRL+C na janela do console do servidor. Clicar no botão X pode deixar o processo do servidor rodando em segundo plano — a Iron Gate confirma que isso é um problema conhecido. Sempre use CTRL+C para um desligamento limpo.

---

Links

• dedicated-server-guide — o guia de instalação que você leu primeiro
• crossplay — códigos de entrada, diferenças de versão, como o crossplay funciona de ponta a ponta
• connection-troubleshooting — a lista de verificação de “versão incompatível” e conexão recusada
• mod-ecosystem-1-0 — BepInEx vs PlayFab, status do Valheim Plus, substitutos independentes
• devcommands-deep-dive — a lista completa de devcommands da 1.0 e opt-in de conquistas