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
- No admin, acesse Servidores → Adicionar servidor e selecione 7 Days to Die.
- Configure as portas:
| Porta | Função | Padrão |
|---|---|---|
| Game | tráfego do jogo | 26900 |
| Telnet | RCON administrativo | 8081 |
| Web admin | painel web do jogo (opcional) | 8080 |
- O download dedicado é feito via SteamCMD (app ID
294420). - Confirme a instalação verificando se o executável
7DaysToDieServer.exeexiste 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:
<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.
| Regra | Limite |
|---|---|
| Tamanho do ZIP | até 200 MB |
| Tamanho descompactado | até 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.
- Em Discord → Canais (por cluster), mapeie o evento
BLOODMOON_WARNINGpara o ID do canal desejado. - O agendador verifica o tempo restante a cada hora e dispara avisos em 60, 30 e 10 minutos antes do Bloodmoon.
- Se
BloodMoonFrequencyestiver definido como0noserverconfig.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
| Comando | Função |
|---|---|
/7dtd-status | status do servidor |
/7dtd-broadcast | envia 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
- Confirme
TelnetEnabled="true"noserverconfig.xml. - Verifique o firewall e se a porta
8081está em escuta. - 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ão10). Reinicie o servidor ou aguardeTelnetFailedLoginsBlocktime(padrão10s) para liberar.
Upload de mod falhando
| Mensagem | Causa e correção |
|---|---|
| extensão não permitida | o ZIP contém .exe, .bat, .ps1 etc. — remova e recompacte |
| path traversal detectado | o ZIP contém entradas com .. — recompacte a partir de uma pasta limpa |
| tamanho excede 200 MB | divida o mod ou use a instalação via Nexus |
| tamanho descompactado excede 1 GB | prová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 de0noserverconfig.xml. - Verifique se o evento
BLOODMOON_WARNINGestá mapeado para um canal no cluster.
Contagem de Bloodmoon incorreta
- Confirme que o RCON
gettimeretorna o formatoDay N, HH:MM. - Revise
DayNightLengthnoserverconfig.xml(minutos reais por dia de jogo, padrão60).
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-statuse/7dtd-broadcastaparecem na lista de comandos registrados. - Verifique se o bot consegue alcançar a API.
Verificações de saúde
| Verificação | Como confirmar |
|---|---|
| Servidor no ar | RCON version retorna Game version: 1.x b333 |
| Telnet autenticando | RCON listplayers retorna Total of N players: ... |
| Mods carregados | existe Mods/NOME_DO_MOD/ModInfo.xml na pasta base |
| Agendador de Bloodmoon | verificação a cada hora aparece nos logs |
| Notificações no Discord | teste primeiro com /7dtd-broadcast |