Automotive Configurator Sample

How to setup the Automotive Configurator sample project, render a commercial with Movie Render Queue, and edit with the Variant Manager.

Windows
MacOS
Linux

The automotive industry is increasingly turning to real-time solutions, such as Unreal Engine 4 (UE4), to drive their visualization and commercial projects. The Automotive Configurator sample is built using Epic Games' best practices for the creation of a vehicle configurator, a common use case for 3D visualization artists in the automotive industry.

The Automotive Configurator sample demonstrates the use of the following features:

How To Use the Automotive Configurator

Downloading the Sample

The project sample is freely available via the Learn tab in the Unreal Engine section of the Epic Games Launcher. Other asset packs used in the making of the sample can be found for free in the Marketplace tab.

To setup a project with the Automotive Configurator sample, use the following steps:

  1. Open the Epic Games Launcher and click on the Unreal Engine button on the sidebar. Then open the Learn tab.

    Launcher Learn tab

  2. Scroll down to the Engine Features Samples and select the Automotive Configurator sample. Click the Free button to add the sample to your Vault.

    Launcher Engine Sample

  3. Click the Create Project button and follow the on-screen instructions to download the sample and start a new project.

    Launcher Create Project

  4. Open your new project in the Unreal Editor.

  5. Open the Plugins menu by going to the Edit menu and selecting the Plugins option.

    Plugins menu

  6. Enable the following plugins:

    • Movie Render Queue

    • Color Correct Regions

    • Control Rig

    • Variant Manager

    This may require you to restart the Editor.

The Automotive Configurator is built using the Product Configurator template as a base. Using the Variant Manager, you can choose from a variety of saved Static Mesh configurations called Variants to customize an Audi A5.

Configurator user interface

You can control the configurator using the interface buttons located at the bottom of the screen:

Number

Description

1

Configurator Mode

2

Commercial Mode

3

Car Paint Color

4

Wheel Style

5

Trim Color

6

Leather Color

7

Seat Upholstery Style

8

Take Screenshot

9

Mute/Unmute

10

Camera Views

The Automotive Configurator also includes focus points, represented by blue flashing circles. These have been animated using Control Rig, UE4's Blueprint-based animation control system:

  • Open/Close Doors: Open and close the car doors.

  • Open/Close Convertible Soft Top: Open and close the convertible top by clicking on the roof control switch located by the rearview mirror in any of the interior views.

  • Open/Close Trunk: Open and close the trunk lid.

  • Horn: Honk the horn.

  • Start/Stop the Engine: Click the Engine Start button to start or stop the engine. When the engine is started, the dash gauges and Audi Virtual Cockpit are powered and the front lights and tail lights are lit up.

Rendering the Commercial View

Clicking the Play button in the Configurator will transport your customized vehicle to the Commercial mode.

Commercial user interface

In Commercial mode, your vehicle becomes the star of your very own TV spot. This takes your vehicle through several camera shots often seen in car commercials. You can control the commercial using the following interface options:

Number

Description

1

Stop

2

Play

3

Pause

4

Render Video

Powered by Sequencer, the camera races across the salt flats, moving to highlight the wheels and interior. The car commercial takes advantage of Ray Tracing for real-time lighting and shadows, and can be saved to your computer thanks to the Movie Render Queue runtime feature.

Variant Manager

The Automotive Configurator is built on the Product Configurator template and uses the Variant Manager to store the various asset configurations used to customize your vehicle.

Move the slider to see the different Trim variants

Each configuration option is stored in an entry called a Variant. Each variant points to a property on an Actor that is changed when the variant is activated. Variants are arranged into Variant Sets and the data is used by the BP_Configurator Blueprint to populate the user interface with options. In the image above, you can see that when different trim options are selected the Variant Manager applies that value to different static mesh components on the vehicle Actor.

For more information on using the Variant Manager, please see the Variant Manager documentation.

Real-time Ray Tracing

Ray tracing techniques offer the ability to create realistic 3D content that display natural looking lighting and shadows:

Ray tracing example

Real-time Ray Tracing uses a hybrid Ray Tracer that combines ray tracing with UE4's existing raster techniques. It also uses a physically-based Path Tracer that works similar to many offline renderers.

The Automotive Configurator sample uses ray tracing for shadows, reflections, and ambient occlusion. Ray traced shadows simulate soft area lighting effects and are important to creating contact shadows on different parts of the car, such as the headlights. Along with ray traced ambient occlusion, they create a more realistic shadow of the car and ground it in the environment. Ray-traced reflections make it possible for the environment to reflect off the car from all angles. Something that was limited when using Screen Space Reflections.

