Les jeux Roblox vivent dans le cloud par défaut. Studio enregistre vos lieux, actifs et scripts sur Roblox, et Historique des versions suit les modifications apportées à chaque lieu. De nombreuses équipes souhaitent également que leur jeu soit dans un système de contrôle de version comme Git afin de pouvoir examiner les modifications avant qu'elles ne soient appliquées, conserver un historique complet et automatiser les builds et les déploiements.
Chaque flux de travail de contrôle de version pour Roblox répond à une question : où se trouve la source de vérité pour chaque partie de votre jeu ? Les trois réponses courantes sont :
- Natif à Studio : Le lieu sur Roblox est la source de vérité pour tout. Script Sync copie les scripts dans Git afin que vous puissiez les examiner et les suivre.
- Partiellement géré : Git est la source de vérité pour le code. Le lieu sur Roblox est la source de vérité pour tout le reste, comme les modèles, le terrain et l'interface utilisateur.
- Entièrement géré : Git est la source de vérité pour l'ensemble du jeu. Les lieux sur Roblox sont des sorties de construction que CI publie à partir du dépôt.
Cette page compare ces flux de travail, décrit les outils utilisés par chacun et couvre les environnements que les équipes mettent en place autour d'eux. Pour configurer un flux de travail, consultez Configurer un flux de travail.
Feuille de route pour les flux de travail basés sur des fichiers
Roblox travaille à des flux de travail basés sur des fichiers de première partie afin que les équipes puissent utiliser le contrôle de version sans assembler d'outils tiers. Jusqu'à ce que ces flux de travail soient disponibles, les configurations sur cette page reflètent ce qui fonctionne pour les équipes aujourd'hui.
Comparaison des flux de travail
Natif à Studio
Partiellement géré
Entièrement géré
| Natif à Studio | Partiellement géré | Entièrement géré | |
|---|---|---|---|
| Bon choix pour | Équipes de moins de cinq créateurs travaillant sur un jeu à un seul lieu | Équipes avec plusieurs programmeurs et des jeux multi-lieux | Équipes qui nécessitent une révision et un historique pour chaque instance et actif |
| Dans le contrôle de version | Scripts | Scripts, configuration de projet et outils | Tout, y compris les modèles et les images |
| Édition de contenu | Team Create | Team Create et packages | Fichiers dans Git, construits par CI |
| Outils à maintenir | Aucun au-delà de Studio et d'un éditeur | Rojo plus des outils de linting et CI | Rojo, outils de fusion et d'actifs, et un pipeline CI complet |
Choisir un flux de travail
Commencez par le flux de travail le plus simple qui répond à vos besoins. Vous pouvez passer à un flux de travail plus géré plus tard, car aucun de ces outils ne vous enferme. La plupart des équipes n'ont pas besoin de Rojo entièrement géré, et cela ajoute une complexité significative.
Outils
La plupart des configurations combinent quelques outils de Roblox avec quelques-uns de la communauté.
Outils Roblox
| Outil | Ce qu'il fait | Utilisé dans |
|---|---|---|
| Team Create | Édition collaborative en temps réel dans Studio, le mieux adapté à la construction, la conception de niveaux et l'art. | Tous les flux de travail |
| Script Sync | Synchronise les scripts dans Studio avec des fichiers sur votre disque local, dans les deux sens. | Natif à Studio |
| Packages | Groupes d'instances réutilisables et versionnés que vous pouvez mettre à jour à travers des lieux et des jeux. | Natif à Studio, partiellement géré |
| Historique des versions | Versions sauvegardées de chaque lieu que vous pouvez visualiser, comparer et restaurer. | Tous les flux de travail |
| API de publication de lieu | API Cloud ouverte qui publie un fichier de lieu sur Roblox. Utilisez-la pour déployer depuis CI. | Partiellement géré, entièrement géré |
| API d'exécution Luau | API Cloud ouverte qui exécute Luau dans un lieu sur les serveurs Roblox. Utilisez-la pour exécuter des tests depuis CI. | Partiellement géré, entièrement géré |
| API des actifs | API Cloud ouverte qui télécharge et met à jour des actifs comme des images, de l'audio et des modèles. | Entièrement géré |
Outils de la communauté
| Outil | Ce qu'il fait | Utilisé dans |
|---|---|---|
| Rojo | Synchronise les fichiers sur le disque dans Studio via un serveur local et un plugin Studio, et construit des fichiers de lieu et de modèle à partir d'un fichier de projet. La commande rojo syncback, dans Rojo 7.7 et ultérieur, convertit un lieu existant en fichiers de projet. | Partiellement géré, entièrement géré |
| Rokit | Gestionnaire de chaîne d'outils. Fixe les versions des outils afin que tout le monde dans l'équipe utilise les mêmes. | Partiellement géré, entièrement géré |
| Wally | Gestionnaire de paquets pour les bibliothèques Luau de la communauté. | Partiellement géré, entièrement géré |
| Lune | Runtime Luau autonome, couramment utilisé pour des scripts de construction, de déploiement et d'automatisation. | Partiellement géré, entièrement géré |
| selene | Linter Luau. | Tous les flux de travail |
| StyLua | Formateur de code Luau. | Tous les flux de travail |
| Serveur de langage Luau | Autocomplétion et vérification de type dans des éditeurs externes. | Tous les flux de travail |
| Tarmac | Télécharge des images depuis le disque vers Roblox et génère un module qui associe les chemins de fichiers aux ID d'actifs. | Entièrement géré |
| rbx-merge | Diff et pilote de fusion Git pour les fichiers .rbxl, .rbxlx, .rbxm et .rbxmx. Affiche des diffs lisibles et fusionne les modifications non conflictuelles au niveau des propriétés. | Entièrement géré |
Pour installer et exécuter Rojo, consultez Rojo. Pour Rokit, Wally, les linters et d'autres outils, consultez Outils tiers.
Environnements
Les équipes qui utilisent le contrôle de version séparent généralement également leur travail en environnements, afin que les modifications inachevées n'atteignent jamais les joueurs. Au lieu d'un seul lieu que tout le monde édite, chaque environnement est son propre lieu.
Nous recommandons de créer chaque environnement en tant que jeu séparé sous le même groupe, plutôt qu'en tant que lieux séparés au sein d'un même jeu. Les magasins de données, secrets et autres services cloud sont limités au jeu, donc des jeux séparés gardent les données de test hors de la production.
Une configuration typique a ces environnements :
| Environnement | But | Qui le met à jour |
|---|---|---|
| Développement personnel | La propre copie de chaque créateur du lieu de développement pour le travail quotidien. | Ce créateur |
| Développement partagé | L'ensemble combiné et instable des fonctionnalités sur lesquelles l'équipe travaille. | Les programmeurs synchronisent le code examiné, et les artistes copient le contenu approuvé. |
| Actifs | Les versions canoniques des packages, comme les personnages, les kits de construction et les décors. | Artistes |
| Stable | Un instantané du développement partagé à un intervalle régulier, comme pour des tests de jeu hebdomadaires. | CI uniquement |
| Production | Le jeu en direct et public. | Copié depuis stable après approbation de la publication |
Créer un lieu de développement personnel
- Ouvrez le lieu de développement partagé dans Studio.
- Sélectionnez Fichier ⟩ Publier sous.
- Sélectionnez le groupe qui possède vos jeux de développement.
- Publiez le lieu en tant que nouveau jeu avec un nom qui vous identifie et identifie le projet, comme USER / VotreNom - NomDuProjet.
- Fermez le lieu de développement partagé et ouvrez votre nouvelle copie personnelle.
Utilisez des noms cohérents pour chaque environnement, tels que DEV - NomDuProjet, ASSET / NomDuProjet, et STABLE / NomDuProjet, afin que l'équipe puisse les distinguer sur le Tableau de bord des créateurs.
Configurer un flux de travail
| Flux de travail | Guide de configuration |
|---|---|
| Natif à Studio | Utiliser Script Sync avec une équipe |
| Partiellement géré | Rojo partiellement géré |
| Entièrement géré | Rojo entièrement géré |
Résoudre les problèmes courants
| Problème | Solution |
|---|---|
| Tester dans un lieu de développement modifie les données de production. | Le développement et la production sont des lieux dans le même jeu, donc ils partagent des magasins de données. Déplacez chaque environnement dans son propre jeu. |
| Les coéquipiers écrasent les modifications de script des autres. | Deux personnes synchronisent les mêmes scripts dans une session Team Create. Synchronisez le code dans des lieux de développement personnels et fusionnez via Git. |
| Une correction d'une copie d'un script ne s'applique pas aux autres. | Copier un script crée une copie indépendante. Mettez le comportement partagé dans un ModuleScript et attachez-le aux instances avec des balises CollectionService. |
| Le code réservé au serveur est visible par les clients. | Les modules dans des conteneurs qui se répliquent aux clients, comme ReplicatedStorage, sont envoyés aux clients. Gardez les modules réservés au serveur dans ServerScriptService ou ServerStorage. |