# Troubleshooting: Bridge won't connect

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