Introduction
Sur S&Box, les maps suivent la même logique que les gamemodes : ce sont des packages distribués sur sbox.game, identifiés en org.name. Une map peut être chargée comme second argument de +game, ou alors elle est embarquée dans le package du gamemode (auquel cas tu n'as rien à faire).
Prérequis
- Un serveur S&Box opérationnel chez VeryCloud
- L'ident de la map cible (ex :
garry.scenemap) - Le gamemode doit supporter la map (toutes les maps ne marchent pas avec tous les gamemodes)
Étape 1 : Trouver une map sur sbox.game
Va sur https://sbox.game/ et filtre par type Map. Chaque map a son ident org.name visible dans l'URL.
Exemples :
garry.scenemap # map de scène par défaut
facepunch.flatgrass # référence GMod
facepunch.construct # référence GMod
Étape 2 : Charger une map au démarrage
Modifie ta variable GAME_MAP (ou équivalent dans le Startup Wisp) :
GAME_PACKAGE = facepunch.sandbox
GAME_MAP = garry.scenemap
La ligne de commande générée sera :
sbox-server.exe +game facepunch.sandbox garry.scenemap +hostname "..." ...
Sauvegarde et redémarre. Le package de la map est téléchargé automatiquement depuis sbox.game (comme un gamemode).
Étape 3 : Changer de map à chaud
Beaucoup de gamemodes exposent une commande pour changer de map sans redémarrer le serveur. Ça dépend du gamemode (S&Box ne fournit pas de commande standardisée comme changelevel de Source 1).
Exemples côté gamemode (à confirmer dans la doc du package) :
# Sandbox Facepunch
map garry.scenemap
# Walker
map facepunch.flatgrass
Si la commande n'existe pas, redémarre simplement le serveur après avoir changé GAME_MAP.
Étape 4 : Précharger plusieurs maps
Pour réduire les temps de chargement quand tu changes de map, tu peux forcer le téléchargement de plusieurs packages map au boot via une commande personnalisée du gamemode (selon implémentation). Sinon, charge chaque map une fois manuellement : le cache local conserve le package téléchargé.
Étape 5 : Maps custom (créées par toi)
Si tu crées ta propre map dans l'éditeur Hammer de S&Box :
- Publie-la sur sbox.game (public ou privé via ton compte Facepunch)
- Référence l'ident
tonorga.tamapdansGAME_MAP - Restart
Cas privé / dev : si tu ne veux pas publier la map, uploade le .sbproj complet (gamemode + map) en local sur le serveur via SFTP et pointe +game vers le .sbproj. Voir le tuto sur l'installation de gamemodes pour le détail.
Étape 6 : Liste des maps disponibles côté serveur
Les maps sont mises en cache dans un dossier sous cloud/packages/. Tu peux lister via SFTP ou l'onglet Files du panel ce qui a déjà été téléchargé. C'est purement informatif : le serveur télécharge à la demande, tu n'as pas à gérer ce dossier manuellement.
Dépannage
Map not found au démarrage
- Format
org.namestrict, minuscules - La map existe-t-elle vraiment sur sbox.game ?
- Compatible avec ton gamemode ?
La map charge mais le gameplay est cassé
- Incompatibilité entre map et gamemode (entités attendues manquantes)
- Vérifie la documentation du gamemode pour la liste des maps officiellement supportées
Téléchargement lent
- Charge la map une première fois pendant une période creuse, ensuite c'est en cache local
+map ignoré
- Sur S&Box, la map n'est pas
+mapmais le 2e argument de+game - Vérifie ta variable Wisp :
GAME_MAPou équivalent doit être bien câblé
Commandes utiles
# Status apres changement de map
status
# Vider le cache d'une map specifique (SFTP)
rm -rf /home/container/cloud/packages/garry.scenemap
# Forcer reload depuis le panel
# -> bouton STOP puis START (pas RESTART, qui ne purge pas toujours le cache)
Conclusion
Ajouter des maps S&Box est aussi simple qu'éditer une variable de startup. Le système de packages cloud rend l'opération bien plus propre qu'à l'époque GMod où il fallait gérer manuellement les fichiers BSP, les addons workshop et le FastDL.
Pour aller plus loin : créer ses propres maps avec Hammer S&Box, gérer une rotation de maps via gamemode, optimiser le téléchargement initial.