Troubleshooting: Studio won't connect

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.

"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.
• 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.

"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 with the chat, the time it happened, whether Studio showed as linked, and any message in Studio's Output window that starts with [RoGenie.