Gerenciando seus servidores
O fluxo do dia a dia para operar servidores de jogos com o Saba-chan, de adicionar, iniciar e monitorar servidores a backups, agendamentos, convidar amigos e integrar com o Discord.
Gerenciando seus servidores
Este documento explica como usar o Saba-chan do ponto de vista do usuário. Mesmo sem mexer no código dos módulos nem escrever extensões próprias, esta página basta para manter um ou dois servidores de jogo para seus amigos.
A instalação é coberta em Primeiros passos, e o pareamento do bot em Bot do Discord e relay em nuvem. Aqui partimos do princípio de que a instalação já terminou e focamos no que clicar e no que observar com a GUI aberta.
1. Visão geral: a GUI é um controle remoto, o daemon roda os servidores
Saiba isto primeiro: fechar a janela da GUI não desliga seus servidores de jogo.
saba-chan-gui(janela): o controle remoto que envia comandos ao daemon e desenha a tela. A CLI (saba-chan-cli) cumpre o mesmo papel.saba-core(daemon): o processo central que roda em segundo plano, iniciando e supervisionando os servidores de jogo. Servidores em execução, backups, tarefas agendadas e a conexão com o Discord são todos tratados pelo daemon.- Processos dos servidores de jogo: os servidores de fato, iniciados pelo daemon (
java,PalServer.exeetc.).
Então a sua operação do dia a dia fica assim:
- Abra a GUI e o daemon inicia junto (se ele já estiver rodando, a GUI se conecta a ele).
- Quando seus amigos estiverem para entrar, clique em Iniciar na tela do servidor.
- Durante o jogo, você pode minimizar ou fechar a janela. Ao fechá-la, você escolhe entre Fechar apenas interface (o daemon continua rodando) e Sair Tudo (o daemon também para). Para manter os servidores rodando, escolha Fechar apenas interface.
- Quando terminar, abra a GUI de novo e clique em Parar.
Desligar o PC também desliga seus servidores de jogo. O daemon roda apenas no seu próprio PC. Se você quer o servidor no ar 24/7, use uma hospedagem dedicada.
2. Criando seu primeiro servidor (resumo rápido)
Veja Primeiros passos para o passo a passo completo. Em resumo:
- Na tela Servidores, clique em Adicionar servidor.
- Escolha Adicionar como novo servidor. Se você já tem uma pasta de servidor, Migrar servidor existente a vincula (os arquivos ficam onde estão).
- Escolha um jogo (Minecraft / Palworld / Project Zomboid / Terraria etc.) e então defina o nome do servidor e uma predefinição recomendada.
- Se o jogo tiver termos a aceitar, você os aceita aqui. Por exemplo, o Minecraft exige que você aceite a EULA do Minecraft antes que o servidor possa iniciar (§3.7).
- Clique em Adicionar Servidor. Os arquivos do servidor são baixados automaticamente e o andamento aparece na tela do servidor.
- Quando a instalação terminar, o servidor aparece na lista.
Você pode dar ao seu servidor o nome que quiser: "Minecraft com os amigos", "Zomboid de fim de semana" e assim por diante. Nos comandos do Discord, você pode se referir a um servidor pelo nome dele ou pelo nome do jogo (apelido). É possível renomear um servidor parado com o botão de lápis ao lado do nome.
3. Fluxo do dia a dia
Ao selecionar um servidor, a tela dele abre à direita. No topo ficam o botão Iniciar/Parar e o status; abaixo ficam as abas. Quais abas aparecem depende do jogo.
| Aba | Conteúdo |
|---|---|
| Console | Saída do servidor e entrada de comandos (apenas para jogos com console) |
| Comandos | Os comandos que o jogo define (por exemplo, avisos e lista de jogadores do Palworld) |
| Configurações | Configurações do jogo (porta, máximo de jogadores, senha etc.) |
| Saba-chan | Configurações de como o Saba-chan cuida do servidor: reinício automático, limite de memória, tempo de espera de parada, prévia dos argumentos de inicialização, encaminhamento do chat do jogo |
| Backups | Criar e restaurar backups, tarefas agendadas |
| Discord | As palavras que chamam este servidor e seus comandos no Discord |
| Registro | Quem iniciou, parou ou enviou comandos, e quando |
| Informações | Porta, versão, tempo no ar, saídas recentes, verificação do servidor, abrir a pasta do servidor, excluir o servidor |
3.1 Iniciar / Parar / Reiniciar
- Iniciar: o daemon primeiro confere a aceitação dos termos e executa as verificações do módulo, e só então inicia o servidor. Se a verificação encontrar um problema crítico, o servidor não é iniciado e o motivo é exibido.
- Parar: envia o comando de parada graciosa do jogo (por exemplo,
stopno Minecraft,quitno Zomboid) e aguarda. Se o servidor não encerrar dentro do tempo de espera de parada (30 segundos por padrão, varia por jogo e pode ser mudado na aba Saba-chan), ele é finalizado à força. - Reiniciar: faz parar → iniciar em um só passo. Os jogadores conectados são desconectados por um instante.
3.2 Vendo o console / enviando comandos
- A aba Console mostra a saída do servidor de jogo em tempo real.
- Digite um comando e pressione Enter para enviá-lo ao console do servidor (stdin). Exemplos para o Minecraft:
say hi!,op FriendNick. Use ↑ para recuperar comandos anteriores. - Os comandos seguem a ordem stdin → REST → RCON. Jogos sem console (como o Palworld, controlado apenas pela REST API) são operados pelos comandos predefinidos da aba Comandos. O RCON só é usado para um jogo sem outro caminho, apenas por loopback (127.0.0.1), com porta e senha aleatória por instância definidas pelo daemon.
- O console pode ser destacado em uma janela separada e, no Windows, Abrir no terminal abre um console da CLI.
- Para cada servidor, o daemon mantém em memória as linhas mais recentes do console (até 10.000) e também as grava em arquivos dentro de
logs/na pasta do servidor.
3.3 Rodando vários servidores ao mesmo tempo
- Você pode criar vários servidores do mesmo jogo (por exemplo, "MC Vanilla" e "MC Modpack") ou rodar jogos diferentes lado a lado.
- A porta de cada servidor (o número que um jogo usa para aceitar jogadores) não pode se sobrepor. Ao criar um novo servidor, o Saba-chan desloca a porta padrão para não colidir com seus outros servidores, e um aviso aparece na tela do servidor se as portas se sobrepuserem. Você pode mudar a porta na aba Configurações.
- Cada servidor a mais usa mais memória e CPU do PC. Confira as especificações do seu PC antes de adicionar mais.
3.4 Detecção de crash e reinício automático
- Quando um servidor encerra, o daemon determina o motivo: Parado por você, Parado no jogo, Crash ou Desconhecido. O veredito é registrado em Saídas recentes na aba Informações.
- Se for considerado um Crash, o servidor é reiniciado automaticamente por padrão. O primeiro reinício acontece após 5 segundos, e a espera dobra a cada reinício. Depois de mais de 3 reinícios em 10 minutos, ele para de reiniciar, e você precisa iniciar o servidor por conta própria.
- Você pode mudar isso em Reinício automático na aba Saba-chan.
- Reiniciar após um crash: quando o servidor claramente encerrou por um erro (ligado por padrão).
- Reiniciar também em saídas desconhecidas: cobre também casos que não podem ser julgados, como finalizá-lo pelo Gerenciador de Tarefas (desligado por padrão).
- Servidores que você mesmo parou, pelo Saba-chan ou dentro do jogo, não são reiniciados.
3.5 Limite de memória (Windows)
- Em Limite de memória na aba Saba-chan, você pode limitar a memória (MB) que o servidor e seus processos filhos podem usar juntos. Se o limite for excedido, o servidor é parado.
- Deixe vazio para não ter limite. Para servidores Java, defina 1–2 GB acima do
-Xmx. - Apenas no Windows; passa a valer depois que o servidor é reiniciado.
3.6 Prévia dos argumentos de inicialização
- Em jogos que usam argumentos de inicialização, a Prévia dos argumentos de inicialização na aba Saba-chan mostra a linha de comando com que o servidor seria iniciado com as configurações atuais, sem iniciá-lo.
- Argumentos que você coloca em Argumentos extras e que não existem na tela de configurações (por exemplo,
-players=16 -useperfthreads) são repassados como estão na inicialização. Valores malformados são apontados na própria prévia. - Valores como senhas são mascarados como
***.
3.7 Aceitando termos (EULA do Minecraft etc.)
- Se um servidor de jogo tiver termos que exigem consentimento, uma janela Concordância necessária aparece quando você cria o servidor ou o inicia pela primeira vez. Leia o texto original, marque a caixa e clique em Concordar e iniciar.
- O consentimento só pode ser dado pela GUI ou pela CLI neste PC. Se alguém tentar iniciar o servidor pelo Discord antes de os termos serem aceitos, aceite-os primeiro no PC.
4. Backups e tarefas agendadas
Ficam na aba Backups. As tarefas agendadas valem para qualquer servidor; a lista de backups e as tarefas de backup só aparecem para jogos com suporte a backup.
4.1 Backups
- Fazer backup agora compacta o mundo e os arquivos de save. O módulo do jogo decide o que é salvo (no Minecraft, as pastas do mundo). Se o servidor estiver rodando, um comando de salvamento (
save-allno Minecraft etc.) é enviado ao jogo antes. - A lista de backups mostra o tipo de cada backup: Manual, Agendado, Antes da atualização, Antes da restauração.
- Restaurar só está disponível com o servidor parado. O estado atual é salvo em backup mais uma vez antes da restauração, então até um backup escolhido por engano pode ser desfeito.
- Backups manuais ficam fora da limpeza automática. Os demais (agendado, antes da atualização, antes da restauração) são mantidos até a quantidade de Backups agendados a manter (10 por padrão), apagando primeiro os mais antigos.
- Os arquivos de backup ficam dentro da pasta do servidor (instância). Excluir o servidor também exclui os backups dele, então copie os backups importantes para outro lugar.
4.2 Tarefas agendadas
Use Adicionar tarefa para executar automaticamente o seguinte em um intervalo fixo (a cada N minutos) ou em um horário definido todos os dias (HH:MM, no fuso horário do PC).
| Tarefa | O que faz |
|---|---|
| Backup | Faz backup enquanto o servidor está rodando |
| Reiniciar | Reinicia o servidor se ele estiver rodando |
| Aviso | Envia uma mensagem no jogo se o servidor estiver rodando |
| Atualizar | Verifica se há atualização do servidor de jogo e a aplica se houver (reinicia o servidor se ele estava rodando) |
- Tarefas de reinício e de atualização podem avisar os jogadores no jogo com antecedência (por exemplo,
10, 5, 1minutos antes). Avisos e alertas só estão disponíveis quando o jogo suporta um comando de aviso. - Quando o daemon reinicia, as tarefas por intervalo voltam a contar a partir daquele momento. Tarefas cujo horário passou enquanto o daemon estava desligado não são executadas em lote depois.
5. Deixando seus amigos se conectarem
Se você configurou o servidor de jogo e seus amigos não conseguem entrar, quase sempre é um destes três casos.
5.1 Amigos no mesmo Wi-Fi (LAN)
Não precisa de nenhuma configuração extra. Basta conectar usando o IP privado do PC do servidor (por exemplo, 192.168.0.10) e a porta.
5.2 Amigos de fora: o roteador suporta encaminhamento de portas
O encaminhamento de portas é uma configuração do roteador que repassa conexões de fora para o PC do servidor.
- Na página de administração do roteador, encaminhe a porta do jogo para o IP privado do PC do servidor.
- Passe aos amigos o endereço
<IP público>:<porta>. Você pode descobrir seu IP público em sites como whatismyip.com. - No Firewall do Windows, libere o tráfego de entrada (conexões vindas de fora) nessa porta.
5.3 Amigos de fora: encaminhamento de portas impossível
O encaminhamento de portas costuma ser bloqueado em redes de escola ou empresa, atrás do CGNAT do provedor e em Wi-Fi de visitantes. Mesmo assim, você pode iniciar e parar servidores pelo Discord por meio do relay em nuvem.
- Na tela Discord da GUI, use Conectar um servidor do Discord para obter um código e digite-o com o comando de barra
/saba connectno seu servidor do Discord. - A partir daí, seus amigos podem iniciar e parar servidores ou ver o status deles pelo Discord.
- Veja Bot do Discord e relay em nuvem para o fluxo detalhado.
O relay em nuvem encaminha apenas comandos de controle (iniciar/parar/status etc.), não o tráfego do jogo. Se seus amigos não conseguirem se conectar diretamente ao servidor de jogo, talvez você também precise de uma solução adicional (por exemplo, ZeroTier, Tailscale).
6. Usando o bot do Discord: resumo em uma página
Com o bot pareado, boa parte da operação do dia a dia pode ser feita pelo Discord sem abrir a GUI. Os comandos de mensagem têm a forma <prefixo> <servidor> <comando>, e o prefixo padrão é Saba-chan (você pode mudá-lo nas configurações do bot). Em <servidor>, use o nome do servidor ou o nome do jogo (apelido).
| Situação | O que digitar no Discord (prefixo padrão) |
|---|---|
| "Bora ligar o MC hoje" | Saba-chan minecraft start |
| "O servidor está no ar agora?" | Saba-chan minecraft status |
| "Vamos desligar" | Saba-chan minecraft stop |
| "Quais servidores existem?" | Saba-chan list |
| "O que eu posso digitar?" | Saba-chan help |
Cada servidor também ganha o próprio comando de barra /<nome do servidor>. A lista completa de comandos e como cadastrar apelidos estão em Comandos.
Para configuração, pareamento e funcionamento do relay do próprio bot, veja Bot do Discord e relay em nuvem.
7. Atualizações e limpeza
7.1 Atualizando o Saba-chan
- O Saba-chan verifica periodicamente uma lista de releases assinada e mostra uma notificação de Atualizações disponíveis na GUI quando sai uma nova versão.
- Em Configurações → Saba Storage, a aba Componentes permite baixar e aplicar atualizações por componente (núcleo, módulos, extensões etc.). Para componentes cujos arquivos em execução precisam ser substituídos, como o núcleo, o instalador (
saba-chan-installer) para o daemon por um instante, troca os arquivos e sobe de novo só o que mudou. Se só o daemon mudou, a janela do app continua aberta e apenas o daemon reinicia. - Como o daemon reinicia, aplique as atualizações quando ninguém estiver jogando.
7.2 Atualizando um servidor de jogo
- Quando há uma nova versão do servidor de jogo, um botão Atualizar aparece na tela do servidor. Ela pode ser aplicada com o servidor parado.
- Um backup Antes da atualização é feito automaticamente antes (em jogos com suporte a backup).
- Você também pode aplicar atualizações automaticamente em um horário definido com a tarefa agendada Atualizar (§4.2).
7.3 Excluindo um servidor
- Exclua-o com Excluir servidor na aba Informações. Um servidor só pode ser excluído depois de parado.
- Para servidores que o Saba-chan baixou e criou, a pasta do servidor (incluindo os arquivos do servidor de jogo e os backups) é apagada por inteiro. Copie antes os mundos ou backups de que precisar.
- Para servidores vinculados com Migrar servidor existente, os arquivos do jogo na pasta original são mantidos.
7.4 Desinstalando o Saba-chan
- Desinstale o Saba-chan em Configurações → Aplicativos → Aplicativos instalados do Windows.
- O desinstalador primeiro encerra normalmente os servidores que estão ligados e então remove a pasta de instalação, a pasta de dados (
%APPDATA%\saba-chan\) e os atalhos. Por padrão, os arquivos e backups dos servidores criados pelo Saba-chan também ficam nessa pasta de dados, então copie os mundos que quiser manter antes de desinstalar. Se você marcar Keep game servers, os arquivos dos servidores, mundos, backups e configurações por servidor são mantidos; se marcar Keep settings, as configurações do app e a conexão com o Discord são mantidas. Assim, uma reinstalação continua de onde parou. Se outra instalação do Saba-chan ainda usar a pasta de dados, ela não é apagada.
8. Quando algo dá errado
- Se aparecerem linhas vermelhas no console, comece pesquisando exatamente aquela mensagem. O Saba-chan mostra a saída do próprio servidor de jogo sem modificá-la.
- Verificar servidor e Diagnosticar log na aba Informações procuram problemas de configuração e erros conhecidos nos logs recentes.
- Se isso não resolver, a página Solução de problemas reúne cenários comuns e como resolvê-los.
- Se você encontrar um problema novo, registre-o no GitHub Issues junto com a saída do console. Os logs da GUI ficam em
%APPDATA%\saba-chan\logs\, e você pode abrir essa pasta com Abrir pasta de logs na janela que aparece ao clicar no status do daemon, no topo. Anexar esses arquivos acelera muito o diagnóstico.