# RoGenie documentation (full text) > Every page of the RoGenie documentation at https://rogenie.ai/docs, in reading order. RoGenie is an AI agent for Roblox Studio: you describe a game in plain English and it plans, writes Luau, builds in your open place through the RoGenie Studio plugin, and playtests the result. --- # What is RoGenie? URL: https://rogenie.ai/docs/introduction Section: Getting started > RoGenie is an AI agent that builds your Roblox game inside Roblox Studio. Here is what it does, how it works and what you need. RoGenie is an AI agent for Roblox Studio. You describe what you want in plain English, a **wish**, and RoGenie plans the work, writes the Luau scripts, builds the parts, models and UI directly in the place you have open in Studio, and playtests the result to check that it works. It does not just chat about your game. It acts in your open Studio place, live, while you watch, and every step it takes is shown in the work log. ## What RoGenie can do - **Build whole games and systems.** Tycoons, obbies, simulators, shooters and more: the map and terrain, the lighting, the scripts, the UI, the economy and the progression. - **Write and fix Luau.** Modern APIs, typed modules, DataStores and client/server replication. It edits the exact lines that need to change instead of rewriting whole scripts. - **Playtest like a real player.** It runs your game, plays it with a real player, client and input, checks the game state after each action, and fixes what is broken. See [Playtesting and verification](https://rogenie.ai/docs/playtesting). - **Use the Toolbox and Creator Store.** It can search, preview and insert marketplace models, find Roblox audio, and use curated royalty-free icon packs. See [Toolbox, audio and icons](https://rogenie.ai/docs/toolbox-and-assets). - **Generate assets with AI.** With the optional [RoGenie Bridge](https://rogenie.ai/docs/bridge), it can make textured 3D meshes, PBR materials and models from a description, and upload images as textures and decals. With the Bridge and Blender on Windows, it can also model and animate in Blender and bring the result into Studio. See [Blender](https://rogenie.ai/docs/blender). - **Animate characters.** It can insert an R15 or R6 rig or your avatar, pose it with inverse kinematics, write and edit keyframed animations and publish them, right in Studio on Windows or Mac. See [Character animation](https://rogenie.ai/docs/animation). - **Split big jobs across sub-agents.** Large requests are broken into parts that specialist [sub-agents](https://rogenie.ai/docs/sub-agents) build in parallel. - **Plan first, if you want.** In [Plan mode](https://rogenie.ai/docs/plan-mode) RoGenie only inspects your place and proposes a plan; nothing changes until you approve it. - **Undo its own work.** [Revert](https://rogenie.ai/docs/revert) undoes the Studio changes a single turn made, without touching your own edits. ## How it works RoGenie has three parts: | Part | What it is | Do you need it? | |---|---|---| | **The RoGenie app** | The website at [rogenie.ai/app](https://rogenie.ai/app), where you chat with RoGenie, follow its work, and manage settings and your plan. | Yes | | **The RoGenie Studio plugin** | A small Roblox Studio plugin that lets RoGenie read and change the place you have open. You pair it with your account using a pairing code it shows. | Yes, to build in Studio | | **The RoGenie Bridge** | An optional Windows app that unlocks Roblox's AI mesh, material and procedural-model generation, image uploads, and Blender. | Optional | When you send a wish, RoGenie's agent decides what to do step by step: it reads your place, writes code, creates instances, runs checks and playtests, and reports back. You can [watch every step](https://rogenie.ai/docs/watching-a-run), [stop or steer it](https://rogenie.ai/docs/stop-and-steer) at any time, and choose which [model](https://rogenie.ai/docs/models) and [tools](https://rogenie.ai/docs/tool-access) it uses. ## What you need - A RoGenie account. The [Free plan](https://rogenie.ai/docs/plans) needs no payment details. - Roblox Studio on Windows or Mac, with the RoGenie plugin installed. - For Roblox's AI generators, image uploads and Blender only: a Windows PC running the RoGenie Bridge (and, for Blender, Blender 5.2 or newer on the same PC). You do not need to know how to code, and you do not need any API keys: 107 models from 11 families are built in. If you already have keys for some providers, you can [add them](https://rogenie.ai/docs/own-api-keys) and those models will not use your RoGenie quota. On Builder and up you can also connect your own [Claude accounts](https://rogenie.ai/docs/claude-accounts). ## Where to go next - New here? Follow the [Quickstart](https://rogenie.ai/docs/quickstart): account, plugin, pairing and your first wish in about five minutes. - Curious about cost? Read [Plans and limits](https://rogenie.ai/docs/plans) and [How usage is counted](https://rogenie.ai/docs/usage-and-quota). - Something not working? Start with [Studio won't connect](https://rogenie.ai/docs/troubleshooting-studio) or [Quota messages and model errors](https://rogenie.ai/docs/troubleshooting-errors). > **Note** > RoGenie is not affiliated with Roblox Corporation. --- # Quickstart: your first wish URL: https://rogenie.ai/docs/quickstart Section: Getting started > Go from no account to a granted wish in about five minutes. Create an account, install the Studio plugin, pair it and ask RoGenie to build something. This page takes you from nothing to your first working build. You need Roblox Studio installed on Windows or Mac. ## 1. Create your account 1. Go to [rogenie.ai](https://rogenie.ai) and choose **Start free**. 2. Sign up with your email and a password (at least 8 characters), or choose **Continue with Google**. 3. Complete the short verification challenge if one appears, and confirm your email if RoGenie asks you to. The Free plan needs no payment details. See [Create an account and sign in](https://rogenie.ai/docs/accounts) for details, including linking Discord. ## 2. Install the Studio plugin 1. In the app at [rogenie.ai/app](https://rogenie.ai/app), click the **Studio** button in the top bar (it says *Studio: Not linked*), then **Pair Studio**. The *Pair Roblox Studio* window opens. 2. Click **Download** in step 1 to get the plugin file. 3. Move the file into your Roblox Studio plugins folder: - **Windows:** `%localappdata%\Roblox\Plugins` - **Mac:** `~/Documents/Roblox/Plugins/` 4. Restart Roblox Studio. If the folder does not exist, open Studio, select the **Plugins** tab and click **Plugins Folder**: Studio opens the right folder for you. Full steps are in [Install the Studio plugin](https://rogenie.ai/docs/install-plugin). ## 3. Pair Studio with your account 1. In Studio, open a place (a new Baseplate is fine). 2. On the **Plugins** tab, click the **RoGenie** button to open the RoGenie panel. 3. Click **Connect**. The panel shows an 8-digit code. 4. Back in the app, type the code into step 2 of the *Pair Roblox Studio* window and click **Pair**. 5. In Studio, click **Confirm pairing** in the RoGenie panel. The Studio button in the top bar now says *Studio: Linked* with your place's name. Codes expire after 5 minutes; if yours did, click **Get a new code** for a new one. More in [Pair Roblox Studio](https://rogenie.ai/docs/connect-studio). ## 4. Make your first wish Type what you want into the message box at the bottom and press `Enter`. For example: - "Build a simple obby with five stages and checkpoints." - "Add a coin pickup that gives the player 10 coins and shows the total on screen." - "Make the baseplate a grassy island with a few trees and a dock." RoGenie plans the work, builds it in your open place and playtests it. You can watch every step in the work log under the message. When it finishes, look at the result in Studio, then ask for changes in plain words: "make the checkpoints glow" or "the coins are too small". > **Tip** > The default model, **Auto (intelligent & cheap)**, handles most wishes for very little quota. Pick a stronger model for hard problems. See [Choosing a model](https://rogenie.ai/docs/models). ## 5. Optional: get the RoGenie Bridge If you want RoGenie to generate textured 3D meshes and materials with Roblox's AI, upload images, or work in [Blender](https://rogenie.ai/docs/blender), install the [RoGenie Bridge](https://rogenie.ai/docs/bridge) on a Windows PC. Everything else works without it. ## What next - [Making wishes: how to ask](https://rogenie.ai/docs/making-wishes) for better results. - [Watching a run](https://rogenie.ai/docs/watching-a-run) to understand the work log, plan checklist and telemetry. - [Plan mode](https://rogenie.ai/docs/plan-mode) if you want to approve a plan before anything changes. - [How usage is counted](https://rogenie.ai/docs/usage-and-quota) to understand your quota. --- # Create an account and sign in URL: https://rogenie.ai/docs/accounts Section: Getting started > Sign up with email or Google, sign in, reset a forgotten password, verify your account, and link Discord or Google. Anyone can create a RoGenie account. No invite or approval is needed, and the [Free plan](https://rogenie.ai/docs/plans) needs no payment details. ## Sign up 1. Go to [rogenie.ai/login?mode=signup](https://rogenie.ai/login?mode=signup), or choose **Start free** on the home page. 2. Fill in the form: - **Email**: used to sign in, to confirm your account and for password resets. - **Username** and **Display name**: how you appear in RoGenie. Your display name can be up to 80 characters and can be changed later in Settings. - **Password**: at least 8 characters. A number or symbol makes it stronger. 3. Complete the verification challenge if one appears. It keeps bots out. 4. Click **Create account**. Or choose **Sign up with Google** to create the account from your Google account in one step. > **Note** > If RoGenie sends you a confirmation email, open the link in it to confirm your address. Until then you may be asked to verify your account before you can use the agent. See [Verify your account](https://rogenie.ai/docs/accounts#verify-your-account). ## Sign in Go to [rogenie.ai/login](https://rogenie.ai/login) and enter your **username or email** and password, or choose **Continue with Google** if that is how you signed up. A short verification challenge may appear first. If your session ends while you are working, RoGenie shows a "your session ended" message and keeps your unsent message, so you can sign in again and carry on. ## Reset a forgotten password 1. On the sign-in page, choose **Forgot password?**. 2. Enter the email on your account and click **Send reset link**. 3. Open the link in the email, choose a new password and confirm it. For privacy, RoGenie says the same thing whether or not the address has an account: "If that account exists, reset instructions have been sent." Check your spam folder if nothing arrives within a few minutes. ## Verify your account To keep bots out, RoGenie can ask every account to prove it belongs to a real person before the agent will work for it. If you see **Verify your account to keep using RoGenie**, do any one of these: - **Link Discord.** This also adds you to the [RoGenie Discord server](https://rogenie.ai/docs/discord). - **Confirm an email address.** Enter or change your email, click send, then open the link in the email. You can resend after a short wait. Click **I've verified** once you have opened the link. - **Continue with Google.** Link the Google account you use. Your chats, settings and plan are all kept while the account is unverified. Only the agent's work (new messages, regenerating, summaries and reviews) waits until you verify. ## Linked accounts Open **Settings › Account & Usage › Linked accounts** to see and change how your account is verified: | Account | What you can do | |---|---| | **Email** | See whether it is confirmed, change it, or resend the confirmation link. | | **Google** | Link or unlink a Google account. | | **Discord** | Link or unlink Discord, see your Discord username, and join the server if you are not in it yet. | A few rules keep accounts safe: - You cannot unlink the account you sign in with if it is your only way in. - If you unlink the only thing verifying your account, RoGenie asks first, because the agent pauses until you verify again. - An email address, Google account or Discord account can belong to only one RoGenie account. ## Invite codes Signing up is open to everyone, so you do not need an invite code. If someone gave you a code from the RoGenie Discord, you can redeem it at [rogenie.ai/invite](https://rogenie.ai/invite) to link your Discord account. ## Change your display name Open **Settings › Account & Usage**, edit your display name and save. It is shown throughout the RoGenie website. ## Delete your account See [Privacy, data and deleting your account](https://rogenie.ai/docs/privacy-and-data#delete-your-account). --- # Install the Studio plugin URL: https://rogenie.ai/docs/install-plugin Section: Getting started > Download the RoGenie plugin, put it in your Roblox Studio plugins folder on Windows or Mac, and keep it up to date. The RoGenie Studio plugin is how RoGenie reads and changes the place you have open in Roblox Studio. You install it once; it then keeps itself up to date. ## Download the plugin 1. Sign in at [rogenie.ai/app](https://rogenie.ai/app). 2. Click the **Studio** button in the top bar, then **Pair Studio**. (On a new account, the first-run guide's **Pair** button does the same.) 3. In step 1 of the *Pair Roblox Studio* window, click the **Download** button. Your browser saves a `.lua` file, usually named `RoGeniePlugin.lua` or `RoGeniePluginLoader.lua`. Either name works. ## Put it in the plugins folder ### Windows 1. Open File Explorer, paste `%localappdata%\Roblox\Plugins` into the address bar and press `Enter`. 2. Drag the plugin file there from your Downloads folder. Or right-click the file, choose **Cut** (or press `Ctrl+X`), then right-click an empty spot in the Plugins folder and choose **Paste** (or press `Ctrl+V`). 3. Restart Roblox Studio. ### Mac 1. In Finder, choose **Go › Go to Folder** (`Shift+Command+G`), paste `~/Documents/Roblox/Plugins/` and press `Return`. 2. Drag the plugin file there from your Downloads folder. Or select it, press `Command+C`, open the Plugins folder and press `Option+Command+V` to move it. 3. Restart Roblox Studio. > **Tip** > If the Plugins folder does not exist, open Roblox Studio, select the **Plugins** tab on the top menu bar and click **Plugins Folder**. Studio creates and opens the right folder for you. ## Check that it loaded After the restart, open any place. On the **Plugins** tab you should see a **RoGenie** button. Click it to open the RoGenie panel. The panel shows: - the connection status (for example *Offline*, *Disconnected* or *Paired*) and the plugin version, - a **Connect** button that gets a pairing code, - what RoGenie is doing in Studio right now, with a **Stop** button while something runs, - a setting to **Auto-connect on start**, and an **Unpair Studio** button. Now [pair Studio with your account](https://rogenie.ai/docs/connect-studio). ## Permissions Studio may ask for Roblox Studio may ask whether the RoGenie plugin can connect to `rogenie.ai` and whether it can change scripts. Allow both: the plugin needs the connection to talk to RoGenie, and script access to write the code you ask for. If you denied one by mistake, you can change plugin permissions in Studio's plugin manager (**Plugins › Manage Plugins**). If Studio shows "Failed to load plugin source. Check Studio HTTP permissions.", the plugin was not allowed to reach `rogenie.ai`. Allow it and restart Studio. ## Updates The file you install is a small loader. Each time Studio starts, it fetches the latest RoGenie plugin code from `rogenie.ai`, so you never need to download the plugin again for updates. - If RoGenie says **Studio: Update needed** ("This Studio runs plugin vX; RoGenie needs vY or later"), restart Roblox Studio so the loader fetches the new version. - If `rogenie.ai` cannot be reached when Studio starts, the loader uses the last version it downloaded and shows "Live update fetch failed. Using cached plugin source." - Some features need a recent plugin version, for example [reverting a turn](https://rogenie.ai/docs/revert) and running Lua safely in [Plan mode](https://rogenie.ai/docs/plan-mode). A restart is all it takes. ## Uninstall Delete the RoGenie plugin file from the plugins folder and restart Studio. To also stop RoGenie from using a pairing, click **Unpair Studio** in the plugin panel first. ## Troubleshooting See [Studio won't connect](https://rogenie.ai/docs/troubleshooting-studio) if the RoGenie button does not appear, the code does not work or the app keeps saying *Studio: Not linked*. --- # Pair Roblox Studio URL: https://rogenie.ai/docs/connect-studio Section: Getting started > Link a Roblox Studio session to your RoGenie account with a pairing code, switch between several Studios, and unpair. Pairing links one Roblox Studio session to your RoGenie account, so the agent can act in the place you have open. You need the [plugin installed](https://rogenie.ai/docs/install-plugin) first. ## Pair with a code 1. Open Roblox Studio and open a place. 2. On the **Plugins** tab, click **RoGenie** to open the RoGenie panel. 3. Click **Connect**. The panel shows **PAIRING CODE** and eight digits (six on a plugin older than 1.1.151). You can click the code to select it, then press `Ctrl+C` (`Cmd+C` on Mac) to copy it. 4. In the RoGenie app, click the **Studio** button in the top bar and choose **Pair Studio** (or open the first-run guide's **Pair** button). 5. Type or paste the digits into **Enter the pairing code** and click **Pair**. 6. Back in Studio, the panel asks **CONFIRM PAIRING** with your account name. Click **Confirm pairing** (plugin 1.1.151 and later). If you did not enter this Studio's code yourself, click **Cancel**: nothing is kept, and that account cannot use your Studio. The plugin panel switches to **PAIRED** ("Paired as" your name), and the app's top bar shows *Studio: Linked* with the name of your place. > **Note** > A pairing code is valid for **5 minutes**. If it expires, the panel says "Code expired. Click 'Get a new code' to try again." The plugin fetches one fresh code by itself after the first expiry; after two unused codes it waits for you to click **Get a new code**. The same pairing window also accepts the code shown by the [RoGenie Bridge](https://rogenie.ai/docs/bridge). ## After pairing - **Auto-connect on start.** With this setting on in the plugin panel, Studio reconnects to your account by itself the next time it starts, so you only pair once per computer. - **What RoGenie can see.** Once linked, RoGenie reads the live scene of the place that is open, follows your Studio selection, and can change instances and scripts in that place. - **Closing Studio keeps the pairing.** When you close Studio the app shows *Studio: Closed*. Open your place again and the plugin reconnects with the same pairing (with Auto-connect off, click **Connect**). If Studio shows a pairing code instead, click **Enter a pairing code** in the app and type it there. - **Status in the app.** The Studio button shows *Studio: Linked — your place*, *Studio: Closed* (paired, Studio not open), *Studio: Not linked* (no Studio paired yet), or *Studio: Update needed* when the plugin is older than RoGenie needs. ## Several Studio sessions You can pair more than one Studio, for example two places open at once or Studio on two computers. 1. Click the **Studio** button in the top bar. 2. Under **Connected Studio sessions**, choose the one RoGenie should act in. Each browser tab works in the Studio you choose there. A run stays on the Studio it started in, and if that Studio drops mid-run, RoGenie waits up to 3 minutes for it to reconnect and carries on. The Studio menu also shows whether the [RoGenie Bridge](https://rogenie.ai/docs/bridge) is connected, how many characters of [project notes](https://rogenie.ai/docs/memory#project-notes) the place has, and a shortcut to the [IDE](https://rogenie.ai/docs/ide). > **Tip** > If several Studios are connected and none is chosen, features that read one specific place (like project notes) ask you to link one in the Studio menu first. ## Stop what RoGenie is doing in Studio While RoGenie runs something in Studio, the plugin panel shows what it is doing and a **Stop** button. It stops the running Studio action at its next safe point. To stop the whole run, use **Stop** in the app instead; see [Stop, queue and steer](https://rogenie.ai/docs/stop-and-steer). ## Unpair Click **Unpair Studio** in the plugin panel. RoGenie removes that Studio's pairing from your account and can no longer act in that Studio until you pair it again with a new code. Studios on your other computers keep theirs. ## Problems? See [Studio won't connect](https://rogenie.ai/docs/troubleshooting-studio). --- # RoGenie Bridge: Roblox AI generation and Blender URL: https://rogenie.ai/docs/bridge Section: Getting started > The optional Windows app that lets RoGenie use Roblox's own AI generators in Studio and work in your Blender. Install it, pair it, keep it running, and what it can and cannot do. The **RoGenie Bridge** is a small, optional Windows app. It lets RoGenie use Roblox Studio's built-in AI generators on your PC, and work in your own Blender when it's open. RoGenie's website can't reach either on its own. Everything else in RoGenie works without it. ## What it unlocks With the Bridge running and paired, RoGenie can: - generate a real **textured 3D mesh** from a description, - generate **PBR materials** (MaterialVariants) and apply them to parts, - generate **models and procedural objects** with AI, - **upload images** to Roblox as textures and decals for your place, - work in **Blender** on the same PC, and send models, rigs and animations into Studio. See [Blender](https://rogenie.ai/docs/blender). The first four are the tools in the *AI Generation* group of [Tool access](https://rogenie.ai/docs/tool-access), and Blender is the *Blender* group. Without the Bridge they are unavailable, and RoGenie builds from primitive parts or the Toolbox instead. See [AI meshes, materials and image uploads](https://rogenie.ai/docs/ai-generation) for how to ask for them. ## Requirements - **Windows.** The Bridge runs on Windows only. It has to run on the same PC as Roblox Studio, so if you use Studio on a Mac, AI generation and Blender are not available; everything else still works. - **Roblox Studio** installed and opened at least once, with a place open while you generate. - Studio's built-in **MCP server** turned on. The Bridge turns it on for you (switch off **Automatically turn on Studio's MCP server** in its window if you'd rather do it yourself). A Studio that was already open reads the setting only when it starts, so the window offers to restart it. To do it by hand: in Studio open the **Assistant**, then **⋯ › Settings › MCP Servers**, and turn on **Enable Studio as MCP server**. - **For Blender:** Blender 5.2 or newer, open on the same PC. The Bridge installs the add-on RoGenie needs. See [Blender](https://rogenie.ai/docs/blender#what-you-need). ## Install it In the app, click the **Studio** button in the top bar and choose **Download / Connect Bridge** (or **Download RoGenie Bridge** in the *Pair Roblox Studio* window). The *Get the RoGenie Bridge* window offers two editions: | Edition | Who it is for | What you download | |---|---|---| | **Easy install** (recommended) | Almost everyone | `RoGenie Bridge Setup.exe`. One file that installs itself for your Windows user, opens, starts with Windows and updates itself. Nothing to unzip. It gets a Start menu entry and can be uninstalled from **Windows Settings › Apps**. | | **Open source** (developers only) | People who want to read the code first | `Get RoGenie Bridge.bat`. A script that fetches the Bridge as readable Python into a folder next to it, downloads an official portable Python from python.org (about 10 MB, checked against a fixed SHA-256), and starts it. No admin rights needed. Later, start it with `Start RoGenie Bridge.bat`. It updates itself too. | Run the file from your Downloads folder. Windows may ask you to confirm before running a downloaded file (see [Why does Windows or Edge warn about the installer?](https://rogenie.ai/docs/bridge#windows-warning)). If your antivirus blocks or removes it, see [Your antivirus blocks the Bridge](https://rogenie.ai/docs/troubleshooting-bridge#antivirus). ## Check your download You can check that the installer you downloaded is exactly the one RoGenie published, by its SHA-256: The current SHA-256 of `RoGenie Bridge Setup.exe`, with its version, is published at https://rogenie.ai/api/bridge/latest (`exe.sha256` and `exe.version`). In PowerShell, in your Downloads folder, run: ```powershell Get-FileHash .\"RoGenie Bridge Setup.exe" -Algorithm SHA256 ``` The **Hash** it prints must match the SHA-256 above (capital or small letters don't matter). If it doesn't, delete the file and download it again from the app. The *Get the RoGenie Bridge* window shows the same SHA-256 on its **Easy install** card, under the steps and above the **Download Easy install** button. ## Why does Windows or Edge warn about the installer? The installer is not code-signed yet, so Microsoft SmartScreen (in Windows and in Edge) has no reputation for it. It may say *Windows protected your PC*, or that the file *isn't commonly downloaded*. That is not a sign that anything is wrong with it. 1. [Check your download](https://rogenie.ai/docs/bridge#verify) by its SHA-256. 2. **Edge:** open the download's **⋯** menu, choose **Keep**, then **Show more › Keep anyway**. 3. **Windows:** when *Windows protected your PC* appears, click **More info**, then **Run anyway**. ## Pair it 1. When the Bridge opens for the first time, it shows an **8-digit code** (a new code every 5 minutes until one is used). 2. Click **Open rogenie.ai to pair** in the Bridge window, or open the *Pair Roblox Studio* window in the app yourself. 3. Enter the code and click **Pair**. The Bridge remembers your account after that. Its window looks like the RoGenie website and wears your theme and genie once paired. ## Keep it running - **Close or hide the window whenever you like.** The Bridge keeps running in the system tray, near the clock. Left-click its icon to reopen the window; right-click for **Open**, **Start with Windows** and **Stop**. - **Start with Windows.** Turn this on in the window or the tray menu so the Bridge starts quietly every time you sign in to Windows, and AI generation just works. - **Idle cost.** With the window closed, the Bridge uses almost nothing. - **Status in the app.** If the Bridge is not connected, the Studio menu says *Bridge offline* and the AI Generation tools show as unavailable. The [Tool access](https://rogenie.ai/docs/tool-access) panel says when the Bridge is connected. ## Your Discord status With the Discord app open on your PC, the Bridge shows RoGenie at work on your Discord profile: **Building in Roblox Studio**, what RoGenie is doing right now (thinking, writing scripts, building, playtesting, reviewing, or waiting for you) and for how long. A **Try RoGenie** button on it carries your [referral link](https://rogenie.ai/docs/referrals), so a friend who signs up from it counts as your referral. - **Between runs,** while Roblox Studio is open, it says *Roblox Studio open* and *RoGenie ready* for half an hour. With Studio closed it shows nothing. - **Never your chats.** RoGenie tells the Bridge only which step a run is on and when it started; the words on your profile are the Bridge's own. - **Your place's name** is shown only if you switch on **Show the place name** in the Bridge window. - **Turn it off** with **Show what I'm building on Discord** in the Bridge window. It's on until you do, and an update keeps your choice. - **Discord opened after the Bridge?** It finds Discord by itself within seconds. The window says whether it's connected. ## Updates Both editions update themselves: - Updates come only from `rogenie.ai` over HTTPS, and the Bridge installs only updates signed with RoGenie's offline release key. Every downloaded file is checked against the signed list of hashes; anything that does not match is thrown away and nothing changes. - An update never happens in the middle of a generation or while a pairing code is on screen, and the Bridge never goes back to an older version. - If a new version fails to start, the previous one is put back and starts again. To update by hand, download the Bridge again from the app and run it. ## Is it safe? - The Bridge forwards only Roblox's **generation tools** (generate a mesh, a material or a procedural model, upload an image) and, when Blender is open, a **reviewed list of Blender tools**. Blender's raw-Python tools are off, and tools that open, save, export or render files at a path RoGenie picks are blocked. The Bridge exports and renders only into its own folder. It does not read your other files, and changes nothing in your place beyond what you ask RoGenie to make. - It connects **out** to `rogenie.ai` over an encrypted connection. It does not open your computer to the internet; its window is served on `127.0.0.1` (your machine only) and only answers requests that carry a secret made fresh each time it starts. - Besides Roblox Studio, the only other programs it talks to are **Blender**, through its add-on on your PC and only while Blender is open, and the **Discord app**, over Discord's own local connection and only to set or clear your Discord status. - The open-source edition is plain, readable Python that uses only Python's standard library, so you can check all of this yourself. - When Blender is open, the Bridge also installs the pinned **blenderwright** Blender add-on (version 3.1.0, its download checked against a fixed SHA-256) and the matching blenderwright helper, so RoGenie can talk to Blender. - That helper runs through **uv**, Astral's Python tool runner. If your PC has no usable uv (none, or one older than 0.13.4, which has a security fix), the Bridge 2.4.2 and newer sets up its own once Blender is on your PC (installed or open), or when you press **Install uv for me**: one pinned uv release from `github.com/astral-sh/uv`, checked against a fixed SHA-256 before it is unpacked, into `%LOCALAPPDATA%\RoGenie\tools\uv`. It doesn't change your PATH or anything else in Windows, a uv you installed yourself still comes first, and an older Bridge's uv in that folder is removed once the new one works. ## Uninstall - **Easy install:** Windows **Settings › Apps**, find **RoGenie Bridge**, and uninstall. - **Open source:** stop it from the tray menu, then delete its folder. After uninstalling, RoGenie cannot make AI meshes or materials, upload images, or use Blender until you install the Bridge again. ## Problems? See [Bridge won't connect](https://rogenie.ai/docs/troubleshooting-bridge). The Bridge's log file is at `%LOCALAPPDATA%\RoGenie\bridge.log`. --- # The workspace at a glance URL: https://rogenie.ai/docs/the-workspace Section: Using RoGenie > A tour of the RoGenie app at rogenie.ai/app - the library, the conversation, the message box and its controls, the Studio button, the IDE and your genie. The RoGenie app lives at [rogenie.ai/app](https://rogenie.ai/app). The first time you open it, a one-minute tour shows you where everything is. You can take it again any time from the account menu: **Take the tour**. ## The top bar | Control | What it does | |---|---| | **Library** button (`Ctrl+B`) | Shows or hides the chat library. | | **Studio** button | Shows which Studio place RoGenie is working in (*Studio: Linked — place name*), lets you switch between paired Studios, pair a new one, check the [Bridge](https://rogenie.ai/docs/bridge), and open the IDE. | | **IDE** button | Opens the [IDE](https://rogenie.ai/docs/ide): browse your place's scripts and edit them yourself. | | **Themes** button | Opens Settings at Appearance, with every theme and your genie. See [Themes and your genie](https://rogenie.ai/docs/themes-and-mascots). | | **Settings** (`Ctrl+Shift+S`) | Opens [Settings](https://rogenie.ai/docs/settings). | | **Account** menu | Your plan and Studio status, Settings, Themes, Referrals, Keyboard shortcuts, the tour, Documentation, the RoGenie Discord, and Sign out. | ## The library Every wish is a chat you can come back to. The library lists your chats, grouped and searchable, with folders to sort them. At the bottom it shows your plan and how much quota you have left for the last 5 hours and for the month. See [Chats, folders and search](https://rogenie.ai/docs/chats-and-search). On a phone, the library opens from the menu button. ## The conversation Your messages and RoGenie's replies. While RoGenie works, each reply shows: - the **plan checklist**, ticking off as tasks finish, - the **work log**, with every action RoGenie takes, its request and its result, - **thought summaries**, when the model provides them, - cards that need you: questions RoGenie asks, publish approvals, and plan approvals. See [Watching a run](https://rogenie.ai/docs/watching-a-run). Each message has its own actions (copy, edit, regenerate, revert, report, delete); see [Edit, regenerate, copy, delete and report](https://rogenie.ai/docs/message-actions). ## The message box Type your wish and press `Enter` to send (`Shift+Enter` for a new line). Around the box: | Control | What it does | |---|---| | **Attach** | Add images or files, up to 10 MB each. You can also paste or drag them in. | | **Model** | Pick the model for this chat. Each chat keeps the model you last picked in it. See [Choosing a model](https://rogenie.ai/docs/models). | | **Effort** | How hard the model thinks before it acts. See [Reasoning effort and Fast mode](https://rogenie.ai/docs/effort-and-fast-mode). | | **Tools** | Which optional tools RoGenie may use in this session. See [Tool access](https://rogenie.ai/docs/tool-access). | | **Plan / Act** | Switch [Plan mode](https://rogenie.ai/docs/plan-mode) on to approve a plan before anything changes. | | **Fast** | Fast mode, on models that support it. | | **Chat memory** ring | How full this chat's memory is. It is not your usage limit. See [Chat memory and summarizing](https://rogenie.ai/docs/chat-memory). | Type `/` for [slash commands](https://rogenie.ai/docs/slash-commands). While RoGenie is working you can keep typing: a follow-up waits its turn, or can steer the run as it goes. See [Stop, queue and steer](https://rogenie.ai/docs/stop-and-steer). Unsent text is saved as a draft per chat, so you can switch chats and come back to it. ## Your genie The genie beside the message box shows what RoGenie is doing: idle when it is ready, thinking while it works, and a finger-snap when your wish is granted. Click it to pick or create a mascot. See [Themes and your genie](https://rogenie.ai/docs/themes-and-mascots). ## The first-run guide On a new account, the empty chat shows **Three steps to your first granted wish**: pair Studio, optionally connect the RoGenie Bridge, and make your first wish. Each step ticks off as you do it, and you can dismiss the guide. --- # Making wishes: how to ask URL: https://rogenie.ai/docs/making-wishes Section: Using RoGenie > How to describe what you want so RoGenie builds the right thing the first time, with examples, attachments and follow-ups. A **wish** is just a message: describe what you want in plain words. RoGenie plans it, writes the Luau, builds it in your place and playtests it. The more useful detail you give, the better the result. ## Good wishes say what, where and how you will know it works | Instead of | Try | |---|---| | "make a shop" | "Add a shop GUI that opens when the player touches the shop pad. Sell a speed coil for 50 coins and a gravity coil for 80. Coins are in `leaderstats.Coins`." | | "fix my gun" | "The pistol in `StarterPack.Pistol` fires but never damages NPCs. Fix it so each hit does 20 damage, server-side." | | "build a map" | "Turn the baseplate into a low-poly desert canyon about 600 studs long with a winding path, a few cacti and a small town at the end. No Toolbox models." | What helps: - **Where things are.** Name the service, folder or script ("in `ServerScriptService.Combat`"). - **Rules and constraints.** "Server-authoritative", "mobile-friendly UI", "no Toolbox", "keep the existing NPC folder untouched". - **What done looks like.** "Players should keep their coins after rejoining." RoGenie uses this to decide what to playtest. - **Style.** "Low-poly", "neon sci-fi", "match the existing lobby". You do not need to know the Roblox API names. "When a player joins" is fine; RoGenie works out `Players.PlayerAdded`. ## Quick starts A new chat offers a few starting points, for example: - Create a basic obby with checkpoints - Write a DataStore saving system for player data - Create an inventory system with GUI - Make a combat system with sword and abilities ## Big requests You can ask for a whole game ("a tycoon with droppers, upgrades and rebirths"). RoGenie breaks it into a plan, and for independent parts it can run [sub-agents](https://rogenie.ai/docs/sub-agents) in parallel. For anything large or risky in an existing place: - Turn on [Plan mode](https://rogenie.ai/docs/plan-mode) to review and approve the plan first. - Write lasting conventions into [project notes](https://rogenie.ai/docs/memory#project-notes) so every chat follows them. ## Attach images and files Click **Attach**, paste, or drag files onto the message box. Each file can be up to **10 MB**. - **Images:** PNG, JPEG, GIF, WebP, SVG and BMP. Use them for references: a UI mockup, a screenshot of a bug, concept art. - **Files:** `.txt`, `.lua`, `.json`, `.py`, `.js`, `.ts`, `.css`, `.html`, `.xml`, `.csv`, `.md`, `.log`, and Roblox files `.rbxl`, `.rbxlx`, `.rbxm`, `.rbxmx`. Not every model can see images. If the model you picked cannot, RoGenie says so; [switch to a model](https://rogenie.ai/docs/models) that can. A message with its files has an overall size limit; if you go over it, RoGenie tells you before sending so you can remove a file or shorten the text. ## Follow up When RoGenie finishes, check the result in Studio and reply with what to change: "make the checkpoints glow", "the shop button overlaps the health bar on mobile". It continues in the same chat with everything it already knows. You can also send follow-ups while it is still working. See [Stop, queue and steer](https://rogenie.ai/docs/stop-and-steer). ## Questions RoGenie asks you Sometimes RoGenie pauses to ask a question, for example which of two layouts you prefer. It shows a card with options; pick one or type your own answer, and the run continues. You can turn this off with the **Ask the User** tool in [Tool access](https://rogenie.ai/docs/tool-access). ## When the result is not right - Say what is wrong, specifically. "The door opens the wrong way" works better than "it's broken". - [Regenerate](https://rogenie.ai/docs/message-actions#regenerate) the last reply to try again. RoGenie offers to [revert](https://rogenie.ai/docs/revert) the Studio changes of the reply first. - Try a stronger [model](https://rogenie.ai/docs/models) or a higher [effort](https://rogenie.ai/docs/effort-and-fast-mode) for hard logic. - Run a [code review](https://rogenie.ai/docs/code-review) to catch security and quality problems in the scripts the chat wrote. --- # Watching a run: work log, plan and telemetry URL: https://rogenie.ai/docs/watching-a-run Section: Using RoGenie > What you see while RoGenie works - the plan checklist, the work log, thought summaries, sub-agent panels, run outcomes and the Info telemetry. A **run** is everything RoGenie does to answer one message. RoGenie shows its work as it goes, so you always know what it changed and why. ## The plan checklist For multi-step work, RoGenie writes a plan first. The checklist shows each task and ticks it off as it finishes, with a progress bar above the message box so the progress stays in view while you scroll. ## The work log Under each reply, the **work log** lists every action RoGenie took: what it asked Studio or a tool to do (the request) and what came back (the result). Typical steps are reading scripts, editing code, creating instances, searching the Toolbox, taking screenshots and running playtests. - **Script edits** show a small diff of the lines that changed. - **Screenshots** from Studio and playtests appear in the log; click one to zoom. - **Failed steps** are marked. A failed step does not always mean the run failed: if RoGenie recovered, the header says how many steps failed and that RoGenie carried on. - **Provider routes.** If a model route failed and RoGenie retried on another one, the log says so. Routes are shown as *Provider 1*, *Provider 2* and so on. You can collapse the log once a run is done. To hide tool calls entirely, turn off **Enable working panel** in [Agent settings](https://rogenie.ai/docs/agent-settings#transparency). ## Thought summaries Some models share a summary of their reasoning as they work. RoGenie shows these **thought summaries** live. They are only the summaries the model provider exposes, never hidden raw chain-of-thought. If the provider redacted a summary, the log says so. You can turn summaries off in [Agent settings](https://rogenie.ai/docs/agent-settings#transparency). ## Sub-agents and background analysis When RoGenie splits work across [sub-agents](https://rogenie.ai/docs/sub-agents), a **Parallel sub-agents** panel shows each one, its role, its progress and its result. **Background script analysis** panels show checks RoGenie runs on scripts in the background. Both are summarized above the message box while they run. ## Cards that need you Some steps wait for you: - **Questions.** RoGenie asks a question with options; pick one or type your own answer. - **Publish approvals.** Before a real upload to Roblox, RoGenie asks for approval. See [Publishing to Roblox](https://rogenie.ai/docs/publishing-approval). - **Plan approvals.** In [Plan mode](https://rogenie.ai/docs/plan-mode), the plan waits for **Approve & build**. ## How a run ends The header of each reply shows how the run ended: | Label | Meaning | |---|---| | **Working...** | The run is still going. | | **Worked** | The run finished. | | **Stopped** | You pressed Stop. Everything that already ran in Studio is kept; nothing was undone. | | **Interrupted** | The run was cut off before RoGenie saved a final reply, for example by a connection drop or a server restart. The completed work and commentary are kept in the log. | | **Partly done** | The run ended with an error after doing real work. The completed steps are in your place. | | **Errored** | The run failed before doing useful work. The card says why and offers **Regenerate** and **Switch model**. | If a run stopped because your quota ran out, the reply says so and RoGenie can pick up from the place's current state once your quota frees up. See [Quota messages and model errors](https://rogenie.ai/docs/troubleshooting-errors). ## Info: the telemetry of a reply Click **Info** on a reply to see its telemetry: | Field | What it shows | |---|---| | provider | Which route answered, shown as *Provider N*. | | model | The model that ran. | | mode, effective_mode | The pacing mode asked for and the one used. | | prompt_tokens, completion_tokens, reasoning_tokens, total_tokens | Token counts. For a run with several model calls, the total covers the whole run. | | quota_billable_tokens | What your quota counted for the run, after the model's multiplier. | | model_calls | How many model calls the run made. | | context_used_tokens | How much chat memory the last call used. | | thinking_budget, max_output_tokens, temperature | Generation settings. | ## Notifications and sounds RoGenie can play a short sound when a reply finishes and show toasts when Studio or the connection connects or disconnects. Both are switches in **Settings › Appearance › Effects and sounds**. --- # Stop, queue and steer URL: https://rogenie.ai/docs/stop-and-steer Section: Using RoGenie > Stop a run at any time, queue follow-up messages while RoGenie works, or guide the agent mid-run with a message that lands after its next step. You are always in control of a run. You can stop it, line up the next request, or change its direction while it works. ## Stop a run While RoGenie is working, the send button becomes **Stop**. Click it to end the run. - Everything that already ran in Studio is **kept**. Stop does not undo anything. To undo the turn's Studio changes, use [Revert](https://rogenie.ai/docs/revert). - The reply is marked **Stopped** and says so. Send a message whenever you want to pick it back up. - If your connection is down when you press Stop, RoGenie queues the Stop and applies it the moment the connection returns. - If the run had already moved on to its next response, RoGenie says "Stop did not apply" and you can press Stop again. The RoGenie panel in Studio also has a **Stop** button that stops the Studio action running right now, at its next safe point. To end the whole run, use Stop in the app. ## Queue a follow-up You do not have to wait for RoGenie to finish. Type your next message and send it: it appears as a **queued follow-up** above the message box. Each queued message has a switch for when it is delivered: | Mode | When it is sent | Use it for | |---|---|---| | **Queue** | After the current response finishes. | The next task: "now add a leaderboard". | | **Guide** | After the agent's next tool call, so it steers the run that is already going. | Corrections: "use the existing Remotes folder", "skip the sound effects". | You can change a queued message's mode, delete it, or, after a Stop, send it right away with **Send now**. Stopping a run does not delete your queued messages. There is a limit on how many follow-ups can wait in one chat. If you hit it, RoGenie says "Queued follow-up limit reached": wait for the current run to finish or delete a queued message. ## Regenerate instead If a reply went the wrong way, you can [regenerate it](https://rogenie.ai/docs/message-actions#regenerate). If that reply changed your place, RoGenie asks whether to revert those Studio changes first, so the new attempt does not build on top of the old one. ## Close the tab during a run A run keeps going on RoGenie's servers if you close the tab or lose your connection. When you come back, the chat shows the run's progress or its result. If a run was cut off before RoGenie saved a final reply (for example during a server restart), it is marked **Interrupted** and the completed work is still in your place and in the log. --- # Plan mode URL: https://rogenie.ai/docs/plan-mode Section: Using RoGenie > Have RoGenie inspect your place and propose a plan before it changes anything. Approve the plan to build it, or keep refining it. In **Plan mode**, RoGenie only inspects your place and proposes a plan. **Nothing in your place changes until you approve.** Use it for big changes, unfamiliar places, or whenever you want to see the approach first. The other mode, **Act mode**, is the default: RoGenie builds in your place as it goes. ## Turn Plan mode on Click the **Plan / Act** switch beside the message box. The setting is per chat. When Plan mode is on, the switch says so: "Plan mode is on: RoGenie only inspects and proposes a plan". ## What RoGenie does in Plan mode 1. **Inspects** with read-only tools: it reads scripts, searches, checks properties, analyses the scene and takes screenshots. 2. **Measures safely.** If it needs to run Lua to measure something, it runs inside a sandbox: every change it makes is rolled back as soon as it finishes. Tools such as find-and-replace and bulk edits run as dry runs that report what they *would* change. 3. **Writes the plan**: what it found, the concrete steps, the risks, and how each step will be verified. Every tool that would change your place is unavailable until you approve. This is enforced by RoGenie for every tool call, not left to the model. > **Note** > Running Lua in the Plan mode sandbox needs a recent RoGenie plugin. If yours is older, restart Studio so the plugin updates itself. See [Install the Studio plugin](https://rogenie.ai/docs/install-plugin#updates). ## Approve or keep planning Under the plan, RoGenie shows **Awaiting approval** with the plan's title and number of steps, and two buttons: - **Approve & build** switches the chat to Act mode and builds exactly that plan. The plan is then marked **Approved**. - **Keep planning** lets you say what to change: "use a ModuleScript instead", "skip step 4". RoGenie revises the plan and asks again. If you change your place or the plan is replaced by a newer one, approve the latest plan. ## Good uses - Refactoring or reorganising an existing game. - Changes to data saving, purchases or anything you cannot easily undo. - Asking "how would you build X here?" before committing. - Getting an audit of a place without touching it. ## Limits - Plan mode cannot undo effects outside your place, so RoGenie does not call web requests, DataStores, plugin settings or asset uploads while planning. - Approving builds in Act mode, which uses the normal tools and quota. You can still [stop](https://rogenie.ai/docs/stop-and-steer) or [revert](https://rogenie.ai/docs/revert) the build afterwards. --- # Choosing a model URL: https://rogenie.ai/docs/models Section: Using RoGenie > The two Auto modes, every model family, what the quota multiplier means, routes and fallback, and how to pick the right model for a job. RoGenie has 107 built-in models from 11 families: Claude, DeepSeek, MiniMax, GPT, Gemini, Kimi, Qwen, Grok, GLM, Mistral, Composer. You do not need any API keys to use them. Pick a model with the **Model** button beside the message box. Each chat keeps the model you last picked in it. ## The two Auto modes | Mode | What it does | Multiplier | |---|---|---| | **Auto (intelligent & cheap)** | The default. Runs a capable, low-cost model at a fraction of the quota, with automatic failover between routes. Handles most wishes well. | 0.058× | | **Auto (Smartest Available)** | Sends every turn to the smartest model available. The most capable choice, and the priciest of the two. | 0.4× | If a model is unavailable, Auto routes around it automatically. ## The quota multiplier The number beside each model is its **quota multiplier**: how fast it uses your quota compared with Claude Opus 5, which is 1× (priced at $5 per million input tokens and $25 per million output tokens). A 0.5× model uses your quota half as fast as Opus 5; a 2× model uses it twice as fast. Auto (intelligent & cheap) runs at 0.058×, and the cheapest model in the catalog right now is GPT 6 Luna (0.02×). - The label is an estimate for a typical RoGenie run. Under the hood, input and output tokens each have their own multiplier, and you are billed by those exactly. Hover a model's multiplier to see both. - A model with no published price shows an estimate with `~` and is billed at the default 1×. - Models that run on [your own API key](https://rogenie.ai/docs/own-api-keys) show **Your API key · no RoGenie quota** and do not use your quota at all. See [How usage is counted](https://rogenie.ai/docs/usage-and-quota) for the full picture. ## Model families As of 2026-11-09. The live catalog in the app changes often, so new models may already be there. | Family | Models | Lowest multiplier | Highest multiplier | |---|---|---|---| | Claude | 19 | 0.02× | 3× | | DeepSeek | 8 | 0.051× | 0.25× | | MiniMax | 10 | 0.029× | 0.12× | | GPT | 23 | 0.02× | 2× | | Gemini | 8 | 0.15× | 0.41× | | Kimi | 13 | 0.12× | 0.8× | | Qwen | 11 | 0.023× | 0.47× | | Grok | 4 | 0.38× | 0.76× | | GLM | 9 | 0.029× | 0.27× | | Mistral | 1 | 0.26× | 0.26× | | Composer | 1 | 0.1× | 0.1× | Models marked **Recommended** in the picker are good defaults within their family. ## How to choose | You want | Try | |---|---| | Everyday building, small fixes, assets, UI | **Auto (intelligent & cheap)** | | Hard logic, tricky bugs, large refactors | A stronger model, or **Auto (Smartest Available)**, and a higher [effort](https://rogenie.ai/docs/effort-and-fast-mode) | | To stretch your quota | A model with a low multiplier. When you reach 75% of a quota window, RoGenie offers to switch you to Auto (intelligent & cheap). | | A model you already pay for elsewhere | [Add your own key](https://rogenie.ai/docs/own-api-keys) for that provider | | Different models for different jobs in one run | Pick per role in [Agent settings](https://rogenie.ai/docs/agent-settings#sub-agent-models), for example a cheap model for asset searches and a strong one for scripting | ## Routes and fallback Many models are offered through more than one **route** (a provider that serves the model). The picker shows how many routes a model has and which one is currently best. RoGenie uses the best available route and **falls back automatically** if it fails, so a model keeps working when one provider has a problem. Routes are shown as *Provider 1*, *Provider 2* and so on. You do not choose or order the routes yourself: RoGenie picks them for you. To run a provider's models on your own account instead, [add your own key](https://rogenie.ai/docs/own-api-keys). ## Using the picker - Type to search: a model name or a family like "Claude" or "Gemini". - Filter by family with the tabs. - Keyboard: `↑` `↓` to move, `Enter` to select, `→` to see a model's routes. - A model that is not available right now is greyed out with the reason. If a chat's model is no longer available when you come back to it, RoGenie switches to another one and tells you. ## Images and models Not every model can read images. If you attach an image and the model cannot see it, RoGenie tells you; switch to a model that supports images. --- # Reasoning effort and Fast mode URL: https://rogenie.ai/docs/effort-and-fast-mode Section: Using RoGenie > Set how hard the model thinks before it acts, what each effort level costs, and when Fast mode is available. ## Reasoning effort **Effort** sets how hard the model thinks before it acts. Deeper thinking gives better results on hard tasks, but it is slower and uses more quota. Click the **Effort** button beside the message box to change it. | Level | Good for | |---|---| | **None**, **Minimal**, **Low** | Quick, simple edits where speed matters. | | **Medium** | Most everyday work. | | **High**, **XHigh**, **Max** | Hard logic, debugging, architecture and large refactors. | | **Adaptive** | The model decides how deeply to think for each step. | What you can choose depends on the model: - Each model offers only the levels it supports. - Some models have no effort control at all. Then the button says so, and the model runs at its own fixed depth. - If the button says *set by the model*, the model's own default is used. RoGenie remembers the effort you pick for each model. > **Tip** > Higher effort can be cheaper overall on hard problems, because the model may get it right in fewer turns. On simple tasks it just costs more. Start at the default and raise it when RoGenie struggles. Advanced thinking options for Claude and Gemini models (extended thinking, adaptive thinking, the thinking budget ratio and thought summaries) are in [Agent settings](https://rogenie.ai/docs/agent-settings#transparency). ## Fast mode **Fast mode** gives up to 2.5× faster output at 6× the price. The **Fast** button appears beside the message box only when the selected model and route support it (currently Claude Opus 4.6 on a direct Anthropic route, such as your own Anthropic key). Click it to turn Fast mode on or off; RoGenie confirms with "Fast Mode enabled (6× pricing)". The 6× is Anthropic's price for fast output. On [your own Anthropic key](https://rogenie.ai/docs/own-api-keys), Anthropic charges it to your account and no RoGenie quota is used, so use Fast mode only when speed matters more than cost. --- # Tool access URL: https://rogenie.ai/docs/tool-access Section: Using RoGenie > Turn RoGenie's optional tools on or off for a session - playtesting, screenshots, asset generation, the Toolbox, sub-agents and more. RoGenie has 62 optional tools in 10 groups: AI Generation, Toolbox & Assets, Verification, Editing & History, Build & Assets, Interaction, Research, Parallel & Analysis, Advanced Build, Blender. All of them are on by default. **Tool access** lets you switch any of them off, for example to stop RoGenie from inserting Toolbox models, taking screenshots or spawning sub-agents. ## Open Tool access Click the **Tools** button beside the message box. The *Tool Access* window shows each group with a switch per tool and a short description of what it does, and what RoGenie does instead when it is off. - **Enable all** and **Disable all** change every optional tool at once. - The button beside the message box shows how many tools are off, for example *Tool access — 3 of 62 optional tools disabled this session*. > **Important** > Tool access choices apply to the **current session only**: they are kept for this browser tab, survive a reload, and reset when you close the tab. ## What switching a tool off does RoGenie simply does not use that tool and works around it. For example: - **Toolbox Search** off: RoGenie builds from parts instead of inserting marketplace models. - **AI Mesh Generation** off: no AI meshes; RoGenie builds from primitives or the Toolbox. - **Sub-Agents** off: RoGenie does all the work in one agent. - **Ask the User** off: RoGenie does not pause to ask you questions. - **Project & User Notes** off: RoGenie saves no new notes. Notes already saved still load. Core abilities, like reading your place, editing scripts, creating and changing instances and running Luau in Studio, are not optional and cannot be switched off. Switching off a shortcut tool such as **Terrain** or **Lighting** does not stop that kind of work: RoGenie can still do it with Luau. To make RoGenie change nothing at all, use [Plan mode](https://rogenie.ai/docs/plan-mode). ## Tools that need the RoGenie Bridge The **AI Generation** group (AI models, meshes, materials, procedural models and image uploads) uses Roblox's AI through the [RoGenie Bridge](https://rogenie.ai/docs/bridge) on your PC. When the Bridge is not connected, the window says so and offers **Download / Connect Bridge**, and those tools are unavailable whatever their switches say. The **Blender** group (**Blender Control**) also needs the Bridge, plus Blender open on the same PC; its tools appear only while Blender is connected. See [Blender](https://rogenie.ai/docs/blender). ## Playtesting Runtime playtesting has its own switch in [Agent settings](https://rogenie.ai/docs/agent-settings#playtest-verification): **Playtest verification**. Turning it off skips runtime playtests to save tokens; static checks (compile, validation, scans) still run. ## Every tool The full list, with what each tool does, is in the [Tool reference](https://rogenie.ai/docs/tool-reference). --- # Chat memory and summarizing URL: https://rogenie.ai/docs/chat-memory Section: Using RoGenie > What the chat memory ring means, why long chats cost more, and how summarizing frees memory and saves quota. ## Chat memory is not your usage limit The ring beside the message box is **chat memory**: how much of this chat RoGenie can keep in mind at once, measured in tokens. Hover or tap it to see the numbers, for example "Chat memory 40% full: 80K of 200K tokens." It is **not** your quota. Your quota is the amount of model usage your plan allows per 5 hours and per month; see [How usage is counted](https://rogenie.ai/docs/usage-and-quota). Chat memory is about one conversation. Each model has its own memory size (its *context window*). You can also set a lower ceiling yourself in [Agent settings](https://rogenie.ai/docs/agent-settings#context-and-savings). ## Why long chats cost more Every step RoGenie takes sends the conversation so far to the model. The longer the chat, the more tokens each step uses, so a very long chat spends your quota faster for the same work. Summarizing keeps that in check. ## Summarizing When a chat's memory fills up, RoGenie **summarizes older messages automatically**: it replaces the older turns with a compact summary and keeps the recent ones in full, so the conversation can keep going. A *Summarization* step appears in the work log while it happens, and "Chat summarized" when it is done. You can also summarize yourself at any time: - type `/summarize` in the message box, or - open the chat's actions menu and choose **Summarize to free memory**. When a chat gets large, RoGenie may suggest it: "This chat's memory holds N tokens. Summarizing now compacts the older turns, which slows how fast your quota is used and keeps the model sharp." You can summarize from the suggestion or dismiss it. Good to know: - Summarizing makes one model call, which uses a little quota. - Nothing important is paraphrased away: under the summary, the card keeps **Pinned facts** (details RoGenie pinned during the chat so they survive summarizing) and **Your requests, verbatim**, and both go to the model with the summary. - Your history stays in the chat: the summarized turns show read-only beside a summary card, and they stay [searchable](https://rogenie.ai/docs/chats-and-search). Only what the model is sent changes. - If summarizing is slow, RoGenie says "Summarization is taking longer than expected. It may still finish — reload to check." If it fails, the chat is left as it was and nothing is lost. ## When a chat no longer fits If a chat has grown beyond what the selected model can hold, the run fails with a message that the conversation no longer fits the model's context window. Then: 1. Type `/summarize` to compact the chat, and try again, or 2. switch to a model with a larger memory, or 3. start a new chat. Lasting facts about your place belong in [project notes](https://rogenie.ai/docs/memory#project-notes), which every new chat reads. ## Starting fresh A new chat starts with empty chat memory but still knows your [standing instructions, your notes and the place's project notes](https://rogenie.ai/docs/memory). For a new feature or a new topic, a new chat is often cheaper and sharper than continuing a very long one. --- # Slash commands URL: https://rogenie.ai/docs/slash-commands Section: Using RoGenie > The commands you can type in the message box - /summarize, /init and /review - and what each one does. Type `/` at the start of the message box to see the commands. Use `↑` and `↓` to choose one and `Enter` to run it. | Command | What it does | |---|---| | `/summarize` | Summarizes the older messages of this chat to free up [chat memory](https://rogenie.ai/docs/chat-memory). | | `/init` | Drafts this place's [project notes](https://rogenie.ai/docs/memory#project-notes): the conventions and decisions every future chat should know. | | `/review` | Runs a fresh-context security and quality [review](https://rogenie.ai/docs/code-review) of the scripts this chat wrote. | ## /summarize Compacts the older turns of the open chat into a summary, so the model keeps working with a smaller, cheaper conversation. RoGenie also does this automatically when a chat's memory fills up. Summarizing makes one model call, which uses a little quota. See [Chat memory and summarizing](https://rogenie.ai/docs/chat-memory). ## /init Asks RoGenie to inspect your place and draft its project notes, stored in the place itself at `ServerStorage.RoGenie.ProjectNotes`. You can add a focus after the command: - `/init` - `/init the combat system and its remotes` The draft is a normal run: RoGenie reads your place, writes the notes, and you can ask for changes. Studio must be linked. See [Memory: instructions, notes and project notes](https://rogenie.ai/docs/memory#project-notes). ## /review Starts a code review of the scripts this chat wrote. Add a focus to narrow it: - `/review` reviews for both security and quality, - `/review security` looks for exploits, such as a server that trusts a price sent by the client, - `/review quality` looks for bugs, performance problems and maintainability. The review runs separately from the chat and does not add a message to it. See [Code review](https://rogenie.ai/docs/code-review). --- # Chats, folders and search URL: https://rogenie.ai/docs/chats-and-search Section: Using RoGenie > Start new wishes, organise chats into folders and subfolders, rename and delete them, and search every conversation you have had. Every wish is a **chat** you can come back to. Chats live in the **library** on the left (`Ctrl+B` shows or hides it; on a phone, open it from the menu button). ## Start a new chat Click **New Wish** at the top of the library, or press `Ctrl+Shift+O`. A new chat starts with empty [chat memory](https://rogenie.ai/docs/chat-memory) but still follows your [standing instructions and notes](https://rogenie.ai/docs/memory). Each chat remembers its own model, so switching chats also switches the model picker to that chat's model. ## What the library shows - Your chats, newest first, with each chat's title, its place and whether a run is active. - A **Draft** marker on chats with an unsent message. Drafts are saved per chat in your browser. - At the bottom, your plan and the quota you have left for the last 5 hours and the month, with when each frees up. See [How usage is counted](https://rogenie.ai/docs/usage-and-quota). ## Chat actions Open a chat's **⋯** menu, in the library or in the chat's header: | Action | What it does | |---|---| | **Rename** | Give the chat a title (up to 120 characters). | | **Move to folder** | File it in a folder, or back at the top level. | | **Summarize to free memory** | Same as [/summarize](https://rogenie.ai/docs/slash-commands#summarize). | | **Delete chat** | Removes the chat and its history for good. This does not undo anything in Studio. | ## Folders - **Create** a folder with the **New folder** button (names up to 60 characters). Folders can hold **subfolders**. - **Move chats** by dragging them onto a folder, or with **Move to folder**. Drop a chat on *Drop here to move to the top level* to take it out of every folder. - **Rename**, **move** or **delete** a folder from its menu. A folder cannot be moved into itself. Deleting a folder does not delete its chats: they become unorganized. ## Search every chat Press `Ctrl+K` (or `Ctrl+Shift+F`), or click the search box in the library, and type at least 2 characters. Search looks through: - chat titles and place names, - the full text of every message, - older messages that were summarized out of a chat's memory. Results show each chat's folder and when it was last updated. Click a result to open the chat. > **Tip** > RoGenie can search your other chats too. Mention earlier work ("like the shop we built last week") and it can look it up with the **Search My Other Chats** tool, which you can turn off in [Tool access](https://rogenie.ai/docs/tool-access). ## Message drafts Whatever you type but do not send is kept as a draft for that chat, even if you switch chats or close the tab. Drafts are stored in your browser for up to 14 days. --- # Edit, regenerate, copy, delete and report URL: https://rogenie.ai/docs/message-actions Section: Using RoGenie > Every action on a message - copy, edit and resend, regenerate, revert Studio changes, telemetry, report a problem and delete. Hover a message to see its actions. On a phone, press and hold the message. ## Your messages | Action | What it does | |---|---| | **Copy** | Copies the message text. | | **Edit** | Change the message and click **Save & Resend**. RoGenie answers the edited message, and the replies after it are replaced. | | **Report issue** | Sends a report to the RoGenie team. See [Report a problem](https://rogenie.ai/docs/message-actions#report-a-problem). | | **Delete** | Removes the message and every message after it from the conversation. | ## RoGenie's replies | Action | What it does | |---|---| | **Info** | Shows the reply's telemetry: model, route, token counts and what your quota counted. See [Watching a run](https://rogenie.ai/docs/watching-a-run#info-the-telemetry-of-a-reply). | | **Copy** | Copies the reply text. | | **Regenerate** | Asks for a new answer to the same message. | | **Revert Studio changes** | Undoes the Studio changes this turn made. Shown only when the turn changed your place. See [Revert Studio changes](https://rogenie.ai/docs/revert). | | **Report issue** | Sends a report to the RoGenie team. | | **Delete** | Removes the reply and every message after it. | ## Regenerate **Regenerate** throws away the reply and runs the same message again. If that reply changed your place in Studio, RoGenie first asks **Revert Studio changes before regenerating?**: - **Revert & regenerate** undoes the old reply's Studio changes, then runs again on a clean place. Usually the right choice. - **Keep changes & regenerate** leaves the old changes in place and runs again on top of them. - **Cancel** does nothing. You must stop a running response before you regenerate, edit or delete. ## Delete messages Deleting a message also deletes every message after it, and RoGenie warns you how many. If those messages changed Studio, you can tick **Also revert the Studio changes these messages made**. Otherwise the Studio changes stay in your place. To delete a whole chat, use **Delete chat** in the chat's menu. See [Chats, folders and search](https://rogenie.ai/docs/chats-and-search#chat-actions). ## Report a problem Use **Report issue** when a reply is wrong, broken or failed. A dialog asks *What is wrong with this message?* You can add a short description (up to 1,000 characters) or leave it empty, then click **Send report**. - The report includes the relevant chat context, so the team can see exactly what happened. - A message has to be saved before you can report it. If the reply is still running, wait for it to finish. - Reports are rate limited to prevent spam. For other ways to get help, see [Get help and report a problem](https://rogenie.ai/docs/get-help). ## Keyboard shortcuts | Keys | Action | |---|---| | `Ctrl+Shift+C` | Copy the last reply | | `Ctrl+Shift+E` | Edit your last message | | `Ctrl+Shift+G` | Regenerate the last reply | All shortcuts are in [Keyboard shortcuts](https://rogenie.ai/docs/keyboard-shortcuts). --- # Keyboard shortcuts URL: https://rogenie.ai/docs/keyboard-shortcuts Section: Using RoGenie > Every keyboard shortcut in the RoGenie app, the IDE and these docs. Press `Ctrl+/` in the app to see this list at any time, or choose **Keyboard shortcuts** in the account menu. On a Mac, use `Cmd` where this page says `Ctrl`. ## Chat | Keys | Action | |---|---| | `Enter` | Send the message | | `Shift+Enter` | New line in the message box | | `/` at the start of the box | Show [slash commands](https://rogenie.ai/docs/slash-commands) | | `Ctrl+/` | Show or hide the shortcuts panel | | `Ctrl+Shift+C` | Copy the last reply | | `Ctrl+Shift+E` | Edit your last message | | `Ctrl+Shift+G` | Regenerate the last reply | | `Ctrl+Shift+S` | Open or close Settings | | `Esc` | Close a dialog, or cancel an edit | ## Library | Keys | Action | |---|---| | `Ctrl+K` or `Ctrl+Shift+F` | Search every chat | | `Ctrl+Shift+O` | New Wish | | `Ctrl+B` | Show or hide the library | ## IDE | Keys | Action | |---|---| | `Ctrl+S` | Save the script to Studio | | `Ctrl+P` | Quick open a script | | `Ctrl+Shift+P` | Open `sourcemap.json` | | `F2` | Rename the selected instance (explorer) | | `Delete` | Delete the selected instance (explorer) | | `Shift+F10` | Actions for the selected instance (explorer) | ## Model picker | Keys | Action | |---|---| | `↑` `↓` | Move through models | | `Enter` | Select the model | | `→` | Show the model's routes | ## These docs | Keys | Action | |---|---| | `/` or `Ctrl+K` | Search the docs | | `↑` `↓` then `Enter` | Choose a search result | | `Esc` | Close the results | --- # Playtesting and verification URL: https://rogenie.ai/docs/playtesting Section: Building in Studio > How RoGenie proves its work - static checks, scans, screenshots, playtests and playing your game like a real player - and how to turn runtime playtests off. RoGenie does not stop at writing code. It checks that the code actually works in your place, and fixes what is broken before it tells you it is done. ## What RoGenie checks From cheapest to most thorough: | Check | What it does | |---|---| | **Validate** | Fast static checks of scripts and targets in edit mode, such as syntax errors and API names that do not exist. | | **Geometry Scan** | Finds hidden parts, z-fighting, duplicates and parts that intersect. | | **UI Layout Scan** | Finds GUI elements cut off by the screen, overlapping each other, or sized so they will not scale on other devices. | | **Screenshots** | Captures the Studio viewport so RoGenie can see what it built. Screenshots appear in the work log. | | **Playtest** | Runs your game in a Studio playtest for runtime and physics proof, and reads the output. | | **Play as Player** | Plays your game like a real player in a real Play session, with a live player, client and input, and reports what happened. | | **Runtime Eval** | Reads or changes state inside the running game during a play session, for example a player's health or coins. | | **Profiler** | Measures live FPS, frame time and memory. | ## Playing your game like a real player For gameplay, RoGenie can play the game itself: it moves the character, presses buttons, triggers prompts and touches parts, then checks the game state after every action. If something is wrong, for example an NPC's health did not change when it was hit, it repairs the code and replays until every check passes. Tell RoGenie what "working" means in your wish to get the most out of this: "players should keep their coins after rejoining", "the door should only open for players with the key". ## Playtest verification on or off Playtests are the most thorough check, and the most expensive in tokens. You can turn runtime playtesting off in **Settings › Agent › Playtest verification**. With it off, RoGenie skips runtime playtests to save tokens; static checks (compile, validation and scans) still run. You can also switch individual checks off for a session in [Tool access](https://rogenie.ai/docs/tool-access), in the *Verification* group. ## Imported games and reference folders If your place contains scripts you imported only as reference, they can run during playtests and confuse the results. RoGenie's **Reference Quarantine** tool can disable the scripts under a reference folder, reversibly, so they stop polluting playtests. ## Tips - Keep Studio open on the place while RoGenie playtests, and avoid clicking around in Studio until the playtest finishes. - If a playtest seems stuck, press **Stop** in the app, then stop the play session in Studio if it is still running. - Playtests make model calls like any other step, so they use your [quota](https://rogenie.ai/docs/usage-and-quota). - A screenshot RoGenie takes is real evidence: look at the ones in the work log to see what it saw. --- # Sub-agents URL: https://rogenie.ai/docs/sub-agents Section: Building in Studio > How RoGenie splits big jobs across specialist sub-agents that work in parallel, which model each role runs on, and how to stop or resume them. For a big job with independent parts, RoGenie works like a team lead. The main agent, the **orchestrator**, plans the work and hands separate parts to **sub-agents** that build at the same time. Three themed zones, a shop, an inventory and a quest system can all be built in parallel, which is much faster than one step at a time. ## The roles Each sub-agent gets a specialist role with its own instructions: | Role | Typical work | |---|---| | **Builder** | Maps, buildings, props and geometry | | **Scripter** | Game systems and Luau code | | **Debugger** | Finding and fixing bugs | | **UI Designer** | GUIs, menus and HUDs | | **VFX Artist** | Particles, beams, lighting and effects | | **Asset & Audio Finder** | Toolbox models, audio and icons | | **Animator** | Animations and rigs, in Studio or in [Blender](https://rogenie.ai/docs/blender) when it is connected | | **3D modelling (Blender)** | Models, sculpts, UVs and materials in your [Blender](https://rogenie.ai/docs/blender), imports the result into Studio, and renders icons and thumbnails | | **Verifier** | Checking work and running reviews | | **Researcher** | Looking things up in the Roblox docs and RoGenie's knowledge | Sub-agents work in their own isolated context and are given separate parts of your place to write to, so they do not overwrite each other. RoGenie also uses sub-agents for parallel investigation, such as auditing many scripts or searching for several assets at once. ### The Blender sub-agents The **3D modelling (Blender)** sub-agent works in your own Blender through the [RoGenie Bridge](https://rogenie.ai/docs/bridge). It models the asset in its own collection, checks it in Blender's viewport, sends it into your place as real MeshParts, confirms the import landed in Studio, and then reports back. If any part did not come across, the report says which. Its import has to name the objects it sends, so your own objects in the scene are not exported with it. The same agent also makes game icons and thumbnails: Blender renders the image, and the agent sets up the shot and checks the result. Uploading a render needs your approval, so it hands the render to the main agent, which shows you the approval card (unless you chose **Always allow** for uploads in that chat). This sub-agent works only while Blender is connected and allowed, so open Blender before you ask for Blender work. While Blender is closed it is not available, and if it can't start, RoGenie tells you what is missing. Only one sub-agent uses Blender at a time, because everything happens in one Blender scene. A second one shows **Waiting for Blender** until the first finishes or has not used Blender for 10 minutes; after an hour of waiting it pauses and can be resumed. The **Animator** also uses Blender when it is connected, for character animations and rigged models, and works in Studio when it is not. ## Following them While sub-agents run, a **Parallel sub-agents** panel in the work log shows each one with its role, progress and result, and a summary above the message box tracks them all ("4 sub-agents completed — 36 steps, 18 actions"). When they finish, the orchestrator reads their results, puts the pieces together and verifies the whole. ## Choosing a model for each role Open **Settings › Agent › Agent & sub-agents** (also reachable from the model picker). There you can pick: - the **Orchestrator model**, which plans the work and assigns the sub-agents, and - a model for each **specialist sub-agent** role. **Same as chat** runs that role on the model you picked for the chat. By default, the **Debugger**, **Asset & Audio Finder**, **Verifier** and **Researcher** run on **Auto (intelligent & cheap)**, and the other roles, the **Animator** and **3D modelling (Blender)** included, follow the chat's model. The 3D modelling agent's icon work runs on the model you pick for it, like the rest of its job. A good pattern is a cheap model for asset searches and research and a strong one for scripting. [Code reviews](https://rogenie.ai/docs/code-review) run on the Verifier's model. ## Stop, resume and wait The orchestrator has tools to manage its sub-agents, and you can ask for them in plain words: - **Stop Sub-Agents** stops one or all of the sub-agents a run spawned. - **Resume Sub-Agents** brings back sub-agents that paused or failed, for example because a model route went down or a rate limit hit. A resumed sub-agent keeps the work it already applied. - **Wait for Sub-Agents** makes the orchestrator wait for some or all of them before it continues. Pressing **Stop** in the app stops the whole run, sub-agents included. ## Cost Every sub-agent step is a model call billed to your [quota](https://rogenie.ai/docs/usage-and-quota), at the multiplier of the model its role runs on. Parallel work is faster, not cheaper: picking cheap models for simple roles is what saves quota. ## Turning sub-agents off Switch off **Sub-Agents** in [Tool access](https://rogenie.ai/docs/tool-access) to make RoGenie do all the work in a single agent for the session. --- # Revert Studio changes URL: https://rogenie.ai/docs/revert Section: Building in Studio > Undo exactly the Studio changes one RoGenie turn made, without touching your own edits, and what to do when a revert is blocked or partial. **Revert** undoes the Studio changes that one RoGenie turn made: the parts it inserted, the properties it changed and the scripts it edited. It never undoes a change the turn did not make, so your own edits are safe. ## Revert a turn 1. Find RoGenie's reply to the message whose changes you want to undo. 2. Click **Revert Studio changes** on that reply. (It only appears on turns that changed your place.) 3. RoGenie shows what it will undo and asks **Revert this turn's Studio changes?** - **Revert changes** undoes this turn only. - If a later RoGenie turn changed something on top of this one, the turn cannot be undone alone, and the dialog offers **Revert this and later turns** instead: it undoes this turn and every RoGenie turn after it. RoGenie confirms with a message such as "Reverted 14 Studio change(s) from this turn." Revert also comes up when you [regenerate](https://rogenie.ai/docs/message-actions#regenerate) or [delete](https://rogenie.ai/docs/message-actions#delete-messages) messages that changed Studio, so a new attempt does not build on top of the old one. ## How it works Every change RoGenie makes in Studio is recorded in Studio's own **undo history**, tagged with the turn that made it. A revert undoes only the entries carrying that turn's tag, newest first, and stops at the first entry it does not own. That is why it can never undo your work. It also means: - **A newer change on top blocks the revert.** If you (or a later RoGenie turn) changed something after the turn, that change sits on top in the undo history. RoGenie stops there and tells you what is in the way. Use **Revert this and later turns** when the blocker is a later RoGenie turn, or undo your own change in Studio first. - **Partial reverts.** If RoGenie can undo only some of a turn's changes before reaching a blocker, it reverts those and tells you how many older changes from the turn are still in place. - **Reopening the place clears the history.** Studio's undo history resets when the place is closed and reopened, so a revert after that finds nothing to undo. - **Effects outside the place cannot be undone.** Assets already uploaded to Roblox, DataStore writes made during playtests and similar effects are not part of the undo history. > **Note** > Revert needs a recent RoGenie plugin. If RoGenie asks you to update it, restart Studio so the plugin updates itself. ## You must stop first You cannot revert while the turn is still running. Press **Stop**, then revert. ## Other ways to undo - **Studio's own Undo** (`Ctrl+Z` in Studio) works as usual, one step at a time. - Ask RoGenie: "undo the last change" uses its **Undo / Redo** tool. - **Checkpoints**: RoGenie can save a named restore point of part of your place before a risky change and restore it later. Ask for one: "make a checkpoint of the map before you start." - **Snapshots & Diff** lets RoGenie prove exactly what changed between two moments. > **Tip** > For anything you cannot afford to lose, save a copy of your place in Studio (**File › Save to File As** or publish a version) before a large change. RoGenie's revert is precise, but a backup is a backup. --- # Code review (/review) URL: https://rogenie.ai/docs/code-review Section: Building in Studio > Get a fresh-context security and quality review of every script a chat wrote, with prioritized findings you can send back as a fix. The model that wrote your code is not the best judge of it: it already believes its own reasoning. **/review** gives you a second opinion. A separate reviewer reads the scripts with no chat history and reports what is wrong, most serious first. For example, a shop whose client sends `BuyItem:FireServer(itemId, price)` to a server that trusts `price` passes every syntax check, but anyone can buy anything for free. That is exactly what a security review is for. ## Start a review In a chat where RoGenie wrote scripts, type one of: | Command | Reviews for | |---|---| | `/review` | Security and quality | | `/review security` | Exploits and trust problems: remotes that trust the client, missing server checks, unsafe data handling | | `/review quality` | Bugs, performance and maintainability | After RoGenie writes scripts, it may also suggest a review with a one-time hint in the chat. ## What happens - A single **read-only** reviewer runs with fresh context: no chat history, Roblox security and code-review knowledge loaded, and the **current** source of every script this chat wrote (up to 12 scripts per review). - A review card shows *Reviewing N scripts*, its progress and a **Stop** button. - If Studio is not connected, the reviewer reads the last version RoGenie wrote, and the card says so. - Only one review runs per chat at a time. The last few reviews of a chat are kept on the card. The review runs on the **Verifier** sub-agent's model. To change it, open **Settings › Agent › Agent & sub-agents › Verifier**. See [Sub-agents](https://rogenie.ai/docs/sub-agents#sub-agent-models). ## Read the findings Each finding has a priority, the script and lines it is about, what is wrong and how to fix it: | Priority | Meaning | |---|---| | **Critical** (P0) | Exploitable or game-breaking. Fix now. | | **High** (P1) | A real bug or security weakness. | | **Medium** (P2) | Should be fixed; lower risk. | | **Low** (P3) | Minor quality issues. | A review returns up to 20 findings. ## Fix what it found Tick the findings you want fixed and click **Fix selected**. RoGenie sends them back to the chat as a fix request and works through them like any other wish. Wait for any running response to finish first. When the fixes are in, run `/review` again to check. ## Cost A review is an ordinary sub-agent run: its model calls use your [quota](https://rogenie.ai/docs/usage-and-quota) at the Verifier model's multiplier. --- # Memory: instructions, notes and project notes URL: https://rogenie.ai/docs/memory Section: Building in Studio > What RoGenie remembers between chats - your standing instructions, the notes it keeps about how you work, and project notes stored in your place - and how to edit or clear them. Each chat has its own [chat memory](https://rogenie.ai/docs/chat-memory). Three kinds of memory carry over **between** chats, so you do not have to repeat yourself: | Memory | Where it lives | Who writes it | Size | |---|---|---|---| | **Standing instructions** | Your RoGenie account | You, in Settings | Up to 2,000 characters | | **Notes about you** | Your RoGenie account | RoGenie, when you tell it how you like to work | Up to 1,400 characters | | **Project notes** | Inside your place, at `ServerStorage.RoGenie.ProjectNotes` | RoGenie (for example with `/init`), or you | Up to 6,000 characters | All three are in **Settings › Memory**. ## Standing instructions Rules RoGenie follows in every chat, for example: - "Use `--!strict` and typed Luau." - "Explain changes briefly; skip long summaries." - "Never use Toolbox models." Write them in **Settings › Memory › Standing instructions** and click save. Changes apply to new chats, and to a running chat after its next summary. ## Notes about you When you tell RoGenie how you like to work ("I'm on mobile a lot, keep UI touch-friendly"), it can save a short note so future chats know. **What RoGenie remembers about you** lists every note with when it was saved. - Delete a single note with its delete button. - **Forget everything** deletes every note. Your standing instructions stay, and new chats start without notes. ## Project notes Project notes are the place's own memory: its conventions and decisions, for example "remotes live in `ReplicatedStorage.Remotes`", "low-poly style, no Toolbox", "don't touch the NPC folder, a friend owns it". They are stored **in the place**, as `ServerStorage.RoGenie.ProjectNotes`. That means: - they travel with the place file and work for unpublished places, - everyone who edits the place (for example in Team Create) shares them, - RoGenie reads them at the start of every chat about that place. ### Create them with /init Type `/init` in a chat to have RoGenie inspect your place and draft its notes. Add a focus if you like: `/init the combat system`. See [Slash commands](https://rogenie.ai/docs/slash-commands#init). ### See and edit them - **Settings › Memory › Project notes** shows the notes of the linked place and how many of the 6,000 characters they use. Use the refresh button to read them again. - The **Studio** menu in the top bar shows the size of the place's notes. - Edit them directly in Studio (it is a ModuleScript under `ServerStorage.RoGenie`), or just ask RoGenie: "add to the project notes that all UI uses the Gotham font." Viewing project notes needs Studio open on the place with the RoGenie plugin, and one Studio chosen if several are linked. ## When memory takes effect RoGenie takes a snapshot of your instructions, notes and project notes when a chat starts. Changes you make show up in new chats, and in an existing chat after its next summary. This keeps every step of a chat consistent and cheaper to run. ## Turning note-saving off Switch off **Project & User Notes** in [Tool access](https://rogenie.ai/docs/tool-access) and RoGenie saves no new notes for the session. Notes already saved still load. ## Safety Everything in memory is added to future prompts, so RoGenie checks what is written there: notes that try to give the assistant new instructions, contain hidden characters, or look like secrets are refused. Never put passwords, API keys or private tokens in notes or instructions. --- # The IDE URL: https://rogenie.ai/docs/ide Section: Building in Studio > Browse your place's explorer, edit scripts in a full code editor with live two-way sync to Studio, change properties and attributes, and export a Rojo project. The **IDE** puts your whole place one tab away. Browse the Studio explorer, read exactly what RoGenie wrote, and edit Scripts, LocalScripts and ModuleScripts yourself in a full code editor, in live two-way sync with Studio. Open it with the **IDE** button in the top bar, or **Open script IDE** in the Studio menu. Studio must be [linked](https://rogenie.ai/docs/connect-studio). ## The explorer - Shows your place's services and instances, like Studio's Explorer. - **Search** the explorer and script contents from the search box. For big places, the explorer shows the first matches; narrow the search to reveal more. - Very large places may load partially: the IDE says how many of the place's instances Studio sent. - **Refresh** re-reads the explorer from Studio. Select an instance and press `F2` to rename it, `Delete` to delete it, or `Shift+F10` for its actions. Deleting removes the instance and everything inside it from your place in Studio. ## Editing scripts Choose a Script, LocalScript or ModuleScript to open it in the editor. Each script opens in its own tab. - `Ctrl+S` saves the script straight to Studio. - `Ctrl+P` quick-opens a script by name. - Closing a tab with unsaved edits asks first. ### Live sync and conflicts The IDE stays in sync with Studio both ways: - When a script changes in Studio (because you or RoGenie edited it), the open tab updates, or tells you it changed so you can decide. - If you try to save a script that changed in Studio since you opened it, the IDE asks before it overwrites the Studio version, and can show you both versions. - When a script changed in Studio while you were editing it, the tab shows **Changed in Studio** with **Compare** and **Load Studio's version**. Loading Studio's version replaces your unsaved edits, so the IDE asks first. - Clicking the open script in the explorer again reloads it from Studio; with unsaved edits, the IDE asks first (**Discard and reload**). > **Note** > If the IDE says a script was loaded as a **truncated** copy, saving is turned off for it so it cannot be cut short. Refresh the IDE (and restart Studio if the plugin is old) to load the full script. ## Properties and attributes Select any other instance to see its **properties** and **attributes**. Changes save straight back to Studio. - Attribute names use letters, numbers and underscores. Names starting with `RBX` are reserved by Roblox. - Boolean attributes take `true` or `false`. - Deleting an attribute means scripts that read it get `nil`. ## Creating instances Create an instance by giving it a name with an extension: | Name ends in | Creates | |---|---| | `.server.lua` | a Script | | `.client.lua` | a LocalScript | | `.lua` | a ModuleScript | | anything else | a Folder | ## Rojo export The IDE can export your place for [Rojo](https://rojo.space/) and external editors: - `default.project.json`, the Rojo project file, - `sourcemap.json` (`Ctrl+Shift+P` opens it), - a full **Rojo project archive** (`.tar`) with every script as a file. If a script was too large to include in full, the IDE warns that the archive truncated it. This is a one-way export: RoGenie doesn't import Rojo projects or sync with `rojo serve` or a folder on disk. RoGenie and the IDE work with Studio itself. ## Compatibility mode With an older RoGenie plugin, the IDE loads scripts in **compatibility mode**: you can read and edit scripts, but properties and attributes are not available and saving takes a slower path that cannot detect Studio-side changes. Restart Studio so the plugin updates itself, then reload the IDE. ## Shortcuts See [Keyboard shortcuts](https://rogenie.ai/docs/keyboard-shortcuts#ide). --- # AI meshes, materials and image uploads URL: https://rogenie.ai/docs/ai-generation Section: Building in Studio > Generate textured 3D meshes, PBR materials and models with Roblox's AI through the RoGenie Bridge, and upload images as textures and decals. RoGenie can create original assets with AI, using Roblox Studio's own AI generators on your PC through the [RoGenie Bridge](https://rogenie.ai/docs/bridge). These tools need the Bridge running and paired on a Windows PC with Studio open. ## What you can generate | Tool | What it makes | Example wish | |---|---|---| | **AI Mesh Generation** | A real textured mesh from a description. | "Generate a mossy stone well mesh for the village square." | | **AI Model Generation** | A 3D model built from parts with AI. | "Make a wooden market stall." | | **AI Procedural Model** | Objects assembled from primitive parts by AI. | "Build a sci-fi crate with glowing edges." | | **AI Material Generation** | A PBR MaterialVariant from a prompt, applied to the parts you choose. | "Give the floor a cracked lava material." | | **Image Upload to Roblox** | Uploads an image to Roblox as an asset, for custom textures and decals. | "Use the logo at https://… as a decal on the shop sign" (a public image link). | You can just describe what you want; RoGenie decides when an AI asset is the right tool. Say so if you prefer it: "use an AI mesh for the statue" or "no AI meshes, build it from parts". ## Before you start 1. [Install and pair the RoGenie Bridge](https://rogenie.ai/docs/bridge). 2. Keep Roblox Studio open with your place. 3. Check that the AI Generation tools are on in [Tool access](https://rogenie.ai/docs/tool-access). The window says *The Bridge is connected* when everything is ready. If the Bridge is not connected, RoGenie builds from primitive parts or the Toolbox instead, and the Studio menu shows *Bridge offline*. ## Uploads are real Uploading an image puts a real asset on Roblox. RoGenie asks for your approval before it uploads, showing what will be uploaded and where it will be applied. See [Publishing to Roblox](https://rogenie.ai/docs/publishing-approval). ## Without the Bridge You can still get great-looking builds without AI generation: - the **Native Model Builder** builds models from primitive parts with RoGenie's own geometry code, - **CSG / Solid Modeling** combines parts with union, negate and intersect, - **Material Variants** creates custom PBR MaterialVariants from texture asset IDs you already have, - the [Toolbox and Creator Store](https://rogenie.ai/docs/toolbox-and-assets) offer ready-made models. ## Tips - Describe the look, size and style: "a low-poly pine tree about 20 studs tall, dark green". - Generation takes a little time per asset. For many props, ask RoGenie to generate a few and reuse them. - **Bake to ServerStorage** can freeze generated geometry into one stored snapshot, so it does not have to be generated again. ## More with the Bridge: Blender With Blender open on the same PC, RoGenie can also model, rig and animate in your own Blender, send the result into Studio as MeshParts and Roblox Animations, and render icons of your models. See [Blender](https://rogenie.ai/docs/blender). --- # Blender: model and animate, then bring it into Studio URL: https://rogenie.ai/docs/blender Section: Building in Studio > With the RoGenie Bridge on Windows, RoGenie works in your own Blender, then sends models, rigs and animations into Roblox Studio as MeshParts and Animation assets, and renders icons of your models. With the [RoGenie Bridge](https://rogenie.ai/docs/bridge) on a Windows PC and Blender open on the same PC, RoGenie works in **your own Blender**. It models, sculpts, rigs and animates there, checks its work with viewport screenshots, and then sends the result into your Studio place as real MeshParts, with its animations published as Roblox Animations. ## What it can do RoGenie uses a reviewed set of **242 Blender tools**, covering: - objects and mesh editing, modifiers and booleans, - sculpting and UV unwrapping, - node materials, lights and cameras, - armatures, keyframes and curves, and physics, - **viewport screenshots**, which reach RoGenie as real images so it can see what it made and fix it. Ask in plain words: "model a low-poly windmill in Blender and bring it into my place, with the blades spinning", or "make a treasure chest in Blender whose lid opens". ## What you need - **The RoGenie Bridge on Windows**, version 2.3.0 or newer (2.4.0 or newer for [renders](https://rogenie.ai/docs/blender#renders-and-icons)). It updates itself. See [RoGenie Bridge](https://rogenie.ai/docs/bridge). - **Blender 5.2 or newer on the same PC.** The RoGenie add-on needs 5.2: Blender refuses to install it into anything older. - **The blenderwright add-on.** The Bridge installs it for you the first time it sees Blender running. Restart Blender once after that. - **uv**, the small tool the Bridge's connection to Blender runs on. If your PC doesn't have a usable one, the Bridge (2.4.2 or newer) sets it up for you once Blender is on your PC; no terminal needed. The Bridge window's Blender line says *Setting up…* meanwhile, and offers **Install uv for me** or **Retry** if it couldn't. See [Blender isn't connecting](https://rogenie.ai/docs/troubleshooting-bridge#blender-isnt-connecting). - **To send things to Studio:** Studio connected through the [RoGenie plugin](https://rogenie.ai/docs/connect-studio) and signed in, because the meshes and animations are published to your Roblox account. Working in Blender alone does not need Studio. ## Turning it on and off Blender control switches on by itself when the Bridge and Blender are both running; RoGenie's Blender tools appear only while Blender is connected. To stop RoGenie using Blender even when it is open, turn off **Let RoGenie control Blender** in [Settings › Agent](https://rogenie.ai/docs/agent-settings#blender-control). The **Blender Control** switch in [Tool access](https://rogenie.ai/docs/tool-access) turns it off for a session. ## The Blender sub-agent For a bigger modelling job, RoGenie can hand the work to its **3D modelling (Blender)** [sub-agent](https://rogenie.ai/docs/sub-agents). It looks at your scene first and is told to leave objects it did not make alone. It builds the asset in its own collection, checks it with viewport screenshots, sends it into your place, confirms the import landed in Studio, and then reports back, naming any part that did not come across. A sub-agent's import has to name the objects it sends, and RoGenie refuses one that does not, so your own objects are never exported along with it. The same agent also makes icons and thumbnails: Blender renders the image, and the agent sets up the shot and checks the result. The upload goes through the main agent so you can approve it. The **Animator** sub-agent uses Blender too while it is connected, for character animations and rigged models. - Both run on **Same as chat** unless you pick a model for them in [Settings › Agent](https://rogenie.ai/docs/agent-settings#sub-agent-models). The 3D modelling agent's icon work runs on the model you pick for it, like the rest of its job. - The 3D modelling sub-agent works only while Blender is connected and allowed, so open Blender before you ask for it. If it can't start, RoGenie says why: Blender is closed, **Let RoGenie control Blender** is off, or **Blender Control** is off in Tool access. The Animator is always available, and works in Studio while Blender is closed. - One sub-agent works in Blender at a time, since there is one scene. A second one shows **Waiting for Blender** until the first finishes or has not used Blender for 10 minutes. Looking at the scene does not make an agent wait. After an hour of waiting, the agent pauses, and RoGenie can resume it later. ## Send a model to Studio When the model is ready, RoGenie sends it into your place: - It arrives as **one Model of MeshParts**, each mesh uploaded once to your Roblox account (or the place's group). Sending again reuses meshes that have not changed. - By default it lands **on the ground in front of the Studio camera**. RoGenie can also place it at a position, scale it (one Blender metre is one stud by default) or fit it to a size in studs. - Sending the same model again **replaces it in place**, so you can keep iterating. - **What carries over:** colours (base and vertex colour), smooth shading, and metal on metallic materials. ## Animations Animated objects and rigs come into Studio with their motion: - **Moving parts** get Motor6D joints. **Armatures** become skinned MeshParts with Bones. - Each animation is published as a **Roblox Animation** and played in-game by a generated **PlayAnimation** script. - RoGenie can send the whole timeline as one animation, or **one animation per Blender action** (Walk, Idle and so on), and choose whether it loops and plays on its own. ## R6 and R15 character animation For characters, RoGenie builds a Roblox **R15 or R6 rig in Blender**, one object per body part, each pivoting at its joint. It can also copy the exact proportions of a rig or character already in your place. Building the rig works without Studio. Once it is animated, RoGenie converts the motion to Roblox joint poses, publishes it as an **Animation asset**, and puts it on your rig, or on a grey preview dummy that plays it in-game. You get the **animation id** to use on players' characters. Priority, looping and the frame range can be set; a hand-made rig is matched to Roblox parts by name, or by a mapping you give. To animate in Studio without Blender, see [Character animation](https://rogenie.ai/docs/animation). ## Renders and icons RoGenie can **render your Blender model to a picture** for game icons, item thumbnails and shop art. Renders need Bridge 2.4.0 or newer. - A **PNG** from 64 to 4,096 pixels a side, 1,024 × 1,024 by default, with a **transparent background** by default. - An **automatic camera** framed on the objects you choose, and temporary **studio lighting** sized to the model. Everything else is hidden for the render. - Views: three-quarter (the default), front, back, left, right, top, high and low. - Your Blender scene is left exactly as it was. RoGenie **sees each render** and can fix what looks wrong and render again. When you are happy, it can **upload the render to Roblox** as an image asset on your account, after you approve the upload card, and put it on an ImageLabel or ImageButton, a Decal or Texture, or a part. See [Publishing to Roblox](https://rogenie.ai/docs/publishing-approval). Renders make images for your game's UI. They do not create experience thumbnails or set your game's icon; upload those in the Creator Dashboard. ## What doesn't carry over yet - Image textures and UVs: only colours and metal come across. - Shape keys. - Hidden objects, cameras and lights are skipped. ## Publishing Sending a model or an animation to Studio publishes its meshes and animations to your account, or to the place's group, as part of the import. Roblox needs them published to keep them in your place, so there is no approval card for these. Uploading a render asks first. With **Publish Assets to Roblox** switched off in [Tool access](https://rogenie.ai/docs/tool-access), RoGenie publishes nothing. See [Publishing to Roblox](https://rogenie.ai/docs/publishing-approval). ## Safety Blender's raw-Python tools are off, and tools that open, save, export or render files at a path RoGenie picks are blocked. The Bridge exports and renders only into its own folder. See [Is it safe?](https://rogenie.ai/docs/bridge#is-it-safe) ## Troubleshooting ### Blender won't connect The Bridge says why. Look at the **Blender** line in the Bridge window (left-click the RoGenie icon in the tray), or at the **Blender** group in [Tool access](https://rogenie.ai/docs/tool-access) and the Studio menu in the app, and RoGenie itself is told the same reason. The most common ones: - **Restart Blender.** The Bridge installed the add-on into a Blender that was already open, and Blender loads a new add-on only when it starts. Close Blender and open it again, once. - **Not open.** Open Blender on the same PC as the Bridge. - **Installing the add-on…** Wait about a minute, then restart Blender once. - **Too old.** The add-on needs Blender 5.2 or newer; install the current Blender from blender.org. - **Can't install the add-on.** Blender was probably started as administrator. Open it normally, or press **Install the add-on** in the Bridge window. - **Add-on blocked.** Another MCP add-on that uses the same local port (9876), for example one called *mcp*, *blender_mcp* or *blender_addon*, stops RoGenie's add-on from starting. Switch it off in **Edit › Preferences › Add-ons** and restart Blender. - **Off.** Turn on **Let RoGenie control Blender** in [Settings › Agent](https://rogenie.ai/docs/agent-settings#blender-control). Restarting the chat or reloading the page doesn't help with any of these. Every state and its fix is in [Bridge won't connect](https://rogenie.ai/docs/troubleshooting-bridge#blender-isnt-connecting). ### Other problems - **Sending to Studio fails.** Check Studio is connected and signed in. ## Limits | What | Limit | |---|---| | One MeshPart | 20,000 triangles and 60,000 vertices; bigger objects are split into several MeshParts | | One import | 80 parts and 600,000 triangles | | Mesh uploads | About 1.5 seconds each, done in batches | | Animations per export | 24, each up to 600 seconds | | Joints per animation | 400 | | Bones per skinned mesh | 256 | | Render size | 64 to 4,096 pixels a side | | Cycles render time | Capped at 120 seconds | | Renders per upload | Up to 8 | | How long a render is kept | 6 hours | --- # Character animation in Studio URL: https://rogenie.ai/docs/animation Section: Building in Studio > Insert R15 or R6 rigs or avatars, pose them with inverse kinematics, write and edit keyframed animations and publish them, on Windows or Mac, with no Bridge needed. RoGenie can animate characters right in Roblox Studio, on Windows or Mac, with only the [Studio plugin](https://rogenie.ai/docs/install-plugin). Ask for what you want to see: "make a two-handed sword swing for my R15 rig", "add a looping idle for the shopkeeper", "make the run animation 20% faster". ## Rigs to animate - **Insert Rig** drops a blank, animatable **R15 or R6** dummy, with its joints, Humanoid and Animator, like Studio's Rig Builder. It can also load a Rig Builder outfit, such as your own avatar or a mannequin. - **Insert Avatar** inserts a player's avatar rig, yours by default. If you already have a rig or character in your place, RoGenie animates that. ## Posing with inverse kinematics **Inverse Kinematics** works out the joint rotations that put a hand or foot on a point in the world: reaching, grabbing, pointing, planting feet on uneven ground, or holding a two-handed prop. Bends stay within natural limits, and if a target is out of reach the limb stretches toward it and RoGenie is told so. ## Create an animation **Create Animation** writes a keyframed animation (a KeyframeSequence) from poses, with easing, looping and a priority. Every result comes with a **quality check**: a broken loop seam, a pose for a joint the rig doesn't have, or a clip longer than 10 seconds fails it, and RoGenie fixes the animation before publishing. ## Edit an existing animation **Edit Animation** starts from an animation that already exists, by asset id or from your place, and can: - retime it (faster or slower), - mirror it to the other side, - change its priority or looping, - fix its loop seam, - trim it, - rename it or add markers. ## Publishing To keep an animation and play it from scripts, RoGenie publishes it as a real **Animation asset** on your account (or the place's group) and gives you its id. - A **new** animation is published as part of creating it, without an approval card. - **Overwriting** an existing animation always asks for your approval first. - With **Publish Assets to Roblox** switched off in [Tool access](https://rogenie.ai/docs/tool-access), nothing is published. See [Publishing to Roblox](https://rogenie.ai/docs/publishing-approval). ## Animating in Blender instead With the [RoGenie Bridge](https://rogenie.ai/docs/bridge) and Blender on Windows, RoGenie can also build an R15 or R6 rig in Blender, animate it there, and publish the animation onto your rig or a preview dummy. See [R6 and R15 character animation](https://rogenie.ai/docs/blender#r6-and-r15-character-animation). ## Switching it off **Insert Rig**, **Insert Avatar**, **Inverse Kinematics**, **Create Animation** and **Edit Animation** are in the *Build & Assets* group of [Tool access](https://rogenie.ai/docs/tool-access). With them off, RoGenie poses limbs by hand or animates with scripted tweens instead. --- # Toolbox, audio and icons URL: https://rogenie.ai/docs/toolbox-and-assets Section: Building in Studio > How RoGenie finds, checks and inserts Toolbox and Creator Store models, searches Roblox audio, uses royalty-free icon packs, and inserts avatars and rigs. RoGenie can use what already exists on Roblox instead of building everything from scratch. ## Toolbox and Creator Store models Ask for a model in plain words ("add a working jeep", "find a medieval tavern") and RoGenie: 1. **searches** the Toolbox and Creator Store, or browses its categories, 2. **probes** the candidates before inserting, to check they load and are what you asked for, 3. **inserts** the best one and places it in your scene. RoGenie keeps an inserted asset intact: its scripts, welds, seats, joints and constraints stay as the creator made them. A car that already drives is placed and wired up, not rebuilt. It only edits an asset's insides when you ask, or when a playtest proves something in it is broken. If you already know the asset you want, give RoGenie its ID: "insert asset 123456789 near the spawn". > **Tip** > Do not want marketplace models? Say "no Toolbox models" in your wish or in your [standing instructions](https://rogenie.ai/docs/memory#standing-instructions), or switch off **Toolbox Search** and the insert tools in [Tool access](https://rogenie.ai/docs/tool-access). ## Audio RoGenie searches the Roblox audio library for sound effects and music, checks that the audio IDs load, and wires them up: "add footstep sounds", "play calm background music in the lobby". ## Icons For UI, RoGenie can browse and search curated **royalty-free icon packs** and use real icons in your GUIs instead of drawing its own. Ask for "a shop button with a coin icon". There are 2,440 icons in three packs: the Material and Lucide icons are ready to use without the Bridge, and the gamepass and badge-style pack is uploaded through the [RoGenie Bridge](https://rogenie.ai/docs/bridge) when RoGenie picks one. With the Bridge and Blender, RoGenie can also [render icons of your own models](https://rogenie.ai/docs/blender#renders-and-icons). ## Avatars and rigs - **Insert Avatar** inserts a player's avatar rig. - **Insert Rig** drops a blank R15 or R6 dummy you can animate. These pair well with [animations](https://rogenie.ai/docs/toolbox-and-assets#animations). ## Animations RoGenie can author animations (KeyframeSequence poses), and edit existing ones: retime, mirror, change priority or loop. It can also solve **inverse kinematics** so a hand or foot reaches a point, and build hinges, motors, servos, welds and vehicle joints with correct attachments. A new animation RoGenie creates is published as part of making it; overwriting an existing animation asks for your approval first. See [Character animation](https://rogenie.ai/docs/animation) and [Publishing to Roblox](https://rogenie.ai/docs/publishing-approval). ## The asset library RoGenie also has a pre-configured asset library it can query and import from, for common props and effects. --- # Publishing to Roblox (approvals) URL: https://rogenie.ai/docs/publishing-approval Section: Building in Studio > Which uploads to Roblox ask for your approval first, what the approval card shows, the always-allow grant, what publishes without a card, and how to turn publishing off. Some things RoGenie can do are real uploads to Roblox: publishing a model, mesh, image, animation or other asset type, uploading images as textures and decals, or uploading a [Blender render](https://rogenie.ai/docs/blender#renders-and-icons). An upload creates a real asset owned by you (or your group, for a group place) and **cannot be undone from RoGenie**. So RoGenie asks first when it publishes an asset with **Publish Assets**, uploads images (including Blender renders), or overwrites an existing animation. ## The approval card When RoGenie wants to upload, the run pauses and shows **RoGenie needs your approval to publish**, with: - **what will be uploaded**: for example *Model named "Shop Counter", from Workspace.Shop* or *Upload 3 images, then applied to Workspace.Sign*, - a warning if the upload **overwrites an existing asset**, with that asset's ID, - the **owner** the asset will belong to, - how long the request stays open (*Expires in N min*; a request waits up to 20 minutes). Choose: | Option | What happens | |---|---| | **Approve** | This upload goes ahead. | | **Always allow in this chat** | This upload goes ahead, and later uploads of **new** assets in this chat do not ask again. | | **Deny** | Nothing is uploaded; RoGenie carries on without it. | | **✕** (close) | Same as not approving. | If the request expires or you stop the run, nothing is uploaded and the card says *Timed out: not approved* or *Stopped: not approved*. ## The always-allow grant After **Always allow in this chat**, the chat shows *Publishing is always allowed in this chat*. The grant has limits: - It covers **new assets only**. Overwriting an existing asset always asks, and the card for an overwrite does not offer *Always allow*. - It applies to **this chat only**. - **Revoke** it at any time; the chat then says *Publishing asks for approval again in this chat*. ## What publishes without a card Two kinds of upload are part of the action you asked for, so they do not show a card: - **A new animation** that RoGenie creates and publishes with **Create Animation** or **Edit Animation**. Overwriting an existing animation always asks. See [Character animation](https://rogenie.ai/docs/animation). - **A [Blender](https://rogenie.ai/docs/blender) import.** Sending a model or an animation from Blender to Studio publishes its meshes and animations to your account (or the place's group) as part of the import, because Roblox needs them published to keep them in your place. Both stop when publishing is switched off (below). ## Turning publishing off Switch off **Publish Assets to Roblox** in [Tool access](https://rogenie.ai/docs/tool-access) and RoGenie never publishes anything for you in that session, including new animations and Blender imports. **Image Upload to Roblox** has its own switch in the AI Generation group. ## Notes - Uploads happen through Roblox Studio as your signed-in Studio account, so they follow your Roblox account's own limits and moderation. - An uploaded asset is not removed by [Revert](https://rogenie.ai/docs/revert). Manage it on the Roblox Creator Dashboard. --- # Tool reference URL: https://rogenie.ai/docs/tool-reference Section: Building in Studio > Every optional tool RoGenie can use, grouped as in Tool access, with what each one does and what RoGenie does instead when it is switched off. These are RoGenie's 62 optional tools in 10 groups, exactly as they appear in [Tool access](https://rogenie.ai/docs/tool-access), where you can switch any of them off for a session. Where a description says *When off*, that is what RoGenie does instead. Besides these, RoGenie always has its core abilities: reading your place and its scripts, searching instances and script text, editing scripts with targeted diffs, creating and changing instances, properties and attributes, and running Luau in Studio. Those cannot be switched off, and with Luau RoGenie can still do the work of a tool you switched off (terrain or lighting, for example) the long way. Use [Plan mode](https://rogenie.ai/docs/plan-mode) to keep RoGenie from changing anything. ## AI Generation > **Note** > These tools need the [RoGenie Bridge](https://rogenie.ai/docs/bridge) running on a Windows PC with Studio open. | Tool | What it does | |---|---| | **AI Model Generation** | Generate 3D models from primitive parts with AI. When off: build models from primitives / Toolbox. | | **AI Mesh Generation** | Generate a real textured mesh from a prompt. When off: build from primitives / Toolbox. | | **AI Material Generation** | Generate a PBR MaterialVariant from a prompt and apply it to parts. | | **AI Procedural Model** | AI-build objects from primitive parts. | | **Image Upload to Roblox** | Upload images to the Roblox Asset Server for custom textures/decals. | ## Toolbox & Assets | Tool | What it does | |---|---| | **Toolbox Search** | Search the Roblox Toolbox / Creator Store for models. | | **Toolbox Browse** | Browse Toolbox categories. | | **Asset Probe** | Inspect Toolbox asset candidates before inserting. | | **Audio Search** | Search the Roblox audio library for SFX / music. | | **Audio Probe** | Check whether audio IDs can load. | | **Asset Library** | Query / import from the pre-configured asset library. | | **Icon Library** | Browse and search the curated royalty-free icon packs. When off: no icon browsing (RoGenie must not hand-draw icons). | ## Verification | Tool | What it does | |---|---| | **Playtest** | Run StudioTestService playtests for runtime / physics proof. | | **Screenshots** | Capture viewport screenshots for visual proof. | | **Validate** | Cheap static edit-mode validation of scripts / targets. | | **Geometry Scan** | Scan for hidden parts, z-fighting, duplicates, intersections. | | **Floor Plan** | Text/SVG top-down plan of one storey: furniture in walls, blocked doors, clear zones. | | **Build Introspection** | Synthesize a BuildSpec from existing geometry (rooms, openings, stairs, furniture) and write it to the kit spec module. | | **UI Layout Scan** | Check GUIs for elements cut off by the screen, overlapping siblings, and non-scaling sizes. | | **Orientation Probe** | Inspect foreign meshes/models before rotating them. | | **Runtime Eval** | Run Lua inside the LIVE running game to read/poke runtime state (needs a run session). | | **Profiler** | Live FPS / frame-time / memory-by-tag via the Stats service. | | **Play as Player** | Run agent-authored behaviour in a real Play session (live player + client + input) and get a report. | | **Scene Analysis** | Read-only project audit: instance/script stats, triangle & memory composition, dead scripts, module dependencies. | | **Compare Instances** | Deep structural diff of two instances/subtrees. | | **Snapshots & Diff** | Capture a property-state snapshot of a subtree and diff against it later to prove exactly what changed. | | **Reference Quarantine** | Disable scripts under a reference folder (reversibly) so imported games stop polluting play tests. | ## Editing & History | Tool | What it does | |---|---| | **Undo / Redo** | Undo or redo recent Studio changes via ChangeHistoryService. When off: mistakes must be corrected with a fresh edit. | | **Find & Replace in Scripts** | Find-and-replace a string across many scripts at once (dry run by default). When off: edit scripts individually. | | **Smart Rename** | Rename an instance and refactor references to the old name across scripts. When off: rename via property set. | | **Reparent** | Move an instance to a new parent. When off: reparent with a Luau script. | | **Smart Duplicate** | Clone instances with positional/rotational/scale offsets and property variation. When off: duplicate with a Luau script. | ## Build & Assets | Tool | What it does | |---|---| | **Insert Asset by ID** | Insert a Toolbox/Creator-Store asset by explicit asset ID. When off: insert via a Luau script / build from primitives. | | **Insert Asset by Search** | Resolve a search query and insert the TOP result in one call (opt-in, one asset). When off: search, then insert by id. | | **Insert Avatar** | Insert a player's avatar rig. When off: insert a blank rig or build one. | | **Insert Rig** | Drop a blank animatable R15/R6 dummy. When off: build a rig with a Luau script. | | **Constraints & Joints** | Build hinges, motors, servos, welds and vehicle joints with correct Attachments. When off: hand-write Attachment CFrames. | | **Inverse Kinematics** | Solve joint rotations so a hand/foot reaches a world point. When off: pose limbs by hand. | | **Create Animation** | Author a KeyframeSequence from poses (and optionally publish it). When off: animate with scripted tweens. | | **Edit Animation** | Retime/mirror/re-prioritise/loop an animation that already exists. When off: re-author it from scratch. | | **Publish Assets to Roblox** | Upload ANY asset type as a real Roblox asset. When off: RoGenie never publishes anything for you. | | **Bake to ServerStorage** | Freeze generated geometry into one stored snapshot. When off: keep re-running the generator. | | **Declarative UI Builder** | Build a GUI from a tree in one call with per-prop errors. When off: assemble GUIs with a Luau script. | ## Interaction | Tool | What it does | |---|---| | **Ask the User** | Let RoGenie pause mid-task to ask you a question. When off: it never interrupts and decides for itself. | | **Project & User Notes** | Let RoGenie save lasting notes: this place's conventions and decisions (ServerStorage.RoGenie.ProjectNotes) and how you like to work. When off: it never writes notes; notes already saved still load. | ## Research | Tool | What it does | |---|---| | **Roblox Skills** | Curated Roblox engineering knowledge (security, data, networking, UI, growth, publishing). | | **Roblox Docs Search** | Search official Roblox documentation. | | **Class Info** | Look up Roblox class/member API shape. | | **Search My Other Chats** | Let RoGenie search and quote your other chats when you refer to earlier work. When off: it only sees this chat. | ## Parallel & Analysis | Tool | What it does | |---|---| | **Sub-Agents** | Spawn parallel background sub-agents for independent work. | | **Stop Sub-Agents** | Stop one or all running sub-agents this run spawned. | | **Resume Sub-Agents** | Re-run sub-agents paused when their model route went down. | | **Wait for Sub-Agents** | Block until chosen sub-agents finish (some, all, or none), then read their results. | | **LLM Queries** | Batched background LLM queries. | | **Script Analyzer** | Background zero-context script bug analysis. | ## Advanced Build | Tool | What it does | |---|---| | **Native Model Builder** | Build a Model from primitive parts with RoGenie's own geometry code (no bridge/AI needed). When off: hand-build with a Luau script. | | **CSG / Solid Modeling** | Boolean union/negate/intersect operations on parts. | | **Terrain** | Sculpt smooth Terrain (fill/clear/read). When off: build with parts or a Luau script. | | **Lighting** | Read/set Lighting or apply mood presets. When off: set lighting via a Luau script. | | **Material Variants** | Create/list/override custom PBR MaterialVariants from texture asset IDs. When off: manage via a Luau script. | | **Checkpoints** | Save/restore named binary-fidelity restore points of a subtree. When off: rely on undo. | ## Blender > **Note** > These tools need the [RoGenie Bridge](https://rogenie.ai/docs/bridge) running on a Windows PC with Studio open. | Tool | What it does | |---|---| | **Blender Control** | Model, sculpt, rig, animate and render in your own Blender through the Bridge, then send models, rigs, animations and rendered icons into Studio. When off: no Blender access. | --- # Themes and your genie URL: https://rogenie.ai/docs/themes-and-mascots Section: Customize > Pick a theme, including the animated showcase themes, match the genie to your theme, and generate your own custom mascot with idle, thinking and grant poses. ## Themes RoGenie has **65 themes**, including **16 animated showcase themes**: Sunlit Marble, Prismatic Daydream, Blueprint Day, Midnight, Dark Matter, Tron Grid, Neon Magenta, Matrix, Cyberpunk, Synthwave 84, Laser Grid, Aurora Borealis, Volcanic, Nebula, Dracula and Midnight Purple. Every other theme has a still background. Open them with the **Themes** button in the top bar, or **Settings › Appearance**. The [theme catalog](https://rogenie.ai/docs/themes-catalog) lists every theme with its category, its main colours, what its animation looks like and the genie's colours on it. - **Search** by name, by category such as "Neon", or type "showcase" for the animated ones. - The categories are Signature, Light, Dark, Neon, Nature, Color, Editor and Special. The gallery shows the showcase themes first, under **Showcase**, each with a **Live** badge. - **Hover or focus** a showcase card to preview its animated effect. - Click a theme to apply it. It applies across the app, and the [RoGenie Bridge](https://rogenie.ai/docs/bridge) window wears it too. **RoGenie Classic** is the default theme. **RoGenie Night** is a still, dark Signature theme in the colours of the RoGenie website: deep indigo with the genie's own cyan, crimson and gold. Neither is a showcase theme, and both always show the official genie. > **Tip** > New chats show a small "Make RoGenie yours" tip with a preview of a few themes. You can dismiss it. ## Effects and sounds In **Settings › Appearance › Effects and sounds**: | Switch | What it does | |---|---| | **Glow effects** | Ambient glows and animated theme backgrounds. Always off when your device asks for reduced motion. | | **Response sound** | Plays a short sound when RoGenie finishes a response. | | **Connection toasts** | Shows notifications when Studio or the connection connects or disconnects. | ## Your genie The genie beside the message box shows what RoGenie is doing: **idle** when it is ready, **thinking** while it works, and a **finger-snap** when your wish is granted. Click it to open the mascot studio. The official genie has genie cyan skin (`#03A3DE`), crimson turban and vest (`#B51E2A`), gold trim (`#E8BE23`) and emerald gem (`#22D147`), with a near-black outline. **Match the genie to the theme** (in Appearance, on by default) lets the genie take on your theme's colours wherever its own would clash. RoGenie Classic and RoGenie Night always show the official genie, and a custom mascot keeps its own colours. The [theme catalog](https://rogenie.ai/docs/themes-catalog#how-the-genie-matches-a-theme) explains how the genie is recoloured and lists its colours on every theme. ## Create a custom mascot Custom mascots are available on paid plans. Each plan allows a number of mascot generations per 5-hour window: Starter 2, Builder 4, Pro 12, Studio 30, with a small hourly cap. The Free plan does not include mascot generation. 1. Open **Settings › Appearance** and scroll to the mascot studio (or click the genie). 2. Fill in **Create a mascot**: - **Mascot name** (up to 60 characters), - **Image model**: the model that draws it, - **Instructions** (optional, up to 1,200 characters): colour, outfit, accessories or style, - **Reference image** (optional): PNG, JPEG or WebP up to 8 MB. Click to choose, paste, or drop it in. 3. Optionally turn on **fit with theme** to keep the result close to your current theme's colours, and its stricter mode to follow them more closely. A theme-fitted mascot can still be used with any theme. 4. Click generate. RoGenie makes three poses, **idle**, **thinking** and **grant**. Generation runs in the background: keep working, and RoGenie saves and activates the mascot when it is done. You can cancel a generation while it runs. **About the reference image:** when the image model supports editing, RoGenie edits your reference into the idle pose. Otherwise a vision model reads the reference and folds a description of it into the prompt. The mascot studio tells you which applies to the model you picked. ## Your mascot library All your mascots are listed in the mascot studio with their three poses. You can: - **switch** to any mascot, including the built-in original, - **filter** by whether they were fitted to a theme, - **delete** a mascot and its poses. ## Limits - The mascot studio shows how many generations you have left in the current 5-hour window and when the next one frees up. - If you hit the limit, RoGenie says when you can generate again. See [Plans and limits](https://rogenie.ai/docs/plans). - If no image model is available, the studio says so. Image generation may be temporarily unavailable, or you may need an image-capable [provider key](https://rogenie.ai/docs/own-api-keys). --- # Theme catalog URL: https://rogenie.ai/docs/themes-catalog Section: Customize > Every RoGenie theme by category, which ones are animated showcase themes and what their effects look like, each theme's main colours, and the genie's colours on every theme. This page lists every theme in the app. It is built from the theme code the app itself runs, so the names, effects and colours here are exactly what **Settings › Appearance** shows. To pick a theme or turn the genie's theme colours off, see [Themes and your genie](https://rogenie.ai/docs/themes-and-mascots). ## At a glance - RoGenie has **65 themes** in 8 categories: Signature, Light, Dark, Neon, Nature, Color, Editor and Special. - **16 animated showcase themes:** Sunlit Marble, Prismatic Daydream, Blueprint Day, Midnight, Dark Matter, Tron Grid, Neon Magenta, Matrix, Cyberpunk, Synthwave 84, Laser Grid, Aurora Borealis, Volcanic, Nebula, Dracula and Midnight Purple. Every other theme has a still background. - **RoGenie Classic** is the default theme. Neither it nor RoGenie Night is a showcase theme. - Each theme's **main colours** are its background, its panels, its accent (links, highlights and focus rings) and its buttons. Colour names are approximate; the hex value is exact. ## The default genie The official genie, as drawn in the RoGenie mascot art: | Part | Colour | Hex | |---|---|---| | Skin | Genie cyan | `#03A3DE` | | Turban and vest | Crimson | `#B51E2A` | | Trim, jewellery and the grant pose's sparkles | Gold | `#E8BE23` | | Gem on the turban | Emerald | `#22D147` | | Outline | Near-black ink | `#010101` | | Sticker rim around the genie-head logo | Off-white | `#FDFDFA` | The genie wears these colours on RoGenie Classic, on RoGenie Night, on every theme listed below as "Official colours", and everywhere when **Match the genie to the theme** is off. ## How the genie matches a theme With **Match the genie to the theme** on (the default, in **Settings › Appearance**), the built-in genie takes on the theme's colours wherever its own would clash. The genie's head beside the RoGenie logo and on RoGenie's messages changes with it. A custom mascot always keeps its own colours. - The art is never redrawn: only its colours change. - The **skin** always stays genie cyan. - The **turban and vest** take the theme's main colour, or its deeper shade, its red or its gold: the first one that clearly differs from the cyan skin. They stay dark enough to read against the outline. - The **trim** stays gold unless gold would not stand out against the new turban and vest. Then it takes the theme's red or pink, or silver. - The **gem** stays emerald unless the turban is green too. Then it turns gold, cyan or silver. - A theme keeps the official genie when its main colour is grey, black or white, when none of its colours stands apart from the cyan skin, or when the colour the genie would wear is a red close to its own crimson. RoGenie Classic and RoGenie Night always keep it. These themes keep the official genie: RoGenie Classic, RoGenie Night, Blueprint Day, Paper, Cloud, Studio Light, Midnight, Charcoal, Dark Matter, Abyss, Shadow, Onyx, Pitch Black, Electric Blue, Ocean Deep, Volcanic, Coral Reef, Sapphire, Ruby, Steel, Ice, Solarized Dark, Nord, One Dark Pro, Material Dark, Palenight, Crimson Tide and Roblox Studio. ## Showcase themes A showcase theme animates its background, drawn in the theme's own colours. In the theme gallery the showcase themes come first, under **Showcase**, each with a **Live** badge; hover or focus a card to preview its effect. With **Glow effects** off, or when your device asks for reduced motion, the animation stops on a still frame. ### Sunlit Marble - **Category:** Light - **Style:** Light theme, animated (a showcase theme) - **Animated effect:** Warm sunbeams fan in from the top left and slowly brighten and dim, with specks of dust drifting up through the light. - **Main colours:** background off-white `#FFFBEB`, panels white `#FFFFFF`, accent orange `#E67E22`, buttons orange `#E67E22` - **Genie on this theme:** Turban and vest deep orange `#C2410C`; skin, trim and gem stay official ### Prismatic Daydream - **Category:** Light - **Style:** Light theme, animated (a showcase theme) - **Animated effect:** Iridescent rainbow light leaks over the page, with drifting glass shards that have rainbow edges, and glints of light. - **Main colours:** background white `#FFFFFF`, panels white `#FFFFFF`, accent violet `#8B5CF6`, buttons violet `#8B5CF6` - **Genie on this theme:** Turban and vest violet `#8B5CF6`; skin, trim and gem stay official ### Blueprint Day - **Category:** Light - **Style:** Light theme, animated (a showcase theme) - **Animated effect:** Blueprint drafting paper drifts slowly across the whole screen, every fourth grid line bold, while a dashed compass arc turns around its crosshair. - **Main colours:** background off-white `#F8FAFC`, panels white `#FFFFFF`, accent deep blue `#2563EB`, buttons deep blue `#2563EB` - **Genie on this theme:** Official colours ### Midnight - **Category:** Dark - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** A night sky turning slowly around a point just off the top right corner, each star drifting along its own arc. Stars twinkle at four depths, a crescent moon hangs in the genie's corner, and shooting stars cross every few seconds. - **Main colours:** background near-black `#06060F`, panels very dark indigo `#0A0A22`, accent indigo `#6366F1`, buttons violet `#A78BFA` - **Genie on this theme:** Official colours ### Dark Matter - **Category:** Dark - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** A vortex fills the screen: particles orbit the middle, the inner ones faster, and spiral slowly inward until they are swallowed and reappear at the rim, each leaving a short trail. - **Main colours:** background black `#020408`, panels near-black `#060C18`, accent cyan `#22D3EE`, buttons light cyan `#67E8F9` - **Genie on this theme:** Official colours ### Tron Grid - **Category:** Neon - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** A floor of glowing grid tiles glides toward you under a sky that fades to night above the horizon, with a glow breathing on the horizon, a slow scanline and a dark vignette. - **Main colours:** background near-black `#000808`, panels near-black `#000C0C`, accent bright cyan `#00FFEE`, buttons bright cyan `#00FFEE` - **Genie on this theme:** Turban and vest orange `#FF6600`; skin, trim and gem stay official ### Neon Magenta - **Category:** Neon - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** Ribbons of neon silk flow slowly across the lower part of the screen while soft bokeh lights rise through a magenta haze. Calm moving light, with no pulses or rings. - **Main colours:** background very dark purple `#080008`, panels very dark purple `#0F000D`, accent pink `#FF2D95`, buttons pink `#FF6EC7` - **Genie on this theme:** Turban and vest pink `#FF2D95`; skin, trim and gem stay official ### Matrix - **Category:** Neon - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** Digital rain: columns of glyphs fall smoothly down the screen, each column's head leaving a trail that fades out. - **Main colours:** background black `#000400`, panels very dark green `#000800`, accent neon green `#00FF41`, buttons neon green `#00FF41` - **Genie on this theme:** Turban and vest green `#00C730`, gem gold `#E8BE23`; skin and trim stay official ### Cyberpunk - **Category:** Neon - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** A night city: three layers of skyline drift past at their own depth, windows and neon signs burn and stutter, rain slants down, and once in a while the picture glitches for a split second. - **Main colours:** background very dark purple `#08020E`, panels very dark violet `#0E0420`, accent neon yellow `#FCEE09`, buttons neon yellow `#FCEE09` - **Genie on this theme:** Turban and vest neon yellow `#E3D600`, trim red `#FF003C`; skin and gem stay official ### Synthwave 84 - **Category:** Neon - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** A striped retro sun sets behind the genie over neon-lit mountain ranges, with stars above and a glowing grid floor running toward the sun. - **Main colours:** background very dark purple `#140A20`, panels very dark violet `#1C0E30`, accent pink `#FF71CE`, buttons bright gold `#FEDE5D` - **Genie on this theme:** Turban and vest pink `#FF71CE`; skin, trim and gem stay official ### Laser Grid - **Category:** Neon - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** A corridor of laser light: glowing grids on the floor and the ceiling glide toward you, with a hot core of light breathing where they meet. - **Main colours:** background black `#060002`, panels very dark pink `#0A0004`, accent red `#FF0066`, buttons orange `#FF6600` - **Genie on this theme:** Turban and vest red `#FF0066`; skin, trim and gem stay official ### Aurora Borealis - **Category:** Nature - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** The northern lights: shimmering curtains of light over a starry sky and dark mountain ranges. - **Main colours:** background near-black `#010C0C`, panels very dark teal `#021A18`, accent green `#34D399`, buttons light cyan `#67E8F9` - **Genie on this theme:** Turban and vest green `#0CC289`, gem gold `#E8BE23`; skin and trim stay official ### Volcanic - **Category:** Nature - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** Lava glows and breathes along the bottom, magma flows through cracks, embers rise and cool, and dark smoke drifts up. - **Main colours:** background very dark red `#0A0000`, panels very dark red `#140202`, accent red `#EF4444`, buttons bright gold `#FBBF24` - **Genie on this theme:** Official colours ### Nebula - **Category:** Nature - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** Clouds of glowing gas swirl slowly, with dark dust lanes drifting through them, stars at two depths, bright stars with spikes, and now and then a new star flaring inside the clouds. - **Main colours:** background very dark purple `#0A0014`, panels very dark violet `#140428`, accent magenta `#E879F9`, buttons purple `#C084FC` - **Genie on this theme:** Turban and vest magenta `#DF70F0`; skin, trim and gem stay official ### Dracula - **Category:** Editor - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** A full moon with a breathing halo, clouds drifting across it, the odd bat crossing the sky, and mist rolling along the ground. - **Main colours:** background near-black `#21222C`, panels dark greyish indigo `#282A36`, accent purple `#BD93F9`, buttons bright yellow `#F1FA8C` - **Genie on this theme:** Turban and vest purple `#B68CF1`; skin, trim and gem stay official ### Midnight Purple - **Category:** Special - **Style:** Dark theme, animated (a showcase theme) - **Animated effect:** Stardust streams across the whole screen on long looping paths. Each mote trails a short bright streak, and every path stays as a faint line for about half a minute before thinning away, so a web of paths keeps building and renewing itself. - **Main colours:** background very dark purple `#04000C`, panels very dark purple `#0A0016`, accent deep purple `#9333EA`, buttons purple `#A855F7` - **Genie on this theme:** Turban and vest deep purple `#9333EA`; skin, trim and gem stay official ## Signature themes ### RoGenie Classic - **The default theme** - **Category:** Signature - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark blue `#0F172A`, panels very dark blue `#152036`, accent sky blue `#00B0FF`, buttons bright gold `#FFCC00` - **Genie on this theme:** Official colours ### RoGenie Night - **Category:** Signature - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark indigo `#0E0731`, panels very dark indigo `#151041`, accent genie cyan `#03A3DE`, buttons gold `#E8BE23` - **Genie on this theme:** Official colours ## Light themes Also in this category, under [Showcase themes](https://rogenie.ai/docs/themes-catalog#showcase-themes): [Sunlit Marble](https://rogenie.ai/docs/themes-catalog#sunlit-marble), [Prismatic Daydream](https://rogenie.ai/docs/themes-catalog#prismatic-daydream) and [Blueprint Day](https://rogenie.ai/docs/themes-catalog#blueprint-day). ### Paper - **Category:** Light - **Style:** Light theme, still background (not a showcase theme) - **Main colours:** background off-white `#FBFBFB`, panels white `#FFFFFF`, accent dark grey `#78716C`, buttons dark grey `#78716C` - **Genie on this theme:** Official colours ### Cloud - **Category:** Light - **Style:** Light theme, still background (not a showcase theme) - **Main colours:** background off-white `#F0F9FF`, panels white `#FFFFFF`, accent cyan `#06B6D4`, buttons cyan `#06B6D4` - **Genie on this theme:** Official colours ### Studio Light - **Category:** Light - **Style:** Light theme, still background (not a showcase theme) - **Main colours:** background off-white `#FFF1F2`, panels white `#FFFFFF`, accent red `#F43F5E`, buttons red `#F43F5E` - **Genie on this theme:** Official colours ### Graph Paper - **Category:** Light - **Style:** Light theme, still background (not a showcase theme) - **Background:** Still graph paper: a faint green grid of small squares with darker slate-grey rules every fifth square, over off-white, clearing to plain off-white in the middle behind the conversation. - **Main colours:** background off-white `#F8FAFC`, panels white `#FFFFFF`, accent green `#10B981`, buttons green `#10B981` - **Genie on this theme:** Turban and vest green `#10B981`, gem gold `#E8BE23`; skin and trim stay official ## Dark themes Also in this category, under [Showcase themes](https://rogenie.ai/docs/themes-catalog#showcase-themes): [Midnight](https://rogenie.ai/docs/themes-catalog#midnight) and [Dark Matter](https://rogenie.ai/docs/themes-catalog#dark-matter). ### Obsidian - **Category:** Dark - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background black `#050507`, panels near-black `#0A0A0D`, accent violet `#8B5CF6`, buttons purple `#C084FC` - **Genie on this theme:** Turban and vest violet `#8B5CF6`; skin, trim and gem stay official ### Charcoal - **Category:** Dark - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#0E0E0E`, panels near-black `#141414`, accent greyish blue `#94A3B8`, buttons light grey `#E2E8F0` - **Genie on this theme:** Official colours ### Abyss - **Category:** Dark - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background black `#000508`, panels near-black `#000810`, accent sky blue `#0EA5E9`, buttons sky blue `#38BDF8` - **Genie on this theme:** Official colours ### Void - **Category:** Dark - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background black `#000000`, panels black `#030304`, accent violet `#A78BFA`, buttons light violet `#C4B5FD` - **Genie on this theme:** Turban and vest deep violet `#6D28D9`; skin, trim and gem stay official ### Eclipse - **Category:** Dark - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#080604`, panels near-black `#100C06`, accent orange `#D97706`, buttons bright gold `#FBBF24` - **Genie on this theme:** Turban and vest orange `#D97706`; skin, trim and gem stay official ### Shadow - **Category:** Dark - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#080808`, panels near-black `#0E0E0E`, accent greyish sky blue `#78858F`, buttons greyish blue `#A0AEC0` - **Genie on this theme:** Official colours ### Onyx - **Category:** Dark - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background black `#020606`, panels near-black `#04100C`, accent teal `#14B8A6`, buttons bright cyan `#5EEAD4` - **Genie on this theme:** Official colours ### Pitch Black - **Category:** Dark - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background black `#000000`, panels black `#040404`, accent white `#FFFFFF`, buttons white `#FFFFFF` - **Genie on this theme:** Official colours ## Neon themes Also in this category, under [Showcase themes](https://rogenie.ai/docs/themes-catalog#showcase-themes): [Tron Grid](https://rogenie.ai/docs/themes-catalog#tron-grid), [Neon Magenta](https://rogenie.ai/docs/themes-catalog#neon-magenta), [Matrix](https://rogenie.ai/docs/themes-catalog#matrix), [Cyberpunk](https://rogenie.ai/docs/themes-catalog#cyberpunk), [Synthwave 84](https://rogenie.ai/docs/themes-catalog#synthwave-84) and [Laser Grid](https://rogenie.ai/docs/themes-catalog#laser-grid). ### Retrowave - **Category:** Neon - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark purple `#1A0820`, panels very dark purple `#280A30`, accent orange `#FF6B35`, buttons pale gold `#FCE38A` - **Genie on this theme:** Turban and vest orange `#FF6B35`; skin, trim and gem stay official ### Vaporwave - **Category:** Neon - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark purple `#0C0318`, panels very dark purple `#140420`, accent purple `#B967FF`, buttons pink `#FF71CE` - **Genie on this theme:** Turban and vest purple `#B967FF`; skin, trim and gem stay official ### Electric Blue - **Category:** Neon - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background black `#000610`, panels very dark blue `#000A18`, accent bright cyan `#00D4FF`, buttons bright cyan `#00D4FF` - **Genie on this theme:** Official colours ### Digital Rain - **Category:** Neon - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background black `#000300`, panels black `#040600`, accent neon lime `#7FFF00`, buttons neon lime `#AAFF44` - **Genie on this theme:** Turban and vest neon lime `#79F400`, gem gold `#E8BE23`; skin and trim stay official ### Aurora Neon - **Category:** Neon - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#020808`, panels near-black `#031010`, accent neon green `#00FF88`, buttons bright cyan `#00FFDD` - **Genie on this theme:** Turban and vest green `#00C467`, gem gold `#E8BE23`; skin and trim stay official ## Nature themes Also in this category, under [Showcase themes](https://rogenie.ai/docs/themes-catalog#showcase-themes): [Aurora Borealis](https://rogenie.ai/docs/themes-catalog#aurora-borealis), [Volcanic](https://rogenie.ai/docs/themes-catalog#volcanic) and [Nebula](https://rogenie.ai/docs/themes-catalog#nebula). ### Deep Forest - **Category:** Nature - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#040E06`, panels very dark green `#081808`, accent green `#22C55E`, buttons neon lime `#A3E635` - **Genie on this theme:** Turban and vest green `#20C45D`, gem gold `#E8BE23`; skin and trim stay official ### Ocean Deep - **Category:** Nature - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark teal `#021418`, panels very dark teal `#041C22`, accent cyan `#06B6D4`, buttons cyan `#22D3EE` - **Genie on this theme:** Official colours ### Sunset - **Category:** Nature - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background black `#0C0400`, panels very dark brown `#1A0A02`, accent orange `#F97316`, buttons orange `#FB923C` - **Genie on this theme:** Turban and vest orange `#F97316`; skin, trim and gem stay official ### Desert Night - **Category:** Nature - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#0C0804`, panels very dark brown `#180E06`, accent amber `#C2860A`, buttons bright gold `#E8B84D` - **Genie on this theme:** Turban and vest deep amber `#8A5F08`; skin, trim and gem stay official ### Starlight - **Category:** Nature - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark violet `#06001A`, panels very dark violet `#0C0024`, accent purple `#C084FC`, buttons pale purple `#E9D5FF` - **Genie on this theme:** Turban and vest purple `#BF83FB`; skin, trim and gem stay official ### Coral Reef - **Category:** Nature - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#060810`, panels near-black `#0C1018`, accent red `#FB7185`, buttons light red `#FDA4AF` - **Genie on this theme:** Official colours ### Night Garden - **Category:** Nature - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#040800`, panels very dark lime `#0A1200`, accent neon lime `#A3E635`, buttons bright lime `#BEF264` - **Genie on this theme:** Turban and vest neon lime `#A3E635`, trim pink `#F472B6`, gem genie cyan `#03A3DE`; skin stays official ## Color themes ### Royal Purple - **Category:** Color - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark purple `#080014`, panels very dark violet `#100028`, accent purple `#A855F7`, buttons purple `#C084FC` - **Genie on this theme:** Turban and vest purple `#A855F7`; skin, trim and gem stay official ### Rose Gold - **Category:** Color - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#0C0408`, panels very dark pink `#180A10`, accent pink `#F472B6`, buttons light red `#FDA4AF` - **Genie on this theme:** Turban and vest pink `#F472B6`; skin, trim and gem stay official ### Emerald - **Category:** Color - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#010C08`, panels very dark teal `#021410`, accent green `#10B981`, buttons green `#34D399` - **Genie on this theme:** Turban and vest green `#10B981`, gem gold `#E8BE23`; skin and trim stay official ### Sapphire - **Category:** Color - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark blue `#000818`, panels very dark blue `#000C28`, accent blue `#3B82F6`, buttons blue `#60A5FA` - **Genie on this theme:** Official colours ### Ruby - **Category:** Color - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark pink `#0A0004`, panels very dark pink `#140008`, accent red `#E11D48`, buttons red `#FB7185` - **Genie on this theme:** Official colours ### Amber - **Category:** Color - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#0A0600`, panels very dark amber `#160C00`, accent amber `#F59E0B`, buttons bright gold `#FBBF24` - **Genie on this theme:** Turban and vest deep orange `#B45309`; skin, trim and gem stay official ### Copper - **Category:** Color - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background black `#080402`, panels near-black `#120804`, accent orange `#B87333`, buttons orange `#D4956B` - **Genie on this theme:** Turban and vest orange `#B87333`; skin, trim and gem stay official ### Steel - **Category:** Color - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#08090C`, panels near-black `#0E1218`, accent deep greyish blue `#64748B`, buttons greyish blue `#94A3B8` - **Genie on this theme:** Official colours ### Ice - **Category:** Color - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#040A14`, panels very dark blue `#081420`, accent light sky blue `#7DD3FC`, buttons pale sky blue `#BAE6FD` - **Genie on this theme:** Official colours ### Lavender - **Category:** Color - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark indigo `#08061A`, panels very dark violet `#141028`, accent violet `#B4A0F5`, buttons light violet `#D4C5FF` - **Genie on this theme:** Turban and vest violet `#8266C5`; skin, trim and gem stay official ## Editor themes Also in this category, under [Showcase themes](https://rogenie.ai/docs/themes-catalog#showcase-themes): [Dracula](https://rogenie.ai/docs/themes-catalog#dracula). ### Monokai Pro - **Category:** Editor - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#1E1F1C`, panels near-black `#272822`, accent neon lime `#A6E22E`, buttons bright yellow `#E6DB74` - **Genie on this theme:** Turban and vest neon lime `#A6E22E`, trim pink `#F92672`, gem genie cyan `#03A3DE`; skin stays official ### Solarized Dark - **Category:** Editor - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark teal `#001E26`, panels dark greyish teal `#002B36`, accent sky blue `#268BD2`, buttons gold `#B58900` - **Genie on this theme:** Official colours ### Nord - **Category:** Editor - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#242932`, panels dark greyish blue `#2E3440`, accent cyan `#88C0D0`, buttons light gold `#EBCB8B` - **Genie on this theme:** Official colours ### Gruvbox Dark - **Category:** Editor - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#181818`, panels near-black `#1D2021`, accent orange `#FE8019`, buttons bright amber `#FABD2F` - **Genie on this theme:** Turban and vest orange `#D55C0D`; skin, trim and gem stay official ### Tokyo Night - **Category:** Editor - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#16161E`, panels very dark indigo `#1A1B26`, accent blue `#7AA2F7`, buttons amber `#E0AF68` - **Genie on this theme:** Turban and vest red `#F7768E`; skin, trim and gem stay official ### Catppuccin Mocha - **Category:** Editor - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark indigo `#181825`, panels very dark indigo `#1E1E2E`, accent blue `#89B4FA`, buttons pale gold `#F9E2AF` - **Genie on this theme:** Turban and vest pink `#F38BA8`; skin, trim and gem stay official ### One Dark Pro - **Category:** Editor - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#1E2127`, panels near-black `#282C34`, accent sky blue `#61AFEF`, buttons light amber `#E5C07B` - **Genie on this theme:** Official colours ### Material Dark - **Category:** Editor - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#1A1A1A`, panels near-black `#212121`, accent blue `#82AAFF`, buttons bright amber `#FFCB6B` - **Genie on this theme:** Official colours ### Palenight - **Category:** Editor - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background dark greyish indigo `#23273A`, panels dark greyish indigo `#292D3E`, accent blue `#82AAFF`, buttons purple `#C792EA` - **Genie on this theme:** Official colours ## Special themes Also in this category, under [Showcase themes](https://rogenie.ai/docs/themes-catalog#showcase-themes): [Midnight Purple](https://rogenie.ai/docs/themes-catalog#midnight-purple). ### Crimson Tide - **Category:** Special - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background very dark pink `#080002`, panels very dark pink `#100004`, accent deep red `#DC143C`, buttons red `#FF6B81` - **Genie on this theme:** Official colours ### Roblox Studio - **Category:** Special - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#141414`, panels near-black `#1C1C1C`, accent sky blue `#00A2FF`, buttons bright gold `#F5C842` - **Genie on this theme:** Official colours ### Hacker - **Category:** Special - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background black `#000000`, panels black `#030503`, accent neon green `#00FF00`, buttons neon green `#00FF00` - **Genie on this theme:** Turban and vest neon green `#00FD00`, gem gold `#E8BE23`; skin and trim stay official ### Warm Night - **Category:** Special - **Style:** Dark theme, still background (not a showcase theme) - **Main colours:** background near-black `#0A0604`, panels near-black `#120A06`, accent orange `#FB923C`, buttons light orange `#FDBA74` - **Genie on this theme:** Turban and vest deep orange `#C2410C`; skin, trim and gem stay official --- # Settings reference URL: https://rogenie.ai/docs/settings Section: Customize > Every tab in RoGenie's Settings - Account and Usage, Referrals, Creator, Agent, Memory, Appearance and Providers - and what you can change in each. Open Settings with the gear button in the top bar, from the account menu, or with `Ctrl+Shift+S`. If you leave with unsaved changes, RoGenie asks whether to discard them. ## Account & Usage - **Profile**: your display name (up to 80 characters), username and email. - **Usage**: three cards, **Last 5 hours**, **This month** and **Mascots (5h)**, each with how much you have used, what is left and when it frees up. See [How usage is counted](https://rogenie.ai/docs/usage-and-quota). - **Plan**: your current plan, with **Upgrade plan** and **Manage billing**, which opens the Stripe billing portal: change your card, see invoices or cancel your plan. A scheduled downgrade shows when it takes effect ("Nothing is charged now"). A failed payment shows *Payment past due*. See [Upgrade, downgrade and cancel](https://rogenie.ai/docs/billing). - **Referral bonus**: shown when friends you referred are adding to your limits. See [Referrals](https://rogenie.ai/docs/referrals). - **Linked accounts**: email, Google and Discord. See [Accounts and sign-in](https://rogenie.ai/docs/accounts#linked-accounts). - **Take the tour**: go through the one-minute tour of the app again. - **Danger zone**: delete your account. See [Privacy, data and deleting your account](https://rogenie.ai/docs/privacy-and-data#delete-your-account). ## Referrals Your referral link, how many friends are currently adding bonus quota (up to 8), and the list of people you referred with their status. See [Referrals](https://rogenie.ai/docs/referrals). ## Creator For creators in the RoGenie creator program: your code, what it gives the people you refer, your earnings or quota bonus, purchases and payouts. See [Creator program](https://rogenie.ai/docs/creator-program). ## Agent How the agent works for you. See [Agent settings](https://rogenie.ai/docs/agent-settings) for every option: - **Agent & sub-agents**: the orchestrator model and a model per sub-agent role, plus **Playtest verification**. - **Transparency**: thinking summaries, Claude extended and adaptive thinking, the thinking budget ratio, Gemini thought summaries, and the working panel. - **Optimization mode**: Efficient, Auto, Granular or Model's choice. - **Context and savings**: smart context compression, minified code context, and the maximum context window. ## Memory Standing instructions, what RoGenie remembers about you, and the linked place's project notes. See [Memory: instructions, notes and project notes](https://rogenie.ai/docs/memory). ## Appearance Themes, **Match the genie to the theme**, effects and sounds, and the mascot studio. See [Themes and your genie](https://rogenie.ai/docs/themes-and-mascots). ## Providers Your own API keys for Gemini, OpenAI, Anthropic, OpenRouter, Together, Perplexity and DeepSeek, and your own Claude accounts (Builder plan and above). See [Use your own API keys](https://rogenie.ai/docs/own-api-keys) and [Your Claude accounts](https://rogenie.ai/docs/claude-accounts). ## Settings that live in your browser A few choices are remembered by your browser rather than your account, so they do not follow you to another device: drafts of unsent messages, the effort per model, Fast mode, the response sound and connection toasts. [Tool access](https://rogenie.ai/docs/tool-access) choices last only for the current session. --- # Agent settings URL: https://rogenie.ai/docs/agent-settings Section: Customize > Settings › Agent in detail - sub-agent models, playtest verification, Blender control, thinking and transparency options, optimization mode, context compression, minified code and the maximum context window. Open **Settings › Agent**. Changes apply to your account and are used by every new run. ## Agent & sub-agents Big jobs are split across specialist [sub-agents](https://rogenie.ai/docs/sub-agents). Here you pick the model each one runs on. - **Orchestrator model**: plans the work and assigns the sub-agents. - **Specialist sub-agents**: Builder, Scripter, Debugger, UI Designer, VFX Artist, Asset & Audio Finder, Animator, 3D modelling (Blender), Verifier and Researcher. **Same as chat** runs a role on the model you picked for the chat and sends no override. By default the Debugger, Asset & Audio Finder, Verifier and Researcher run on **Auto (intelligent & cheap)**; the other roles follow the chat, the Animator and 3D modelling (Blender) included. That sub-agent also sets up and checks its icon renders (Blender draws the image) on the model you pick for it, and that role works only while [Blender](https://rogenie.ai/docs/blender#blender-sub-agent) is connected. The status line says how many roles run on a model of their own. ### Playtest verification RoGenie runs your game to verify that changes actually work. Turn **Playtest verification** off to skip runtime playtesting and save tokens. Static checks (compile, validation, scans) still run. See [Playtesting and verification](https://rogenie.ai/docs/playtesting). ### Blender control **Let RoGenie control Blender** is on by default. With the [RoGenie Bridge](https://rogenie.ai/docs/bridge) running and Blender open on the same PC, RoGenie can model, rig and animate in your Blender; its Blender tools and the 3D modelling (Blender) sub-agent appear only while Blender is connected. The Animator uses Blender while it is connected and works in Studio otherwise. Turn it off to stop RoGenie using Blender even when it is open. See [Blender](https://rogenie.ai/docs/blender). ## Transparency These controls show the thinking summaries a provider exposes (Claude thinking blocks, Gemini thought summaries) and rich tool-call logs. They never expose hidden raw chain-of-thought. | Setting | What it does | |---|---| | **Enable thinking summaries** | Shows models' thought summaries live in the work log. | | **Enable Claude extended thinking (when supported)** | Lets Claude models think before answering. | | **Adaptive thinking (Opus 4.6 / Sonnet 4.6)** | Claude decides how deeply to think for each step. Recommended for those models; older models use a fixed budget. | | **Claude thinking budget ratio (0.1–0.9)** | The fixed budget older Claude models get, as a share of the output. | | **Enable Gemini thought summaries** | Shows Gemini's thought summaries. | | **Enable working panel (tool calls + results)** | Shows the [work log](https://rogenie.ai/docs/watching-a-run#the-work-log) of tool calls and results under each reply. | ## Optimization mode Every request re-sends the whole conversation, so how the agent paces its work changes the total cost. | Mode | Pacing | |---|---| | **Efficient** (recommended) | Fewer, bigger replies. The lowest total token cost. | | **Auto** | Quick, cheap steps first, then bigger plans once it has context. | | **Granular** | More, smaller replies. Uses more total tokens; pick it only if you want the agent to check results after every small step. | | **Model's choice** | No pacing guidance at all; the model decides how to split up the work. | ## Context and savings RoGenie's "up to 11× more usage" comes from three levers. The first, discounted model rates, is automatic. The other two live here. See [How RoGenie saves tokens](https://rogenie.ai/docs/savings). | Setting | What it does | |---|---| | **Smart context compression** | Structurally compresses large JSON tool outputs (scene reads, search results, property dumps) before they reach the model. Cuts token cost on long builds while preserving answers (about 97% fidelity, benchmark-backed). | | **Minified code context** (experimental) | Shows the model a copy of your code with comments and extra whitespace removed but every line number kept, typically about a quarter fewer tokens, so edits land on the exact lines of your real scripts. Your scripts are never stored minified. | ### Maximum context window The context window is a chat's memory (the [Chat memory](https://rogenie.ai/docs/chat-memory) ring by the message box): how much of the conversation RoGenie keeps in mind at once. It is **not** your usage limit. RoGenie summarizes older turns once a chat reaches this many tokens, which keeps cost and latency down. - **0** means auto: use the model's own window. - Otherwise, enter at least **8,000** tokens. - The value is always capped by the model. For example, 200K on a 1M-token model summarizes at 200K; 200K on a 100K-token model still caps at about 100K. A lower value makes long chats cheaper per step, at the cost of summarizing more often. --- # Use your own API keys URL: https://rogenie.ai/docs/own-api-keys Section: Customize > Add your own keys for Gemini, OpenAI, Anthropic, OpenRouter, Together, Perplexity or DeepSeek so those models run on your key instead of your RoGenie quota. You never need an API key to use RoGenie. But if you already pay a provider, you can add your own key and that provider's models will run **on your key, not on your RoGenie quota**. This is often called BYOK, "bring your own key". ## Supported providers **Settings › Providers** takes keys for: | Provider | Key looks like | |---|---| | Gemini | `AIza...` | | OpenAI | `sk-...` | | Anthropic | `sk-ant-...` | | OpenRouter | `sk-or-...` | | Together | `together-...` | | Perplexity | `pplx-...` | | DeepSeek | `sk-...` | ## Add a key 1. Open **Settings › Providers**. 2. Paste the key into the provider's field and save. 3. RoGenie checks the key with the provider when you save it, and the field shows its status. | Status | Meaning | |---|---| | **Configured** | Your key is saved. This provider's models run on your key, not on your RoGenie quota. | | **Default** | You have not added a key. RoGenie's own access covers this provider, so its models use your RoGenie quota. | | **Rejected — replace this key** | The provider refused the key. Until you replace it, runs fall back to RoGenie's own route and spend your RoGenie quota. | | **Not set** | No key saved. | In the [model picker](https://rogenie.ai/docs/models), models on your key are marked **Your API key · no RoGenie quota**. ## How your keys are kept - Keys are stored securely on RoGenie's server and used only to route **your** account's requests. - A saved key is never shown again, not even to you. To change it, paste a new one. - **Clear** removes a key. RoGenie stops using it right away; you can add it again any time. - RoGenie redacts known secret formats in its logs. Never paste keys into chat messages. ## When your quota runs out Calls on your own keys are billed to you by the provider and never count toward your RoGenie quota, on every plan. They keep working when your RoGenie quota is used up. See [How usage is counted](https://rogenie.ai/docs/usage-and-quota#when-you-run-out). ## If a key is rejected When a provider refuses your key during a run, the error card says so and offers **Open Settings › Providers**. Common causes: the key was revoked or mistyped, the provider account is out of credit, or the key lacks access to that model. Replace the key, then [regenerate](https://rogenie.ai/docs/message-actions#regenerate). ## Keys and routes Many models are offered by more than one provider. RoGenie picks the route for each model by itself: the best available one, falling back automatically if it fails. RoGenie's own routes are shown as *Provider 1*, *Provider 2* and so on. You do not need to set an order; see [Routes and fallback](https://rogenie.ai/docs/models#routes-and-fallback). ## Your own Claude accounts On the Builder plan and above you can also connect your own Claude subscription accounts. See [Your Claude accounts](https://rogenie.ai/docs/claude-accounts). --- # Your Claude accounts URL: https://rogenie.ai/docs/claude-accounts Section: Customize > On the Builder plan and above, connect your own Claude subscription accounts so RoGenie runs Claude models on them instead of your RoGenie quota. If you have your own Claude subscription, you can connect it to RoGenie. RoGenie then runs **Claude models on your Claude accounts**, and those runs do not use your RoGenie quota. Accounts you add are private to your RoGenie account. This is available on the **Builder**, **Pro** and **Studio** plans. On Free and Starter, the section in Settings shows **Upgrade to Builder**. ## Add a Claude account 1. Open **Settings › Providers › Your Claude accounts**. 2. Click **Add Claude account**. A sign-in tab opens. 3. Sign in to Claude in that tab and approve RoGenie. 4. The tab then ends on a page that does not load, with an address starting `http://localhost`. That is expected. 5. Copy the whole address from that tab (or just the code in it), paste it into **Callback address or code** in Settings and click **Add account**. 6. RoGenie shows **Claude account added**. If your browser blocked the sign-in tab, click **Open the sign-in tab** (or allow pop-ups for rogenie.ai). **Open the sign-in tab again** reopens it if you closed it. If the sign-in took too long, it expires: click **Start again**. ## Turn it on or off The switch **Use my own Claude accounts**: - **On**: RoGenie runs Claude models on your accounts. - **Off**: your accounts are kept, but RoGenie does not use them; Claude models use your RoGenie quota as usual. You need at least one account before you can switch it on. ## Remove an account Click remove beside the account and confirm. RoGenie stops running Claude models on that account right away. You can add it again later. ## Good to know - Your Claude subscription's own usage limits still apply to the accounts you add. - Their usage never counts toward your RoGenie quota, and Claude models on your accounts keep working when your RoGenie quota runs out. - Only Claude subscriptions can be connected. ChatGPT and Codex subscriptions can't; add an [OpenAI API key](https://rogenie.ai/docs/own-api-keys) instead. - Non-Claude models are not affected and keep using your RoGenie quota (or your [own API keys](https://rogenie.ai/docs/own-api-keys)). - If adding accounts is temporarily unavailable, Settings says "Adding Claude accounts is not available right now". Nothing is wrong with your account; try again later. --- # Plans and limits URL: https://rogenie.ai/docs/plans Section: Plans and billing > RoGenie's five plans - Free, Starter, Builder, Pro and Studio - with their prices, token limits per 5 hours and per month, mascot generations and support. Every plan gets the full agent, the Studio plugin and the RoGenie Bridge (Roblox's AI generators and Blender, on Windows), every built-in model, and the option to use your own API keys. Plans differ in how much you can use and in mascot generations, and Builder and up can also connect your own [Claude accounts](https://rogenie.ai/docs/claude-accounts). | Plan | Price | Tokens per 5 hours | Tokens per month | Mascot generations per 5 hours | Support | |---|---|---|---|---|---| | **Free** | $0/month | 250K | 2M | Not included | Community support | | **Starter** | $5/month | 750K | 7.5M | 2 | Standard support | | **Builder** | $19/month | 3M | 30M | 4 | Standard support | | **Pro** | $49/month | 8M | 75M | 12 | Standard support | | **Studio** | $99/month | 20M | 150M | 30 | Standard support | Prices are in US dollars, billed monthly. The current prices are always on the [pricing page](https://rogenie.ai/#pricing). ## What the numbers mean - **Tokens per 5 hours** is a **rolling window**: what you used in the last 5 hours. It frees up gradually as older usage ages out. - **Tokens per month** counts from the start of your monthly cycle: the 1st of the month on Free, and on paid plans the day of the month your subscription started (midnight UTC). - Tokens are counted at each model's **multiplier**, relative to Claude Opus 5 at 1×. A cheap model stretches the same limit much further: Auto (intelligent & cheap) runs at 0.058×. See [How usage is counted](https://rogenie.ai/docs/usage-and-quota) for the details. ## Each plan ### Free: $0/month For trying RoGenie and smaller Studio tasks. - 250K tokens per 5 hours and 2M per month - Full agent, Studio plugin & RoGenie Bridge - All built-in models - Roblox AI meshes & materials, and Blender (Windows Bridge) - Bring your own API keys - Mascot generation on paid plans - When the quota runs out: Hard stop on the built-in models until the 5-hour or monthly window frees up; models on your own API keys keep working. ### Starter: $5/month For a first paid month and steady Studio work. - 750K tokens per 5 hours and 7.5M per month - Everything in Free - 2 mascot generations per 5 hours - 3x the 5-hour tokens of Free - Standard support - When the quota runs out: Hard stop on the built-in models until the 5-hour or monthly window frees up; models on your own API keys keep working. ### Builder: $19/month For active solo Roblox development. - 3M tokens per 5 hours and 30M per month - Everything in Starter - 4 mascot generations per 5 hours - 4x the 5-hour tokens of Starter - Connect your own Claude accounts - Standard support - When the quota runs out: Hard stop on the built-in models until the 5-hour or monthly window frees up; your own API keys and connected Claude accounts keep working. ### Pro: $49/month For frequent, large Studio builds and iteration. - 8M tokens per 5 hours and 75M per month - Everything in Builder - 12 mascot generations per 5 hours - Room for large, all-day builds - Standard support - When the quota runs out: Hard stop on the built-in models until the 5-hour or monthly window frees up; your own API keys and connected Claude accounts keep working. ### Studio: $99/month For production-scale Roblox projects and all-day building. - 20M tokens per 5 hours and 150M per month - Everything in Pro - Highest usage limits - 30 mascot generations per 5 hours - Standard support - When the quota runs out: Hard stop on the built-in models until the 5-hour or monthly window frees up; your own API keys and connected Claude accounts keep working. ## Extras by plan | Feature | Free | Starter | Builder | Pro | Studio | |---|---|---|---|---|---| | Full agent, plugin and Bridge | Yes | Yes | Yes | Yes | Yes | | All built-in models | Yes | Yes | Yes | Yes | Yes | | Your own API keys (no quota used) | Yes | Yes | Yes | Yes | Yes | | Custom mascots per 5 hours | No | 2 | 4 | 12 | 30 | | [Your own Claude accounts](https://rogenie.ai/docs/claude-accounts) | No | No | Yes | Yes | Yes | | Support | Community support | Standard support | Standard support | Standard support | Standard support | ## More usage without upgrading - **Referrals.** Every friend who subscribes through your link adds 25% of the limits of the plan they bought to yours for their first month. See [Referrals](https://rogenie.ai/docs/referrals). - **Your own keys.** Models on [your own API keys](https://rogenie.ai/docs/own-api-keys) or [your Claude accounts](https://rogenie.ai/docs/claude-accounts) do not use your RoGenie quota, and keep working when it runs out. - **Cheaper models.** Auto (intelligent & cheap) and other low-multiplier models make the same quota last many times longer. ## Changing plan Upgrade, downgrade or cancel at any time. Upgrades between paid plans take effect immediately and are prorated; downgrades take effect at the end of the current period. See [Upgrade, downgrade and cancel](https://rogenie.ai/docs/billing). --- # How usage is counted URL: https://rogenie.ai/docs/usage-and-quota Section: Plans and billing > Tokens, the rolling 5-hour window, the monthly limit, model multipliers, what uses quota and what does not, warnings, and what happens when you run out. RoGenie measures usage in **tokens**, the small pieces of text models read and write. Your plan sets two limits, and both apply at once. ## The two limits | Limit | How it works | When it frees up | |---|---|---| | **5-hour window** | Everything you used in the **last 5 hours**. It is a rolling window, not a fixed daily reset. | Gradually, as older usage ages out. The time shown is when your oldest usage in the window ages out. | | **Monthly limit** | Everything you used in your current **monthly cycle**. | At the start of your next cycle: the 1st of the month on Free, and on paid plans the day of the month your subscription started (midnight UTC). | For example, on Builder you can use 3M tokens in any 5-hour stretch and 30M in the month. See every plan in [Plans and limits](https://rogenie.ai/docs/plans). ## Tokens are counted at the model's multiplier What counts against your quota is **billable tokens**: the tokens a model read and wrote, weighted by that model's price relative to Claude Opus 5, which is 1×. - Input (what the model reads: your message, the conversation so far, tool results) and output (what it writes) are weighted **separately**, by that model's own input and output rates. At the 1× reference rate, an output token costs five times an input token. - When the model supports prompt caching, the part of the conversation it has already read is billed at a lower cached rate. - The multiplier label in the [model picker](https://rogenie.ai/docs/models) is an estimate for a typical run; hover it to see the model's exact input and output rates. A 0.1× model makes the same quota last about ten times as long as Opus 5. - A model with no published price is billed at the default 1×. To see what one reply cost, click **Info** on it: `quota_billable_tokens` is what your quota counted for that run. ## What uses quota Every model call made for you, at the multiplier of the model it ran on: - the agent's steps in a run, including playtests and checks that call the model, - [sub-agents](https://rogenie.ai/docs/sub-agents) and [code reviews](https://rogenie.ai/docs/code-review), - [summarizing](https://rogenie.ai/docs/chat-memory) a chat. Long chats cost more per step, because every step re-sends the conversation. Summarizing and starting new chats for new topics keeps this down. ## What does not use quota - Models running on [your own API keys](https://rogenie.ai/docs/own-api-keys) or [your own Claude accounts](https://rogenie.ai/docs/claude-accounts). They also keep working when your RoGenie quota runs out. - Custom mascot generations, which have their own per-plan limit per 5-hour window. One small exception: when a vision model reads a reference image you attached, that short call counts as usual. - Browsing the app, the IDE, chat search and settings. ## Where to see your usage - **The library**, at the bottom: your plan and what is left for the last 5 hours and the month. - **Settings › Account & Usage**: cards for *Last 5 hours*, *This month* and *Mascots (5h)*, each with used, left and when it frees up. - **Info** on any reply, for that run. ## Warnings before you run out When you reach **75%** of either limit, RoGenie tells you and offers to switch the chat to **Auto (intelligent & cheap)**, which runs a capable, low-cost model at a fraction of the quota. Before each model call, RoGenie also checks that the step fits in what you have left, so a single large step cannot overshoot your limit. ## When you run out When what is left is not enough for another step, RoGenie stops the run and says which limit you reached, for example: - *5-hour token limit reached (2,995,000 / 3,000,000 tokens): what is left is not enough for another step. This is a rolling 5-hour window, so it frees up as older usage ages out.* - *Monthly token limit reached (...): what is left is not enough for another step. It resets at the start of your next monthly cycle.* Built-in models then stop until the limit frees up. The reply shows when, plus your options: 1. **Wait.** The 5-hour window frees up gradually; the reply shows the time. 2. **Use your own keys or Claude accounts.** Models on [your own API keys](https://rogenie.ai/docs/own-api-keys) (any plan) and your connected [Claude accounts](https://rogenie.ai/docs/claude-accounts) (Builder and up) keep working, and their usage never counts toward your RoGenie quota. 3. **Invite friends.** [Referrals](https://rogenie.ai/docs/referrals) add bonus quota. 4. **Upgrade.** The card offers plans with higher limits. An upgrade applies right away. Everything RoGenie already did in Studio stays. When your quota frees up, ask it to continue: it picks up from the place's current state instead of starting over. ## Changing plans Changing plan does not erase usage you already have. A higher plan's limits apply as soon as the upgrade goes through; a downgrade applies at the end of your billing period. See [Upgrade, downgrade and cancel](https://rogenie.ai/docs/billing). ## Make your quota go further - Use **Auto (intelligent & cheap)** or another low-multiplier model for everyday work. - [Summarize](https://rogenie.ai/docs/chat-memory) long chats, and start a new chat for a new topic. - Keep **Efficient** pacing and **Smart context compression** on in [Agent settings](https://rogenie.ai/docs/agent-settings). - Use a lower [effort](https://rogenie.ai/docs/effort-and-fast-mode) for simple tasks, and avoid Fast mode unless you need it. - Pick cheap models for simple [sub-agent roles](https://rogenie.ai/docs/sub-agents#sub-agent-models). - For small, low-risk changes, turn off [playtest verification](https://rogenie.ai/docs/agent-settings#playtest-verification). --- # How RoGenie saves tokens (up to 11×) URL: https://rogenie.ai/docs/savings Section: Plans and billing > What "up to 11× more usage" means - discounted model rates, minified code context and smart context compression - and how the estimate is made. RoGenie says you get **up to 11× more usage** than using the same models at official list prices, which is up to 91% lower cost. That is RoGenie's maximum estimate, and it comes from three levers working together. Actual savings vary by model, project and workload. ## Lever 1: discounted model rates RoGenie's rates for the same models are discounted against the providers' official list prices. Nothing to turn on: every built-in model's [multiplier](https://rogenie.ai/docs/models#the-quota-multiplier) already reflects it. ## Lever 2: minified code, same line numbers When RoGenie reads your scripts, the model can get a **minified copy** with comments, indentation and extra spaces removed, typically about a quarter fewer tokens. Every line keeps its line number, so edits land on the exact lines of your real script. - Your scripts are never stored minified. What you see in Studio and the [IDE](https://rogenie.ai/docs/ide) is always your real code. - This is marked **experimental**. Switch it in **Settings › Agent › Minified code context**. ## Lever 3: smart context compression Large JSON tool outputs, like scene reads, search results and property dumps, are **structurally compressed** before they reach the model. This cuts token cost on long builds while preserving answers: about 97% fidelity, benchmark-backed. Switch it in **Settings › Agent › Smart context compression**. ## Other ways RoGenie keeps cost down - **Targeted diffs.** RoGenie edits the exact lines that need to change instead of rewriting whole scripts. - **Automatic summarizing.** Long chats are compacted so each step re-sends less. See [Chat memory and summarizing](https://rogenie.ai/docs/chat-memory). - **Efficient pacing.** The default optimization mode favours fewer, bigger replies, which cost the least overall. See [Agent settings](https://rogenie.ai/docs/agent-settings#optimization-mode). - **Cheap defaults.** Auto (intelligent & cheap) is the default model, and simple sub-agent roles run on it unless you choose otherwise. ## How the estimate is made The "up to 11×" figure compares one build task on one model, paid two ways: at the model's official list price with no savings, and through RoGenie with all three levers. It is a maximum, not a promise: a project with little code to read or few large tool outputs saves less, and the model you choose matters most of all. --- # Upgrade, downgrade and cancel URL: https://rogenie.ai/docs/billing Section: Plans and billing > How paying for RoGenie works - checkout through Stripe, upgrading and prorating, a declined card, scheduled downgrades, cancelling, changing your card, failed payments and refunds. Paid plans are processed securely through **Stripe**. RoGenie changes your plan only after it receives and verifies signed billing events from Stripe, so a plan change shows up a moment after payment goes through. The binding terms are on the [Billing and Plans](https://rogenie.ai/billing) policy page. ## Upgrade Upgrade from any of these: - **Settings › Account & Usage › Upgrade plan**, - the [pricing page](https://rogenie.ai/#pricing), - the card RoGenie shows when your quota runs out. What you pay depends on where you start: | From | To | What happens | |---|---|---| | **Free** | any paid plan | You go to Stripe checkout and pay the plan's monthly price. The plan starts when payment completes. | | a **paid** plan | a **higher** paid plan | The upgrade takes effect **immediately** and is **prorated**: you are charged now for the difference for the rest of the current period. Your billing date stays the same. | Before an upgrade between paid plans, RoGenie shows a **Change plan** confirmation with the prorated amount. ### If your card is declined The prorated amount is charged to your saved card the moment you confirm. If your bank declines it, nothing is charged and your plan does not change: RoGenie says *Your card was declined* and shows **Update payment method**, which opens the Stripe billing portal. Change your card there, then try the upgrade again. If your bank wants an extra confirmation step (3D Secure), RoGenie says so and offers the same button: update or re-add the card in the portal, where your bank can confirm it, then try again. ## Downgrade Moving to a lower paid plan is **scheduled for the end of the current billing period**. Nothing is charged now, and you keep your current plan's limits until then. Settings shows the pending change: "Changes to Starter on [date]. Nothing is charged now." ## Cancel 1. Open **Settings › Account & Usage**. 2. Click **Manage billing**. The Stripe billing portal opens. 3. Cancel the subscription there. A cancelled subscription ends **at the end of the paid period**. You keep full access to your plan until then, and the account then moves to the Free plan. Your chats, settings and memory stay. ## Change your card or payment method 1. Open **Settings › Account & Usage** (or the account menu). 2. Click **Manage billing**. The Stripe billing portal opens. 3. Add the new card and make it the default. You can remove the old one there too. The same portal shows your invoices and is where you cancel. Opening it leaves the app; if you have unsaved settings, RoGenie asks first. **Manage billing** shows once you have a paid Stripe subscription; a free account has no card on file to change. Signed in on the [pricing page](https://rogenie.ai/#pricing), your current plan's card has **Manage billing** too, so you can change the card there before you upgrade. ## Failed payments If a renewal payment fails, your subscription may be marked **past due**, and Settings shows *Payment past due: Your last payment did not go through. Update your payment method with Manage billing.* A later successful payment restores the subscription. ## Refunds Refunds are not processed automatically. For refund requests and billing questions, contact RoGenie support; see [Get help](https://rogenie.ai/docs/get-help) and the [Billing and Plans](https://rogenie.ai/billing) page. ## Usage and plan changes Changing plan does not reset your usage windows or erase usage you already have. See [How usage is counted](https://rogenie.ai/docs/usage-and-quota#changing-plans). ## Deleting your account An active Stripe subscription must be cancelled before you can delete your account. See [Privacy, data and deleting your account](https://rogenie.ai/docs/privacy-and-data#delete-your-account). --- # Referrals URL: https://rogenie.ai/docs/referrals Section: Plans and billing > Share your link and earn bonus quota - 25% of the limits of the plan each friend buys, for their first month, up to 8 friends at once. Invite friends to RoGenie and get more usage for free. Every friend who signs up through your link and subscribes to **any paid plan** adds **25% of that plan's token limits** to your own, on top of your plan, for that friend's **first month**. ## What you get For each friend who subscribes, a quarter of the 5-hour and monthly limits of the plan they bought is added to your own limits: | Your friend buys | You get per 5 hours | You get per month | |---|---|---| | **Starter** | +187.5K | +1.875M | | **Builder** | +750K | +7.5M | | **Pro** | +2M | +18.75M | | **Studio** | +5M | +37.5M | So a friend on Builder adds +750K tokens per 5 hours and +7.5M per month (25% of Builder's 3M and 30M), and a friend on Studio adds +37.5M per month. The share is of the plan your friend's **first payment** bought. If they upgrade or downgrade later in that month, your bonus stays the same. It stacks: **four friends** on the same plan in the same month give you a whole plan's worth of usage without paying (four friends on Builder are a whole Builder plan). Up to **eight friends** count at a time: the eight whose first payment came first. When one friend's month ends, the next friend still in their first month takes the place. The bonus works on every plan, including Free. ## How long it lasts The bonus for each friend lasts for that friend's **first month**: it is credited once, when their first payment goes through, and ends when their first billing period ends (at most 31 days). Their renewals and plan changes do not extend it. A friend who subscribes without a real payment does not count, and a payment that is refunded in full or disputed ends that friend's bonus at once (a later payment does not start it again). ## Share your link 1. Open **Settings › Referrals** (or **Refer friends · earn free usage** in the account menu). 2. Copy your referral link and share it. Your friend just opens the link and signs up. The link is remembered in their browser for 30 days, so they can sign up later from the same browser and still count as your referral. ## Track your referrals **Settings › Referrals** shows: - how many friends are counting now, out of 8, and the bonus they add, - what a friend adds on each plan, - everyone you referred, with their status, the plan they bought and what each one adds now, - your total referrals and current monthly bonus. **Settings › Account & Usage** also shows an active referral bonus beside your plan. ## Creators Running a channel or community? RoGenie also has a [creator program](https://rogenie.ai/docs/creator-program) with its own code and rewards. --- # Creator program URL: https://rogenie.ai/docs/creator-program Section: Plans and billing > For creators partnered with RoGenie - your creator link, the discount it gives your audience, your cash cut or quota bonus, and the Creator dashboard. RoGenie partners with creators, such as YouTubers, streamers and community owners, through a creator program. It is separate from everyday [referrals](https://rogenie.ai/docs/referrals), which every account has. ## How it works A creator in the program gets a personal **creator link**. Anyone who signs up with it gets **a discount on their first plan**. The creator earns one of two rewards for each referred first purchase: | Reward | How it works | |---|---| | **Cash cut** | A percentage of the net amount (after Stripe fees) of each referred first purchase. Payouts are handled manually by the RoGenie team. | | **Quota bonus** | Bonus quota added to the creator's plan for each referred first purchase, instead of cash. | The discount and the reward percentages are set per creator. ## The Creator dashboard Creators in the program see a **Creator** tab in Settings with: - the creator link, to copy and share, and the discount it gives, - **Currently owed to you** and **Lifetime earned** (cash cut), or the quota bonus per referral, - **Total referred**, **Purchases**, and **Total paid out** or the program status, - **Referred purchases**: each plan bought, when, and the amount minus fees, with whether your cut has been paid, - **Payout history**: when each payout was made. The tab appears only for accounts in the program; other accounts do not see it in Settings. ## Joining To ask about the creator program, contact the RoGenie team in the [RoGenie Discord](https://rogenie.ai/docs/discord). --- # Troubleshooting: Studio won't connect URL: https://rogenie.ai/docs/troubleshooting-studio Section: Help > Fixes for a missing RoGenie button, pairing codes that do not work, "Studio: Not linked", "Update needed", HTTP permission errors and Studio disconnecting mid-run. Find your symptom below. Most problems are fixed by restarting Roblox Studio, or by getting a fresh pairing code. ## There is no RoGenie button in Studio 1. Check the file is in the right folder: - **Windows:** `%localappdata%\Roblox\Plugins` - **Mac:** `~/Documents/Roblox/Plugins/` The easiest way to be sure is Studio's own button: **Plugins** tab › **Plugins Folder**. It opens the folder Studio actually reads. 2. Check the file still ends in `.lua`. Some browsers add `(1)` or `.txt` to downloads; rename it back if so. 3. **Restart Roblox Studio** completely. Plugins load when Studio starts. 4. Open a place. The button is on the **Plugins** tab. 5. Check the plugin is not disabled in **Plugins › Manage Plugins**. See [Install the Studio plugin](https://rogenie.ai/docs/install-plugin). ## "Failed to load plugin source. Check Studio HTTP permissions." The plugin was not allowed to reach `rogenie.ai`. When Studio asks whether the RoGenie plugin may connect to `rogenie.ai`, allow it. If you denied it earlier, change the plugin's permissions in **Plugins › Manage Plugins**, then restart Studio. Also check that nothing on your network blocks `rogenie.ai`: a school or work network, a VPN, a proxy or a firewall. ## The pairing code does not work - **It expired.** Codes last 5 minutes. Click **Get a new code** (or **Connect**) in the plugin panel for a new one. - **A typo.** Check all the digits: eight (six on a plugin older than 1.1.151). You can click the code in the plugin panel to select it and copy it with `Ctrl+C` (`Cmd+C` on Mac). - **Wrong account.** Enter the code in the RoGenie account you want to use, signed in at [rogenie.ai/app](https://rogenie.ai/app). - **Too many tries.** Wrong codes pause pairing: for a few minutes after many attempts, and for up to a day after 20 wrong codes in 24 hours. Check the code shown in Studio or the RoGenie Bridge before you try again. - **"Network error. Please try again."** Your connection to RoGenie dropped. Refresh the app and try again. ## The app says "Studio: Not linked" - **Is the plugin connected?** Open the RoGenie panel in Studio. If it says *Offline* or *Disconnected*, click **Connect**. Turn on **Auto-connect on start** so it reconnects by itself next time. - **Is Studio open on a place?** RoGenie needs an open place, not just the Studio start page. - **Several Studios?** Click the **Studio** button in the top bar and choose the session RoGenie should act in. - **Did you unpair?** If you clicked **Unpair Studio**, pair again with a new code. - **Signed in to the right RoGenie account?** The Studio is linked to the account that entered the code. ## "Studio: Update needed" RoGenie needs a newer plugin than the one running. The plugin updates itself when Studio starts, so **restart Roblox Studio**. If the message stays, download the plugin again from the app and replace the old file. See [Install the Studio plugin](https://rogenie.ai/docs/install-plugin#updates). ## "Reload Studio or update the RoGenie plugin before script edits" The running plugin is too old for safe script edits. Restart Studio so it updates. ## Studio disconnects during a run If Studio closes, sleeps, crashes or loses its connection while RoGenie is working, the steps that needed Studio fail and the run may end early. Everything RoGenie already did is still in your place. 1. Reopen Studio and the place, and make sure the plugin is connected. 2. Ask RoGenie to continue. It reads the place's current state and carries on. ## Studio actions time out or hang - A modal dialog open in Studio, or Studio being busy with a long operation, can block the plugin. Close dialogs and wait for Studio to finish. - If a playtest is stuck, press **Stop** in the app, then stop the play session in Studio. - The plugin panel's **Stop** button stops the action running in Studio right now. ## Still stuck? [Report the problem](https://rogenie.ai/docs/get-help) with the chat, the time it happened, whether Studio showed as linked, and any message in Studio's Output window that starts with `[RoGenie`. --- # Troubleshooting: Bridge won't connect URL: https://rogenie.ai/docs/troubleshooting-bridge Section: Help > Fixes for the RoGenie Bridge - antivirus blocking it, no window, "Waiting for Roblox Studio", Studio's MCP helper, Blender not connecting, pairing again, "Bridge offline" in the app, and where the log is. The [RoGenie Bridge](https://rogenie.ai/docs/bridge) only matters for Roblox's AI mesh and material generation, image uploads and Blender. If it is not working, everything else in RoGenie still does. ## Check the basics first 1. **Are you on Windows?** The Bridge runs on Windows only, on the same PC as Roblox Studio. 2. **Is it running?** Look for the RoGenie icon in the system tray, near the clock (it may be in the hidden-icons overflow). Left-click it to open the window. 3. **Is Studio open on a place?** The Bridge needs a place open in Studio to generate anything. 4. **Is it paired?** The Bridge window shows an 8-digit code when it is not. Enter it in the app (see [Pair it](https://rogenie.ai/docs/bridge#pair-it)). ## No window appears The Bridge may have started in the tray. Left-click the RoGenie icon in the tray. If there is no icon, start it again: - **Easy install:** from the Start menu, open **RoGenie Bridge**. - **Open source:** double-click `Start RoGenie Bridge.bat` in its folder. ## Your antivirus blocks the Bridge Windows Defender does not flag the Bridge, but some other antivirus programs can block or quarantine it. A user with AhnLab V3 Lite hit this. It happens because the Bridge is new and its installer is not code-signed yet, not because it does anything harmful. Signs of it: the installer does nothing or vanishes, the Bridge never opens, or your antivirus shows a warning about `RoGenie Bridge Setup.exe`. 1. Open your antivirus and look in its **quarantine** or **blocked items** list for `RoGenie Bridge Setup.exe` or files from the Bridge folder. Restore them if they are there. 2. Add an **exclusion** (also called an exception or allow list) in your antivirus for: - the installer you downloaded, `RoGenie Bridge Setup.exe`, and - the Bridge's folder, `%LOCALAPPDATA%\Programs\RoGenie Bridge`. To open it, paste that path into File Explorer's address bar. 3. Run `RoGenie Bridge Setup.exe` again. Most antivirus vendors also have a "report a false positive" page. Reporting it there helps everyone who uses that antivirus. To make sure the file is the one RoGenie published before you allow it, [check its SHA-256](https://rogenie.ai/docs/bridge#verify). If you would rather not add an exclusion, the [open-source edition](https://rogenie.ai/docs/bridge#install-it) is plain Python that you can read before you run it. ## "Roblox Studio isn't installed" Install Roblox Studio and open it once, then start the Bridge again. ## "Waiting for Roblox Studio" or "Studio isn't sharing yet" The Bridge can see no Studio sharing a place with it. Open a place in Studio (the start page is not enough), then turn on Studio's built-in **MCP server**, either way: - In the Bridge window, click **Turn it on for me**, then save your place and press **Restart Studio** (or close and reopen Roblox Studio yourself). Studio reads the setting only when it starts. - Or in Studio: open the **Assistant**, then **⋯ › Settings › MCP Servers**, and turn on **Enable Studio as MCP server**. No restart is needed; the Bridge notices within about 15 seconds. The Bridge turns this on by itself unless you switch off **Automatically turn on Studio's MCP server** in its window. If the window says **Not sharing** while Studio is open, check the same switch. ## Several Studio windows are open The Bridge makes things in one of them. When more than one place is open, the Bridge window shows **Make things in:** with a list of the open places; pick the one you are working in. If the window says Roblox Studio's MCP helper is not running or did not respond, the Bridge restarts it by itself. Give it a few seconds; if it keeps failing, restart Studio. ## Asked to pair again The pairing was removed, for example because you unpaired it in the app. Enter the new code shown in the Bridge window. A new code appears every 5 minutes until one is used. ## The app says "Bridge offline" or "RoGenie Bridge not connected" - Open the Bridge window and check it is paired and not waiting for Studio. - Check your PC is online and nothing blocks `rogenie.ai` (VPN, proxy, firewall, school or work network). - Close the Bridge from the tray menu (**Stop**) and start it again. - Turn on **Start with Windows** so it is always running when you need it. ## Generation fails or an image is not uploaded - Check the generation tools are on in [Tool access](https://rogenie.ai/docs/tool-access). - Image uploads need your approval each time unless you allowed them for the chat. See [Publishing to Roblox](https://rogenie.ai/docs/publishing-approval). - Generations and uploads go through Roblox's own services, so Roblox's limits and moderation apply. Try again, or rephrase the prompt. ## Blender isn't connecting RoGenie's Blender tools appear only while Blender 5.2 or newer is connected through the Bridge. The Bridge says why it isn't: look at the **Blender** line in the Bridge window, or at the **Blender** group in [Tool access](https://rogenie.ai/docs/tool-access) and the Studio menu in the app. From Bridge 2.4.1 the line is one of these: | The Bridge says | What to do | |---|---| | **Not open** | Open Blender on the same PC as the Bridge. It connects within about 10 seconds. | | **Starting…** | Blender has just opened. Wait a few seconds for its add-on to start. | | **Installing the add-on…** | The Bridge is installing the RoGenie add-on (blenderwright) into your Blender. Wait about a minute. | | **Restart Blender** | The add-on is installed, but a Blender that is already open loads a new add-on only when it starts. Close Blender and open it again, once. | | **Add-on not installed**: Blender is too old | The add-on needs Blender 5.2 or newer: Blender refuses to install it into anything older. Install the current Blender from blender.org and open it; the Bridge installs the add-on by itself. | | **Add-on not installed**: couldn't download | Check the PC is online and nothing blocks github.com. The Bridge tries again every 10 minutes, or press **Install the add-on**. | | **Add-on not installed**: not set to start | In Blender, **Edit › Preferences › Add-ons**, turn on **blenderwright** and tick **Start with Blender** in its preferences, then restart Blender. | | **Add-on not installed**: Blender refused | The Bridge tries again every 10 minutes, or press **Install the add-on** in the Bridge window to try now. The Bridge's log says why (see [The log file](https://rogenie.ai/docs/troubleshooting-bridge#the-log-file)). | | **Can't install the add-on** | The Bridge can't see where Blender is installed, usually because Blender was started as administrator. Close Blender and open it normally, or press **Install the add-on**. | | **Add-on blocked** | Another MCP add-on, for example one called *mcp*, *blender_mcp* or *blender_addon*, holds the local port (9876) that RoGenie's add-on needs, so RoGenie's add-on can't start. The line names it when the Bridge has found it. Switch it off in **Edit › Preferences › Add-ons** and restart Blender. | | **Add-on not answering** | Blender was restarted but the add-on still doesn't answer. Check **blenderwright** is on in **Edit › Preferences › Add-ons**, with **Start with Blender** ticked, and restart Blender. **Install the add-on** installs it again. | | **Off** | Blender control is switched off. Turn on **Let RoGenie control Blender** in [Settings › Agent](https://rogenie.ai/docs/agent-settings#blender-control). | | **Add-on not installed yet** | Blender is open without the RoGenie add-on, and the Bridge isn't connected to RoGenie yet (it is pairing or offline), so it hasn't installed it. It does as soon as it connects, or press **Install the add-on**. | | **Not connected** | The Bridge can't tell why: it couldn't look at the programs running on this PC, or it is a Bridge before 2.4.1 (the line under it is that Bridge's own). Open Blender on the same PC; if it is already open, close it and open it again once. | | **Problem** | Blender answers, but the Bridge's own connection to it (blenderwright) couldn't start; the line under it says what failed. Close the Bridge from the tray menu (**Stop**) and start it again. If it keeps happening, send the log (see [The log file](https://rogenie.ai/docs/troubleshooting-bridge#the-log-file)). | | **Setting up…** | The Bridge is setting up uv, the small tool its connection to Blender runs on (about 15 MB from github.com). Wait a minute; Blender connects by itself once it's done. From Bridge 2.4.2. | | **Needs uv** | This PC has no usable uv yet. Press **Install uv for me** in the Bridge window, and the Bridge sets it up; no terminal needed. If setting it up didn't work, the line says why (for example, github.com is blocked): fix that, then press **Retry**. | Restarting the chat, reloading the page or reinstalling the RoGenie plugin doesn't change any of these: the fix is always on the PC with Blender. A Bridge before 2.4.1 shows less; it updates itself, see [Updates](https://rogenie.ai/docs/troubleshooting-bridge#updates). - **Sending to Studio** also needs Studio connected and signed in, because the meshes and animations are published to your Roblox account. - **Renders** need Bridge 2.4.0 or newer. ## Updates The Bridge updates itself; it never updates during a generation or while a pairing code is showing. To update by hand, download it again from the app and run it. The open-source edition can also be updated by running `Get RoGenie Bridge.bat` again next to its folder. ## The log file The Bridge writes a log to `%LOCALAPPDATA%\RoGenie\bridge.log`. Paste `%LOCALAPPDATA%\RoGenie` into File Explorer's address bar to find it. Include the last lines when you [report a problem](https://rogenie.ai/docs/get-help), after checking they contain nothing private. ## Mac users The Bridge does not run on a Mac. Everything else in RoGenie works on a Mac; AI generation and Blender need a Windows PC. --- # Quota messages and model errors URL: https://rogenie.ai/docs/troubleshooting-errors Section: Help > What each limit message, error card and notice means - quota reached, Spell Failed, rejected keys, chats too long for the model, connection drops, oversized messages - and what to do. ## Quota messages ### "You've used up your 5-hour tokens" You reached your plan's rolling 5-hour limit. The message reads like *5-hour token limit reached (used / limit tokens): what is left is not enough for another step*. The card shows when your quota frees up. The 5-hour window frees up gradually as older usage ages out, so you do not always have to wait the full 5 hours. ### "You've used up this month's tokens" You reached your plan's monthly limit. It resets at the start of your next monthly cycle: the 1st of the month on Free, and on paid plans the day of the month your subscription started. ### What to do - **Wait** for the time shown on the card. - **Use your own keys or Claude accounts.** Models on [your own API keys](https://rogenie.ai/docs/own-api-keys) and your [Claude accounts](https://rogenie.ai/docs/claude-accounts) keep working, and their usage doesn't count toward your RoGenie quota. - **Invite friends.** Each friend who subscribes adds bonus quota. See [Referrals](https://rogenie.ai/docs/referrals). - **Upgrade.** The card lists plans with higher limits; an upgrade applies immediately. See [Billing](https://rogenie.ai/docs/billing). - **Spend less per step.** Switch to Auto (intelligent & cheap) and [summarize](https://rogenie.ai/docs/chat-memory) long chats. Everything RoGenie already built stays in your place. When your quota frees up, ask it to continue. ### "You've used N% of your quota" A heads-up at 75% of either limit. **Switch to cheaper model** moves the chat to Auto (intelligent & cheap). More in [How usage is counted](https://rogenie.ai/docs/usage-and-quota). ## Model errors ### "Spell Failed" The model or its provider returned an error RoGenie could not recover from. The card says what went wrong, with: - **Regenerate** to try again, and - **Switch model** to pick another model. RoGenie already retries and falls back to other routes automatically, so a Spell Failed card usually means every route for that model failed at that moment. Trying again a little later, or another model, usually works. ### "The API key you supplied for this provider was rejected" A key you added in Settings was refused by the provider: revoked, mistyped, out of credit, or without access to that model. The card offers **Open Settings › Providers** to replace it. Until you do, runs use RoGenie's own route and your RoGenie quota. ### "This conversation no longer fits the model's context window" The chat has grown bigger than the model can hold. Type `/summarize` to compact it and try again, switch to a model with a larger window, or start a new chat. See [Chat memory and summarizing](https://rogenie.ai/docs/chat-memory#when-a-chat-no-longer-fits). ### "No available channel for that model" or "could not get a response" The provider has no capacity for that model right now, or every route failed. Pick another model or try again shortly. With an Auto mode selected, RoGenie routes around failing models by itself. ### The model cannot see your image Some models cannot read images. If you attached one, RoGenie says the image was not delivered. Switch to a model that supports images and send again. ## Sending problems | Message | What it means | What to do | |---|---|---| | *This message is too large to send* | The text and files together are over the limit for one message. | Remove a file or shorten the text. Each file can be up to 10 MB. | | *The connection dropped while this message was on its way, so RoGenie never got it* | Your connection broke during sending. | Click **Send again**. | | *A photo could not be uploaded, so the message was not sent* | An attachment failed to upload. | Try again, or attach a smaller image. | | *Rate limit reached. Try again later.* | Too many requests in a short time. Nothing ran. | Wait a moment, then send again. | | *Wait for the current response to finish, or stop it.* | You tried to regenerate, edit or approve while a run is going. | Wait, or press **Stop**. | | *Your session ended* | You were signed out. Your unsent message is kept. | Sign in again. | | *Verify your account to keep using RoGenie* | Your account needs a verified email, Discord or Google. | See [Verify your account](https://rogenie.ai/docs/accounts#verify-your-account). | ## Runs that ended early - **Interrupted**: the run was cut off before RoGenie saved a final reply, for example by a server restart. Completed work is kept in your place and in the log. Ask RoGenie to continue. - **"RoGenie stopped before answering this: the connection or the server dropped."** Click **Retry**. - **Partly done**: the run hit an error after doing real work. Check the log for what finished, then ask RoGenie to finish the rest. ## Still stuck? [Report the message](https://rogenie.ai/docs/message-actions#report-a-problem) with the **Report issue** button, or ask in the [Discord](https://rogenie.ai/docs/discord). See [Get help](https://rogenie.ai/docs/get-help). --- # Get help and report a problem URL: https://rogenie.ai/docs/get-help Section: Help > Where to get help with RoGenie - these docs, the in-app report button, the RoGenie Discord - and what to include so a problem gets fixed fast. ## Start here - **Search these docs** with the box at the top of the page (press `/`). - **Troubleshooting:** [Studio won't connect](https://rogenie.ai/docs/troubleshooting-studio), [Bridge won't connect](https://rogenie.ai/docs/troubleshooting-bridge), [Quota messages and model errors](https://rogenie.ai/docs/troubleshooting-errors). - **The [FAQ](https://rogenie.ai/docs/faq)** answers the most common questions. ## Report a reply that went wrong The fastest way to report a problem with RoGenie's work is the **Report issue** button on the message: 1. Hover the reply (or press and hold it on a phone) and click **Report issue**. 2. Optionally describe what is wrong, up to 1,000 characters. 3. Click **Send report**. The report reaches the RoGenie team with the chat context, so they can see exactly what happened. Reports help the team verify fixes before marking an issue resolved. See [Message actions](https://rogenie.ai/docs/message-actions#report-a-problem). ## Ask in the Discord The [RoGenie Discord](https://discord.gg/kHkdU7W9tP) is where support happens: - ask questions in the help channels, - post bugs in the bug reports forum, and ideas in the suggestions forum, - ask the RoGenie assistant bot questions about RoGenie. See [The RoGenie Discord](https://rogenie.ai/docs/discord). ## What to include A good report gets fixed faster. Include: - the **chat** it happened in (or report it from the message itself), - a short **description** of what you expected and what happened, - whether **Studio was connected** at the time, - the **time** it happened, and the **model** you had selected, - whether the run was **active or queued**, and any **error message** you saw, - for Bridge problems, the last lines of `%LOCALAPPDATA%\RoGenie\bridge.log`. > **Warning** > Never send API keys, passwords, Roblox cookies or private tokens in a report, a chat or Discord. The RoGenie team will never ask for them. ## Account, billing and privacy questions - **Billing questions, cancellations and refund requests:** contact the RoGenie team through the Discord. You can change your card, see invoices and cancel your subscription yourself in **Settings › Account & Usage › Manage billing**. See [Billing](https://rogenie.ai/docs/billing). - **Deleting your account:** you can do it yourself in **Settings › Account & Usage › Danger zone**. See [Privacy and data](https://rogenie.ai/docs/privacy-and-data#delete-your-account). - **Privacy or access questions:** contact a RoGenie admin through the Discord. The [Support](https://rogenie.ai/support) policy page has the official support terms. ## Outages If RoGenie seems down, note the time, the model you had selected, whether a run was active or queued, and any message you saw, and check the Discord for announcements. --- # The RoGenie Discord URL: https://rogenie.ai/docs/discord Section: Help > Join the RoGenie Discord to get help, report bugs, suggest features and share builds, link your Discord account, and ask the RoGenie assistant bot. The **RoGenie Discord** is the community: creators share builds, ask questions, report bugs and trade ideas, and it is where RoGenie support happens. **Join:** [discord.gg/kHkdU7W9tP](https://discord.gg/kHkdU7W9tP), or **Join our Discord** in the app's account menu. ## Getting in When you join, verify in the server to unlock its channels. Until you do, most channels stay hidden. ## Link your Discord account to RoGenie Linking connects your Discord account to your RoGenie account, **verifies your RoGenie account**, and **adds you to the server** if you are not in it yet. 1. Open **Settings › Account & Usage › Linked accounts**. 2. Next to **Discord**, click link and approve RoGenie in Discord. 3. Back in the app, the row shows your Discord username and whether you are in the server, with **Join the server** if you are not. You can also link Discord from the **Verify your account** screen. A Discord account can be linked to only one RoGenie account. To unlink, use the same row; see [Linked accounts](https://rogenie.ai/docs/accounts#linked-accounts). After your first finished answer, RoGenie may show a one-time invitation to join the server. It never appears if you are already in it. ## What is there - **Help channels** to ask how to do something or why something is not working. - A **bug reports** forum, one thread per bug. - A **suggestions** forum for feature ideas. - Places to **share your builds** and see what others made. - **Announcements** about new features and outages. ## Ask the RoGenie bot The RoGenie assistant bot answers questions about RoGenie in the server, using this documentation. It is a quick way to find out how something works or where a setting is. It cannot see your account, your chats or your place, and it cannot change anything for you. For problems with your account, billing or a specific run, [report the message](https://rogenie.ai/docs/message-actions#report-a-problem) in the app or ask the RoGenie team. You can attach files to your question, or add one with the **file** option of `/ask`. The bot reads text and code files (such as `.lua`, `.luau`, `.txt`, `.json`, `.log` and `.md`) and PNG, JPEG, WebP or GIF images, up to 4 per message. An image is turned into a written description before the bot answers, so it can miss a small detail. It reads only the files on the message you are asking about, so attach a file again if you come back to it later. Leave passwords and API keys out of anything you attach. Your questions to the bot are limited per member over a **rolling 5 hours**, not per day. Each question stops counting 5 hours after you asked it, and if you reach the limit, the bot tells you when you can ask again. ## Invite codes You do not need an invite code to use RoGenie; sign-up is open. A code from the Discord can be redeemed at [rogenie.ai/invite](https://rogenie.ai/invite) to link your Discord account. ## Be safe The RoGenie team will never ask for your password, API keys or Roblox cookie, in Discord or anywhere else. Report anyone who does. --- # Privacy, data and deleting your account URL: https://rogenie.ai/docs/privacy-and-data Section: Help > What RoGenie processes and why, what it can see in Studio, how your keys are kept, who else is involved, and how to delete your account. This is a plain-language summary. The binding text is the [Privacy Policy](https://rogenie.ai/privacy) and the [Terms of Service](https://rogenie.ai/terms). ## What RoGenie processes - **Account details:** username, email, sign-in profile details from Google or Discord if you link them, and your sessions. - **Your work:** chats, prompts, model responses, screenshots, attachments, generated mascots, and the results of Studio tools needed to do what you ask. - **Usage records:** token counts, which models and routes were used, timestamps, your plan and rate-limit state. - **Billing records:** Stripe customer, subscription, price and payment event identifiers. RoGenie never sees your full card details; Stripe handles payment. RoGenie uses this to sign you in, run Studio-connected work, get model responses, apply usage limits, look into reports you send, keep the service safe, and handle billing. ## What RoGenie can see in Studio Only the place you have open in a [paired](https://rogenie.ai/docs/connect-studio) Studio, and only while it is paired: the scene, its scripts and properties, your selection, and screenshots RoGenie takes. RoGenie does not read other files on your computer. The optional [RoGenie Bridge](https://rogenie.ai/docs/bridge) only forwards generation and image-upload commands; it does not run code or read your files. ## Who else is involved - **AI model providers.** To answer you, your prompts and the relevant context are sent to the AI provider that runs the selected model. - **Stripe** processes payments. - **Google and Discord**, if you sign in with or link them. - **Discord** also hosts community support and reports. ## Your API keys Keys you add in [Settings › Providers](https://rogenie.ai/docs/own-api-keys) are stored only for your account, used only to route your requests, never shown again once saved, and redacted from logs in known formats. Never paste passwords, private keys or other secrets into chats. ## Your place's data stays in your place [Project notes](https://rogenie.ai/docs/memory#project-notes) are stored inside your place at `ServerStorage.RoGenie.ProjectNotes`, so anyone who can edit the place can read them. Keep secrets out of them. ## Delete your account 1. If you have an active paid subscription, cancel it first (**Settings › Account & Usage › Manage billing**, then cancel in the Stripe billing portal). Deletion is refused while a Stripe subscription is active. 2. Open **Settings › Account & Usage** and scroll to the **Danger zone**. 3. Type `DELETE` to confirm and click **Delete account forever**. Your account, chats, folders, keys, screenshots and mascots are removed for good. Deletion also removes sessions, Studio pairings, usage records and settings where supported. **This cannot be undone.** Deleting your account does not change your Roblox places: anything RoGenie built, and any project notes, stay in your place files. Assets already uploaded to Roblox stay on Roblox. ## Questions For privacy or account questions, contact the RoGenie team through the [Discord](https://rogenie.ai/docs/discord) or the [Support](https://rogenie.ai/support) page. --- # Limits reference URL: https://rogenie.ai/docs/limits Section: Help > Every size, time and count limit in RoGenie in one place - plans, attachments, pairing codes, Blender, notes, mascots, referrals, reviews and more. ## Usage by plan | Plan | Price | Tokens per 5 hours | Tokens per month | Mascot generations per 5 hours | Support | |---|---|---|---|---|---| | **Free** | $0/month | 250K | 2M | Not included | Community support | | **Starter** | $5/month | 750K | 7.5M | 2 | Standard support | | **Builder** | $19/month | 3M | 30M | 4 | Standard support | | **Pro** | $49/month | 8M | 75M | 12 | Standard support | | **Studio** | $99/month | 20M | 150M | 30 | Standard support | The 5-hour limit is a rolling window; the monthly limit resets at the start of each monthly cycle (the 1st of the month on Free, your subscription's monthly date on paid plans). Mascot generations also have an hourly cap: 1 on Starter, 2 on Builder, 4 on Pro and 8 on Studio. See [How usage is counted](https://rogenie.ai/docs/usage-and-quota). ## Messages and attachments | What | Limit | |---|---| | One attached file or image | 10 MB | | One message with its files | An overall size limit; RoGenie tells you before sending if you are over it | | Image types | PNG, JPEG, GIF, WebP, SVG, BMP | | File types | `.txt` `.lua` `.json` `.py` `.js` `.ts` `.css` `.html` `.xml` `.csv` `.md` `.log` `.rbxl` `.rbxlx` `.rbxm` `.rbxmx` | | A report's description | 1,000 characters | | Unsent drafts | Kept in your browser for 14 days | ## Account | What | Limit | |---|---| | Password | At least 8 characters | | Display name | Up to 80 characters | | Chat title | Up to 120 characters | | Folder name | Up to 60 characters | ## Studio and the Bridge | What | Limit | |---|---| | Studio pairing code | Valid for 5 minutes | | Bridge pairing code | A new code every 5 minutes until one is used | | Revert history per chat | The most recent 120 turns; Studio's own undo history resets when the place is reopened | | Publish approval request | Waits up to 20 minutes | | A Studio that drops mid-run | RoGenie waits up to 3 minutes for it to reconnect | ## Blender | What | Limit | |---|---| | One MeshPart | 20,000 triangles and 60,000 vertices; bigger objects are split into several MeshParts | | One import | 80 parts and 600,000 triangles | | Mesh uploads | About 1.5 seconds each, done in batches | | Animations per export | 24, each up to 600 seconds | | Joints per animation | 400 | | Bones per skinned mesh | 256 | | Render size | 64 to 4,096 pixels a side; 1,024 × 1,024 by default | | Cycles render time | Capped at 120 seconds (your own setting is put back afterwards) | | Renders per upload | Up to 8 | | How long a render is kept | 6 hours | See [Blender](https://rogenie.ai/docs/blender). ## Memory | What | Limit | |---|---| | Standing instructions | 2,000 characters | | Notes RoGenie keeps about you | 1,400 characters in total | | Project notes (in your place) | 6,000 characters | | Maximum context window setting | 0 (auto) or at least 8,000 tokens, never more than the model's own window | ## Code review | What | Limit | |---|---| | Scripts per review | Up to 12 | | Findings per review | Up to 20 | | Reviews kept per chat | The last 3 | ## Mascots | What | Limit | |---|---| | Mascot name | 60 characters | | Instructions | 1,200 characters | | Reference image | PNG, JPEG or WebP, up to 8 MB | | Generations | Per plan, per 5-hour window: Starter 2, Builder 4, Pro 12, Studio 30. Not included on Free. | ## Referrals | What | Limit | |---|---| | Bonus per subscribing friend | 25% of the limits of the plan they bought: from +187.5K per 5 hours and +1.875M per month (Starter) to +5M and +37.5M (Studio) | | Which plan the share is of | The plan the friend's first payment bought; a later upgrade or downgrade does not change it | | How long each bonus lasts | The friend's first month (until their first billing period ends, at most 31 days) | | Friends counting at once | 8 (the eight whose first payment came first) | | Referral link remembered | 30 days in your friend's browser | ## Things with a limit that can change Some limits are set by RoGenie and can change without a new version of these docs, for example how many follow-ups can wait in one chat's queue, and rate limits that protect the service. RoGenie always tells you when you hit one. --- # Frequently asked questions URL: https://rogenie.ai/docs/faq Section: Help > Quick answers about coding, Studio, existing places, several Studios, Mac, Rojo, tokens and limits, models, keys and Claude accounts, the Bridge, Blender, animation, icons, playtests, stopping runs, plans, referrals, phones and safety. ## Getting started ### Do I need to know how to code? No. Describe what you want in plain English and RoGenie writes the Luau, builds it in your place and playtests it. If you do code, you can read every change in the work log and edit scripts yourself in the built-in [IDE](https://rogenie.ai/docs/ide). ### How does RoGenie connect to Roblox Studio? Through the RoGenie Studio plugin. Put the plugin file in Studio's plugins folder (`%localappdata%\Roblox\Plugins` on Windows, `~/Documents/Roblox/Plugins/` on Mac; if it is not there, open Studio, select the Plugins tab and click Plugins Folder), restart Studio, and pair your account with the pairing code it shows. You can pair several Studio sessions too (see below). See [Install the plugin](https://rogenie.ai/docs/install-plugin) and [Pair Studio](https://rogenie.ai/docs/connect-studio). ### Does it work in my existing place? Yes. RoGenie acts directly in the place you open. It reads the live scene, follows your Studio selection, and edits the exact lines with targeted diffs instead of rewriting whole scripts. For big changes to an existing game, try [Plan mode](https://rogenie.ai/docs/plan-mode) first. ### Can I connect more than one Roblox Studio? Yes. Pair several Studio sessions with one account, for example two places open at once or Studio on two computers. The Studio menu lists each one by place name, and you choose the one RoGenie works in. A run stays on the Studio it started in, and if that Studio drops mid-run, RoGenie waits up to 3 minutes for it to reconnect. See [Several Studio sessions](https://rogenie.ai/docs/connect-studio#several-studio-sessions). ### Does RoGenie work on a Mac? Yes. The Studio plugin and the app work on Mac and Windows: building, scripting, playtesting, terrain, UI, the Toolbox and Studio animation all work. Only the optional [RoGenie Bridge](https://rogenie.ai/docs/bridge) needs a Windows PC: Roblox's AI mesh and material generators, image uploads and Blender. ### Does RoGenie work with Rojo? You can export your place from the built-in [IDE](https://rogenie.ai/docs/ide#rojo-export) as a Rojo project: `default.project.json`, `sourcemap.json`, or a full project archive with every script as a file. It's a one-way export. RoGenie works in Studio itself, so it doesn't sync with `rojo serve` or a folder on disk. ### Can I use RoGenie on my phone? The app works on phones and tablets, so you can chat with RoGenie and follow its work from anywhere. RoGenie acts in the Studio you paired on your computer, so Studio needs to be open there. ### Is RoGenie made by Roblox? No. RoGenie is not affiliated with Roblox Corporation. ## Usage and plans ### What are tokens, and how do the 5-hour and monthly limits work? Usage is measured in tokens, over a rolling 5-hour window (what you used in the last 5 hours) and a monthly total, and every plan sets a limit for both. Each model has a quota multiplier that says how fast it uses your quota compared with Claude Opus 5 (1×): a model at 0.1× uses quota ten times slower. Auto (intelligent & cheap) runs at 0.058×, and the cheapest model, GPT 6 Luna (0.02×), is even lower. The 5-hour window and the monthly total reset on their own schedules. See [How usage is counted](https://rogenie.ai/docs/usage-and-quota). ### What does "up to 11×" mean? It is RoGenie's maximum estimate versus using the same models at official list prices. It combines discounted model rates with the token savings from minified code context (with line numbers kept) and smart context compression. Actual savings vary by model, project and workload. See [How RoGenie saves tokens](https://rogenie.ai/docs/savings). ### What happens when I run out of quota? Built-in models stop until the limit frees up. The 5-hour window frees up gradually, and the monthly total resets at the start of your next monthly cycle. Models on your own API keys and your connected Claude accounts keep working, and their usage never counts toward your RoGenie quota. Referrals add bonus quota on top of your plan, and an upgrade applies right away. Everything already built stays in your place. See [When you run out](https://rogenie.ai/docs/usage-and-quota#when-you-run-out). ### Can I change or cancel my plan? Yes. Upgrades between paid plans take effect immediately and are prorated, and downgrades are scheduled for the end of the current period. To cancel, open **Settings › Account & Usage › Manage billing** (the Stripe billing portal). You keep access through the paid period. See [Billing](https://rogenie.ai/docs/billing). ### How do I change my card or payment method? Open **Settings › Account & Usage › Manage billing** (also in the account menu). It opens the Stripe billing portal, where you add a new card and make it the default; your invoices are there too. If an upgrade was declined, nothing was charged: update the card there, then try the upgrade again. See [Change your card](https://rogenie.ai/docs/billing#change-your-card-or-payment-method). ### Do you offer refunds? Refunds are not automatic. Contact the RoGenie team for billing questions and refund requests. See [Get help](https://rogenie.ai/docs/get-help) and the [Billing policy](https://rogenie.ai/billing). ### How do referrals work? Share your referral link from Settings. Every friend who signs up through it and subscribes to a paid plan adds 25% of that plan's token limits (5-hour and monthly) to your own, for the friend's first month: a friend on Studio adds a quarter of Studio, a friend on Starter a quarter of Starter. It stacks: four friends on the same plan in the same month are a whole plan's worth of usage without paying, and up to eight count at a time. See [Referrals](https://rogenie.ai/docs/referrals). ## Models and keys ### Which models can I use, and do I need API keys? 107 models from Claude, DeepSeek, MiniMax, GPT, Gemini, Kimi, Qwen, Grok, GLM, Mistral, Composer are built in, so you don't need any keys. If you like, you can also add your own keys for OpenAI, Anthropic, Gemini, OpenRouter, Together, Perplexity or DeepSeek; models on your own keys do not use your RoGenie quota. See [Choosing a model](https://rogenie.ai/docs/models) and [Your own API keys](https://rogenie.ai/docs/own-api-keys). ### Can I use my own Claude subscription? On Builder, Pro and Studio, yes. Sign in with one or more Claude accounts in **Settings › Providers**, and Claude models run on those accounts instead of your RoGenie quota. Your Claude plan's own limits still apply, and other models use your RoGenie quota as usual. ChatGPT and Codex subscriptions can't be connected; you can add an OpenAI API key instead. See [Your Claude accounts](https://rogenie.ai/docs/claude-accounts). ### Which model should I pick? Start with the default, **Auto (intelligent & cheap)**. Switch to a stronger model, or Auto (Smartest Available), for hard logic and tricky bugs. ## What RoGenie does ### What is the RoGenie Bridge, and do I need it? An optional Windows companion app. Download the installer, run it, and it sets itself up, starts with Windows and keeps itself updated. It pairs with the same code as the plugin (developers can get a readable open-source version instead). It lets RoGenie use Roblox's own AI generators for 3D meshes, materials and procedural models, upload images to Roblox, and work in Blender on the same PC. Everything else works without it, on Windows or Mac. See [RoGenie Bridge](https://rogenie.ai/docs/bridge). ### Why does Windows or Edge warn about the Bridge installer? The installer is not code-signed yet, so Microsoft SmartScreen has no reputation for it and may say *Windows protected your PC*, or that the file *isn't commonly downloaded*. That is not a sign that anything is wrong with it. You can check the file is exactly the one RoGenie published by its SHA-256: see [Check your download](https://rogenie.ai/docs/bridge#verify). Then, in Windows, click **More info** and **Run anyway**; in Edge, choose **Keep** in the download's **⋯** menu. ### Can RoGenie work in Blender? Yes, on Windows. With the RoGenie Bridge on the same PC as Blender (5.2 or newer), RoGenie models, sculpts, unwraps, adds materials, lights, rigs and keyframes in your own Blender using a reviewed set of 242 Blender tools, and checks its work with viewport screenshots. It then sends the result into your Studio place as MeshParts, with its animations published as Roblox Animations. The Bridge installs the Blender add-on the first time; restart Blender once. Colours, smooth shading and metal carry over; image textures and UVs don't yet. See [Blender](https://rogenie.ai/docs/blender). ### Can RoGenie animate my characters? Yes, two ways. In Studio, on Windows or Mac, it can insert an R15 or R6 rig or your avatar, position arms and legs with IK, write keyframed animations from poses, edit existing ones (retime, mirror, fix loops, trim) and publish them as Animation assets. With the Bridge and Blender on Windows, it builds an R15 or R6 rig in Blender, animates it there, and publishes the animation onto your rig or a preview dummy, with an animation id to use on players' characters. See [Character animation](https://rogenie.ai/docs/animation). ### Can RoGenie make icons for my game? It can render icons of your own models in Blender, framed automatically with studio lighting and a transparent background, and upload them to Roblox as image assets for shop buttons, inventory slots and other UI, once you approve the upload. This needs Bridge 2.4.0 or newer on Windows with Blender open. It can also pick from 2,440 royalty-free icons in three packs; the Material and Lucide packs work without the Bridge. It doesn't make experience thumbnails or set your game's icon; you upload those in the Creator Dashboard. See [Renders and icons](https://rogenie.ai/docs/blender#renders-and-icons). ### Can RoGenie playtest my game? Yes. It runs your game and plays it like a real player, with a live player, client and input in a real Play session. It reads runtime state, captures screenshots, scans geometry and UI layout and profiles performance, then fixes what actually broke and replays until the checks pass. See [Playtesting](https://rogenie.ai/docs/playtesting). ### Can I see what it's doing, and stop it? Always. The live work log shows every action with its request and result, next to the plan checklist and the thought summaries the provider exposes. You can stop a run any time, or queue a follow-up to steer it mid-run. See [Watching a run](https://rogenie.ai/docs/watching-a-run) and [Stop, queue and steer](https://rogenie.ai/docs/stop-and-steer). ### Can RoGenie break my game? How do I undo? RoGenie changes your place, so mistakes can happen. You have several safety nets: [Revert](https://rogenie.ai/docs/revert) undoes exactly what one turn changed, [Plan mode](https://rogenie.ai/docs/plan-mode) lets you approve before anything changes, and Studio's own undo still works. For important places, save a copy before large changes. ### Will RoGenie upload things to Roblox without asking? Publishing an asset with **Publish Assets**, uploading images (including Blender renders) and overwriting an existing animation all ask for your approval first, unless you choose to always allow new uploads in that chat. Two things publish as part of the action itself, without a card: a new animation RoGenie creates, and a Blender import, whose meshes and animations Roblox needs published to keep them. Switch off **Publish Assets to Roblox** in [Tool access](https://rogenie.ai/docs/tool-access) and RoGenie publishes nothing. See [Publishing to Roblox](https://rogenie.ai/docs/publishing-approval). ### Does RoGenie remember things between chats? Yes: your standing instructions, short notes about how you like to work, and project notes stored in your place. See [Memory](https://rogenie.ai/docs/memory). ### Can RoGenie see my other files? No. RoGenie sees only the place open in your paired Studio and, if you use the Bridge with Blender, the scene open in Blender. The Bridge does not read your other files. See [Privacy and data](https://rogenie.ai/docs/privacy-and-data). ## Account ### Can I delete my account? Yes. Go to Settings and open the danger zone. Deletion removes your account and its data for good. An active Stripe subscription must be cancelled before deletion. See [Delete your account](https://rogenie.ai/docs/privacy-and-data#delete-your-account). ### Why is RoGenie asking me to verify my account? To keep bots out, RoGenie can ask every account to link Discord, confirm an email or connect Google before the agent works for it. Your chats and plan are safe in the meantime. See [Verify your account](https://rogenie.ai/docs/accounts#verify-your-account). --- # Glossary URL: https://rogenie.ai/docs/glossary Section: Help > The words RoGenie uses - wish, run, turn, pairing, Bridge, quota, multiplier, Auto, route, sub-agent, Plan mode, chat memory, project notes and more. | Term | Meaning | |---|---| | **Wish** | A message asking RoGenie to do something. | | **Chat** | A conversation with RoGenie. Every wish starts or continues one. See [Chats](https://rogenie.ai/docs/chats-and-search). | | **Run** | Everything RoGenie does to answer one message: planning, tool calls, checks and the final reply. | | **Turn** | One message and RoGenie's reply to it. [Revert](https://rogenie.ai/docs/revert) works per turn. | | **Work log** | The list of every action in a run, with its request and result. See [Watching a run](https://rogenie.ai/docs/watching-a-run). | | **Plan checklist** | The tasks of a multi-step run, ticked off as they finish. | | **Thought summary** | A summary of a model's reasoning that its provider chooses to share. Never hidden raw chain-of-thought. | | **Studio plugin** | The RoGenie plugin in Roblox Studio that lets RoGenie act in your open place. See [Install the plugin](https://rogenie.ai/docs/install-plugin). | | **Pairing code** | The 8-digit code (6 on a Studio plugin older than 1.1.151) that links a Studio (or the Bridge) to your account. Valid for 5 minutes. | | **Linked Studio** | The paired Studio session RoGenie is acting in right now. | | **RoGenie Bridge** | The optional Windows app that lets RoGenie use Roblox's AI generators for meshes and materials, upload images, and work in Blender. See [Bridge](https://rogenie.ai/docs/bridge). | | **MCP server** | Roblox Studio's built-in server that the Bridge uses to reach Studio's AI generators. | | **Blender control** | RoGenie working in your own Blender through the Bridge, then sending models, rigs and animations into Studio. See [Blender](https://rogenie.ai/docs/blender). | | **Render** | A finished picture of a Blender model, for icons and UI art, that RoGenie can upload to Roblox as an image. See [Renders and icons](https://rogenie.ai/docs/blender#renders-and-icons). | | **Model** | The AI that does the thinking. RoGenie has many built in. See [Choosing a model](https://rogenie.ai/docs/models). | | **Auto (intelligent & cheap)** | The default model choice: a capable, low-cost model at a fraction of the quota. | | **Auto (Smartest Available)** | Sends every turn to the smartest model available. | | **Route** | One provider that serves a model. Many models have several; RoGenie falls back between them. Shown as *Provider N*. | | **Effort** | How hard the model thinks before it acts. See [Effort](https://rogenie.ai/docs/effort-and-fast-mode). | | **Fast mode** | Faster output at a higher price, on supported models. | | **Token** | The unit models read and write text in. Usage is measured in tokens. | | **Quota** | How much model usage your plan allows: per 5 hours and per month. See [Usage and quota](https://rogenie.ai/docs/usage-and-quota). | | **5-hour window** | The rolling quota of what you used in the last 5 hours. | | **Multiplier** | How fast a model uses your quota compared with Claude Opus 5 at 1×. | | **Billable tokens** | Tokens after the model's multiplier: what your quota counts. | | **BYOK** | "Bring your own key": using your own provider API keys so those models do not use your quota. See [Your own API keys](https://rogenie.ai/docs/own-api-keys). | | **Chat memory** | How much of a chat RoGenie can keep in mind at once (the model's context window). Not your usage limit. See [Chat memory](https://rogenie.ai/docs/chat-memory). | | **Summarize** | Compacting a chat's older turns so it uses less chat memory and quota. | | **Plan mode** | A mode where RoGenie only inspects and proposes a plan; nothing changes until you approve. See [Plan mode](https://rogenie.ai/docs/plan-mode). | | **Act mode** | The default mode: RoGenie builds as it goes. | | **Orchestrator** | The main agent that plans a big job and hands parts to sub-agents. | | **Sub-agent** | A specialist agent (Builder, Scripter, UI Designer...) that works on one part in parallel. See [Sub-agents](https://rogenie.ai/docs/sub-agents). | | **Tool** | One thing RoGenie can do, like a playtest or a Toolbox search. See [Tool access](https://rogenie.ai/docs/tool-access). | | **Playtest verification** | RoGenie running your game to prove a change works. See [Playtesting](https://rogenie.ai/docs/playtesting). | | **Standing instructions** | Rules you write once that RoGenie follows in every chat. | | **Project notes** | A place's conventions and decisions, stored in the place at `ServerStorage.RoGenie.ProjectNotes`. See [Memory](https://rogenie.ai/docs/memory). | | **Revert** | Undoing exactly the Studio changes one turn made. | | **Publish approval** | The card RoGenie shows before a real upload to Roblox. | | **Mascot / genie** | The animated character that shows what RoGenie is doing. You can create your own. | | **Theme** | The app's colour scheme and background. There are 64. | | **Referral** | A friend who signs up with your link; a paying friend adds bonus quota. |