Connecting to BlenderSync for Blender
5. Connecting to BlenderSync for Blender
Click Setup in the Settings panel to open the Setup window. This window configures the connection between the Revit add-in and BlenderSync for Blender.
What BlenderSync for Blender is
BlenderSync for Blender is a companion add-on for Blender 5.0+. Once installed and enabled, it runs an HTTP server inside Blender. The Revit add-in sends sync data to this server, and the server returns Capture responses. You need it installed, enabled, and its server running before any sync or capture operation will succeed.
For Blender-side setup, see blender.gotheresoftware.no.
Setup window fields
Sync View
The Revit view whose elements will be sent to Blender when you sync. Defaults to the currently active view. Use the dropdown to choose a different view. Only one sync view per document can be active at a time.
Display Name
A human-readable name for this Revit document, shown on the Blender side. Defaults to the document title. You can edit this to something more descriptive if needed.
Document UUID
A stable identifier assigned automatically to this Revit project. It is read-only — you cannot change it. This is how BlenderSync identifies your project on the Blender side across sessions.
Server and Port
The host address and port where BlenderSync for Blender is running. Defaults are 127.0.0.1 and 3000.
- If Revit and Blender are running on the same machine, the defaults work without any changes.
- If Blender is on a different machine, enter that machine's IP address here, and make sure the BlenderSync for Blender server is configured to listen on that address.
Typing
localhostis accepted and is normalized to127.0.0.1automatically.
Checking the connection
Click Check connection to test whether the Revit add-in can reach BlenderSync for Blender at the configured address. The result is shown with a color indicator:
| Color | Meaning |
|---|---|
| Green | BlenderSync for Blender is reachable and ready |
| Orange | The server was reached but is not healthy, the check timed out, or the input was invalid |
| Red | An unexpected failure occurred |
The button shows Checking... and is disabled while the check is running. The check has a 3-second timeout.
Common orange messages: - "Enter a server before checking the connection." — the Server field is empty - "BlenderSync did not respond in time." — server did not reply within 3 seconds - "We reached the server, but BlenderSync did not confirm it was ready." — server replied but returned a non-OK response
Saving settings
Settings are saved when you click Apply or when you close the window. They are also saved automatically whenever the Revit document is saved.
Reset BlenderSync data
The Reset BlenderSync data button resets all settings for this document to their defaults, clears the document UUID, and wipes all cached element IDs and hash state. LiveSync is stopped if it is currently active.
A confirmation dialog is shown before anything is reset. Use this when you want to start fresh — for example, after moving to a new Blender file or switching to a different server configuration.
Caution: Resetting clears the sync history for this document. The next sync after a reset will treat all elements as new.