By providing industry leading computer graphics technology to several billion dollar industries, Unreal Engine excels in its position as the world's most advanced real-time 3D creation tool for photoreal visuals and immersive experiences.
Unreal Engine facilitates the full spectrum of Architectural and 3D Visualisation, from quick drag and drop real-time renders to film quality cinematics.

With Speckle, we make it even easier to integrate Unreal Engine with your 3D workflows, and for developers, we provide an open and extensible set of tools to help you create applications that integrate flawlessly with Speckle.

Our Unreal Connector is in a beta stage of development, and our current focus is for creating a tool for developers.
That aside, here's a quick guide on how to get started with it!

Prerequisites

To follow along with this tutorial, you will need to register with Speckle and install the required connectors 🔌. It takes less than 3 minutes!

You will also need Unreal Engine 4.26 or newer installed and an IDE setup.

For a comprehensive overview of this connector, check our docs 📚!

Installation and Project Setup

First you will need to create a new UE  project  (or use an existing one), any template will work.

The Unreal connector is packaged as an Unreal Engine plugin that is currently only available through GitHub. To use it in your project:

  1. Download the speckle-unreal repository archive from https://github.com/specklesystems/speckle-unreal/archive/refs/heads/main.zip
  2. Extract the downloaded archive into your project's Plugins directory (if your project directory doesn't contain a directory called Plugins, you should create it)
Extract archive to your project's "Plugins" directory.
  1. Open your UE project (or restart the editor if you already have it opened). This will build the plugin in your environment.

That's It! Your project can now use the Speckle plugin!

Usage

The plugin includes an actor type named Speckle Unreal Manager that you can use to import objects from Speckle.

Here is how to use it:

1. In the Place Actors sidebar, search for Speckle Unreal Manager and add it to the world.

2. Select the SpeckleUnrealManager instance in the World Outliner sidebar and use the options presented in the Speckle category

3. Currently, we require an explicit Stream ID and Object ID to import.

Sample Stream:

4. If your Speckle Stream is not public, you must generate a Personal Access Token and set it in the Auth Token property.

⚠️ Treat your Personal Access Token as a password. If someone else has access to your auth token, they can access to your Speckle data. ⚠️

5. After you set up the import parameters, just click the Receive button. The specified object and all its children will be important as Actors.

Receiving through Blueprint

The receiving process can be performed using blueprint, doing it this way can allow for extra flexibility for performing additional actions with received data/converted actors.

An example of this process in Blueprint is provided in the Plugins\speckle-unreal\Content\Examples directory.  

Blueprint can be a powerful tool for implementing your own custom behaviours for receiving objects. Check out our Docs for more on Blueprint.

Source Code

All the code is available in our Github repository. Feel free to clone, fork and open issues!

Don't forget to ⭐ our repos if you like what you see!

Conclusion

We hope you enjoyed this tutorial and found it useful!

Please see our docs for more!

Speckle is an Open Source project and we really ❤️ feedback, so if you have any questions, comments, critiques, or praises please let us know on our community forum.