Running Gauntlet Tests

Instructions on how to run a Gauntlet test and an explanation of what happens during the process.


In this guide, you will run an existing Gauntlet test available for the Elemental demo. This will familiarize you with the process for running tests and give you an idea what is happening at each step along the way.

ElementalDemo Test Node


Run the ElementalDemo Example

  1. Open a command prompt at Engine/Build/BatchFiles under your Unreal Engine directory.

  2. Enter the following in the command prompt:

    RunUAT BuildCookRun -project=Samples/Showcases/ElementalDemo/ElementalDemo.uproject -platform=Win64 -configuration=Development -build -cook -pak -stage
  3. Once that process completes, enter the following in the command prompt:

    RunUAT RunUnreal -project=Samples/Showcases/ElementalDemo -platform=Win64 -configuration=Development -build=local -test=ElementalDemoTest

ElementalDemo Test Explanation

  1. BuildCookRun generated a Win64 build of ElementalDemo in Samples/ElementalDemo/Saved/StagedBuilds.

  2. RunUnreal launched Gauntlet, which:

    1. Created an instance of the ElementalDemoTest node, which provided basic rules for running the test.

    2. Discovered local builds for the ElementalDemo Project.

    3. Validated that a Win64 Development build was available.

    4. Launched ElementalDemo.

    5. Monitored the running process for any issues.

    6. Detected that ElementalDemo had exited.

    7. Checked for common issues such as crashes, asserts, and fatal errors.

  3. Along the way, provided the ElementalDemoTest node verifies that the test was still running and that no errors had occurred, create a summary report.

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

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback