Comparer les flux de travail basés sur des fichiers

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

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 à StudioPartiellement 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 versionScriptsScripts, configuration de projet et outilsTout, y compris les modèles et les images
Édition de contenuTeam CreateTeam Create et packagesFichiers dans Git, construits par CI
Outils à maintenirAucun au-delà de Studio et d'un éditeurRojo plus des outils de linting et CIRojo, 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

OutilCe qu'il faitUtilisé 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 SyncSynchronise les scripts dans Studio avec des fichiers sur votre disque local, dans les deux sens.Natif à Studio
PackagesGroupes 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 versionsVersions sauvegardées de chaque lieu que vous pouvez visualiser, comparer et restaurer.Tous les flux de travail
API de publication de lieuAPI 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 LuauAPI 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 actifsAPI 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é

OutilCe qu'il faitUtilisé dans
RojoSynchronise 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é
RokitGestionnaire 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é
WallyGestionnaire de paquets pour les bibliothèques Luau de la communauté.Partiellement géré, entièrement géré
LuneRuntime Luau autonome, couramment utilisé pour des scripts de construction, de déploiement et d'automatisation.Partiellement géré, entièrement géré
seleneLinter Luau.Tous les flux de travail
StyLuaFormateur de code Luau.Tous les flux de travail
Serveur de langage LuauAutocomplétion et vérification de type dans des éditeurs externes.Tous les flux de travail
TarmacTé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-mergeDiff 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 :

EnvironnementButQui le met à jour
Développement personnelLa 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é.
ActifsLes versions canoniques des packages, comme les personnages, les kits de construction et les décors.Artistes
StableUn instantané du développement partagé à un intervalle régulier, comme pour des tests de jeu hebdomadaires.CI uniquement
ProductionLe jeu en direct et public.Copié depuis stable après approbation de la publication

Créer un lieu de développement personnel

  1. Ouvrez le lieu de développement partagé dans Studio.
  2. Sélectionnez Fichier ⟩ Publier sous.
  3. Sélectionnez le groupe qui possède vos jeux de développement.
  4. Publiez le lieu en tant que nouveau jeu avec un nom qui vous identifie et identifie le projet, comme USER / VotreNom - NomDuProjet.
  5. 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 travailGuide de configuration
Natif à StudioUtiliser 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èmeSolution
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.
©2026 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.