Configure Sets (Service Configuration)

This topic provides procedures for adding and changing sets in the service configuration for a title.

For an overall introduction to the various elements of the service configuration, see Introducing Service Configuration.

Sections in this topic:

What is a set?

An optional component of your Rich Presence strings. Sets are a group of key value pairs that will eventually be associated with an instance of a statistic in your Rich Presence. Based on the value of that instance, your Rich Presence string is dynamically updated with the the appropriate set member’s value (you decide the spot when you configure your Rich Presence strings). The great benefit of Sets is you don’t have to keep setting your Rich Presence if only the Set Value is changing-you get that for free.

Create a set

Sets are a group of key value pairs that will be associated with a statistic instance in your Rich Presence. For example, suppose you are using a Rich Presence string, “Playing in {0}.” {0} in this case, is the level the player is currently in and will be plugged in via a set. If you’re going to be using a statistic called “CurrentLevel” to track what level the player is in, you’ll need a set of level names to go with “CurrentLevel.”

To create a set

  1. On the Service Configuration Tasks page for the product instance, or from the left-hand menu, click Sets.
  2. On the Sets page, click New under Sets to display the Add New Set dialog box.
  3. In the dialog box, in the Set Name field, specify the set name. The set name must either start with a capital letter or digit and contain only letters, numbers, and underscores. You will eventually associate the set with a statistic instance, so we recommend to name the set as similar as possible to the statistic instance. For our example, we name the set “CurrentLevel.”
  4. Click the Add Set button to create the set.
  5. Click the newly created set so you can add members to it.

    Important Ensure that the set is selected (highlighted) before you continue.

  6. Under Members, click New.
  7. In the Add New Set Member dialog box, specify the values that you want in the following fields.
    • Member Name - A value of the statistic instance that is associated with the set. For our example, the first level of the game is represented as “Level1” in the statistic. So, we use “Level1” for the member name. Now, in our Rich Presence string, whenever the statistic equals “Level1,” the Rich Presence string will pick this member of the set.
    • Display Name - The default string that will show up as part of your Rich Presence, whenever the statistic equals the value specified in Member Name.
  8. When you have all of the fields and values for your new set member the way that you want them, click Add Set Member to create the set member and close the dialog box.

Your new member is now listed on the Sets page whenever its set is selected.

You can add multiple members to a set. Continue to add members as necessary.

Note Any localization for the set will take place in the Localized String section of your service configuration.

Change a set

Important

After a title passes Final Certification, existing sets in that title can no longer be changed or deleted.

To make changes to an existing set:

  1. On the Sets page, click the Edit icon for the set or member of the set that you want to make changes to.
  2. In the Edit Set or Edit Set Member dialog box, make the changes that you want.
  3. When all of the options are the way that you want them, click Save Set or Save Set Member, and then click the Close button in the upper-right corner of the dialog box.

Delete a set

Important

After a title passes Final Certification, existing sets in that title can no longer be changed or deleted.

To delete an existing set:

  1. On the Sets page, click the Delete icon for the set or member of the set that you want to delete.
  2. In the Delete Set or Delete Set Member dialog box, confirm the deletion by clicking Delete Set or Delete Set Member.

    Important Deletion of a set or set member is a permanent action and can’t be undone or reversed.