Rojo

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

Rojo est un outil communautaire qui adopte une approche "système de fichiers d'abord" pour les projets Roblox. Il exécute un serveur sur votre machine qui communique avec un plugin Studio pour synchroniser les fichiers sur votre disque avec le modèle de données de Studio, et il peut construire des fichiers de lieu et de modèle à partir de ces fichiers. Avec votre projet sur disque, vous pouvez utiliser Git, votre propre éditeur et CI.

Comment vous utilisez Rojo dépend de la quantité de votre jeu que vous souhaitez qu'il gère :

  • Gestion partielle: Rojo gère votre code, et Git est sa source de vérité. Les lieux et les actifs restent sur Roblox, où les artistes les modifient avec Team Create et des packages. Nous recommandons cela pour la plupart des équipes qui utilisent Git.
  • Gestion complète: Rojo gère l'ensemble de votre jeu, y compris les modèles et les images. Git est la source de vérité pour tout, et CI construit et publie vos lieux.

Pour comparer cela avec un flux de travail natif de Studio, consultez Comparer les flux de travail basés sur des fichiers.

Installer Rojo

Vous pouvez télécharger et exécuter manuellement un binaire Rojo, mais cette approche comporte le risque que différentes personnes de votre équipe utilisent différentes versions de Rojo. Une meilleure solution est d'utiliser un gestionnaire de chaîne d'outils comme Rokit, qui utilise un fichier de configuration, une liste de dépôts et de versions, pour rendre le processus d'installation et de mise à niveau cohérent sur les machines.

Parce qu'il gère votre environnement de développement de base plutôt que les packages au sein de votre projet, Rokit est plus semblable à nvm qu'à npm, mais la comparaison n'est pas parfaite. Un simple fichier rokit.toml ressemble à ceci :

[tools]
rojo = "rojo-rbx/rojo@7.6.1"
wally = "upliftgames/wally@0.3.2"
lune = "lune-org/lune@0.10.4"

Ensuite, vous installez ces outils avec rokit install. En plus d'un fichier global rokit.toml, Rokit prend en charge des fichiers par projet, vous permettant d'utiliser facilement différentes versions de Rojo, Wally ou tout autre outil pour différents projets et de garder toute votre équipe sur ces mêmes versions.

Lorsqu'un outil publie une nouvelle version, vous augmentez alors explicitement le numéro de version dans votre fichier .toml, utilisez Rokit pour effectuer la mise à niveau, testez la nouvelle version et revenez en arrière si cela cause des problèmes. Pour les commandes et les instructions d'installation, consultez Rokit.

Exécuter Rojo

Après avoir installé Rojo avec Rokit, ce que vous avez vraiment installé est le serveur Rojo. L'étape suivante consiste à installer le plugin Rojo pour Roblox Studio.

Vous pouvez l'installer depuis le Creator Store ou l'installer localement avec cette commande :

rojo plugin install

Ensuite, générez la structure du projet pour votre nouveau jeu et construisez-le :

rojo init my-new-experience
cd my-new-experience
rojo build -o my-new-experience.rbxl

Alternativement, vous pouvez porter un jeu existant. Quoi qu'il en soit, après avoir un projet, démarrez le serveur Rojo :

rojo serve

Dans Roblox Studio, ouvrez le fichier .rbxl que vous venez de construire, ouvrez le plugin Rojo et connectez-vous à votre serveur en cours d'exécution, à quel point vous pouvez commencer à apporter des modifications dans votre éditeur de texte préféré et voir ces modifications se synchroniser automatiquement avec Studio.

Visual Studio Code avec un projet Rojo ouvert.

Le plugin Rojo et l'Explorateur Studio côte à côte.

Les projets Rojo ont certaines exigences de nommage pour les fichiers, de nombreuses options de configuration et certaines limitations, toutes couvertes dans la documentation de Rojo.

Dépanner Rojo

ProblèmeSolution
Rojo échoue à synchroniser, ou se comporte différemment sur différentes machines.Les membres de l'équipe utilisent différentes versions de Rojo ou de plugin. Fixez les versions dans rokit.toml et exécutez rokit install.
Le code est synchronisé au mauvais endroit.Ajoutez servePlaceIds à votre fichier de projet afin que Rojo ne synchronise que vers les lieux que vous listez.
Rojo a supprimé du contenu que les artistes ont ajouté.Définissez $ignoreUnknownInstances sur true sur les services que Rojo et les artistes utilisent.
©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.