Rojo entièrement géré

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

Un flux de travail d'équipe pour les projets Roblox où tout vit dans Git : code, configuration, art et mise en page des niveaux. Les lieux sont construits à partir du dépôt, jamais modifiés à la main, et chaque construction peut être retracée jusqu'à un commit.

Comment cela change le rôle de Studio

Ce flux de travail considère Roblox Studio comme exactement deux choses :

  1. Une cible de déploiement. Rojo assemble le fichier de lieu .rbxl à partir du dépôt. Studio l'ouvre, l'exécute et le publie, mais le lieu n'est jamais la source de vérité.
  2. Un outil pour construire des modèles .rbxm. Vous construisez ou modifiez un actif ou une zone dans Studio, puis l'exportez vers le dépôt avec Enregistrer dans le fichier. Rojo regroupe les fichiers exportés dans le lieu.

Le dépôt, pas Studio, définit comment le jeu est assemblé. Le fichier de projet et la disposition des dossiers indiquent quels fichiers .rbxm vont où. Vous exportez ces fichiers depuis Studio un par un.

À cause de cela, les flux de travail habituels de Studio ne s'appliquent pas :

  • Pas de Team Create. Personne ne co-édite un lieu partagé. La collaboration se fait par le biais de branches et de PRs.
  • Pas d'édition itérative du monde dans un lieu en direct. Vous ne pouvez pas construire un niveau au fil du temps dans Dev et enregistrer le lieu. Toute modification qui n'est pas exportée vers un .rbxm et commitée est jetée lors de la prochaine construction.
  • Pas de paquets. Git fournit la version et le partage que les paquets offriraient.

Si votre équipe s'appuie sur Team Create et l'édition des niveaux dans le lieu, utilisez plutôt le flux de travail Rojo + Packages.

La version courte

  • Code, configuration, art et niveaux vivent dans Git sous src/. Les pièces d'art et de niveau sont des fichiers .rbxm.
  • Rojo construit le lieu à partir du dépôt. Le code s'itère en direct avec rojo serve. Les changements d'art arrivent en reconstruisant le lieu.
  • Tout le monde travaille dans son propre lieu Utilisateur et soumet des changements par le biais de PRs.
  • CI construit et publie Dev à chaque fusion dans main, et Stable à partir des tags de version.
  • Prod est le jeu en direct.

Lieux

Tous les lieux sont la propriété du groupe du projet.

LieuButQui le changeCommentNom
UtilisateurVotre espace de travail personnel, construit à partir de votre brancheVousrojo build + rojo serveUSER / [Nom] - [Projet] - [Niveau]
DevDernier main, utilisé pour les tests d'équipeCI uniquementConstruit et publié à chaque fusionDEV - [Projet]
StableUne construction taguée, utilisée pour les tests de jeuCI uniquementConstruit et publié à partir d'un tag de versionSTABLE / [Projet]
ProdLe jeu publicPropriétaire de la version, avec approbationCI publie une construction Stable approuvée[Projet]

Ne jamais modifier Dev ou Stable à la main. La prochaine publication CI les écrase. Si quelque chose doit être changé, changez-le dans Git.

Où vont les choses

QuoiOùFormat
Code (systèmes, bibliothèques)src/…/Systems, src/…/Libraries.luau
Configuration et définitions typéessrc/…/ManagedContent/.luau, .model.json
Actifs artistiques (props, pièces de kit, personnages, VFX)src/…/ManagedContent/Art/.rbxm, un fichier par actif
Mise en page des niveauxsrc/Workspace/Areas/.rbxm, un fichier par zone
Paramètres d'éclairage, d'espace de travail et de servicedefault.project.json$properties
Art source (FBX, PSD, textures)Git LFS ou PerforceFormats natifs

