Instalar um servidor Soulmask

Instalação passo a passo

1. 1

   Confira os requisitos (CPU, RAM, disco) e escolha o host: PC Windows, VPS ou servidor dedicado.

2. 2

   Instale o SteamCMD e baixe o servidor (aplicativo Steam 3017300 / 3017310).

3. 3

   No Linux, crie um usuário não root e uma pasta dedicada; no Windows, uma pasta simples (ex.: C:\servidor).

4. 4

   Inicie o servidor uma vez para gerar os arquivos de configuração e encerre-o corretamente.

5. 5

   Configure nome, senha e número de vagas (use nossas ferramentas de Soulmask para gerar os arquivos).

6. 6

   Abra as portas 8777/UDP, 27015/UDP no firewall do sistema e do provedor; redirecione-as no roteador se hospedar em casa.

7. 7

   Teste localmente (127.0.0.1) e depois a partir de uma conexão externa à sua rede.

8. 8

   Crie um serviço systemd (Linux) ou uma tarefa agendada (Windows) para a inicialização automática.

9. 9

   Agende os backups e as atualizações do servidor.

10. 10

    Adicione seu servidor em game-rank.com/jeux/soulmask para divulgá-lo.

Pré-requisitos

• Sistema: Linux ou Windows.
• Hardware (indicação da comunidade, não oficial): RAM 16 GB min.; disco —.
• Conta Steam: o SteamCMD baixa o servidor com login anônimo; apenas os jogadores precisam ter o jogo.
• Rede: um IP público (ou redirecionamento de portas) com as portas 8777/UDP, 27015/UDP abertas.
• Acesso: SSH (Linux) ou Área de Trabalho Remota (Windows Server); recomenda-se SSD.

Instalação local (Windows)

Instale o SteamCMD (steamcmd.exe) em uma pasta dedicada e execute os comandos abaixo em um prompt de comando. Depois inicie o servidor e entre pelo jogo em 127.0.0.1.

steamcmd +force_install_dir C:\soulmask-server +login anonymous +app_update 3017310 validate +quit
cd C:\soulmask-server
REM create StartServer.bat with our Soulmask generator, then run it
StartServer.bat

Instalação em VPS ou servidor dedicado Linux (Ubuntu/Debian)

Crie um usuário dedicado sem direitos de root, instale as dependências de 32 bits exigidas pelo SteamCMD e baixe o servidor. Adapte o nome de usuário e as pastas ao seu gosto.

sudo dpkg --add-architecture i386
sudo apt update && sudo apt install -y curl tar lib32gcc-s1
sudo adduser --disabled-password --gecos "" soulmask
# then, as the soulmask user (sudo -iu soulmask):
mkdir -p ~/steamcmd ~/soulmask-server && cd ~/steamcmd
curl -sqL "https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz" | tar zxvf -
./steamcmd.sh +force_install_dir ~/soulmask-server +login anonymous +app_update 3017300 validate +quit

Portas a abrir

Valores padrão; o tráfego é de entrada (para o servidor).

Para mudar uma porta, edite-a na configuração ou na linha de inicialização do servidor (-Port, -QueryPort, -EchoPort) e ajuste o firewall.

• 8777/UDP — jogo
• 27015/UDP — consultas Steam / lista de servidores
• 18888/TCP — console telnet (apenas local, não exponha)
• 19000/TCP — RCON (opcional, não exponha sem uma senha forte)

Firewall Linux (ufw), provedor e roteador

Libere primeiro o SSH para não ficar bloqueado e depois as portas do jogo. As portas só ficam acessíveis se também estiverem abertas no firewall do provedor (OVH, Hetzner, Scaleway…: «security group» ou regras de rede do painel).

Hospedagem em casa: crie um redirecionamento de portas (NAT) no roteador para o IP local fixo do servidor, com as mesmas portas e protocolos. Se sua operadora usa CGNAT (sem IPv4 público), o redirecionamento é impossível: peça um IP público ou alugue um VPS.

Teste: UDP não pode ser testado com um verificador de portas web simples; confirme entrando pelo jogo a partir de uma rede externa (um hotspot de celular, por exemplo) e consulte os logs do servidor.

sudo ufw allow 22/tcp
sudo ufw allow 8777/udp
sudo ufw allow 27015/udp
sudo ufw enable
sudo ufw status verbose

Firewall do Windows (netsh)

Execute estes comandos em um prompt de comando iniciado como administrador. Se hospedar em casa, adicione também o redirecionamento de portas no roteador.

netsh advfirewall firewall add rule name="Soulmask 8777 UDP" dir=in action=allow protocol=UDP localport=8777
netsh advfirewall firewall add rule name="Soulmask 27015 UDP" dir=in action=allow protocol=UDP localport=27015

