Facepunch publie les prochaines modifications de s&box dans une branche Steam appelée staging. Les créateurs peuvent y ouvrir leurs projets avec la prochaine version, repérer les problèmes à temps et les signaler avant que ces modifications arrivent dans la version publique par défaut.
Les joueurs peuvent aussi utiliser staging pour essayer les nouveautés en avance, mais cette version peut être instable. Pour les développeurs, l’essentiel est de savoir si une mise à jour du moteur casse un jeu tant qu’il est encore temps de le corriger.
Qu’est-ce que la branche staging ?
La version publique par défaut est celle qu’utilisent la plupart des joueurs. Staging la précède. Les nouvelles API, les changements de l’éditeur, les correctifs du moteur et parfois les changements incompatibles y arrivent avant la version publique.
Le développement du moteur est visible dans le dépôt sbox-public de Facepunch. Sa branche master montre les travaux en cours, tandis que staging est la version Steam fournie par Facepunch pour tester les changements à venir. Elles évoluent de près, mais une version Steam n’est pas forcément une copie exacte du dernier commit GitHub.
Passer sur staging dans Steam
Dans Steam, le choix de la branche se trouve désormais sous Game Versions & Betas. Sélectionnez staging pour s&box ; l’éditeur change avec le jeu, sans branche distincte à choisir.
- Faites un clic droit sur s&box dans votre bibliothèque Steam et ouvrez Propriétés.
- Ouvrez Game Versions & Betas et sélectionnez staging.
- Attendez que Steam termine le téléchargement avant d’ouvrir votre projet.
Avant de changer de branche : Sauvegardez votre projet ou validez vos modifications avant de changer de branche si vous avez du travail en cours.
Ne testez pas seulement le lancement de l’éditeur
Une compilation réussie est un bon début, mais ce n’est pas un test complet. Vérifiez les parties du jeu qui dépendent le plus du moteur.
- Compilez après un démarrage propre de l’éditeur et vérifiez la console.
- Chargez le menu principal et chaque scène importante.
- Hébergez une partie multijoueur et rejoignez-en une.
- Vérifiez l’interface, les matériaux, les shaders, l’audio et le chargement des ressources.
- Ouvrez les sauvegardes existantes ou les autres données persistantes, si le jeu en utilise.
- Démarrez un serveur dédié et connectez-vous-y, si le jeu le permet.
Signaler les régressions sur staging
Si une fonction marche dans la version par défaut mais échoue sur staging, signalez-le dans le suivi des problèmes de sbox-public. Indiquez la branche et la version, quelques étapes pour reproduire le problème et les journaux utiles. Des captures d’écran ou une courte vidéo aident pour les problèmes visuels.
Avant de signaler le problème, revenez à la version par défaut et confirmez la différence. Il sera ainsi plus facile de distinguer une régression de staging d’un problème déjà présent dans le projet.
Revenir à la version publique avant de publier
Utilisez staging pour tester et corriger le jeu, mais revenez à la version publique par défaut de s&box et faites un dernier test avant de publier. L’éditeur revient avec le jeu. Si le projet dépend d’une API uniquement disponible sur staging, attendez son arrivée dans la version publique.
Selon Facepunch, les publications sur staging ne sont d’abord jouables que sur cette branche, puis deviennent publiques à la sortie de la mise à jour du moteur. C’est utile pour préparer une sortie, mais un package construit autour d’une fonction non publiée peut ainsi finir par atteindre les joueurs de la version normale.
Règle de publication : Ne publiez pas depuis staging sauf si vous voulez volontairement diffuser une version staging. Testez sur staging ; vérifiez et publiez dans la version publique par défaut.