Docs

Roblox

Set up Roblox Studio, make a new Roblox game or bring one you have, and what Ryuo does in Studio.

Ryuo makes Roblox experiences in Luau. Your game lives on your computer as a Rojo project: scripts are .luau files and the world is saved as model files, so everything Ryuo makes is a normal file you can read, keep in git and open in Roblox Studio. Ryuo works in Roblox Studio through Studio's own MCP server, with your own Roblox account.

Set up Roblox

Open Engines & setup in the left sidebar and choose the Roblox card. Ryuo checks:

  • Roblox Studio. If it's missing, Install Roblox Studio downloads Roblox's official installer from Roblox's download server (setup.rbxcdn.com), checks that Roblox signed it, and runs it. The installer downloads Studio and opens it. You can also get Studio from create.roblox.com.
  • Rojo and the Luau tools: Rojo, which turns the project's files into a place, luau-lsp and selene, which check your scripts, and StyLua, which formats them. Install tools downloads the official releases from GitHub, checks each one against its published checksum, and keeps them in Ryuo's own folder. They are free and open source.
  • Signed in to Roblox Studio. Choose Open Roblox Studio and sign in with your Roblox account in Studio itself. Ryuo never asks for or sees your password.
  • Studio's MCP server turned on. In Studio, open a place, click Assistant at the top right, choose … then Settings, open MCP Servers and turn on Enable Studio as MCP server. The Roblox card shows each step with a picture. Once it's on, Studio shows MCP Ready in its bottom-right corner, and clicking that opens the same setting. This is how Ryuo works in Studio. Ryuo checks again by itself, so the row turns ready as soon as Studio answers.
  • Rojo's Studio plugin is optional. Ryuo doesn't need it; Install plugin adds it if you also want to sync with rojo serve yourself.
  • Blender is optional, for modeling and game-ready meshes.

Make a new Roblox game

Choose + beside Games, then Create from scratch, pick Roblox and choose New experience. The game starts with:

  • a baseplate and a spawn point;
  • a server script in src/server, a client script in src/client and a shared module in src/shared, written in strict, modern Luau;
  • selene and StyLua settings and a .gitignore for Ryuo's own files.

Bring a Roblox game you have

  • A Rojo project: choose + beside Games, then Browse folder, and pick the folder with default.project.json.
  • A place file (.rbxl or .rbxlx): choose + beside Games, then Create from scratch, pick Roblox and choose Import a place. Ryuo turns it into a Rojo project in a new folder with Rojo's syncback: scripts become .luau files and the rest of the place becomes model files. Your place file isn't changed.

How your game is kept

In StudioOn disk
Scripts in ServerScriptService, StarterPlayerScripts, StarterCharacterScripts and ReplicatedStorage.Sharedsrc/server, src/client, src/character, src/shared
What's in Workspace, Lighting, ReplicatedStorage, ServerStorage, StarterGui and StarterPlayer (such as a StarterCharacter)world/<service>/<name>.rbxm

Launch Roblox in the Roblox tab opens the game in Studio from these files, so Studio always starts from what's on disk. Before your first publish, Ryuo builds a fresh place from the files and opens that. Once the game is published, Launch opens your game from Roblox instead (uploads only work there) and copies the project's files into it:

  • what the project has replaces the same scripts and objects in the game;
  • anything the game has that the project doesn't, such as a part a collaborator added, stays in the game and is saved into the project;
  • if the game changed something since Ryuo last saw it, Ryuo keeps a copy of the game's version in .ryuo/roblox/place-backups before replacing it, and tells you what it kept, replaced or backed up.

Nothing is published while this happens: the game on Roblox only changes when you publish. Edit scripts as files (Ryuo's agent does): Ryuo copies changed scripts into Studio before it checks scripts or plays the game. When the agent saves, or when you save in Studio while Ryuo is open, Ryuo writes the world back into world/. Terrain and the properties of Lighting and Workspace themselves aren't saved to files yet.

Work in Roblox from Ryuo

While Studio is connected, the agent can:

  • write Luau scripts and check them with luau-lsp and selene, fixing errors by file and line;
  • look at the place through Studio's viewport, and play-test it: press keys, walk the character to a point or an object, take screenshots and read the output for errors;
  • run Luau in Studio, or in the play test's server or client, to build parts of the world or check a value;
  • turn a generated or rigged 3D model into a character with a Humanoid and make it the body every player spawns as (StarterCharacter), with an Animate script that plays its idle, walk, run and jump animations. Roblox's model upload drops the animations inside a .glb or .fbx file, so Ryuo rebuilds each one on the character's bones and uploads it as an Animation (one upload per animation, on top of the model's). A model with no animations of its own can be animated in Studio's Animation Editor, or rigged by Studio as an R15 avatar that plays Roblox's own animations;
  • make 2D sprites and flipbook animations and show them as ImageLabels in your UI or as BillboardGuis in the world;
  • use Studio's own tools, such as searching the place, inspecting instances and searching the Creator Store;
  • restart Studio when it needs to, and force quit it if it freezes, after asking you.

Uploads and publishing

Images, sounds and models from Ryuo become Roblox assets only by uploading them, and uploads are permanent: they go through Roblox moderation, belong to the experience's owner (the group, if a group owns it) and can only be removed from the Creator Dashboard. Audio uploads are limited to 10 a month, or 100 if your account is ID-verified. A character's animations are uploads too: Roblox plays an animation in a published game only from an uploaded Animation, never from one kept inside the place. Meshes can have at most 20,000 triangles. So the agent always asks before it uploads anything, in every permission mode, and says what it's about to upload.

Uploads need a published game, opened from Roblox, and your permission in Studio:

  1. Publish the game once from Studio with File → Publish to Roblox. Ryuo then remembers the game in default.project.json. If the game is already on Roblox, give the agent its universe and place ids (from its page on the Creator Dashboard) and ask it to link the project.
  2. Open the game from Roblox: press Launch Roblox (close Studio first if it's open), or ask the agent to restart Studio. Studio only allows uploads, and only saves MCP Permissions, for a game opened from Roblox, never for a local place file.
  3. In that Studio, open Assistant, choose … then Assistant Settings, and open MCP Permissions (clicking MCP in Studio's bottom-right corner opens it too). Set Look at your game (Ryuo reads which account or group owns the game) and Publish & manage assets to Allow (or the Access level to Full access), add the game's .ryuo folder under Open Cloud upload directories, where Ryuo keeps what it generates, and press Save.

If an upload says a permission or folder is missing, it names the setting to change. If every upload fails after your computer slept, Studio's sign-in has expired: quit Roblox Studio and open it again.

Publishing a new version of your game is always your own click. When you ask the agent to publish, it copies the latest scripts into Studio, saves the world to your project and checks the game is linked to its experience; then you choose File → Publish to Roblox in Studio. Ryuo never handles your Roblox password or cookies: Studio makes every call with your own sign-in, under the permissions you set.

Limits

Roblox Studio only runs on Windows and macOS and has no background mode, so Studio stays open while Ryuo works. A character made from one skinned mesh (as Tripo rigs them) can't fall as a ragdoll in Roblox, whose physics only simulates parts. Cutscene videos are for the other engines. Roblox can't run in the cloud.

On this page