How challenges work on XBOX devices
Challenges are achievements available only during a specified period of time. For example, you might want to create an achievement available only on three consecutive days that begin and end at midnight. Because of the time limitation, this achievement would be considered a challenge. Like achievements, challenges can be either visible (in the list of possible achievements) or hidden.Configure a challenge
Sign in with your account on [Partner Center](https://developer.microsoft.com...
Select your title, and then go to **Services** > **XBOX Live**.
Select the link to the **Challenges** page.
On **Challenges**, create and manage the challenges for your title.
Create a challenge
On the **Challenges** page, select the **New challenge** button.
In the **Challenge name** field, provide the name to be shown to players.
In the **Locked description** field, provide the description to be shown to p...
In the **Image icon** field, provide the achievement icon that will serve as ...
- In the Promo icon field, specify the promotional icon. It must be 424 x 424 pixels in size and formatted as 1:1 PNG. While developing your title, you can select use placeholder image to use a default XBOX icon until your final art is ready to replace it.
- Under Time frame, specify the Start time and End time of the challenge. The challenge can only be unlocked during the period of time specified here. The end date can’t be later than three months after the start date. Note that times are based on Greenwich Mean Time (GMT).
- Under How should the details be treated?, select from the following options.
- Public
Indicates that the challenge and its details are visible to all players. - Secret Indicates that the challenge and its details are visible only to players who have unlocked the challenge. This is useful for avoiding plot spoilers and rewarding players for experimenting.
- Public
- Optional: In the Challenge deep link field, specify the in-game location where players will be redirected to attempt this challenge immediately. For example, in
ms-xbl-11aa99ff://default?trackId=18,11aa99ffis the TitleId anddefault?trackId=18is the code that your game will understand and use to redirect players to the particular location in the game. - To grant an additional reward (art or in-game) for unlocking the achievement, do the following:
- Select the Add reward button.
- On the Achievement rewards page, select Art or In-game.
- In the Display name field, provide the reward’s name to be shown to players.
- In the Description field, provide the reward’s description to be shown to players. The description can’t be longer than 90 characters. Include details such as the reward’s duration (if applicable) and instructions for redeeming the reward.
- Perform the following according to the reward type you selected:
- If you selected the reward type Art, then use the Art field to specify the art reward that the player will get upon unlocking the challenge. The reward must be 1920 x 1080 pixels in size and formatted as a PNG file. While developing your title, you can select use placeholder image to use a default XBOX image until your final art is ready to replace it.
- If you selected the reward type In-game, then
- Use the Image field to specify an image that represents the reward that the player will get upon unlocking the challenge. While developing your title, you can select use placeholder image to use a default XBOX image until your final art is ready to replace it.
- Use the In-game value to specify a value or code passed to your game. Ensure that your game can use this code to unlock a reward.
- Select Add to add the reward to the challenge or select Cancel to cancel and return to the New challenge page.
- Select an Unlock logic that will determine how a challenge will be unlocked.
- Do something with incremental progress
Select a single player stat. When the player stat meets the specified criteria, the challenge will be unlocked. Players will be able to see their progress toward unlocking of the challenge. To meet the criteria, a stat must be equal to or greater than the specified value. This doesn’t apply to a stat configured with the min operator. Such a stat must be less than or equal to the specified value. - Do multiple things, cumulatively
Select multiple player stats configured with the sum operator. When all the player stats you selected meet the specified criteria, the challenge will be unlocked. - Min/max one of several things
Select multiple player stats that have been configured with the max or min operator. When at least one player stat requirement is met, the challenge will be unlocked. - Do something once
Select a player stat. When its instance is created as a result of triggering of a stat rule, the challenge will be unlocked. - Custom logic
To create a complex condition for unlocking the challenge, select the Add stat button and add a stat condition to the current condition. To add a new condition clause, select the Add condition button.- All stats in a single condition clause must be of the same operator type and must meet the same criteria for satisfying the condition.
- If the stats use the min or max operator, the clause uses the OR logic to meet the condition.
- If the stats use the sum operator, the clause uses the AND logic to meet the condition. When all conditions are met, the challenge will be unlocked.
- Do something with incremental progress
- Select Save to save the challenge or select Cancel to cancel and return to the Challenges page.
Change an existing achievement or challenge rule
- In the list of challenges on the Challenges page, select the Name for the challenge you want to change. This will open a page whose title is the name of the challenge.
- Make the changes to the challenge.
- Select Save to save the challenge or select Cancel to cancel and return to the Challenges page.
Delete a challenge
- In the list of challenges on the Achievements page, select Delete next to the challenge you want to remove.
- In the Confirmation dialog, select Delete to confirm the deletion; otherwise, select Cancel.
