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!
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:
- Download the
speckle-unrealrepository archive from https://github.com/specklesystems/speckle-unreal/archive/refs/heads/main.zip
- Extract the downloaded archive into your project's
Pluginsdirectory (if your project directory doesn't contain a directory called
Plugins, you should create it)
- 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!
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
3. Currently, we require an explicit Stream ID and Object ID to import.
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
Blueprint can be a powerful tool for implementing your own custom behaviours for receiving objects. Check out our Docs for more on Blueprint.
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!
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.