Troubleshooting: Bridge won't connect

The RoGenie 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

Are you on Windows? The Bridge runs on Windows only, on the same PC as Roblox Studio.
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.
Is Studio open on a place? The Bridge needs a place open in Studio to generate anything.
Is it paired? The Bridge window shows an 8-digit code when it is not. Enter it in the app (see 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.

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.
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.
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. If you would rather not add an exclusion, the open-source edition 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.

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.
Image uploads need your approval each time unless you allowed them for the chat. See Publishing to Roblox.
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 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).
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.
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).
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.

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