Prérequis
- Un serveur S&Box déployé chez VeryCloud
- Accès à l'onglet Startup du panel Wisp
- Connaître ton SteamID64 (utile pour la suite)
Étape 1 : La structure de la ligne de démarrage
Le binaire sbox-server.exe est appelé avec une série de switches préfixés + :
sbox-server.exe +game facepunch.sandbox +hostname "VeryCloud S&Box" +port 27015 +net_query_port 27016 +net_game_server_token TON_TOKEN
Dans Wisp, tu n'éditeras jamais cette ligne à la main : tu modifies les variables dans l'onglet Startup et le panel reconstruit la commande automatiquement.
Étape 2 : Le paramètre +game (obligatoire)
C'est le plus important. Il indique au serveur quel package charger depuis sbox.game.
Format : organisation.nom (lowercase, sans espace).
Exemples valides :
+game facepunch.sandbox
+game facepunch.walker garry.scenemap
+game c:/projects/mygame/.sbproj
Le second argument optionnel est une map spécifique. Sans elle, c'est la map par défaut du package qui charge.
⚠️
+game DeathMatchne marche pas.+game Facepunch.Sandboxnon plus. Format strict, minuscules.
Étape 3 : +hostname (nom dans la liste serveur)
+hostname "VeryCloud S&Box FR - Sandbox Pub"
Les espaces sont autorisés (entre guillemets). Garde un nom court : la plupart des gamemodes tronquent au-delà de 30-40 caractères dans leur UI de lobby.
Étape 4 : +net_game_server_token (Steam ID persistant)
Sans ce token, ton serveur génère un nouveau Steam ID à chaque redémarrage. Conséquences :
- Les joueurs en favoris perdent ton serveur
- Les "recent servers" de tes joueurs ne pointent plus dessus
- Les statistiques par-serveur (côté gamemode) repartent à zéro
Générer un token :
- Va sur https://steamcommunity.com/dev/managegameservers
- Renseigne l'App ID : 1892930 (serveur S&Box dédié)
- Récupère la chaîne du token
- Colle-la dans la variable
SERVER_TOKENdu Startup Wisp
💡 Tu dois générer un token par serveur. Réutiliser le même sur plusieurs instances posera problème.
Étape 5 : +port et +net_query_port
+port: port UDP principal du jeu (défaut 27015)+net_query_port: port de requête Steam pour l'apparition dans la liste (défaut 27016)
Chez VeryCloud, ces ports sont gérés dans Network depuis le panel. Si tu changes le port côté Wisp, vérifie que les deux variables PORT et QUERY_PORT sont bien alignées avec l'allocation.
Étape 6 : Ce qui n'existe PAS dans S&Box
Plusieurs paramètres qu'on s'attend à trouver (héritage Source 1 / GMod) ne sont pas exposés :
| Paramètre | Statut |
|---|---|
+maxplayers | ❌ Géré par le gamemode |
+tickrate / sv_minrate / sv_maxrate | ❌ Pas exposé publiquement |
+map (en flag séparé) | ❌ La map est le 2e argument de +game |
rcon_password | ❌ Pas d'RCON Source 1 standard |
| VAC / EAC / BattlEye | ❌ Pas d'anticheat officiel annoncé |
Tout tuto qui mentionne +maxplayers ou rcon_password pour S&Box est probablement copié-collé d'un guide GMod et incorrect.
Étape 7 : Sauvegarder et appliquer
Dans Wisp :
- Modifie tes variables dans Startup
- Clique sur Save en bas de page
- Redémarre le serveur (les changements de startup ne s'appliquent qu'au boot suivant)
Surveille le Log Viewer pendant le redémarrage : la commande complète est loggée en début de boot, tu peux vérifier qu'elle correspond à ce que tu as configuré.
Dépannage
Le serveur démarre mais n'apparaît pas dans la liste
- Vérifie que
+net_query_portest correctement forwardé (UDP) côté allocation - Confirme que le package du gamemode supporte le listing public
- Attends 1-2 minutes : la propagation Steam peut prendre du temps
Le token Steam donne une erreur
- AppID 1892930 bien renseigné (pas 590830 qui est le client)
- Token recopié intégralement, sans espace en début ou fin
- Un token n'est valide que pour un seul serveur à la fois
La map ne charge pas
- Format
org.nameaussi pour les maps :garry.scenemap, passcenemap - Vérifie que la map est compatible avec le package que tu charges
Commandes utiles
# Voir la commande de boot dans les logs
# -> Log Viewer, premieres lignes apres START
# Lister les sessions actives (depuis la console)
status
# Redemarrer proprement
# -> bouton RESTART sur la vue Console (envoi SIGTERM)
Conclusion
Tu maîtrises maintenant les paramètres de démarrage S&Box : +game est le seul vraiment indispensable, +hostname et +net_game_server_token sont essentiels pour un serveur public stable, et plusieurs ConVars du monde Source 1 n'existent pas ici.
Pour aller plus loin : configurer les permissions admin via users/config.json, installer des gamemodes additionnels, planifier des restarts automatiques.