5 min read Easy 6.0k

Installer un gamemode S&Box depuis sbox.game

Published on May 18, 2026 at 03:59 PM

Comment installer un gamemode S&Box (Sandbox, Walker, gamemode communautaire, ou .sbproj local) sur ton serveur Wisp chez VeryCloud, étape par étape, avec le pourquoi du format `org.name`.

Introduction

Sur S&Box, un "gamemode" n'est pas un mod : c'est un package distribué via la plateforme officielle sbox.game (ex-asset.party). Chaque package est identifié par un format strict organisation.nom et est téléchargé automatiquement par le serveur au démarrage. Pas besoin d'uploader manuellement des fichiers comme à l'époque GMod.

Ce guide couvre les 3 cas : package public, package privé (dev), et projet local .sbproj.

Prérequis

Un serveur S&Box actif chez VeryCloud
L'ident du package que tu veux installer (ex : facepunch.sandbox)
Pour les projets locaux : accès SFTP au serveur

Étape 1 : Trouver l'ident d'un gamemode

Va sur https://sbox.game/ et cherche le gamemode souhaité. L'URL te donne directement l'ident :

https://sbox.game/facepunch/sandbox
                  ^^^^^^^^^^^^^^^^^^
                  -> facepunch.sandbox

Le slash devient un point. Tout est en minuscules.

💡 Si le package n'apparaît pas dans les recherches, il est peut-être privé : il faut alors être ami avec le créateur ou avoir un accès explicite via ton compte Facepunch.

Étape 2 : Configurer le serveur pour charger ce package

Dans le panel Wisp :

Ouvre Startup
Modifie la variable GAME_PACKAGE avec ton ident, ex : facepunch.sandbox
Optionnel : ajoute une map de départ dans GAME_MAP, ex : garry.scenemap
Save
Restart depuis l'onglet Console

Étape 3 : Suivre le téléchargement

Dans la console pendant le redémarrage tu dois voir :

[CloudPackages] Downloading facepunch.sandbox...
[CloudPackages] Resolved facepunch.sandbox v123.4.5
[CloudPackages] Downloaded 145 MB
[Game] Loading scene...

Le téléchargement passe par les CDN sbox.game. C'est généralement rapide (10-60 secondes) selon la taille du package. Pour un gros gamemode RP avec assets custom, ça peut atteindre plusieurs centaines de Mo.

Étape 4 : Cas d'un package privé (dev preview)

Si tu développes ton propre gamemode et que tu ne veux pas le publier :

Option A — Garder le package privé sur sbox.game

Publie le package sur ton compte sbox.game en mode privé. Sur le serveur, l'ident reste tonorga.tonprojet, mais seuls les joueurs ayant accès au package pourront se connecter.

Option B — Charger un .sbproj local

Tu uploades ton projet directement sur le serveur via SFTP, puis tu pointes +game vers le .sbproj :

+game /home/container/projects/mongame/.sbproj

Dans Wisp, ouvre Settings → SFTP Details pour récupérer tes credentials, puis utilise un client comme FileZilla ou WinSCP pour uploader le dossier complet du projet.

⚠️ Avec un .sbproj local, les clients qui se connectent téléchargent le code source du gamemode depuis ton serveur (streaming). C'est plus lent qu'un package cloud, mais c'est la seule manière de faire du serverside-only code : les packages publiés sur sbox.game ont leur code serveur strippé.

Étape 5 : Changer de gamemode

Pour passer d'un gamemode à un autre, il suffit de :

Stop le serveur depuis la console
Modifier GAME_PACKAGE dans Startup
Save, puis Start

💡 Pense à faire un backup avant de switcher de gamemode si tu as des données de jeu persistées (sauvegardes de map, BDD, etc.).

Étape 6 : Forcer un re-download d'un package

Si un package est buggé ou s'il a été mis à jour côté sbox.game et que ton serveur a un cache désynchronisé :

Stop le serveur
Va dans Files, navigue vers cloud/packages/ (chemin selon l'image Wisp)
Supprime le dossier du package
Restart : il sera re-téléchargé proprement

Alternativement, utilise le bouton Steam Update dans Settings.

Dépannage

Failed to resolve package facepunch.sandbox

Tape l'ident en minuscules strictement
Vérifie ta connexion vers sbox.game (ping/curl depuis le node si tu as un accès console)
Le package existe-t-il ? Va sur sbox.game et vérifie

Le serveur charge mais la map est noire / vide

La map spécifiée n'est pas compatible avec le package
Essaye sans +map : le serveur chargera la map par défaut du gamemode

Téléchargement bloqué à 0%

Problème côté CDN sbox.game (rare)
Force un Reinstall depuis Settings

Le package est public mais demande une authentification

Il est peut-être en accès limité (early access dev preview)
Contacte le créateur pour t'inviter

Commandes utiles

# Voir l'etat du package charge
# -> Console : status

# Forcer un reload du package (selon implementation du gamemode)
# -> Console : reload (variable selon le gamemode)

Conclusion

Installer un gamemode S&Box est trivial une fois compris le format org.name : le serveur télécharge tout seul depuis sbox.game. Pour les projets en cours de dev, le .sbproj local te donne le contrôle total au prix d'un peu plus de latence côté joueurs.

Pour aller plus loin : ajouter des maps custom, configurer les permissions admin, optimiser le serveur pour ton gamemode.