MicrosoftGame.config Element - MSAAppId
Specifies the Titles MSA App ID, which is used with Xbox Live Title ID (as follows) for identity with Xbox Live services. As of the March 2022 GDK, the MSA App Id is now required for new titles if the TitleId element is specified. This requirement is enforced by a MicrosoftGame.config schema version update (from configVersion 0 to configVersion 1) that only applies to new titles created with the March 2022 GDK and beyond.
Parent
This element's parent is the Game element.
Requirement
If configVersion = 0 in the MicrosoftGame.config, this element is optional and is not required to be set. If configVersion = 1 in the MicrosoftGame.config, this element is required to be set when:
- A TitleId element is specified.
- A NoCodePCRoot element is specified.
- The AdvancedUserModel element is set to the value of false.
Platform
This element pertains to PC and Console.
Behavior
- No attributes.
- No default value.
- Allowed value is any non-empty string.
Remarks
- Value for MSAAppId is typically a 16 character string of integers.
- The MSAAppId element is your Identity ID that is generated from Partner Center. This can be found in the Xbox services -> Xbox Settings tab in your Partner Center project.
- The MSAAppId element, in your MicrosoftGame.config, must match the value in Partner Center. The MicrosoftGame.config Editor provides a tool, called the Store Association Wizard, which will automatically sync the local .config values for MSAAppId (and other Id values) with what is present in Partner Center for your product.
- The MSAAppId element behaves differently if your title is using game binding. Please refer to the Game Binding Overview for more information.
- The Visual Studio new project template will provide a default value of 'PleaseChangeMe' for this element. This value allows for early iteration of getting your title compiling without having to immediately acquire the Id from Partner Center. It is strongly recommended to change this Id as soon as you get your title building to avoid failures when attempting to do XUser API calls.