Comparar fluxos de trabalho baseados em arquivos

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Os jogos Roblox vivem na nuvem por padrão. O Studio salva seus lugares, ativos e scripts no Roblox, e o Histórico de Versões rastreia as mudanças em cada lugar. Muitas equipes também desejam que seu jogo esteja em um sistema de controle de versão como o Git para que possam revisar mudanças antes de serem implementadas, manter um histórico completo e automatizar builds e implantações.

Todo fluxo de trabalho de controle de versão para Roblox responde a uma pergunta: onde vive a fonte da verdade para cada parte do seu jogo? As três respostas comuns são:

  • Nativo do Studio: O lugar no Roblox é a fonte da verdade para tudo. O Script Sync copia scripts para o Git para que você possa revisá-los e rastreá-los.
  • Parcialmente gerenciado: O Git é a fonte da verdade para o código. O lugar no Roblox é a fonte da verdade para tudo o mais, como modelos, terreno e UI.
  • Totalmente gerenciado: O Git é a fonte da verdade para todo o jogo. Os lugares no Roblox são a saída de build que o CI publica a partir do repositório.

Esta página compara esses fluxos de trabalho, descreve as ferramentas que cada um usa e cobre os ambientes que as equipes configuram ao seu redor. Para configurar um fluxo de trabalho, veja Configurar um fluxo de trabalho.

Roteiro para fluxos de trabalho baseados em arquivos

O Roblox está trabalhando em fluxos de trabalho baseados em arquivos de primeira parte para que as equipes possam usar controle de versão sem montar ferramentas de terceiros. Até que esses fluxos de trabalho sejam lançados, as configurações nesta página refletem o que funciona para as equipes hoje.

Comparação de fluxos de trabalho

Nativo do Studio

Parcialmente gerenciado

Totalmente gerenciado

Nativo do StudioParcialmente gerenciadoTotalmente gerenciado
Bom paraEquipes com menos de cinco criadores trabalhando em um jogo de um único lugarEquipes com vários programadores e jogos de múltiplos lugaresEquipes que exigem revisão e histórico para cada instância e ativo
No controle de versãoScriptsScripts, configuração do projeto e ferramentasTudo, incluindo modelos e imagens
Edição de conteúdoTeam CreateTeam Create e pacotesArquivos no Git, construídos pelo CI
Ferramentas a manterNenhuma além do Studio e um editorRojo mais ferramentas de linting e CIRojo, ferramentas de mesclagem e ativos, e um pipeline CI completo

Escolha um fluxo de trabalho

Comece com o fluxo de trabalho mais simples que atenda às suas necessidades. Você pode mudar para um fluxo de trabalho mais gerenciado depois, pois nenhuma dessas ferramentas o prende. A maioria das equipes não precisa do Rojo totalmente gerenciado, e isso adiciona complexidade significativa.

Ferramentas

A maioria das configurações combina algumas ferramentas do Roblox com algumas da comunidade.

Ferramentas do Roblox

FerramentaO que fazUsado em
Team CreateEdição colaborativa em tempo real no Studio, mais adequada para construção, design de níveis e arte.Todos os fluxos de trabalho
Script SyncSincroniza scripts no Studio com arquivos no seu disco local, em ambas as direções.Nativo do Studio
PacotesGrupos reutilizáveis e versionados de instâncias que você pode atualizar em lugares e jogos.Nativo do Studio, parcialmente gerenciado
Histórico de VersõesVersões salvas de cada lugar que você pode visualizar, comparar e restaurar.Todos os fluxos de trabalho
API de publicação de lugaresAPI de Nuvem aberta que publica um arquivo de lugar no Roblox. Use-a para implantar a partir do CI.Parcialmente gerenciado, totalmente gerenciado
API de execução LuauAPI de Nuvem aberta que executa Luau em um lugar nos servidores do Roblox. Use-a para executar testes a partir do CI.Parcialmente gerenciado, totalmente gerenciado
API de AtivosAPI de Nuvem aberta que faz upload e atualiza ativos como imagens, áudio e modelos.Totalmente gerenciado

Ferramentas da Comunidade

