Outils tiers

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

Pour les studios de développement professionnels, la mise en place d'outils tiers et l'investissement dans l'automatisation peuvent considérablement améliorer la productivité des développeurs. L'approche cloud-first de Roblox présente de nombreux avantages, mais déplacer certaines parties du flux de travail de développement en dehors du cloud peut aider les équipes plus importantes à suivre les changements au fil du temps, à examiner le code et à utiliser les langages et outils avec lesquels elles sont déjà familières.

  • Si vous souhaitez simplement utiliser un éditeur de texte externe ou conserver le code dans un contrôle de version, Script Sync est un excellent choix.
  • Si vous souhaitez gérer l'ensemble de votre projet sous forme de fichiers locaux, cette page couvre certains outils et stratégies.
  • Pour comparer les flux de travail d'équipe complets et leurs compromis, consultez Comparer les flux de travail basés sur des fichiers.

Le problème de synchronisation

Au cœur de l'utilisation d'outils externes avec Roblox se trouve un problème de synchronisation :

  • Vous voulez que vos instances Roblox existent sous forme de fichiers sur le disque afin que vous puissiez utiliser vos propres outils pour travailler dessus.
  • Vous devez récupérer vos fichiers dans votre projet Roblox après avoir terminé de travailler dessus.
  • Si quelqu'un d'autre a modifié ces mêmes fichiers entre-temps, vous devez gérer les conflits.

Pour que l'ensemble de la solution semble fluide et automatique, vous devez a) écouter les changements apportés aux fichiers et b) intégrer ces changements dans Studio.

Plutôt que l'approche cloud-first de Roblox, Rojo permet une approche "file system-first". Il exécute un serveur sur votre machine qui communique avec un plugin Studio pour synchroniser vos fichiers et le modèle de données de Studio.

Rojo

Rojo est l'outil le plus courant pour synchroniser des fichiers avec Studio. Pour l'installer et l'exécuter, et pour choisir entre des projets partiellement ou entièrement gérés, consultez Rojo.

Rokit

Différents membres de l'équipe utilisant différentes versions du même outil provoquent des problèmes difficiles à diagnostiquer. Un gestionnaire de chaîne d'outils comme Rokit résout cela avec un fichier rokit.toml qui répertorie chaque outil et sa version, de sorte que rokit install configure les mêmes versions sur chaque machine. Comme il gère votre environnement de développement de base plutôt que les paquets au sein de votre projet, Rokit est plus semblable à nvm qu'à npm. Pour un exemple de rokit.toml, consultez Installer Rojo.

Gestionnaires de paquets

Roblox dispose d'un ensemble robuste d'API incluses, mais si vous souhaitez utiliser des paquets logiciels communautaires de manière cohérente et reproductible, vous avez besoin d'un gestionnaire de paquets. Wally est une option populaire. Vous pouvez l'installer via Rokit, tout comme Rojo.

Dans le répertoire Rojo de votre jeu, exécutez wally init. Ensuite, ajoutez vos paquets souhaités à wally.toml. Le fichier pourrait ressembler à ceci :

[package]
name = "my-home-directory/my-new-experience"
version = "0.1.0"
registry = "https://github.com/UpliftGames/wally-index"
realm = "shared"
[dependencies]
react = "jsdotlua/react@17.2.1"
react-roblox = "jsdotlua/react-roblox@17.2.1"
cryo = "phalanxia/cryo@1.0.3"

Ensuite, exécutez wally install. Wally crée un répertoire Packages et télécharge les paquets spécifiés là-bas. L'étape finale consiste à ajouter le répertoire Packages à Rojo afin que son contenu se synchronise avec Roblox. Ouvrez default.project.json et ajoutez le chemin. Pour simplifier, cet exemple ajoute l'ensemble du répertoire à ReplicatedStorage afin que tous les paquets soient disponibles pour tous les scripts, mais vous pourriez préférer ajouter des paquets spécifiques à ServerScriptService ou StarterPlayerScripts :

{
"name": "my-new-experience",
"tree": {
"$className": "DataModel",
"ReplicatedStorage": {
"Shared": {
"$path": "src/shared"
},
"Packages": {
"$path": "Packages"
}
},
...
}
}

Ensuite, vous pouvez exiger des paquets dans vos scripts comme n'importe quel autre ModuleScript :

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local React = require(ReplicatedStorage.Packages.react)
local ReactRoblox = require(ReplicatedStorage.Packages["react-roblox"])
local handle = Instance.new("ScreenGui", Players.LocalPlayer.PlayerGui)
local root = ReactRoblox.createRoot(handle)
local helloFrame = React.createElement("TextLabel", {
Text = "Bonjour le monde !",
Size = UDim2.new(0, 200, 0, 200),
Position = UDim2.new(0.5, 0, 0.5, 0),
AnchorPoint = Vector2.new(0.5, 0.5),
BackgroundColor3 = Color3.fromRGB(248, 217, 109),
Font = Enum.Font.LuckiestGuy,
TextSize = 24
})
root:render(helloFrame)

Comme la plupart des autres projets logiciels, l'objectif est que les contributeurs puissent cloner un dépôt, installer Rokit, exécuter quelques commandes et avoir le même environnement de développement que le reste de l'équipe.

Contrôle de version

Avoir un ensemble de fichiers texte brut sur votre ordinateur débloque une variété de capacités, mais la principale est le contrôle de version. Vous pouvez stocker vos fichiers dans un dépôt Git ou Mercurial ; héberger des dépôts distants et examiner les modifications de code dans GitHub, GitLab ou Bitbucket ; et utiliser l'éditeur de texte de votre choix.

Visual Studio Code et Cursor ont l'écosystème d'extensions le plus vaste, mais Sublime Text, Notepad++ et Vim sont tous des choix populaires. Quel que soit l'éditeur que vous choisissez, faire correspondre les capacités de l'éditeur de script de Studio nécessitera certaines extensions.

Vous pourriez également envisager d'ajouter :

Outils de construction, d'actifs et de fusion

  • Lune est un runtime Luau autonome que de nombreuses équipes utilisent pour des scripts de construction, de déploiement et d'automatisation.
  • 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.
  • rbx-merge permet à Git d'afficher des différences lisibles des fichiers de lieu et de modèle Roblox et de fusionner des modifications qui ne sont pas en conflit. Pour la configuration, consultez Rojo entièrement géré.

Annuler tout

Parce que les outils tiers synchronisent les changements avec Roblox Studio plutôt que de le remplacer, aucune partie de ce flux de travail n'implique de verrouillage. À tout moment, vous pouvez cesser d'utiliser un ou tous ces outils et revenir à l'édition de votre jeu exclusivement dans Studio. L'absence de risque rend l'expérimentation avec des outils tiers particulièrement attrayante.

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