Voltar
Runbooks por jogo

7 Days to Die

Atualizado em 2026-06-29

Este guia mostra como colocar um servidor de 7 Days to Die no ar com o BrutusForge: instalação pelo assistente, RCON via telnet, instalação de mods, avisos de Bloodmoon no Discord e entrega da loja in-game. Os identificadores de configuração (chaves do serverconfig.xml, comandos RCON, portas) são apresentados exatamente como o jogo espera.

Instalação do servidor

  1. No admin, acesse Servidores → Adicionar servidor e selecione 7 Days to Die.
  2. Configure as portas:
PortaFunçãoPadrão
Gametráfego do jogo26900
TelnetRCON administrativo8081
Web adminpainel web do jogo (opcional)8080
  1. O download dedicado é feito via SteamCMD (app ID 294420).
  2. Confirme a instalação verificando se o executável 7DaysToDieServer.exe existe na pasta base do servidor.

RCON por telnet

O 7 Days to Die usa um console telnet como protocolo RCON. Habilite-o no serverconfig.xml da pasta base do servidor:

serverconfig.xml
<property name="TelnetEnabled" value="true" />
<property name="TelnetPort" value="8081" />
<property name="TelnetPassword" value="SUA_SENHA_SECRETA" />

A senha do telnet deve ser definida pela tela de configurações do servidor no admin, não editada à mão em produção. Reinicie o servidor após alterar essas propriedades.

Para validar, abra o console RCON do servidor no admin e envie o comando version. A resposta esperada é algo como Game version: 1.x b333.

A senha do telnet definida no serverconfig.xml precisa ser idêntica à senha de RCON gravada para o servidor no admin. Se divergirem, a autenticação falha e os comandos não passam.

Instalação de mods

Há dois caminhos para instalar mods.

Upload manual

Disponível em qualquer cluster, pela aba Mods do servidor. Envie um arquivo ZIP com o conteúdo do mod.

RegraLimite
Tamanho do ZIPaté 200 MB
Tamanho descompactadoaté 1 GB

Extensões permitidas: .dll, .cs, .xml, .lua, .json, .png, .jpg, .gif, .md, .txt, .nbt, .prefab, .unity3d, .asset.

Extensões bloqueadas por segurança: .exe, .bat, .ps1, .sh, .cmd, .vbs, .psm1.

Caminhos relativos com .. e caminhos absolutos são rejeitados (proteção contra path traversal).

Instalação via Nexus Mods

Disponível quando o cluster tem uma chave de API configurada. Em Cluster → Configurações → Nexus Mods (7DTD), informe a chave. A partir daí, o admin permite instalar mods diretamente pelo identificador do mod no Nexus: o download é validado contra uma lista de domínios permitidos (apenas nexusmods.com), descompactado e aplicado ao servidor.

Cada chave de API do Nexus tem um limite diário de requisições. Pelo botão Testar nas configurações do cluster você valida a chave e confere o consumo restante.

Avisos de Bloodmoon no Discord

O BrutusForge envia avisos automáticos antes de cada Bloodmoon, no canal do Discord que você escolher.

  1. Em Discord → Canais (por cluster), mapeie o evento BLOODMOON_WARNING para o ID do canal desejado.
  2. O agendador verifica o tempo restante a cada hora e dispara avisos em 60, 30 e 10 minutos antes do Bloodmoon.
  3. Se BloodMoonFrequency estiver definido como 0 no serverconfig.xml, os avisos são ignorados (Bloodmoon desativado).

A contagem regressiva é calculada a partir do horário do jogo (RCON gettime, formato Day N, HH:MM) e da duração do ciclo dia/noite (DayNightLength, em minutos reais por dia de jogo — padrão 60).

Entrega da loja in-game

Itens comprados na loja são entregues no jogo via RCON (comando give por telnet). Para que a entrega funcione, o telnet precisa estar habilitado e autenticando corretamente — os mesmos pré-requisitos descritos na seção de RCON.

Comandos do bot no Discord

ComandoFunção
/7dtd-statusstatus do servidor
/7dtd-broadcastenvia uma mensagem in-game para todos os jogadores

O bot registra os comandos durante a inicialização. Após uma atualização que altere comandos, reinicie o bot para que eles apareçam.

Solução de problemas

Telnet recusando conexão

  1. Confirme TelnetEnabled="true" no serverconfig.xml.
  2. Verifique o firewall e se a porta 8081 está em escuta.
  3. Teste diretamente: conectar via telnet ao host na porta deve exibir Please enter password:.

Falha de autenticação no telnet

  • Confirme que a senha do telnet bate com a senha de RCON gravada para o servidor no admin.
  • O servidor bloqueia o IP após exceder TelnetFailedLoginLimit (padrão 10). Reinicie o servidor ou aguarde TelnetFailedLoginsBlocktime (padrão 10s) para liberar.

Upload de mod falhando

MensagemCausa e correção
extensão não permitidao ZIP contém .exe, .bat, .ps1 etc. — remova e recompacte
path traversal detectadoo ZIP contém entradas com .. — recompacte a partir de uma pasta limpa
tamanho excede 200 MBdivida o mod ou use a instalação via Nexus
tamanho descompactado excede 1 GBprovável zip bomb — rejeitado

Instalação via Nexus falhando

  • Confirme que a chave de API do Nexus está configurada no cluster.
  • Use o botão Testar nas configurações do cluster para validar a chave.
  • Verifique o limite de requisições restante da chave.
  • Se aparecer erro de host não permitido, o Nexus pode ter mudado o domínio do CDN — atualize a lista de domínios permitidos.

Aviso de Bloodmoon não enviado

  • Confirme que BloodMoonFrequency é diferente de 0 no serverconfig.xml.
  • Verifique se o evento BLOODMOON_WARNING está mapeado para um canal no cluster.

Contagem de Bloodmoon incorreta

  • Confirme que o RCON gettime retorna o formato Day N, HH:MM.
  • Revise DayNightLength no serverconfig.xml (minutos reais por dia de jogo, padrão 60).

Comandos 7DTD do bot não respondem

  • Reinicie o bot após a atualização (os comandos são registrados na inicialização).
  • Confirme que /7dtd-status e /7dtd-broadcast aparecem na lista de comandos registrados.
  • Verifique se o bot consegue alcançar a API.

Verificações de saúde

VerificaçãoComo confirmar
Servidor no arRCON version retorna Game version: 1.x b333
Telnet autenticandoRCON listplayers retorna Total of N players: ...
Mods carregadosexiste Mods/NOME_DO_MOD/ModInfo.xml na pasta base
Agendador de Bloodmoonverificação a cada hora aparece nos logs
Notificações no Discordteste primeiro com /7dtd-broadcast