User Guide (Version 1.12)


Gems are packages that contain code and/or assets to augment your game projects. With the Modular Gems System, you can choose the features and assets that you need for your game project without including unnecessary components. For example, you might add the Boids Gem to create entities for a flock of birds to place in your game. For a list of all Gems included in Lumberyard, see Lumberyard Gems Reference.

Lumberyard features two types of Gems:

  • Code & Assets – Contains assets as well as code that performs certain functions upon the assets.

  • Assets Only – Contains only assets and no code.

All Lumberyard Gems are located in the following directory:


The gems that you enable are automatically detected and built through the integrated Waf Build System.


To enable Code & Assets Gems, you must select the Compile the game code option in Lumberyard Setup Assistant. This option is not required for Assets Only Gems. For more information, see Running Lumberyard Setup Assistant.

You can enable gems with the Project Configurator or the command line (Lmbr.exe).