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 Studio | Parcialmente gerenciado | Totalmente gerenciado | |
|---|---|---|---|
| Bom para | Equipes com menos de cinco criadores trabalhando em um jogo de um único lugar | Equipes com vários programadores e jogos de múltiplos lugares | Equipes que exigem revisão e histórico para cada instância e ativo |
| No controle de versão | Scripts | Scripts, configuração do projeto e ferramentas | Tudo, incluindo modelos e imagens |
| Edição de conteúdo | Team Create | Team Create e pacotes | Arquivos no Git, construídos pelo CI |
| Ferramentas a manter | Nenhuma além do Studio e um editor | Rojo mais ferramentas de linting e CI | Rojo, 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
| Ferramenta | O que faz | Usado em |
|---|---|---|
| Team Create | Edição colaborativa em tempo real no Studio, mais adequada para construção, design de níveis e arte. | Todos os fluxos de trabalho |
| Script Sync | Sincroniza scripts no Studio com arquivos no seu disco local, em ambas as direções. | Nativo do Studio |
| Pacotes | Grupos reutilizáveis e versionados de instâncias que você pode atualizar em lugares e jogos. | Nativo do Studio, parcialmente gerenciado |
| Histórico de Versões | Versões salvas de cada lugar que você pode visualizar, comparar e restaurar. | Todos os fluxos de trabalho |
| API de publicação de lugares | API 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 Luau | API 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 Ativos | API de Nuvem aberta que faz upload e atualiza ativos como imagens, áudio e modelos. | Totalmente gerenciado |
Ferramentas da Comunidade
| Ferramenta | O que faz | Usado em |
|---|---|---|
| Rojo | Sincroniza 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 |
| Rokit | Gerenciador de toolchain. Fixa versões de ferramentas para que todos na equipe usem as mesmas. | Parcialmente gerenciado, totalmente gerenciado |
| Wally | Gerenciador de pacotes para bibliotecas Luau da comunidade. | Parcialmente gerenciado, totalmente gerenciado |
| Lune | Runtime Luau independente, comumente usado para scripts de build, deploy e automação. | Parcialmente gerenciado, totalmente gerenciado |
| selene | Linter Luau. | Todos os fluxos de trabalho |
| StyLua | Formatador de código Luau. | Todos os fluxos de trabalho |
| Luau Language Server | Autocompletar e verificação de tipo em editores externos. | Todos os fluxos de trabalho |
| Tarmac | Faz 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-merge | Driver 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:
| Ambiente | Propósito | Quem atualiza |
|---|---|---|
| Desenvolvimento pessoal | Cópia própria de cada criador do lugar de desenvolvimento para trabalho diário. | Aquele criador |
| Desenvolvimento compartilhado | Conjunto combinado e instável de recursos que a equipe está trabalhando. | Programadores sincronizam código revisado, e artistas copiam conteúdo aprovado. |
| Ativos | As versões canônicas de pacotes, como personagens, kits de construção e decoração de cenários. | Artistas |
| Estável | Um instantâneo do desenvolvimento compartilhado em um intervalo regular, como para playtests semanais. | Apenas CI |
| Produção | O jogo ao vivo e público. | Copiado do estável após aprovação de lançamento |
Criar um lugar de desenvolvimento pessoal
- Abra o lugar de desenvolvimento compartilhado no Studio.
- Selecione Arquivo ⟩ Publicar Como.
- Selecione o grupo que possui seus jogos de desenvolvimento.
- Publique o lugar como um novo jogo com um nome que o identifique e ao projeto, como USUÁRIO / SeuNome - NomeDoProjeto.
- 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 trabalho | Guia de configuração |
|---|---|
| Nativo do Studio | Usar Script Sync com uma equipe |
| Parcialmente gerenciado | Rojo parcialmente gerenciado |
| Totalmente gerenciado | Rojo totalmente gerenciado |
Solucionar problemas comuns
| Problema | Soluçã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. |