Unreal Engine · Quickstart

A CAD file on the screen

Five minutes, three steps, no C++ and no import. At the end a STEP file is in your level, drawn by the plugin, with every part of it addressable.

1 · Install

The plugin in a project

  1. Unreal Engine 5.8, on Windows x64, Linux x86-64 or Android arm64. A C++ project, or a Blueprint project that Unreal will convert the first time it builds a plugin.

  2. Get it from Fab. On the plugin’s Fab page, add it to your library, free. Then, in the Epic Games Launcher, open Library, find Cadaclysm under Fab Library and choose Install to Engine for 5.8. The plugin is then in the engine for every project, enabled by default.

  3. Or copy the plugin folder into one project instead, so that the .uplugin lands here:

    MyGame/
      MyGame.uproject
      Plugins/
        Cadaclysm/
          Cadaclysm.uplugin
          Source/  Shaders/  Content/  Resources/
          Source/ThirdParty/cadaclysm/lib/Win64/  Linux/  Android/
          Source/ThirdParty/cadaclysm/include/cadaclysm.h
  4. Open the project. Unreal builds the plugin on the first launch and asks nothing else. In the editor's Plugins window it is listed under Importers, enabled; search for it by name.

The Plugins window searched for Cadaclysm: version 0.9.0 by Blitter S.r.l., enabled, with links to its documentation and support
The Plugins window, searched for the plugin.

The library under Source/ThirdParty/cadaclysm/lib/ is the reader, the geometry kernel and the format support: one shared library per platform. The plugin loads it when it starts, and packaging stages it beside the game, so there is nothing else to ship.

2 · In the level

An actor and a file

Place a Cadaclysm Actor from the Place Actors panel. It is an actor with one component on it, Document, which is where everything lives. Then call Load CAD File on it — from a Blueprint, from the level Blueprint, or from C++:

#include "CadaclysmActor.h"
#include "CadaclysmLog.h"

// A file from anywhere on disk, opened at run time.
ACadaclysmActor* Cad = GetWorld()->SpawnActor<ACadaclysmActor>();
FString Error;
if (!Cad->Load("D:/models/platform.step", Error))
{
    UE_LOG(LogCadaclysm, Error, TEXT("%s"), *Error);
}
The Unreal Editor with a Cadaclysm Actor selected: the platform assembly in the viewport, the actor in the Outliner, and its Document component in the Details panel
A Cadaclysm Actor in the level, selected: the Outliner lists it, and the Details panel shows its one component, Document. The file was loaded from the editor for this picture; in a project it opens when the game runs.

In Blueprint the same call is one node: Load CAD File, with the path in and a message out where a file cannot be read. A large assembly takes seconds, and a frame does not happen during them, so anywhere a frame is being drawn use Load CAD File Async instead — it returns at once and reports progress. The loading page covers it.

A Blueprint graph: Event BeginPlay calls Load CAD File with a path, and a Branch on its return value prints the error message when it fails
Load CAD File in a Blueprint: when it fails, Print String shows the message the node hands back.
An electric skateboard platform drawn in Unreal Engine: four wheels, two motors, battery modules on frame rails
A STEP assembly of 901 parts, loaded and drawn. The model is built with our own kernel, and every picture on these pages is shot through the plugin.
3 · Look at it

What you get

The whole document is one primitive. It has bounds, so the editor frames it and the renderer culls it; it is lit and shadowed like anything else; and it is clickable, so a trace against it tells you which part was hit. Nothing was imported: stop the session and there is no asset, no mesh and no material in your content folder.

A single hexagonal nut with a counterbored hole, shaded, filling the frame
One part on its own. The same component draws a single part and a ten-thousand-part assembly.

From here: draw the parts from their surfaces rather than from triangles, turn on the edges, or colour and move the parts one by one.

If nothing appears

The usual three

The path. Load CAD File returns false and hands back a message saying what went wrong; log it. A relative path is relative to the packaged build's working directory, which is rarely where you think.

The scale. CAD files are usually in millimetres and Unreal works in centimetres. The plugin converts on the way in, so a part modelled 50 mm across is 5 units across in the level. A file that seems a hundred times too big or small was written in other units than it claims.

The distance. An assembly modelled far from its origin — a building at survey coordinates — arrives far from the level's origin too. Frame the actor rather than hunting for it.