Roblox Studio
Connecting Roblox Studio
Bricklayer installs its Studio plugin for you during setup, so you add nothing by hand. After that, Studio asks for a few one-time things.
After you finish onboarding
Restart Roblox Studio
Bricklayer drops its plugin into Studio during setup, but Studio only loads plugins when it starts. If Studio was already open, close it completely and reopen it. (Or press Ctrl Shift L in Studio to reload plugins.)
Click “Allow” when Studio asks
The first time the Bricklayer plugin runs, Studio asks for permission to script and to reach the local Bricklayer connection. Click Allow. Bricklayer only talks to the editor on your own machine.
Confirm it’s the right game
For an existing game, Bricklayer shows what Studio opened and copies nothing until you click Use this game on the Welcome screen. This keeps it from touching the wrong place.
Watch the status turn green
Once the plugin connects, Bricklayer’s status shows your place name and the number of scripts in sync. Your files and Studio now mirror each other.
Good to know
The connection is entirely local. The plugin talks to Bricklayer Editor on your own computer, not to the internet. Editing scripts works as soon as this connects. To also let your AI playtest, read the console, and add assets, turn on Studio’s extra powers.
If it won’t connect
| Symptom | Fix |
|---|---|
| No Bricklayer toolbar in Studio | The plugin did not load. Fully restart Studio; if it is still missing, reinstall the plugin (Bricklayer: Install Studio Plugin) and restart Studio again. |
| Toolbar is there but status stays “no Studio” | Give it ~15 seconds after the game finishes loading. If nothing happens, click Connect in the Bricklayer toolbar (Plugins tab). |
| “Connection refused” or a token error | The plugin and editor disagree on their pairing. Run Bricklayer’s troubleshooter. It gives you the exact one-line fix to paste into Studio’s command bar. |
| Wrong game or empty project | A different place was confirmed during setup. Reopen the intended game from the Welcome screen and confirm its name before Bricklayer copies anything. |
When in doubt, open Bricklayer: Troubleshoot (Setup & Diagnostics) from the command palette, or click Open the troubleshooter on the Welcome screen. It checks every part of the chain and gives you the exact fix for whatever is red. See Setup & diagnostics for the full list.