Quelques règles pour organiser les fichiers :

  • Un fichier par actif ou zone garde les diffs petits et les conflits de fusion rares. Le nom du fichier devient le nom de l'instance dans le lieu construit.
  • Utilisez .rbxm pour l'art et les niveaux. Les fichiers binaires sont beaucoup plus petits que XML lorsqu'ils contiennent des maillages. Utilisez rbx-merge pour les différencier et les fusionner ; voir ci-dessous.
  • Chaque paramètre doit être dans Git. Un lieu construit ne contient que ce qui est dans le dépôt. Des paramètres comme l'éclairage, Workspace.StreamingEnabled et Players.CharacterAutoLoads vont dans le fichier de projet. Tout ce qui est seulement défini dans Studio est perdu lors de la prochaine construction.
  • Le terrain est binaire, et Rojo ne peut pas le synchroniser en direct. Gardez-le dans son propre fichier, détenu par une seule personne. Confirmez qu'il survit à un rojo build avant de vous y fier.

Fichier de projet

{
"name": "MyGame",
"tree": {
"$className": "DataModel",
"ReplicatedStorage": { "$path": "src/ReplicatedStorage" },
"ServerScriptService": { "$path": "src/ServerScriptService" },
"Workspace": {
"$path": "src/Workspace",
"$properties": { "StreamingEnabled": true }
},
"Lighting": {
"$properties": { "Technology": "Future", "ClockTime": 14 }
}
}
}

Disposition du dépôt

src/
├── ReplicatedStorage/
│ ├── Systems/
│ ├── Libraries/
│ └── ManagedContent/
│ ├── ItemDefinitions/
│ └── Art/
│ ├── Props/Crate.rbxm
│ └── Characters/Hero.rbxm
├── ServerScriptService/
│ ├── Systems/
│ └── ManagedContent/
└── Workspace/
└── Areas/
├── Town.rbxm
└── Forest.rbxm

Pourquoi l'art est reconstruit, pas synchronisé en direct

La synchronisation en direct de Rojo (rojo serve) passe par l'API du plugin Studio, et cette API ne peut pas définir certaines propriétés : MeshPart.MeshId, terrain et parties CSG. rojo build écrit le fichier de lieu directement et n'a pas cette limitation. Voir Détails de synchronisation de Rojo.

Donc les règles sont :

  • Modifications de code et de configuration : rojo serve + Connect, comme d'habitude.
  • Modifications d'art et de niveau : reconstruisez le lieu avec rojo build, puis rouvrez-le.

Configuration (une fois par projet)

  1. Clonez le dépôt et installez la chaîne d'outils avec Rokit : exécutez rokit install.
  2. Configurez rbx-merge afin que les fichiers .rbxm soient correctement différenciés et fusionnés :
    • Une fois par dépôt, une personne exécute cela et commit le résultat : rbx-merge install --write-gitattributes.
    • Une fois par clone, tout le monde exécute rbx-merge install, puis rbx-merge doctor pour vérifier que cela a fonctionné.
  3. Configurez le stockage de l'art source : installez Git LFS (git lfs install), ou configurez l'accès au dépôt Perforce du projet.
  4. Construisez votre lieu Utilisateur :
    • Exécutez rojo build default.project.json -o build/place.rbxl, puis ouvrez build/place.rbxl dans Studio.
    • Pour tester avec d'autres, choisissez Fichier → Publier sous, sélectionnez le groupe de projet, et nommez-le USER / [Nom] - [Projet] - [Niveau].
  5. Connectez Rojo : exécutez rojo serve, puis cliquez sur Connecter dans le plugin Rojo de Studio.

Ingénieurs : la boucle de code

  1. Créez une branche à partir de main.
  2. Construisez votre lieu Utilisateur (étape de configuration 4) et connectez rojo serve.
  3. Travaillez comme d'habitude. Lorsque vous tirez des modifications d'art, reconstruisez et rouvrez le lieu.
  4. Exécutez stylua (formatage) et selene (linting) avant d'ouvrir une PR.
  5. Ouvrez une PR et faites-la examiner. CI doit exécuter un test rojo build sur chaque PR.
  6. Fusionnez dans main. CI publie la nouvelle construction dans Dev.

Artistes : la boucle d'actifs

