Create a build configuration

Note: The content on this page pertains to Game Server Hosting (Multiplay) available on the Unity Dashboard. If you’re using Game Server Hosting (Clanforge), see the Game Server Hosting (Clanforge) documentation.

The embedded Game Server Hosting setup guide walks you through creating your first build configuration. However, you can always add more build configurations by following these instructions.

  1. Go to the Unity Dashboard > Multiplayer > Multiplay.
  2. Select Build Configurations > Create build configuration.
  3. Set the build configuration details.
  4. Define any configuration variables.
  5. Define the usage setting.

Note: You can create up to 200 build configurations.

Set the build configuration details

The first step is to name the build configuration, link it to a specific build, and define any additional details about the build configuration.

  1. Give the new build configuration a name.
  2. Select the Build you want to link to this build configuration.
  3. Select the Game server executable location within the selected build.
  4. Select the Query type the build supports. See server query protocols to learn more.
  5. You also have an opportunity to change the default launch parameters by selecting Custom launch parameters. When enabled, you can edit the default launch parameters or add custom launch parameters.
  6. After you’ve filled out all the fields, select Next.

Define any configuration variables

The next step is to add configuration variables. Add each configuration variable you want to track in this build configuration, then select Next.

If you’re unsure or don’t want to track any additional parameters here, you can continue to the next step without making any changes.

Define the usage settings

After setting the configuration variables, define the usage settings for this build configuration. The usage settings defined in a build configuration tell Game Server Hosting how many resources each server can access when running this build using this build configuration.

You can use the Default usage settings, which should work for most use cases, or you can define Custom usage settings.

To use the default usage settings:

  1. Review the default settings, then select Finish.

To configure custom usage settings:

  1. Define the CPU speed. The CPU speed is measured in frequency and defines the amount of CPU frequency each server can access in megahertz (MHz).
  2. Define the Memory. The memory is measured in megabytes (MB) and defines the amount of RAM (random access memory) each server can access.

After defining the usage setting values, select Finish. You can add this build configuration to a fleet to start spinning up servers.

Note: See Calculate usage settings to learn how to calculate usage settings.