Creating and Switching Game Projects
This feature is in preview release and is subject to change. |
Use the Project Configurator to create and change the settings that affect building and editing of a game project. You can use the Project Configurator to do the following:
-
Create a game project
-
Enable or disable gems (code and assets files) from your game project
-
Switch game projects
To learn about creating and compiling a new game project for Lumberyard, watch the following video tutorial.
Topics
Project Templates
When you create your game project with the Project Configurator, you can use the following templates:
Empty Template
The Empty template has the minimum features required for the editor to load and run a game project:
-
CryLegacy – Enables the editor and launcher to load a game project that contains legacy code
-
Legacy Game Interface – Enables the editor and launcher to load a game project that contains legacy game interface code
-
LyShine gem – Provides access to the in-game UI system for Lumberyard
-
Maestro gem – Provides access to cinematics features
Default Template
The Default template builds on the Empty template and enables the following gems to provide basic features for game development:
-
Amazon GameLift – Provides capabilities to use this service and create game sessions
-
Camera – Includes a basic camera component for runtime rendering
-
ChatPlay – Includes the interface for triggering events based on Twitch chat activity
-
Cloud Canvas – Provides visual scripting capabilities to power your game backend with AWS services
-
Gestures – Allows gesture-based input, including click/tap, drag, hold, pinch, rotate, and swipe
-
Http Requestor – Adds support to handle HTTP and HTTPS requests
-
In-App Purchases – Provides the in-app purchasing API for Android and iOS
-
Input Management Framework – Converts input to user-defined gameplay events
-
LyShine – Provides access to the in-game UI system for Lumberyard
-
PBS Reference Materials – Includes a set of physically based shading reference materials and texture assets
-
Physics Entities (Legacy) – Provides physics entity modifiers to simulate physical events
-
Primitive Assets – Provides primitive objects to manipulate in your level
To see the gems that enabled for the Default template, create a project from that template and choose Enable Gems.
The Default template also includes a simple level for you to manipulate components and entities in the editor and experiment with other assets in a neutral, gray environment. The simple level includes a camera, a single light, an environment probe for reflections, and primitive objects with physics enabled. The objects are provided by the Primitive Assets Gem.
-
When you create your game project, we recommend the Default template and its set of gems. This template helps you start designing and developing quickly. Some of the gems in the template are optional.
-
To create a base project without optional gems, use the Empty template. This template creates a basic project using the minimum features to start a game.
Creating a Game Project in Lumberyard
You can create a game project using the Project Configurator or command line. When you create a game project, the following are also created:
-
A game gem that includes your game-specific code. The gem is named after your game project and is located in the
directory.
\GemMyNewProject
-
A Visual Studio solution file specific to your game.
Choosing a Game Project to Open
Use the Project Configurator to set default game project that opens in Lumberyard Editor.
To open a game project
-
Open the Project Configurator with your preferred method:
-
From the desktop, double-click the Project Configurator icon
-
Open the Lumberyard Project Configurator, located at
. For example, when using Visual Studio 2017 as your build platform, the Project Configurator is located atlumberyard-version
\dev\Bin64BuildPlatform
\ProjectConfigurator.exe
.lumberyard-version
\dev\Bin64vc141\ProjectConfigurator.exe
-
-
On the Summary page, select the project and click Set as default.
-
(Optional) Click Enable Gems and select the additional features and assets that you want available to design your game. If you select a gem labeled with Code & Assets, you must build your project from a command line.
For more information, see Building Lumberyard projects.
-
(Optional) Choose Advanced Settings and verify that the System entity and Memory settings are appropriate for your project.
-
Close the Project Configurator.
-
After setting the default project, open Lumberyard Editor with your preferred method:
-
From the desktop, double-click the Lumberyard Editor icon
-
For Visual Studio 2017, navigate to the
directory and double-clicklumberyard_version
\dev\Bin64vc141Editor.exe
-
For Visual Studio 2019, navigate to the
directory and double-clicklumberyard_version
\dev\Bin64vc142Editor.exe
After the first launch and each time you change projects, Asset Processor runs in the background. Asset Processor manages your assets and project files. While Lumberyard Editor opens, you can see messages appear with status information.
For more information, see Using Asset Processor.
-
Switching Game Projects
To switch projects, you must close Lumberyard Editor. With the Project Configurator, you then specify a different project and its gems and system settings for the editor to open.
When you switch projects, you can specify the following:
-
Name of the project to open
-
(Optional) Gems enabled for the project
-
(Optional) System settings for the editor to use
To switch game projects
-
In Lumberyard Editor, choose File, Project Settings, Switch Projects.
-
You must close Lumberyard Editor before you can open the Project Configurator. In the dialog box, choose Save.
-
Follow the procedure in Choosing a Game Project to Open.