IN THIS ARTICLE
Creating Projects Using O3DE Project Manager
This tutorial provides an introduction to project configuration and building in Open 3D Engine (O3DE). The instructions here and in the video will guide you through the following steps:
- Configure the Project Manager engine settings.
- Create a new O3DE project.
- Build the O3DE project.
At the end of the tutorial, you’ll have a new O3DE project based on the default “standard” project template, ready to open in O3DE Editor.
The following instructions assume that you have:
- O3DE installed or built as an SDK engine on your computer. For help, refer to Set up Open 3D Engine .
- Met all hardware and software requirements listed in O3DE System Requirements .
This tutorial uses the following project name and directories in the examples:
|O3DE engine install directory.|
|New project name and location.|
|Package directory created earlier during setup on Windows or Linux .|
Either launch Project Manager from an icon on your desktop, or open a file browser or command line window on your computer and navigate to your O3DE engine directory. Locate and launch the O3DE Project Manager application,
<install-directory>/bin/<platform>/profile/Default.Important:If you built an SDK engine from source using the
INSTALLtarget, make sure you launch the Project Manager and other tools from the install directory, not the build directory in the engine root. For example, the Windows install directory will typically end in
If this is the first time you’ve used Project Manager to create a project, then check and configure the O3DE engine settings before you create and build the project.
Choose the Engine tab near the top of Project Manager.
Review the default locations and update as desired, taking into consideration that the 3rd Party Software Folder and a typical project located in the Default Projects Folder each require 10 - 20 GB of free space on a computer. O3DE uses your user directory in all the locations by default.
If you set up and built O3DE from GitHub, you can set the 3rd Party Software Folder to the same packages directory you created when you built the engine (for example,
C:\o3de-packages), to avoid downloading the same packages again when the project builds.
Go back to the Projects tab when you have finished updating the engine settings.
In Project Manager, choose Create a Project. This will guide you through creating a new project, starting from the default project template. It will also register the O3DE engine, if you haven’t already registered it.
If you have already registered one or more projects, open the New Project dropdown menu instead and choose Create New Project.
Under Project name, give your project a name, such as “MyProject”.
If you want to change the project location, under Project Location, choose the folder icon, and then use the Browse dialog box to choose a new location. If needed, you can create a new project folder. The folder that you choose becomes the project root directory.
Under Select a Project Template, you can choose a project template with a pre-configured selection of Gems. You can also choose different Gems to enable for your project. This tutorial uses the default template and its pre-configured selection of common Gems.
Choose Create Project to create the project files in the root directory specified as the project location. This also registers your project in the O3DE manifest, located at
You are now ready to build the project from Project Manager.
Inside your project’s icon box, choose Build Project.
The project shouldn’t take long to build. When the build completes, you can find the project binaries in your project directory under
To open your built project in the Editor, choose Open Editor from inside your project’s icon box.
Copyright © 2022 Open 3D Engine Contributors
Documentation Distributed under CC BY 4.0.
The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Policy page.