Game settings

You can configure the global settings of your game in the Game Settings asset. By default, the Game Settings asset is stored in your project's Assets folder.

  • In the Solution Explorer (the bottom-left pane by default), select the Assets folder.

  • In the Asset View (the bottom pane by default), select the GameSettings asset.

Select Game Settings asset

Default scene

You can have multiple scenes in your project. The default scene is the scene Xenko loads at runtime.

To set the default scene:

  • In the GameSettings properties, next to Default Scene, click Hand icon (Select an asset).

The Select an asset window opens.

  • Select the default scene and click OK.

For more information about scenes, see .

Graphics compositor

You can have multiple graphics compositors in your project, but you can only use one at a time.

To set the graphics compositor:

  • In the GameSettings properties, next to Graphics compositor, click Hand icon (Select an asset).

The Select an asset window opens.

  • Select the graphics compositor and click OK.

For more information, see .

Audio

Audio settings

For more details about audio, see .

Note

How Game Studio displays entities is also affected by the Color space setting under Rendering.

PropertyDescription
Rendering modeHow Game Studio renders thumbnails and Asset Previews
Animation framerateThe framerate of animations shown in Game Studio. This doesn't affect animation data.

Navigation

Navigation settings

PropertyDescription
EnabledEnable dynamic navigation on navigation components that have no assigned navigation mesh
Included collision groupsSet which collision groups dynamically-generated navigation meshes use. By default, meshes use all collision groups
Build settingsAdvanced settings for dynamically-generated navigation meshes

For more details, see Dynamic navigation.

For more details, see .

Physics

PropertyDescription
FlagsCollisionsOnly disables except for collisions. For example, if this is enabled, objects aren't moved by gravity, but will still collide if you move them manually. ContinuousCollisionDetection prevents fast-moving entities erroneously moving through other entities. Note: other flags listed here currently aren't enabled in Xenko.
Max sub stepsThe maximum number of simulations the physics engine can run in a frame to compensate for slowdown.
Fixed time stepThe length in seconds of a physics simulation frame. The default is 0.016667 (one sixtieth of a second).

Rendering

Rendering settings

PropertyDescription
Default back buffer widthThis might be overridden depending on the ratio and/or resolution of the device. On Windows, this is the window size. On Android/iOS, this is the off-screen target resolution.
Default back buffer heightThis might be overridden depending on the ratio and/or resolution of the device. On Windows, this is the window size. On Android/iOS, this is the off-screen target resolution.
Adapt back buffer to screenAdapt the ratio of the back buffer to fit the screen ratio
Default graphics profileThe graphics feature level required by the project
Color spaceThe color space (gamma or linear) used for rendering. This affects the game at runtime and how elements are displayed in Game Studio.
Display orientationThe display orientation of the game (default, portrait, left landscape, or right landscape).
Target graphics platformThe target platform Xenko builds the project for. If you set this to Default, Xenko chooses the most appropriate platform. For more information, see .
Tip

To check which default platform your project uses, add a break point to your code (eg in a script), run the project, and check the value of the variable.

Note

Currently, only textures can be streamed.

For more details, see .

Textures

Texture settings

PropertyDescription
Texture qualityThe texture quality when encoding textures. Fast uses the least CPU, but has the lowest quality. Higher settings might result in slower builds, depending on the target platform.

Overrides

You can override settings for particular platforms, graphics APIs, and so on. For example, you can set different texture qualities for different platforms.

  • With the GameSettings asset selected, in the Property Grid, under Overrides, click (Add).

Select graphics platform

Game Studio adds an override.

  • In the new override, next to Platforms, select the platforms you want the override to apply to. You can select as many as you need.

  • Optional: If you want this override to apply only to a specific GPU platform, choose it from the Specific filter drop-down list.

You can add GPU platforms to this list under Platform filters (see Add a platform filter below).

  • In the Configuration drop-down menu, select the kind of setting you want to override (Editor, Texture, Rendering or Physics).

Select graphics platform override

  • Set the options you want to override.

You can choose items in the Platform Filters list as a specific platform filter when you set an override (see above).

  • With the GameSettings asset selected, in the Property Grid, expand Platform Filters.

    The Property Grid displays a list of platform filters you can use.

List of platform filters

  • At the bottom of the list, click Add to Platform Filters.

    Game Studio adds a new empty item.

After you add a platform filter, you can select it under Override > Specific filter.

Override

Note

If the new filter isn't listed, remove the override and re-add it.

Splash screen

The splash screen is displayed when your game starts. The default is the Xenko splash screen.

Note

The splash screen is only displayed when the game is built in release mode.

PropertyDescription
TextureThe image (eg company logo) displayed as the splash screen. By default, this is XenkoDefaultSplashScreen.
ColorThe color the splash screen fades in on top of. By default, this is black (#FF000000).

For more information, see .