File Exchange

image thumbnail

Vehicle Dynamics Blockset Interface for Unreal Engine 4 Projects

Simulink integration for Unreal Engine 4


Updated 19 Apr 2019

The Vehicle Dynamics Blockset includes several built-in scenes in which you can drive a virtual vehicle. This support package provides the following additional content:
• AutoVrtlEnv.exe: A compiled Unreal Engine game that includes additional scenes such as a double lane change with cone markers and the ability to have two cars in the same scene (e.g., for overlaying results)
• AutoVrtlEnv.uproject: A project file that you can open with the Unreal Engine Editors to customize the pre-built 3D scenes
• MathWorks Simulation Plugin: A plugin necessary to connect an Unreal Engine compiled scene with Simulink
Additional information on how to use these features is included within the support package files.
• Setup Document: Please type the MATLAB command open('AVE_README.pdf') for setup instructions.

Comments and Ratings (32)

Mike Sasena

Hi Tim,
We'd be happy to help you get this set up, but we'll need more information. Please use the button in the "Have Questions?" section of the Vehicle Dynamics Blockset product page to contact us (link below). We can then work with you directly to get this working.


I've tried following both method instructions in AVE_README.pdf, and tried all the related examples, but can't get anywhere.

Always get this error:
MATLAB System block 'DLCReferenceApplication/Visualization/3D Engine/3D Engine/Simulation 3D Engine 1/Simulation 3D Engine' error occurred when invoking 'setupImpl' method of 'Simulation3DEngine'. The error was thrown from '
'C:\Program Files\MATLAB\R2018b\toolbox\shared\sim3d\sim3d\+sim3d\Engine.p' at line 0
'C:\Program Files\MATLAB\R2018b\toolbox\shared\sim3d\sim3d\+sim3d\Engine.p' at line 0
'C:\Program Files\MATLAB\R2018b\toolbox\shared\sim3d\sim3d\+sim3d\Project.p' at line 0
'C:\Program Files\MATLAB\R2018b\toolbox\shared\sim3dblks\sim3dblks\Simulation3DEngine.p' at line 0'.
Caused by:
Invalid default value for property 'engine' in class 'sim3d.Engine':
3D simulation engine interface setup error (1). Please check the toolbox preferences and ini-file.
Any Suggestions ?
Thank you.

Victor Sim

Hi Mike,
I'm getting this message when running the script for Method B:
Error using sim3d.Engine/setup
Invalid default value for property 'engine' in class 'sim3d.Engine':
Invalid MEX-file 'C:\Program Files\MATLAB\R2018b\toolbox\shared\sim3d\sim3d\SetupSimulation3DInterface.mexw64':
The specified module could not be found.

Do you know how to fix this?

Sam Reinsel

I suggest starting with the Vehicle Reference Applications:
The shipped version of the game supports multiple scenes (see
You need Unreal Engine Editor and the package only to build a custom scene.
Here is a link to the getting started instructions for Unreal Engine Editor:
The package includes AVE_README.pdf that describes the further steps.

Could you please tell me how to use this package.I'm a beginner

Mike Sasena

Shahzeb, as mentioned in the AVE_README.pdf, this support package was designed to work with Unreal Engine version 4.19. Please install that specific version of Unreal and try again. If you still have problems, you can contact us through the product page at

Hi I have installed Unreal Engine 4.21.1 and I think the Method b is not running and there is compiling error. I don't know how to work with co-simulation as I am new to it.
Can anybody please provide me the startup link or document?

Mike Sasena

One additional piece of information. Make sure that you set the initial position for the Simulation 3D Actor Set block ( to be the same as initial position in the Vehicle Body block mentioned below in my last post. The former specifies the first frame when we initialize the 3D engine. The latter sets the starting position of the vehicle once the simulation begins. Both blocks should reference the same value.

Mike Sasena

Tao, the initial position of the vehicle is set within the reference model for the Vehicle Body (3DOF or 6DOF) block. See in the documentation. if you want help with your specific application, you can contact us through the product page at

tao zhong

Hi, changing the initial value of Vehicle Transform Set block doesn't work for me, the car always starts from the same place. How should I change the starting place? Thanks.

Starting in R2018b, the Vehicle Dynamics Blockset product documentation includes specific information about the scenes, including object locations. See in the documentation

Peter Corke

It would be really great to have a Mac version. Unreal engine is well supported for Mac, pity that this tool doesn't allow it.

Mike Sasena

Carlos. Thank you for your interest, but we do not have any announcements on Mac-supported games at this time.

Any news on when will the games be compiled for Mac?

Mike Sasena

Sudhandshu, Method A in the AVE_README.pdf specifies the path to AutoVrtlEnv.exe using the variable “src_root”. At the end of the code snippet, you can use the command "setenv('PATH', winPath)" to update the Windows path. This will allow MATLAB to find AutoVrtlEnv.exe when it tries to launch the game.

As for your question about “Vehicle Dynamics Blockset doesn’t download on R2018a”, can you please be more specific? What is it that you’re trying to do and what error message are you seeing? If you're starting the download from FileExchange, it may use the latest MATLAB version. You can instead start the download from R2018a's "Add-On Explorer" to ensure you get that specific version.

I am using 2018a version, Vehicle Dynamics Blockset doesn't download on that, anyone knows why?

I don't find the instructions very clear, can I get someone to help me? For example, in Method A: Setup MathWorks Environment for Using AutoVrtlEnv.exe: I do not know what path to add. Also, where can I find AutoVrtlEnv.exe on my pc?

Mike Sasena

Yufei, the current implementation is limited to exchanging data with specific objects defined in the scenes provided with Vehicle Dynamics Blockset. We have received similar requests for interfacing with user-defined objects, but cannot announce when such a feature would become available.

Yufei Quek

Hi, is it possible to configure the interface between Simulink and Unreal Engine? For example, to obtain transformation data from a custom object in UE4 instead of using the provided Sim 3D objects?

Mike Sasena

Christopher, apologies for the inconvenience. There was a slight delay in publishing our materials on the Epic Games Marketplace. The files should now be available at this link:

The MathWorks Simulation Plugin doesn't seem to be available in the Unreal marketplace. Is there anywhere else we can get this from?


Looking forward to having Vehicle Dynamics Blockset work on Linux with the same featureset as on Windows.





Vincent Hu

Mike Sasena

Karan, thank you for your interest. We do plan to compile the games for Linux and Mac, but I don’t have a specific date for when these will be available.

Is it possible for you guys (Mathworks) to recompile this game from unreal editor for Linux? Or does it have any components that only work on windows?

MATLAB Release Compatibility
Created with R2018a
Compatible with R2018a to R2019a
Platform Compatibility
Windows macOS Linux

Discover Live Editor

Create scripts with code, output, and formatted text in a single executable document.

Learn About Live Editor