Importation de l'art source

  1. Gardez les fichiers source (FBX, PSD, textures) dans Git LFS ou Perforce.
  2. Importez-les avec l'importateur 3D de Studio, en les téléchargeant dans le groupe de projet. Les actifs appartiennent alors au groupe, et chaque lieu construit à partir du dépôt peut les utiliser. Voir Confidentialité des actifs.
  3. Changer un maillage ou une texture signifie le télécharger à nouveau, ce qui donne un nouvel ID d'actif. Mettez à jour l'instance qui l'utilise et enregistrez à nouveau le .rbxm.

Ajouter ou changer un actif

  1. Créez une branche, construisez votre lieu Utilisateur et ouvrez-le.
  2. Construisez ou modifiez l'actif dans Studio. Gardez chaque actif comme un seul Modèle.
  3. Cliquez avec le bouton droit, choisissez Enregistrer dans le fichier → .rbxm, et enregistrez-le à son chemin sous ManagedContent/Art/…. Utilisez le même chemin pour écraser un actif existant.
  4. Reconstruisez le lieu et vérifiez que l'actif a l'air correct.
  5. Commitez et ouvrez une PR. Les réviseurs peuvent voir ce qui a changé avec git diff, que rbx-merge transforme en texte lisible.
  6. Fusionnez. CI publie le changement dans Dev.

Mise en page des niveaux

  • Chaque zone est un .rbxm sous src/Workspace/Areas/.
  • Modifiez la zone dans votre lieu Utilisateur, puis enregistrez-la à nouveau avec Enregistrer dans le fichier sur le même fichier.
  • Reconstruire jette toutes les modifications non enregistrées de Studio. Enregistrez dans le fichier avant de reconstruire ou de tirer.
  • Convenez de qui possède chaque zone. Deux personnes modifiant la même zone provoqueront généralement des conflits.

Placement des actifs dans les niveaux

  • Les lieux construits n'ont pas de liens de style paquet. Une copie d'un actif placée dans une zone ne se met pas à jour lorsque vous changez le fichier d'actif original.
  • Option 1 (recommandée) : pour les pièces de kit que vous réutilisez beaucoup, placez des marqueurs dans le niveau au lieu de copies, par exemple une Partie étiquetée nommée Crate. Un script échange chaque marqueur contre l'actif de ManagedContent/Art au moment de l'exécution. Changer le fichier d'actif met alors à jour chaque placement.
  • Option 2 : placez des copies complètes, et mettez-les à jour manuellement lorsque l'actif original change.

Fusion et conflits

  • rbx-merge fusionne les fichiers .rbxm instance par instance. Si deux personnes changent différentes choses dans le même fichier, la fusion se termine d'elle-même.
  • Si les deux côtés changent la même propriété, Git signale un conflit et rbx-merge écrit un rapport dans .rbxmerge/<file>/conflicts.txt. Pour le résoudre :
    1. Dans le rapport, définissez resolution = ours | theirs | base pour chaque conflit.
    2. Exécutez rbx-merge resolve --stash-dir .rbxmerge/<file> --out <file>.
    3. Exécutez git add <file> et continuez la fusion.
  • L'art source ne peut pas être fusionné. Utilisez le verrouillage de fichier LFS (git lfs lock) ou le checkout exclusif de Perforce afin qu'une seule personne édite un fichier à la fois.

CI : construire et publier

Le pipeline a besoin d'une clé API Open Cloud avec la permission assets et un accès Lecture et Écriture, ainsi que l'ID de chaque lieu. Stockez-les en tant que secrets CI.

DéclencheurÉtapes
Chaque PRrojo build, stylua --check, selene. Échouez la PR si l'un d'eux échoue.
Fusion dans mainrojo build -o build/place.rbxl, puis publiez-le dans Dev.
Tag de versionConstruisez le commit tagué et publiez-le dans Stable.
Version approuvéePubliez la même construction taguée dans Prod.

Chaque construction provient d'un commit, vous pouvez donc reconstruire et republier n'importe quelle version antérieure, y compris après une mauvaise version.

Communication

Donnez à chaque projet un canal général, un canal d'ingénierie (liens PR, discussion technique) et un canal artistique (WIPs, revues).

Référence

©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.