For more information on using Real-time Ray Tracing, please see the Real-time Ray Tracing documentation.

Volumetric Clouds

The Volumetric Clouds found in the sample use a physically-based cloud rendering system and a material-driven approach to create the sky that is seen on the salt flats.

Car Configurator sample

The Epic Games team uses volumetric clouds to bring aesthetic touches to the salt flats, while also getting bounced light reflection on the car paint. The Volumetric Cloud component uses a Material Instance of the default cloud Material to accomplish these effects.

For more information on using the Volumetric Clouds system, please see our Volumetric Clouds documentation.

Control Rig

The Control Rig system is a scriptable node-based rigging system that provides rigging and animation tools directly in the engine.

Control Rig convertable top skeleton

In the Automotive Configurator, the Epic Games team uses Control Rig in two ways. The first is to create an adaptable skeletal mesh version of the car and create the animations for the wheels, doors, and trunk. The second is to create the animation for the convertible top.

The Audi A5 uses a skeleton with pivot locations for each movable element in the car. With this method, the main vehicle geometry does not need to be bound to the vehicle, and the skeletal mesh can be imported into Unreal quickly. Once imported, the mesh is added to a Blueprint, which attaches the rest of the vehicle components to the pivots and binds the skeleton to the Control Rig at runtime. This makes it easier to update the pivot locations if needed without having to go back to our DCC application.

Due to its complexity, the cloth convertible top is a separate piece with its own skeleton and Control Rig. A state machine tracks if the top is open or closed, and runs the correct transition animation when it is selected in the configurator application.

For more information on using Control Rig to animate in-engine, please see the Control Rig documentation.

Sequencer

Powering the Commercial mode, Sequencer is a robust keyframe animation system which you can use to create in-game cinematics.

Commervial view using Sequencer

The Commercial mode uses a series of level sequences with animated cameras to showcase various configurable features on the car. The Epic Games team then uses Movie Render Queue to render and save the level sequences and assemble them using a non-linear editing program. This edited sequence is brought back into Unreal as a master sequence, where audio is added and the cameras, animation, and overall timing is refined. These sequences are found in the CarConfigurator/Commercial/Sequences folder.

For more information on using Sequencer in your projects, please see the Sequencer documentation.

Movie Render Queue

Used to output the final commercial render, Movie Render Queue is an engine feature that can export high-quality media. When used with Real-Time Ray Tracing, the final render can take advantage of advanced anti-aliasing, radial motion blur, and reduced noise in ray tracing:

Movie Render Queue at runtime

The Epic Games team uses Blueprint to enable Movie Render Queue at runtime. With this, you can render and save a video of your commercial directly from the configurator.

For more information on using the Movie Render Queue feature, please see the Movie Render Queue documentation.

Adding Art Assets to the Configurator

You can add new art assets to the Automotive Configurator by adding a new variant to the Level Variant Set. This process is similar for both Materials and Static Mesh assets. The example below describes how to add a new paint color to the configurator.

The Audi A5 in this sample makes use of the Automotive Materials Pack for paint, leather, and trim options. To add additional colors to the interface, follow these steps:

  1. Create a custom folder to hold your new Material and any texture samples that it may need. Do this by right clicking on the CarConfigurator folder and selecting New Folder. Name the new folder Custom.

  2. If you are not adding a color that is already available within the sample, you will need to either create your paint sample using the tools available within the Automotive Material Pack, or import and set up your Material. For more information on importing textures and creating new Materials, please see our Material How-To documentation.

  3. Next, open the CarConfigurator/Shared folder and double click on the CarVariants Level Variant Set to open it in the Variant Manager.

    Opening the Level Variant

  4. To make sure that your new color is applied to all the required static meshes, you can duplicate an existing Variant. Open the Paint, Trim, or Leather Variant Sets and right click on the last variant in the list. From the menu, choose the Duplicate option.

    Variant duplicate

  5. Right click on your new variant and choose Rename. Create a new name that is appropriate for the color.

    Variant rename

  6. Click the B_AudiA5 in the Properties panel to display the Properties and Values for the car. For each value in the Values column, click the drop down menu and select your new color, excluding the SM_trunkDetails Material.

    Changing the Variant colors

    Changing the Material for SM_trunkDetails changes the license plate on the car.

  7. Set the thumbnail image for your new variant by switching on the variant and positioning the Viewport camera to best display your new option.

    Setting the Viewport camera

  8. Then right click the variant in the Variant Manager choose the Set from viewport option.

    Variant thembnail from viewport

  9. Test the sample by clicking the Play button in the Editor. Your new variant should appear in the user interface.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Dismiss