Installare un server Soulmask

Installazione passo dopo passo

1. 1

   Verifica i requisiti (CPU, RAM, disco) e scegli l'host: PC Windows, VPS o server dedicato.

2. 2

   Installa SteamCMD e scarica il server (app Steam 3017300 / 3017310).

3. 3

   Su Linux crea un utente non root e una cartella dedicata; su Windows una cartella semplice (es. C:\server).

4. 4

   Avvia il server una volta per generare i file di configurazione, poi fermalo correttamente.

5. 5

   Configura nome, password e numero di slot (usa i nostri strumenti Soulmask per generare i file).

6. 6

   Apri le porte 8777/UDP, 27015/UDP nel firewall del sistema e del provider; inoltrale sul router se ospiti in casa.

7. 7

   Prova in locale (127.0.0.1), poi da una connessione esterna alla tua rete.

8. 8

   Crea un servizio systemd (Linux) o un'attività pianificata (Windows) per l'avvio automatico.

9. 9

   Pianifica i backup e gli aggiornamenti del server.

10. 10

    Aggiungi il tuo server su game-rank.com/jeux/soulmask per farti conoscere.

Prerequisiti

• Sistema: Linux o Windows.
• Hardware (indicazione della community, non ufficiale): RAM 16 GB min.; disco —.
• Account Steam: SteamCMD scarica il server con login anonimo; solo i giocatori devono possedere il gioco.
• Rete: un IP pubblico (o port forwarding) con le porte 8777/UDP, 27015/UDP aperte.
• Accesso: SSH (Linux) o Desktop remoto (Windows Server); si consiglia un SSD.

Installazione locale (Windows)

Installa SteamCMD (steamcmd.exe) in una cartella dedicata ed esegui i comandi seguenti in un prompt dei comandi. Poi avvia il server e connettiti dal gioco a 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

Installazione su VPS o server dedicato Linux (Ubuntu/Debian)

Crea un utente dedicato senza privilegi di root, installa le dipendenze a 32 bit richieste da SteamCMD e scarica il server. Adatta nome utente e cartelle alle tue abitudini.

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

Porte da aprire

Valori predefiniti; il traffico è in ingresso (verso il server).

Per cambiare una porta, modificala nella configurazione o nella riga di avvio del server (-Port, -QueryPort, -EchoPort) e adatta il firewall.

• 8777/UDP — gioco
• 27015/UDP — query Steam / elenco server
• 18888/TCP — console telnet (solo locale, non esporre)
• 19000/TCP — RCON (opzionale, non esporre senza una password robusta)

Firewall Linux (ufw), provider e router

Consenti prima SSH per non restare bloccato, poi le porte del gioco. Le porte sono raggiungibili solo se aperte anche nel firewall del provider (OVH, Hetzner, Scaleway…: «security group» o regole di rete del pannello).

Hosting in casa: crea un port forwarding (NAT) sul router verso l'IP locale fisso del server, con le stesse porte e protocolli. Se il tuo operatore usa il CGNAT (nessun IPv4 pubblico) l'inoltro è impossibile: chiedi un IP pubblico o affitta un VPS.

Test: l'UDP non si verifica con un semplice port checker web; controlla collegandoti dal gioco da una rete esterna (ad esempio un hotspot mobile) e consulta i log del server.

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

Firewall di Windows (netsh)

Esegui questi comandi in un prompt dei comandi avviato come amministratore. Se ospiti in casa, aggiungi anche l'inoltro delle porte sul router.

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

Avvio automatico su Linux (systemd)

Il servizio riavvia il server dopo un crash e all'avvio della macchina. Attivalo con i comandi indicati nel blocco.

[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

Avvio automatico su Windows (attività pianificata)

Crea un'attività che esegua lo script di avvio all'avvio di Windows, se possibile con un account dedicato. Adatta il percorso dello 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"

Aggiornamenti, backup e riavvii

Ferma il server prima di ogni aggiornamento, salva i dati e riavvia. Pianifica i backup con cron (Linux) o l'Utilità di pianificazione (Windows) e un riavvio giornaliero se il gioco ha perdite di memoria.

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>

Pubblicare e trovare il tuo server

Quando il server è stabile, aggiungilo su game-rank.com/jeux/soulmask (sito del proprietario di questi strumenti) con indirizzo di connessione, slot, lingua e versione. Indirizzo di connessione diretta da condividere: <IP>:8777 (a seconda della versione del gioco). Non pubblicare mai una password di amministrazione.

Risoluzione dei problemi

• Il server non compare nell'elenco — causa: porte di query chiuse o server non elencato. Soluzione: apri 8777/UDP, 27015/UDP, controlla nome/password e attendi qualche minuto; connettiti direttamente via IP per provare.
• Impossibile connettersi da Internet ma in locale funziona — causa: firewall di sistema/provider, port forwarding mancante o CGNAT. Soluzione: controlla i tre livelli (ufw/Windows, provider, router) e il protocollo (UDP/TCP).
• Il server si chiude all'avvio o finisce la memoria — causa: RAM insufficiente, librerie mancanti o cartella di lavoro errata. Soluzione: avvialo in primo piano, leggi i log, aggiungi RAM o swap.
• I giocatori vedono una versione incompatibile dopo un aggiornamento del gioco — causa: server non aggiornato. Soluzione: fermalo, aggiornalo (vedi la sezione Aggiornamenti) e riavvialo.
• Le modifiche alla configurazione vengono ignorate o sovrascritte — causa: file modificato a server attivo, cartella sbagliata o errore di sintassi. Soluzione: ferma il server, modifica il file giusto, valida la sintassi (JSON/XML) e riavvia.

Domande frequenti

Di quale macchina ho bisogno per un server Soulmask?

Hardware (indicazione della community, non ufficiale): RAM 16 GB min.; disco —.

Quali porte devo aprire?

Apri 8777/UDP, 27015/UDP in ingresso, nel firewall di sistema, presso il provider e sul router se necessario. Sono i valori predefiniti e si possono cambiare nella configurazione del server.

Devo possedere il gioco per ospitare?

Il server dedicato si scarica gratuitamente con SteamCMD (login anonimo); solo i giocatori devono possedere il gioco.

Come aggiorno il server?

Ferma il server, riesegui il comando SteamCMD +app_update 3017300 (Linux) / 3017310 (Windows) validate (vedi la sezione Aggiornamenti) e riavvia. Per un ramo beta, aggiungi -beta <nome>.

Posso ospitarlo a casa?

Sì, se la tua connessione ha un IP pubblico e puoi inoltrare le porte sul router. Con CGNAT o upload scarso è meglio un VPS o un server dedicato.