Table of Contents

Create a project

Beginner

This page explains how to:

  • create a new empty project
  • create a project based on a template or sample

Templates are projects that contain just the necessary elements to start working on a game.

Samples are complete games, which you can learn from or base a new game on.

Create an empty project

An empty project is project that contains only the bare minimum to make a game: a simple scene with a light, camera, and script to move the camera, plus a preconfigured rendering pipeline. This is good when you want to start your game from scratch without elements you don't need.

To create an empty project:

  1. In the Stride Launcher, click Start to start Game Studio.

    The New/open project dialog opens.

    New Project dialog

    You can also open a new project in Game Studio from File > New.

  2. Select New Game.

  3. In the Name and Location fields, specify a name for the project and the folder to save it in.

  4. Click Select.

    The Create a new game dialog opens.

    Create a new game dialog

  5. In the Namespace field, specify the namespace you want to use. If you don't know what your namespace should be, leave it as default.

  6. Under Platforms, select the platforms you want your game to support.

    Note

    To support iOS and Android, you need to install Xamarin (free if you have Visual Studio). If your development system is missing prerequisites for any of the platforms you select, Stride displays a warning.

  7. Under Asset Packs, you can select additional assets to include in your project. These include assets such as animations and materials. The asset packs are fun to play with when you're learning how to use Stride, but they're not necessary.

  8. Under Rendering, select the options you want.

    Graphics Profile: The graphics features you can use in your project depend on the profile you select. For advanced graphics features, select the latest version of the graphics profiles.

    Warning

    Some graphics cards don't support the latest graphics profiles. For some mobile devices, only Level 9.3 and Level 10.0 are available.

    High or Low Dynamic Range (HDR / LDR): This defines how color is computed in your project. In LDR mode, colors range from 0 to 1. In HDR mode colors can take any float value. HDR provides more advanced and realistic rendering but requires more processing power and profile Level 10.0 or later.

  9. Under Orientation, choose the orientation for your project. For PC games, use landscape. Portrait should usually only be used for mobile games.

  10. Click OK.

Stride creates the project and opens it in Game Studio. For more information, see Game Studio.

Create a project from a sample or template

Stride includes several sample projects demonstrating each part of the engine (2D, 3D, sprites, fonts, UI, audio, input, etc). It also includes template games to help you make your own game.

To create a project from a sample or template:

  1. Open the New Project dialog.

  2. On the left, navigate to New project > Samples.

  3. Select the sample you want to create a project from.

New Project window — samples

  1. Click Select.

    The Select Platforms window opens.

    Select Platforms window

  2. Select the platforms you want your game to support and click OK.

Stride creates the project and opens it in Game Studio.

Create a project without Game Studio

Stride allows you to create new projects from the command line using the dotnet command.

  1. Before starting, make sure to install the project templates from nuget.

    dotnet new install Stride.Templates.Games

  2. Find the template you want to use. The default project template is named stride-game. For a list of all stride templates, use this command:

    dotnet new list --tag stride

  3. Create the project.

    dotnet new stride-game -n NameOfGame

All Stride templates can take additional parameters to change how they are created. Here's a list of the most commonly used ones:

Parameter Values Description
-n text Name of the project.
--platform host (the current os), window, linux, macos, android, ios Platform(s) the project should target, separated by the | character.
--HDR true, false Determines if the project uses HDR (required graphics profile >= 10.0).
--graphics-profile 9.0, 10.0, 11.0 The graphics profile to use. This can be changed later.
--orientation Default, LandscapeLeft, LandscapeRight, Portrait The game's orientation on mobile devices. This can be changed later.

For a list of all available parameters in a template, use dotnet new NameOfTemplate --help.

Example command:

dotnet new stride-game -n ProjectX --HDR true --platform windows`|linux
Edit this page