Getting Started with UBF Previewer
The UBF Previewer is a dedicated tool designed to streamline the content creation process by allowing creators to visually inspect UBF artifacts in real time. It serves as a crucial component of the UBF workflow—with the option to integrate directly with UBF Studio—to ensure that assets, blueprints, and instances function correctly before being integrated into an experience.
Installation and Setup
Install UBF Previewer from the Asset Creator Pack provided to you. In the pack, you will find the latest available version of UBF Studio and UBF Previewer for both Windows and Mac. If you have not yet received the Asset Creator Pack, please contact the Customer Success team to gain access.
After installation, the UBF Previewer is ready to launch and can be opened like any other application on your system.
Welcome to the UBF Previewer
Opening the UBF Previewer presents you with a dedicated environment for testing and validating your UBF creations.
At the top left corner of the Previewer interface, you can inspect the current version of both the Previewer and the UBF Interpreter it is leveraging. This ensures that you are always aware of the specific interpreter version being used, which is useful for debugging and compatibility tracking.
A core component of the Previewer is the viewport (in blue) - which gives you the ability to navigate freely through a 3D, including rotating, panning, and zooming to inspect your creation from different angles. This allows for an in-depth visual review of your assets and their composition.
At the bottom of the viewport, you can find two useful tools for testing:
- Log Console – Displays any errors, warnings, or messages raised during your preview session.
- Turntable – Allows you to start or stop the automatic rotation of your spawned asset, enabling a continuous 360-degree view.
The Previewer operates in two core modes - Live Connection Mode & Standalone Bundle Mode.
Live Connection Mode
Live Connection Mode enables a direct link between the UBF Previewer and UBF Studio, allowing you to visualize changes in real time as you create or modify Blueprints and Blueprint Instances. By eliminating the need to repeatedly export artifacts, this mode dramatically speeds up iteration: any adjustment to a parameter, addition of a node, or reconfiguration of a Blueprint in Studio immediately appears in the Previewer.
This rapid feedback loop is particularly valuable during early development and prototyping, where you may frequently adjust variables—such as colors, materials, or mesh placements—and want to assess those changes without the overhead of full export cycles.\
Establishing Live Connection
To enter Live Connection Mode, first ensure that UBF Studio is running and that you have an open project. In the UBF Previewer, locate the Live Link button at the top right of the viewport. Selecting this option will prompt you to switch into Live Mode—confirm by clicking Yes.
The Previewer’s interface will then update to reflect live view mode, indicated by a connection status in the bottom-left panel.
Simultaneously, if you switch back to UBF Studio, you will notice a Preview button in the top-right corner of the Blueprint Editor screen.
Pressing this button within any blueprint/blueprint instance pushes your changes to the Previewer for immediate review.
Standalone Bundle Mode
Standalone Bundle Mode allows you to load exported UBF bundles directly from your local disk, rendering them in the Previewer exactly as they would appear when interpreted by a UBF-compatible application. This approach is particularly valuable for the final verification of assets—once you’ve finished authoring and refining them in Studio, you can confirm their quality and functionality without the overhead of a live connection or additional integration steps.
This mode is especially beneficial when you’re looking to review published content, test entire collections and even inter-project render testing - i.e. Preview how items from different projects might be combined.
Loading Bundles
To load bundles in Standalone Bundle Mode, simply click the Bundle Loader icon—located in the bottom-left corner of the Previewer interface.
This opens the Bundle Loader, where you can select one or more exported UBF bundles from disk. Each loaded bundle grants you access to its Blueprints and Blueprint Instances as well as all referenced resources, allowing you to preview multiple assets or entire collections simultaneously.
Within the Bundle Explorer, clicking the ‘+’ button allows you to add a new bundle by selecting the path to a previously exported UBF bundle.
Once loaded, each bundle is represented as an entry with three key interactions:
- Bundle Information Panel – Displays details on how the bundle was loaded, including which Blueprints or Instances it contains, along with any warnings or errors encountered during the process.
- Update Bundle Path – Lets you modify the file path if the bundle’s location changes or you need to reference a different version.
- Remove Bundle – Deletes the bundle entry from the Previewer, ensuring you don’t accidentally spawn assets from an outdated or irrelevant bundle.
Once a bundle is successfully loaded through the Bundle Explorer, all Blueprints and Instances contained within that bundle become available to the Previewer. You can freely mix and match assets across any loaded bundles in your session, effectively creating a unified set of content to work with. This seamless integration allows you to spawn, combine, and validate items from different bundles in a single environment—ideal for testing cross-project assets or complex scenarios where multiple collections may interact.