Inicialização automática no Linux (systemd)

O serviço reinicia o servidor após uma falha e na inicialização da máquina. Ative-o com os comandos indicados no bloco.

[Unit]
Description=Soulmask dedicated server
After=network-online.target
Wants=network-online.target

[Service]
User=soulmask
WorkingDirectory=/home/soulmask/soulmask-server
ExecStart=/home/soulmask/soulmask-server/StartServer.sh
Restart=on-failure
RestartSec=10
KillSignal=SIGINT
TimeoutStopSec=90

[Install]
WantedBy=multi-user.target

# sudo nano /etc/systemd/system/soulmask.service
# sudo systemctl daemon-reload && sudo systemctl enable --now soulmask
# journalctl -u soulmask -f

Inicialização automática no Windows (tarefa agendada)

Crie uma tarefa que execute o script de inicialização quando o Windows iniciar, de preferência com uma conta dedicada. Adapte o caminho do script.

schtasks /Create /TN "Soulmask Server" /TR "C:\soulmask-server\StartServer.bat" /SC ONSTART /RU SYSTEM /RL HIGHEST
schtasks /Run /TN "Soulmask Server"
schtasks /End /TN "Soulmask Server"

Atualizações, backups e reinicializações

Pare o servidor antes de qualquer atualização, faça backup dos dados e reinicie. Agende backups com cron (Linux) ou o Agendador de Tarefas (Windows) e uma reinicialização diária se o jogo tiver vazamento de memória.

sudo systemctl stop soulmask
/home/soulmask/steamcmd/steamcmd.sh +force_install_dir /home/soulmask/soulmask-server +login anonymous +app_update 3017300 validate +quit
sudo systemctl start soulmask
# Windows uses app 3017310: steamcmd +force_install_dir C:\soulmask-server +login anonymous +app_update 3017310 validate +quit

mkdir -p ~/backups
tar czf ~/backups/soulmask-$(date +%F).tar.gz -C ~/soulmask-server/WS Saved
find ~/backups -name 'soulmask-*.tar.gz' -mtime +14 -delete
# crontab -e   ->   30 4 * * * <the two lines above, as a script>

Divulgar e encontrar seu servidor

Quando o servidor estiver estável, adicione-o em game-rank.com/jeux/soulmask (site do proprietário destas ferramentas) com endereço de conexão, vagas, idioma e versão. Endereço de conexão direta para compartilhar: <IP>:8777 (conforme a versão do jogo). Nunca publique uma senha de administração.

Solução de problemas

• O servidor não aparece na lista — causa: portas de consulta fechadas ou servidor não listado. Solução: abra 8777/UDP, 27015/UDP, confira nome/senha e aguarde alguns minutos; conecte-se direto por IP para testar.
• Não conecta pela Internet, mas funciona localmente — causa: firewall do sistema/provedor, redirecionamento de portas ausente ou CGNAT. Solução: verifique os três níveis (ufw/Windows, provedor, roteador) e o protocolo (UDP/TCP).
• O servidor fecha ao iniciar ou fica sem memória — causa: RAM insuficiente, bibliotecas ausentes ou diretório de trabalho errado. Solução: execute em primeiro plano, leia os logs, adicione RAM ou swap.
• Jogadores veem versão incompatível após uma atualização do jogo — causa: servidor desatualizado. Solução: pare-o, atualize-o (veja a seção Atualizações) e reinicie.
• Alterações de configuração são ignoradas ou sobrescritas — causa: arquivo editado com o servidor em execução, pasta errada ou erro de sintaxe. Solução: pare o servidor, edite o arquivo certo, valide a sintaxe (JSON/XML) e reinicie.

Perguntas frequentes

De que máquina preciso para um servidor Soulmask?

Hardware (indicação da comunidade, não oficial): RAM 16 GB min.; disco —.

Quais portas devo abrir?

Abra 8777/UDP, 27015/UDP de entrada, no firewall do sistema, no provedor e no roteador, se necessário. São os valores padrão e podem ser alterados na configuração do servidor.

Preciso ter o jogo para hospedar?

O servidor dedicado é baixado gratuitamente com o SteamCMD (login anônimo); apenas os jogadores precisam ter o jogo.

Como atualizar o servidor?

Pare o servidor, execute novamente o comando do SteamCMD +app_update 3017300 (Linux) / 3017310 (Windows) validate (veja a seção Atualizações) e reinicie. Para um branch beta, adicione -beta <nome>.

Posso hospedar em casa?

Sim, se sua conexão tiver IP público e você puder redirecionar portas no roteador. Com CGNAT ou upload fraco, prefira um VPS ou servidor dedicado.