Vergelijk bestand-gebaseerde workflows

*Deze inhoud is vertaald met behulp van AI (bèta) en kan fouten bevatten. Klik hier om deze pagina in het Engels te bekijken.

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-nativeDeels beheerdVolledig beheerd
Goed geschikt voorTeams van minder dan vijf makers die aan een enkel-plaats spel werkenTeams met meerdere programmeurs en multi-plaats spellenTeams die beoordeling en geschiedenis vereisen voor elke instantie en asset
In versiebeheerScriptsScripts, projectconfiguratie en toolingAlles, inclusief modellen en afbeeldingen
ContentbewerkingTeam CreateTeam Create en pakkettenBestanden in Git, gebouwd door CI
Tools om te onderhoudenGeen behalve Studio en een editorRojo plus linting en CI-toolsRojo, 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

ToolWat het doetGebruikt in
Team CreateRealtime collaboratieve bewerking in Studio, het beste geschikt voor bouwen, levelontwerp en kunst.Alle workflows
Script SyncSynchroniseert scripts in Studio met bestanden op je lokale schijf, in beide richtingen.Studio-native
PakkettenHerbruikbare, versiegebonden groepen van instanties die je kunt bijwerken over plaatsen en spellen.Studio-native, deels beheerd
VersiegeschiedenisOpgeslagen versies van elke plaats die je kunt bekijken, vergelijken en herstellen.Alle workflows
Plaats publicatie APIOpen Cloud API die een plaatsbestand naar Roblox publiceert. Gebruik het om te deployen vanuit CI.Deels beheerd, volledig beheerd
Luau-executie APIOpen 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 APIOpen Cloud API die assets zoals afbeeldingen, audio en modellen uploadt en bijwerkt.Volledig beheerd

Community-tools

ToolWat het doetGebruikt in
RojoSynchroniseert 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
RokitToolchain manager. Bevestigt toolversies zodat iedereen in het team dezelfde gebruikt.Deels beheerd, volledig beheerd
WallyPakketbeheerder voor community Luau-bibliotheken.Deels beheerd, volledig beheerd
LuneStandalone Luau-runtime, vaak gebruikt voor build-, deploy- en automatiseringsscripts.Deels beheerd, volledig beheerd
seleneLuau-linter.Alle workflows
StyLuaLuau-code formatter.Alle workflows
Luau Language ServerAutocompletion en typechecking in externe editors.Alle workflows
TarmacUploadt afbeeldingen van schijf naar Roblox en genereert een module die bestandslocaties aan asset-ID's koppelt.Volledig beheerd
rbx-mergeGit 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:

OmgevingDoelWie werkt het bij
Persoonlijke devElke maker's eigen kopie van de dev-plaats voor dagelijkse werkzaamheden.Die maker
Gedeelde devDe gecombineerde, onstabiele set van functies waar het team aan werkt.Programmeurs synchroniseren beoordeelde code, en kunstenaars kopiëren goedgekeurde content.
AssetsDe canonieke versies van pakketten, zoals personages, bouwkits en set dressing.Kunstenaars
StabielEen momentopname van gedeelde dev op een regelmatig interval, zoals voor wekelijkse playtests.CI alleen
ProductieHet live, openbare spel.Gekopieerd van stabiel na goedkeuring van de release

Maak een persoonlijke dev-plaats

  1. Open de gedeelde dev-plaats in Studio.
  2. Selecteer Bestand ⟩ Publiceren als.
  3. Selecteer de groep die jouw dev-games bezit.
  4. Publiceer de plaats als een nieuw spel met een naam die jou en het project identificeert, zoals USER / JouwNaam - ProjectNaam.
  5. 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

WorkflowSetup-gids
Studio-nativeGebruik Script Sync met een team
Deels beheerdDeels beheerd Rojo
Volledig beheerdVolledig beheerd Rojo

Probleemoplossing voor veelvoorkomende problemen

ProbleemOplossing
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.
©2026 Roblox Corporation. Roblox, het Roblox-logo en Powering Imagination behoren tot onze geregistreerde en niet-geregistreerde handelsmerken in de VS en andere landen.