FragmentUnreal is an Unreal Engine plugin designed to import and visualize BIM models in the Fragment 2.0 format. It bridges architecture and construction data with immersive 3D visualization in Unreal Engine.
🔄 This plugin is actively developed. Community feedback and contributions are welcome!
- 🏗 Import BIM models in Fragment 2.0 format
- 🧱 Translate model hierarchy, geometry, and metadata into Unreal-native assets
git clone https://github.com/bastto/FragmentsUnreal.gitOr add it as a submodule (recommended for multi-repo projects):
git submodule add https://github.com/bastto/FragmentsUnreal.git- Open your Unreal project
- Go to Edit > Plugins
- Search for "FragmentUnreal" and enable it
- Restart the editor
Use ProcessFragment to import and spawn a Fragment model. The origin point (0,0,0) will be relative to the owning actor's position.
-
Set
SaveMeshes = trueto save the generated geometry for future reuse. -
Set
UseDynamicMesh = trueto generate a fast preview using DynamicMesh.⚠️ When usingDynamicMesh,SaveMeshesis ignored.
Use LoadFragment to import and store a Fragment model in memory for later use during the session.
Call ProcessLoadedFragment to spawn a previously loaded Fragment model using its ModelGuid.
- Can optionally enable
SaveMeshesorUseDynamicMeshjust like inProcessFragment.
Use this to spawn individual items and their children from a loaded model using:
ModelGuid– to identify the loaded modelElement LocalId– to specify the starting node
Supports both SaveMeshes and UseDynamicMesh.
- Prepare a model in Fragment 2.0 format
- Add FragmentsUnreal as dependency in your Module
- Using the UFragmentsImporterSubsystem. Runtime Subsystem
- Same functions as in the blueprint example above.
- The plugin will generate actors, meshes, and materials in-scene
- Hierarchies, transforms, and metadata will be applied based on the input
⚠️ FragmentEditor, is aneditor onlymodule.
- Prepare a model in Fragment 2.0 format
- Add FragmentsUnreal as dependency in your Module
- Using the UFragmentsImporterEditorSubsystem. Editor Subsystem
- Same functions as in the blueprint example above.
FragmentUnreal/
├── Source/
│ ├── FragmentUnreal/ # Core plugin code
| │ ├── Fragment/ # Fragment class to store element's data
| │ ├── Importer/ # Fragments import logic
| │ ├── Index/ # flatbuffers Fragment structure reference
| │ └── Utils/ # Functions library
│ ├── FragmentEditor/ # Editor functionalitites
| │ └── EditorSubsystems/ # Editor import logic
├── ThirdParty/ # ThirdParty dependencies
│ ├── FlatBuffers/include/flatbufferss # Flatbuffers structure
│ ├── libtess2 # libtess2 for mesh triangulation
| │ ├── include/ # tesselator header file
| │ ├── Lib/ # Libraries for Android/ARM64 and Win64
| │ └── Source/ # Source files
├── Content/ # Assets
│ ├── Materials # Base Materials
│ └── Resources # Fragments file example
├── FragmentUnreal.uplugin # Plugin descriptor
- Unreal Engine: > 5.3
- Platforms: Windows, Android (runtime)
- Dependencies: FlatBuffers (included)
- Dependencies: libtess2 (included)
We welcome pull requests and feature ideas!
- Create a fork or work on a feature branch
- Write clean, commented, and modular code
- Follow Unreal Engine C++ standards
- Add a helpful description to your pull request
- All changes go through
devand must be merged via PR
This project is licensed under the MIT License. You are free to use, modify, and distribute it with attribution.
Jairo Basto Picott @jairo-picott. Msc. Civil Engineer | Software developer Feel free to open issues or email if you're using this in a real-world application!
If you're integrating Fragment BIM data into Unreal, let’s connect and collaborate! Contributions, issues, or even just stars are appreciated. 🌟
If FragmentUnreal helps you save development time or adds value to your workflow, consider supporting its development.
Your contribution helps cover maintenance, new features, documentation, and plugin support.