Install Support Package and Configure Environment

Step 1 of 4 in Customize 3D Scenes for Aerospace Blockset Simulations

To customize scenes in your installation of the Unreal^® Editor and simulate within these scenes in Simulink^®, you must first install and configure the Aerospace Blockset™ Interface for Unreal Engine^® Projects support package.

Verify Software and Hardware Requirements

Before installing the support package, make sure that your installed version of Unreal and your environment meets the requirements described in Unreal Engine Simulation Environment Requirements and Limitations. This topic also lists the supported Unreal Engine version.

Note

These installation instructions apply to R2023a. If you are using a previous release, see the documentation for Other Releases.

Verify Software and Hardware Requirements

Before installing the support package, make sure that your environment meets the minimum software and hardware requirements described in Unreal Engine Simulation Environment Requirements and Limitations.

Install Support Package

To install the Aerospace Blockset Interface for Unreal Engine Projects support package, follow these steps:

1. On the MATLAB^® Home tab, in the Environment section, select Add-Ons > Get Add-Ons.

   

2. In the Add-On Explorer window, search for the Aerospace Blockset Interface for Unreal Engine Projects support package. Click Install.

   Note

   You must have write permission for the installation folder.

Configure Environment

The Aerospace Blockset Interface for Unreal Engine Projects support package includes these components:

• An Unreal project, AutoVrtlEnv.uproject, and its associated files. The project includes editable versions of the prebuilt 3D scenes that you can select from the Scene description parameter of the Simulation 3D Scene Configuration block. To use this project, you must copy the file to a folder on your local machine.

• A plugin, MathWorkInterface (with a folder name of MathWorkSimulation). This plugin establishes the connection between MATLAB and the Unreal Editor and is required for co-simulation. It also includes some shared automotive-oriented assets. You must copy this plugin to your local installation of the editor.

• A second plugin, MathWorksAerospaceContent. This plugin contains the aerospace components and connects them to MATLAB using the MathWorksSimulation plugin. You must also copy this plugin to your local installation of the editor.

• A third plugin, RoadRunnerMaterials. This plugin is required for scenes created by the RoadRunner scene editing software, and for packaging the project into an executable.

To configure your environment so that you can customize scenes, use copyExampleSim3dProject to copy the support package components to a folder on your local machine. For example, this code copies the files to C:\project.

sim3d.utils.copyExampleSim3dProject("C:\project");

If you want to use a project developed using a prior release of the Aerospace Blockset Interface for Unreal Engine Projects support package, you must migrate the project to make it compatible with Unreal Editor 4.27. See Migrate Projects Developed Using Prior Support Packages. Otherwise, you can Customize Scenes Using Simulink and Unreal Editor.

Note

If you want to use the plugins to co-simulate with more than one Unreal project, see Unreal Engine 4.27 Plugins.