# Install the Studio plugin

> 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*.