IN THIS ARTICLE
Code Gem Specifications
Code Gems contain source code that can extend the Open 3D Engine (O3DE) Editor or integrate features and logic for your O3DE project. They can also contain assets that are required by the source code such as interface elements and assets that are used as tests and samples.
Follow Create an O3DE Gem to create a Gem based on the DefaultGem template. Code and asset Gems have the same Gem directory structure and you can use the same command to create them.
The code components of a Gem are located in the
Code directory. The DefaultGem template provides the following boilerplate code for the Gem’s source code in the
Code/Source directory of your Gem.
You can view the Gem’s source code from a Gem that you created or from the DefaultGem template that’s located in the
templates/DefaultGem directory of your engine source code.
The following files are the code components of a Gem.
<Gem>ModuleInterface is the main Gem Module class that contains the entry point functions to connect the Gem’s functionality to O3DE. The DefaultGem template already sets up the Gem Module to connect to O3DE by calling the
For more information on modules and their responsibilities in O3DE, refer to Gem Module System .
<Gem>SystemComponent class is a global singleton class that’s responsible for managing the Gem’s code. The Gem Module registers the Gem System Component which manages the Gem Module’s life cycle: initialization, activation, and deactivation. The Gem System Component activates when the Gem loads and deactivates when the Gem unloads.
The Gem System Component allows the component within the Gem Module to communicate with components from other Gems by connecting to their EBus. It also handles initialization and shutdown, events, memory allocation, and debugger connections.
<Gem>EditorModule class contains the logic for using the Gem in the Editor. It’s separate from the main Gem Module, which handles the logic of the Gem. For example, if the Gem implements a component, the main Gem Module implements the component’s logic and the Editor module implements the component’s user interface in the Editor.
<Gem>EditorSystemComponent class is the system component class for managing the Editor module. You can use this class to program Editor functionality. For example, if your Gem implements a component or a window that appears in the O3DE Editor.
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.