Compressing Your Gem - Lumberyard User Guide

Compressing Your Gem

Open 3D Engine (O3DE), the successor to Lumberyard, is now available in Developer Preview. Download O3DE or visit the AWS Game Tech blog to learn more.

You can compress your gem to make it distributable to other Lumberyard game developers. To do this, you zip the contents of the gem directory using your preferred zip tool, and change the .zip filename extension to .crate. The compressed .crate file must be under 4GB in size. By renaming the .zip to .crate, game developers who use your gem can unpack and install it by drag and dropping it into Lumberyard.

To compress your gem into a crate file

  1. Using a file browser, open your gem's directory. For example, lumberyard_version\dev\Gems\my_gem.

  2. Select the contents of this directory and use your preferred zip tool to zip them.


    Don't include your gem's top level directory as part of the zip file. Select the files and directories inside the my_gem directory to zip.

                    Compressing your directory to create a gem.
  3. After the .zip file is created, remove the .zip extension and rename it to .crate.

    Your gem crate is ready for distribution.