Debug multi-jogo

Este guia ajuda o administrador a diagnosticar problemas de RCON, métricas e eventos quando o BrutusForge gerencia servidores de jogos diferentes. Cada jogo usa um protocolo de RCON e portas próprias, então o caminho de depuração muda conforme o jogo. Aqui você encontra os sintomas mais comuns, como isolar a camada com falha e como testar a conexão diretamente, sem passar pelo painel.

Diagnóstico do RCON

O BrutusForge resolve automaticamente o protocolo de RCON a partir da definição do jogo. Cada jogo conversa com um protocolo distinto:

Sintoma: comando expira (timeout)

1. Confirme que o protocolo resolvido corresponde ao jogo do servidor. Se o servidor estiver classificado com o jogo errado, o painel tentará falar o protocolo errado.
2. Verifique se o host e a porta de RCON estão corretos para aquele jogo.
3. Teste a conexão diretamente, ignorando o painel, para isolar se o problema é do servidor ou da integração:

# Source RCON (ARK)
nc -u host porta   # envie um pacote de autenticacao
 
# WebRcon (Rust)
wscat -c ws://host:porta/senha
 
# Telnet (7 Days to Die)
telnet host porta   # ou: nc host porta

Se a conexão direta também falhar, o problema está no servidor de jogo ou na rede, não no BrutusForge.

Sintoma: falha de autenticação

• Confirme que a senha de RCON está definida na configuração do servidor de jogo (o nome do campo varia por jogo).
• Confirme que a senha salva no painel não está corrompida ou desatualizada.
• No 7 Days to Die (telnet), a resposta ErrAuthFailed indica senha incorreta.

Diagnóstico em tempo real (WebSocket de admin)

O painel administrativo recebe atualizações ao vivo por WebSocket. Para inspecionar:

DevTools do navegador → Network → WS → /socket.io

• Verifique se o cookie de sessão está presente na conexão.
• Verifique se o socket entra na sala do servidor correto ao conectar (mensagem de inscrição no servidor).

Se o socket não entrar na sala esperada, as atualizações ao vivo daquele servidor não chegarão ao painel.

Palworld

O Palworld não usa RCON tradicional: ele expõe uma API REST com autenticação HTTP Basic.

• Protocolo: palworld-rest (HTTP + Basic auth, porta padrão 8212).
• Comandos suportados: informações do servidor, lista de jogadores, anúncio, salvar, desligar, parar e expulsar.

Teste direto:

curl -u admin:senha http://host:8212/v1/api/info

Minecraft

O Minecraft usa o protocolo Source RCON (o mesmo do ARK), em porta própria.

• Protocolo: minecraft-rcon (Source RCON, porta padrão 25575).

Teste direto:

mcrcon -H host -P 25575 -p senha "list"

Instalação do servidor Paper

A instalação do servidor Paper roda em segundo plano (fila de trabalho). Ela busca a build mais recente na API oficial do Paper e gera os arquivos iniciais: o .jar do servidor, o arquivo de EULA e o server.properties (já com RCON habilitado e uma senha aleatória).

Mods via Modrinth

• Os endpoints de leitura do Modrinth não exigem autenticação.
• O cabeçalho User-Agent é obrigatório.
• O limite de requisições é de 300 por minuto por IP. Acompanhe o saldo restante e reduza o ritmo ao se aproximar do limite.

Segredos criptografados em repouso

Chaves de API de mods (por exemplo, a chave do Nexus) são guardadas criptografadas no banco, não em texto puro.

• Os valores criptografados usam um prefixo de versão (enc:v1: ou enc:v2:).
• A versão mais recente vincula o segredo ao cluster e ao campo, dificultando o reuso indevido do dado criptografado.
• A descriptografia tenta primeiro a versão mais recente e, em seguida, faz fallback para versões anteriores e, por fim, para texto puro, mantendo a compatibilidade com dados antigos.
• A descriptografia exige a chave de criptografia configurada no ambiente, idêntica à usada no momento da criptografia.