This documentation is for a prerelease version of O3DE. Click here to switch to the latest release, or select a version from the dropdown.

Version:

Create a Level in Open 3D Engine

In Open 3D Engine (O3DE), a level is a playable section of a project. Within a level, you create entities, instantiate prefabs, arrange lights and cameras, and implement scripted behaviors and interactivity. A level can be interpreted literally as a level of a game; however, levels are the basis for all O3DE projects. Non-gaming applications, such as simulations, require at least one level. A project can have a single level or many levels.

In O3DE, levels are stored in .prefab files within subdirectories of the Levels directory of your project. The level .prefab file is in JSON format. It contains a list of the entities placed in the level, including the components, values, and asset references that define the entities. All assets, including the meshes, scripts, materials, audio files, and other prefabs that compose the level, are referenced within the level .prefab file.

Note:
By default, all levels must be placed in the Levels subdirectory of the project.

Create a level

You can create levels in the Welcome to O3DE dialog box that appears when O3DE Editor is launched, or from the File menu within O3DE Editor.

  1. In the Welcome to O3DE dialog box, choose the Create new… button to open the New Level dialog box. Alternatively, from the File menu in O3DE Editor, choose New Level (hotkey Ctrl + N) to open the New Level dialog box.

    Welcome to O3DE dialog

  2. In the New Level dialog box, enter a name for the level.

    New Level dialog

  3. Choose OK to create the level.

Atom Default Environment contents

The new level is populated with some basic entities. In Entity Outliner, there is a root entity named Atom Default Environment. Choose the arrow to the left of the default entity in Entity Outliner to expand the list of child entities.

Note:
The Atom Default Environment is a prefab. A prefab is a collection of preconfigured entities that is stored on disk as a reusable .prefab asset file. Prefabs can be instanced in a level. You can modify the contents of the default level environment by saving your own prefab to /o3de/Assets/Editor/Prefabs/Default_Level.prefab.

Default level prefab

Entity NameDescription
Atom Default EnvironmentThis is the root entity. It contains a Transform component and is the parent for the default environment entities.
Global SkyContains a Global Skylight (IBL) component and a HDRI Skybox component. This entity provides image-based lighting using a high dynamic range image and displays the image as a skybox.
GroundContains a Mesh component and a Material component to display a simple ground plane with a checkerboard material.
GridContains a Grid component aligned with the Ground entity that can be used as a construction plane for placing and aligning entities and prefabs.
Shader BallContains a Mesh component with a shaderball_default_1m mesh asset. This mesh asset provides a good basis for developing materials.
SunContains a Directional Light component. A directional light casts light uniformly in a single direction and simulates a distant light source.
CameraContains a Camera component that provides a camera view frustum to view the level, and a Fly Camera Input component that takes user input and moves the camera while in Game mode.