Testing

Test automation is the process of writing small snippets of code (tests) to verify the desired functionality of Open 3D Engine extensions and tools that you create.

Important:
Contributors to the O3DE Project are required to write tests for their features, following the standards set by the Open 3D Foundation Testing Special Interest Group . If you plan to contribute, make sure that you’re familiar with project test standards as well as the frameworks.

Test Runners

O3DE uses standard test runners to collect, execute, and gather results. The officially supported test runners are:

Test Tools Packages

Open 3D Engine (O3DE) offers several tools packages to make writing tests quicker, safer, and more consistent. Before you write tests, take time to familiarize yourself with the tools.

AzTest

AzTest is a collection of abstractions, functions, and wrappers to make writing C++ tests easier.

EditorPythonTestTools

EditorPythonTestTools are a collection of test tools focused around accessing Editor functionality. These tools should be used whenever you want to automate tasks which would occur in the Editor.

LyTestTools

The LyTestTools are testing productivity tools for writing and debugging tests that across different environments. This includes (but isn’t limited to) environment manipulation, creating/collecting images and logs, and starting project launchers.

Getting Started

Learn about the automated testing tools provided with Open 3D Engine (O3DE).

Best Practices

Advice for automating tests in Open 3D Engine (O3DE).

AzTest

Use AzTest to write C++ unit tests for O3DE.

LyTestTools

Use LyTestTools to write tests quicker, safer, and more consistently.

Parallel Tests

Use parallel patterns to allow tests to be run in parallel in Open 3D Engine (O3DE).

Copyright © 2026 DawnEngine. All rights reserved.

DawnEngine is a commercial 3D engine distributed under the DawnEngine end-user license agreement. Engine binaries and source are proprietary and are not covered by the licenses below.

Documentation only: the prose and templates on this site are a derivative work of Open 3D Engine (O3DE) documentation by the O3DE Contributors, used under CC BY 4.0 (documentation content), Apache 2.0 (site code), and the MIT license (inline code samples).

The open-source 3D engine that DawnEngine is built on top of is Open 3D Engine . DawnEngine is not affiliated with, endorsed by, or sponsored by The Linux Foundation or the O3DE project. “O3DE” and “Open 3D Engine” are trademarks of The Linux Foundation.