speckle-unreal

Speckle | Unreal

Speckle is the first AEC data hub that connects with your favorite AEC tools. Speckle exists to overcome the challenges of working in a fragmented industry where communication, creative workflows, and the exchange of data are often hindered by siloed software and processes. It is here to make the industry better.

Speckle Connector for Unreal Engine

[!WARNING] This is a legacy repo! A new next generation connector will be coming soon. In the meantime, check out our active next generation repos here 👇
speckle-sharp-connectors: our .NET next generation connectors and desktop UI
speckle-sharp-sdk: our .NET SDK, Tests, and Objects

Notice

We officially support Unreal Engine 4.27, 5.0-5.4

Features:

• Receiving Speckle geometry as Actors in editor and standalone runtime.
• Material override/substitiution.
• Blueprint nodes for receiving and converting objects.
• Blueprint nodes for fetching stream/branch/commit/user details.
• Ability to write/extend custom conversion functions in C++/BP.

Supported Conversions:

Speckle Type		Native Type
Objects.Geometry.Mesh	→	Static Mesh Component / Procedural Mesh Component
Objects.Geometry.PointCloud	→	LiDAR Point Cloud
Objects.Other.Instance	→	Actor with Transform
Objects.BuiltElements.View	→	Camera
Speckle.Core.Models.Collection	→	Empty Actor

Supported platforms: Windows, Linux, MacOS Other platforms may work, but currently untested.

Limitations:

• Currently no support for sending Unreal geometry to Speckle.
• Does not use the .NET or Python SDK, or the Speckle Kit based workflow, all code is in native C++/BP.
• Does not use our shared Desktop UI 2, only a simple editor UI is currently provided.
• Does not fetch accounts from Speckle Manager, you must generate a personal access token (auth token) to receive non-public streams.

How to install

Speckle for Unreal Engine can be installed through the Unreal Engine Marketplace.

---

Alternatively, developers may prefer to install manually.

1. Git clone this repo (or download and extract the archive zip) into your project’s Plugins directory (created as needed)
2. Open/Restart your Unreal project. This will build the plugin for your environment.

See our docs for usage instructions.

If you encounter build issues, try building your project from VS/Rider directly. Look at the Saved\Logs\ files for error messages, and don’t hesitate to reach out on our community forums for help!

For contributing to any of our code repositories, please make sure you read the contribution guidelines for an overview of the best practices we try to follow.