Roblox-spellen leven standaard in de cloud. Studio slaat je plaatsen, assets en scripts op in Roblox, en Versiegeschiedenis houdt wijzigingen bij voor elke plaats. Veel teams willen ook hun spel in een versiebeheersysteem zoals Git zodat ze wijzigingen kunnen bekijken voordat ze worden doorgevoerd, een volledige geschiedenis kunnen bijhouden en builds en deploys kunnen automatiseren.
Elke versiebeheersworkflow voor Roblox beantwoordt één vraag: waar bevindt de bron van waarheid zich voor elk onderdeel van je spel? De drie gebruikelijke antwoorden zijn:
- Studio-native: De plaats op Roblox is de bron van waarheid voor alles. Script Sync kopieert scripts naar Git zodat je ze kunt bekijken en bijhouden.
- Deels beheerd: Git is de bron van waarheid voor code. De plaats op Roblox is de bron van waarheid voor alles wat betreft modellen, terrein en UI.
- Volledig beheerd: Git is de bron van waarheid voor het hele spel. Plaatsen op Roblox zijn build-output die CI publiceert vanuit de repository.
Deze pagina vergelijkt deze workflows, beschrijft de tools die elk gebruikt en behandelt de omgevingen die teams eromheen opzetten. Om een workflow in te stellen, zie Stel een workflow in.
Roadmap voor bestand-gebaseerde workflows
Roblox werkt aan first-party, bestand-gebaseerde workflows zodat teams versiebeheer kunnen gebruiken zonder dat ze derde-partijtools hoeven samen te stellen. Totdat deze workflows worden uitgebracht, weerspiegelen de setups op deze pagina wat vandaag de dag voor teams werkt.
Workflow vergelijking
Studio-native
Deels beheerd
Volledig beheerd
| Studio-native | Deels beheerd | Volledig beheerd | |
|---|---|---|---|
| Goed geschikt voor | Teams van minder dan vijf makers die aan een enkel-plaats spel werken | Teams met meerdere programmeurs en multi-plaats spellen | Teams die beoordeling en geschiedenis vereisen voor elke instantie en asset |
| In versiebeheer | Scripts | Scripts, projectconfiguratie en tooling | Alles, inclusief modellen en afbeeldingen |
| Contentbewerking | Team Create | Team Create en pakketten | Bestanden in Git, gebouwd door CI |
| Tools om te onderhouden | Geen behalve Studio en een editor | Rojo plus linting en CI-tools | Rojo, merge- en asset-tools, en een volledige CI-pijplijn |
Kies een workflow
Begin met de eenvoudigste workflow die aan je behoeften voldoet. Je kunt later naar een meer beheerde workflow overstappen, omdat geen van deze tools je vastlegt. De meeste teams hebben geen volledig beheerd Rojo nodig, en het voegt aanzienlijke complexiteit toe.
Tools
De meeste setups combineren een paar tools van Roblox met een paar van de community.
Roblox-tools
| Tool | Wat het doet | Gebruikt in |
|---|---|---|
| Team Create | Realtime collaboratieve bewerking in Studio, het beste geschikt voor bouwen, levelontwerp en kunst. | Alle workflows |
| Script Sync | Synchroniseert scripts in Studio met bestanden op je lokale schijf, in beide richtingen. | Studio-native |
| Pakketten | Herbruikbare, versiegebonden groepen van instanties die je kunt bijwerken over plaatsen en spellen. | Studio-native, deels beheerd |
| Versiegeschiedenis | Opgeslagen versies van elke plaats die je kunt bekijken, vergelijken en herstellen. | Alle workflows |
| Plaats publicatie API | Open Cloud API die een plaatsbestand naar Roblox publiceert. Gebruik het om te deployen vanuit CI. | Deels beheerd, volledig beheerd |
| Luau-executie API | Open Cloud API die Luau uitvoert in een plaats op Roblox-servers. Gebruik het om tests vanuit CI uit te voeren. | Deels beheerd, volledig beheerd |
| Assets API | Open Cloud API die assets zoals afbeeldingen, audio en modellen uploadt en bijwerkt. | Volledig beheerd |
Community-tools
| Tool | Wat het doet | Gebruikt in |
|---|---|---|
| Rojo | Synchroniseert bestanden op schijf naar Studio via een lokale server en Studio-plugin, en bouwt plaats- en modelbestanden vanuit een projectbestand. De rojo syncback-opdracht, in Rojo 7.7 en later, converteert een bestaande plaats naar projectbestanden. | Deels beheerd, volledig beheerd |
| Rokit | Toolchain manager. Bevestigt toolversies zodat iedereen in het team dezelfde gebruikt. | Deels beheerd, volledig beheerd |
| Wally | Pakketbeheerder voor community Luau-bibliotheken. | Deels beheerd, volledig beheerd |
| Lune | Standalone Luau-runtime, vaak gebruikt voor build-, deploy- en automatiseringsscripts. | Deels beheerd, volledig beheerd |
| selene | Luau-linter. | Alle workflows |
| StyLua | Luau-code formatter. | Alle workflows |
| Luau Language Server | Autocompletion en typechecking in externe editors. | Alle workflows |
| Tarmac | Uploadt afbeeldingen van schijf naar Roblox en genereert een module die bestandslocaties aan asset-ID's koppelt. | Volledig beheerd |
| rbx-merge | Git diff en merge-driver voor .rbxl, .rbxlx, .rbxm, en .rbxmx-bestanden. Toont leesbare diffs en voegt niet-conflicterende wijzigingen samen op het niveau van eigenschappen. | Volledig beheerd |
Om Rojo te installeren en uit te voeren, zie Rojo. Voor Rokit, Wally, linters en andere tools, zie Derden-tools.
Omgevingen
Teams die versiebeheer gebruiken, scheiden meestal ook hun werk in omgevingen, zodat onafgemaakte wijzigingen nooit bij spelers komen. In plaats van één plaats die iedereen bewerkt, is elke omgeving zijn eigen plaats.
We raden aan om elke omgeving als een aparte game onder dezelfde groep te creëren, in plaats van als aparte plaatsen binnen één game. Databases, geheimen en andere cloudservices zijn beperkt tot de game, dus aparte games houden testgegevens uit de productie.
Een typische setup heeft deze omgevingen:
| Omgeving | Doel | Wie werkt het bij |
|---|---|---|
| Persoonlijke dev | Elke maker's eigen kopie van de dev-plaats voor dagelijkse werkzaamheden. | Die maker |
| Gedeelde dev | De gecombineerde, onstabiele set van functies waar het team aan werkt. | Programmeurs synchroniseren beoordeelde code, en kunstenaars kopiëren goedgekeurde content. |
| Assets | De canonieke versies van pakketten, zoals personages, bouwkits en set dressing. | Kunstenaars |
| Stabiel | Een momentopname van gedeelde dev op een regelmatig interval, zoals voor wekelijkse playtests. | CI alleen |
| Productie | Het live, openbare spel. | Gekopieerd van stabiel na goedkeuring van de release |
Maak een persoonlijke dev-plaats
- Open de gedeelde dev-plaats in Studio.
- Selecteer Bestand ⟩ Publiceren als.
- Selecteer de groep die jouw dev-games bezit.
- Publiceer de plaats als een nieuw spel met een naam die jou en het project identificeert, zoals USER / JouwNaam - ProjectNaam.
- Sluit de gedeelde dev-plaats en open je nieuwe persoonlijke kopie.
Gebruik consistente namen voor elke omgeving, zoals DEV - ProjectNaam, ASSET / ProjectNaam, en STABLE / ProjectNaam, zodat het team ze kan onderscheiden op het Creator Dashboard.
Stel een workflow in
| Workflow | Setup-gids |
|---|---|
| Studio-native | Gebruik Script Sync met een team |
| Deels beheerd | Deels beheerd Rojo |
| Volledig beheerd | Volledig beheerd Rojo |
Probleemoplossing voor veelvoorkomende problemen
| Probleem | Oplossing |
|---|---|
| Testen in een dev-plaats verandert productiedata. | Dev en productie zijn plaatsen in dezelfde game, dus ze delen databasens. Verplaats elke omgeving naar zijn eigen game. |
| Teamgenoten overschrijven elkaars scriptwijzigingen. | Twee mensen synchroniseren dezelfde scripts in één Team Create-sessie. Synchroniseer code naar persoonlijke dev-plaatsen en merge via Git. |
| Een fix voor één kopie van een script wordt niet toegepast op de anderen. | Het kopiëren van een script creëert een onafhankelijke kopie. Plaats gedeeld gedrag in een ModuleScript en koppel het aan instanties met CollectionService-tags. |
| Server-only code is zichtbaar voor clients. | Modules in containers die repliceren naar clients, zoals ReplicatedStorage, worden naar clients verzonden. Houd server-only modules in ServerScriptService of ServerStorage. |