FerramentaO que fazUsado em
RojoSincroniza arquivos no disco com o Studio através de um servidor local e plugin do Studio, e constrói arquivos de lugar e modelo a partir de um arquivo de projeto. O comando rojo syncback, no Rojo 7.7 e posterior, converte um lugar existente em arquivos de projeto.Parcialmente gerenciado, totalmente gerenciado
RokitGerenciador de toolchain. Fixa versões de ferramentas para que todos na equipe usem as mesmas.Parcialmente gerenciado, totalmente gerenciado
WallyGerenciador de pacotes para bibliotecas Luau da comunidade.Parcialmente gerenciado, totalmente gerenciado
LuneRuntime Luau independente, comumente usado para scripts de build, deploy e automação.Parcialmente gerenciado, totalmente gerenciado
seleneLinter Luau.Todos os fluxos de trabalho
StyLuaFormatador de código Luau.Todos os fluxos de trabalho
Luau Language ServerAutocompletar e verificação de tipo em editores externos.Todos os fluxos de trabalho
TarmacFaz upload de imagens do disco para o Roblox e gera um módulo que mapeia caminhos de arquivos para IDs de ativos.Totalmente gerenciado
rbx-mergeDriver de diff e merge do Git para arquivos .rbxl, .rbxlx, .rbxm e .rbxmx. Mostra diffs legíveis e mescla mudanças não conflitantes no nível da propriedade.Totalmente gerenciado

Para instalar e executar o Rojo, veja Rojo. Para Rokit, Wally, linters e outras ferramentas, veja Ferramentas de terceiros.

Ambientes

Equipes que usam controle de versão geralmente também separam seu trabalho em ambientes, para que mudanças inacabadas nunca cheguem aos jogadores. Em vez de um lugar que todos editam, cada ambiente é seu próprio lugar.

Recomendamos criar cada ambiente como um jogo separado sob o mesmo grupo, em vez de como lugares separados dentro de um jogo. Armazenamentos de dados, segredos e outros serviços de nuvem são limitados ao jogo, então jogos separados mantêm dados de teste fora da produção.

Uma configuração típica tem esses ambientes:

AmbientePropósitoQuem atualiza
Desenvolvimento pessoalCópia própria de cada criador do lugar de desenvolvimento para trabalho diário.Aquele criador
Desenvolvimento compartilhadoConjunto combinado e instável de recursos que a equipe está trabalhando.Programadores sincronizam código revisado, e artistas copiam conteúdo aprovado.
AtivosAs versões canônicas de pacotes, como personagens, kits de construção e decoração de cenários.Artistas
EstávelUm instantâneo do desenvolvimento compartilhado em um intervalo regular, como para playtests semanais.Apenas CI
ProduçãoO jogo ao vivo e público.Copiado do estável após aprovação de lançamento

Criar um lugar de desenvolvimento pessoal

  1. Abra o lugar de desenvolvimento compartilhado no Studio.
  2. Selecione Arquivo ⟩ Publicar Como.
  3. Selecione o grupo que possui seus jogos de desenvolvimento.
  4. Publique o lugar como um novo jogo com um nome que o identifique e ao projeto, como USUÁRIO / SeuNome - NomeDoProjeto.
  5. Feche o lugar de desenvolvimento compartilhado e abra sua nova cópia pessoal.

Use nomes consistentes para cada ambiente, como DEV - NomeDoProjeto, ATIVO / NomeDoProjeto, e ESTÁVEL / NomeDoProjeto, para que a equipe possa diferenciá-los no Painel do Criador.

Configurar um fluxo de trabalho

Fluxo de trabalhoGuia de configuração
Nativo do StudioUsar Script Sync com uma equipe
Parcialmente gerenciadoRojo parcialmente gerenciado
Totalmente gerenciadoRojo totalmente gerenciado

Solucionar problemas comuns

ProblemaSolução
Testar em um lugar de desenvolvimento altera dados de produção.Desenvolvimento e produção são lugares no mesmo jogo, então eles compartilham armazenamentos de dados. Mova cada ambiente para seu próprio jogo.
Companheiros de equipe sobrescrevem as mudanças de script uns dos outros.Duas pessoas estão sincronizando os mesmos scripts em uma sessão do Team Create. Sincronize o código em lugares de desenvolvimento pessoais e mescle através do Git.
Uma correção em uma cópia de um script não se aplica às outras.Copiar um script cria uma cópia independente. Coloque o comportamento compartilhado em um ModuleScript e anexe-o a instâncias com tags CollectionService.
Código apenas do servidor é visível para os clientes.Módulos em contêineres que se replicam para os clientes, como ReplicatedStorage, são enviados para os clientes. Mantenha módulos apenas do servidor em ServerScriptService ou ServerStorage.
©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.