# Tripo3D Roblox Bridge

Tripo3D Roblox Bridge sends models from Tripo Studio to Roblox Studio.

## Requirements

- Roblox Studio
- A Roblox account with permission to upload assets
- An internet connection

**Packaged Windows and macOS users do not need to install Python.** Python is only required for developers running the project from source.

## Windows Installation

1. Extract the Windows ZIP package.
2. Run Tripo3d_Roblox_Bridge-V1.0.0.exe.
3. Restart Roblox Studio after the first launch so the plugin can load.

## macOS Installation

1. Extract the macOS ZIP package.
2. Open the DMG matching your Mac:
   - Apple silicon: Tripo3d_Roblox_Bridge-V1.0.0-macOS-arm64.dmg
   - Intel: Tripo3d_Roblox_Bridge-V1.0.0-macOS-x86_64.dmg
3. Drag Tripo3D Roblox Bridge into Applications, launch it, and restart Roblox Studio after the first launch.
4. If macOS blocks the first launch, Control-click the installed app and select **Open**.

## First Use

1. Start Tripo3D Roblox Bridge.
2. Click **Sign in with Roblox**.
3. Select the Roblox account that will upload assets and approve access.
4. In Roblox Studio, enable **Allow HTTP Requests** under Game Settings and Security.
5. Open the **TripoBridge** plugin and keep **Auto-import into scene** checked.
6. Send a model from Tripo Studio.

The Roblox connection is ready only when the Bridge is signed in and the Roblox Studio plugin is active.

## Import Recommendations

- Keep each mesh at or below 20,000 triangles.
- Use **SmartMesh** mode in Tripo Studio when possible.
- Keep each texture below 20 MB.
- Every fully downloaded model is saved to **Staging** before Roblox upload begins. Successful imports remove that temporary copy; failed, cancelled, or interrupted imports remain available through **Staging**.

## Help

Tutorial: https://www.tripo3d.ai/blog/tripo-dcc-bridge-for-roblox

If the connection does not update, fully quit the old Bridge process, reopen the latest application, and restart Roblox Studio.
