Rojo

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

Rojo is een communitytool die een "bestandsysteem-eerst" benadering hanteert voor Roblox-projecten. Het draait een server op je machine die communiceert met een Studio-plugin om bestanden op je schijf te synchroniseren met het Studio-datamodel, en het kan plaats- en modelbestanden bouwen vanuit die bestanden. Met je project op schijf kun je Git, je eigen editor en CI gebruiken.

Hoe je Rojo gebruikt, hangt af van hoeveel van je game je wilt dat het beheert:

  • Deels beheerd: Rojo beheert je code, en Git is de bron van waarheid. Plaatsen en assets blijven op Roblox, waar artiesten ze bewerken met Team Create en pakketten. We raden dit aan voor de meeste teams die Git gebruiken.
  • Volledig beheerd: Rojo beheert je hele game, inclusief modellen en afbeeldingen. Git is de bron van waarheid voor alles, en CI bouwt en publiceert je plaatsen.

Om deze te vergelijken met een Studio-native workflow, zie Vergelijk bestandsgebaseerde workflows.

Installeer Rojo

Je kunt handmatig een Rojo-binaire downloaden en uitvoeren, maar die aanpak loopt het risico dat verschillende mensen in je team verschillende Rojo-versies gebruiken. Een betere oplossing is om een toolchain-manager zoals Rokit te gebruiken, die een configuratiebestand en een lijst van repositories en versies gebruikt om het installatie- en upgradeproces consistent te maken op verschillende machines.

Omdat het je basisontwikkelomgeving beheert in plaats van de pakketten binnen je project, is Rokit meer vergelijkbaar met nvm dan met npm, maar de vergelijking is niet perfect. Een eenvoudig rokit.toml-bestand ziet er als volgt uit:

[tools]
rojo = "rojo-rbx/rojo@7.6.1"
wally = "upliftgames/wally@0.3.2"
lune = "lune-org/lune@0.10.4"

Vervolgens installeer je deze tools met rokit install. Naast een globaal rokit.toml-bestand ondersteunt Rokit per-projectbestanden, zodat je gemakkelijk verschillende versies van Rojo, Wally of een andere tool voor verschillende projecten kunt gebruiken en je hele team op diezelfde versies kunt houden.

Wanneer een tool een nieuwe versie uitbrengt, verhoog je expliciet het versienummer in je .toml-bestand, gebruik je Rokit om de upgrade uit te voeren, test je de nieuwe versie en downgraden als het problemen veroorzaakt. Voor commando's en installatie-instructies, zie Rokit.

Voer Rojo uit

Nadat je Rojo met Rokit hebt geïnstalleerd, wat je eigenlijk hebt geïnstalleerd is de Rojo-server. De volgende stap is om de Rojo-plugin voor Roblox Studio te installeren.

Je kunt het installeren vanuit de Creator Store of lokaal installeren met dit commando:

rojo plugin install

Genereer vervolgens de projectstructuur voor je nieuwe game en bouw deze:

rojo init my-new-experience
cd my-new-experience
rojo build -o my-new-experience.rbxl

Alternatief kun je een bestaand spel porteren. Hoe dan ook, nadat je een project hebt, start je de Rojo-server:

rojo serve

Open in Roblox Studio het .rbxl-bestand dat je zojuist hebt gebouwd, open de Rojo-plugin en maak verbinding met je nu draaiende server, waarna je kunt beginnen met het aanbrengen van wijzigingen in je favoriete teksteditor en die wijzigingen automatisch kunt laten synchroniseren met Studio.

Visual Studio Code met een geopend Rojo-project.

De Rojo-plugin en Studio Explorer naast elkaar.

Rojo-projecten hebben bepaalde naamvereisten voor bestanden, talrijke configuratieopties en enkele beperkingen, die allemaal worden behandeld in de Rojo-documentatie.

Probleemoplossing Rojo

ProbleemOplossing
Rojo synchroniseert niet, of gedraagt zich anders op verschillende machines.Teamleden gebruiken verschillende Rojo- of pluginversies. Pin versies in rokit.toml en voer rokit install uit.
Code gesynchroniseerd op de verkeerde plaats.Voeg servePlaceIds toe aan je projectbestand zodat Rojo alleen synchroniseert naar de plaatsen die je vermeldt.
Rojo heeft inhoud verwijderd die artiesten hebben toegevoegd.Stel $ignoreUnknownInstances in op true op de services die zowel Rojo als artiesten gebruiken.
©2026 Roblox Corporation. Roblox, het Roblox-logo en Powering Imagination behoren tot onze geregistreerde en niet-geregistreerde handelsmerken in de VS en andere landen.