Rojo é uma ferramenta da comunidade que adota uma abordagem "primeiro o sistema de arquivos" para projetos Roblox. Ele executa um servidor na sua máquina que se comunica com um plugin do Studio para sincronizar arquivos no seu disco com o modelo de dados do Studio, e pode construir arquivos de lugar e modelo a partir desses arquivos. Com seu projeto no disco, você pode usar Git, seu próprio editor e CI.
Como você usa o Rojo depende de quanto do seu jogo você deseja que ele gerencie:
- Gerenciado parcialmente: O Rojo gerencia seu código, e o Git é sua fonte de verdade. Lugares e ativos permanecem na Roblox, onde os artistas os editam com o Team Create e pacotes. Recomendamos isso para a maioria das equipes que usam Git.
- Gerenciado totalmente: O Rojo gerencia todo o seu jogo, incluindo modelos e imagens. O Git é a fonte de verdade para tudo, e o CI constrói e publica seus lugares.
Para comparar isso com um fluxo de trabalho nativo do Studio, veja Comparar fluxos de trabalho baseados em arquivos.
Instalar o Rojo
Você pode baixar e executar manualmente um binário do Rojo, mas essa abordagem corre o risco de diferentes pessoas na sua equipe usarem diferentes versões do Rojo. Uma solução melhor é usar um gerenciador de toolchain como o Rokit, que usa um arquivo de configuração, uma lista de repositórios e versões, para tornar o processo de instalação e atualização consistente entre as máquinas.
Como ele gerencia seu ambiente de desenvolvimento básico em vez dos pacotes dentro do seu projeto, o Rokit é mais semelhante ao nvm do que ao npm, mas a comparação não é perfeita. Um simples arquivo rokit.toml se parece com isso:
[tools]
rojo = "rojo-rbx/rojo@7.6.1"
wally = "upliftgames/wally@0.3.2"
lune = "lune-org/lune@0.10.4"Então você instala essas ferramentas com rokit install. Além de um arquivo global rokit.toml, o Rokit suporta arquivos por projeto, para que você possa facilmente usar diferentes versões do Rojo, Wally ou qualquer outra ferramenta para diferentes projetos e manter toda a sua equipe nessas mesmas versões.
Quando uma ferramenta lança uma nova versão, você então aumenta explicitamente o número da versão no seu arquivo .toml, usa o Rokit para realizar a atualização, testa a nova versão e reverte se causar algum problema. Para comandos e instruções de instalação, veja Rokit.
Executar o Rojo
Depois de instalar o Rojo com o Rokit, o que você realmente instalou é o servidor Rojo. O próximo passo é instalar o plugin Rojo para o Roblox Studio.
Você pode instalá-lo a partir da Creator Store ou instalá-lo localmente com este comando:
rojo plugin installEntão, gere a estrutura do projeto para seu novo jogo e construa-o:
rojo init my-new-experience
cd my-new-experience
rojo build -o my-new-experience.rbxlAlternativamente, você pode portar um jogo existente. De qualquer forma, depois de ter um projeto, inicie o servidor Rojo:
rojo serveNo Roblox Studio, abra o arquivo .rbxl que você acabou de construir, abra o plugin Rojo e conecte-se ao seu servidor em execução, momento em que você pode começar a fazer alterações no seu editor de texto preferido e ver essas alterações sincronizarem automaticamente de volta para o Studio.


Projetos Rojo têm certos requisitos de nomenclatura para arquivos, inúmeras opções de configuração e algumas limitações, todas as quais são cobertas na documentação do Rojo.
Solucionar problemas do Rojo
| Problema | Solução |
|---|---|
| O Rojo falha ao sincronizar ou se comporta de maneira diferente em diferentes máquinas. | Membros da equipe estão em diferentes versões do Rojo ou do plugin. Fixe as versões no rokit.toml e execute rokit install. |
| Código sincronizado no lugar errado. | Adicione servePlaceIds ao seu arquivo de projeto para que o Rojo sincronize apenas com os lugares que você listar. |
| O Rojo deletou conteúdo que os artistas adicionaram. | Defina $ignoreUnknownInstances como true nos serviços que tanto o Rojo quanto os artistas usam. |