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.

Prerequisites

The following instructions assume that you have:

Note:
If you set up O3DE from GitHub and chose the source engine build type, we recommend that you create your project using the command line interface (CLI). For more information, refer to Creating Projects Using the CLI.

This tutorial uses the following project name and directories in the examples:

DirectoryDescription
o3de-installO3DE engine install directory.
o3de-projects/MyProjectNew project name and location.
o3de-packagesPackage directory created earlier during setup on Windows or Linux .

Launch Project Manager

  1. 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, o3de.exe, from <install-directory>/bin/<platform>/profile/Default.

    Important:
    If you built an SDK engine from source using the INSTALL target, 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 /bin/Windows/profile/Default.

Configure the engine settings

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.

  1. Choose the Engine tab near the top of Project Manager.

  2. 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.

    Default Projects Folder and 3rd Party Software Folder updated in engine settings

  3. Go back to the Projects tab when you have finished updating the engine settings.

Create a new O3DE project

  1. 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.

    Choose “Create a Project”

    If you have already registered one or more projects, open the New Project dropdown menu instead and choose Create New Project.

    Or choose “New Project - Create New Project”

  2. Under Project name, give your project a name, such as “MyProject”.

  3. 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.

    Create a New Project - Project Details screen

  4. 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.

  5. 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 <user-folder>/.o3de/o3de_manifest.json.

Build the O3DE project

You are now ready to build the project from Project Manager.

  1. Inside your project’s icon box, choose Build Project.

    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 build/<platform>/bin/profile.

  2. To open your built project in the Editor, choose Open Editor from inside your project’s icon box.

For more information about project configuration and building, refer to the Project Configuration and Build sections of the User Guide.


Copyright © 2022 Open 3D Engine Contributors

Documentation Distributed under CC BY 4.0.
For our trademark, privacy and antitrust policies, code of conduct, and terms of use, please click the applicable link below or see https://www.lfprojects.org.


The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Policy page.