Set up challenges - Challenge - (Unity module)

Last updated on July 28, 2025

Overview

You can configure challenge goals and their requirements in the Admin Portal. The goal requirements can vary, from events such as registering a new account to values such as player statistics.

In this tutorial, you will configure challenges using statistics defined in the Stat tracking module as the goal requirements, and configure currencies as the reward items.

Configure reward items in the Admin Portal

In this section, you will learn how to configure currencies and store items to be used as challenge item rewards.

1. First, you need to configure currencies in the Admin Portal. You can follow the Manage real and virtual currencies guide. Go ahead and create several currencies, for example, BG for Byte Gems and BC for Byte Coins.

2. Next, you need to create store items. You can follow the Create store items guide. Go ahead and create Coin-type items for the currencies you created earlier—for example, 1 Byte Gem and 1 Byte Coin.

3. Then, make sure to publish the store so your items are live. You can follow the Publish a store guide.

Configure statistics cycle in the Admin Portal

For periodic challenges, you need periodic statistics. Therefore, you must configure the statistics cycles first in the Admin Portal. In this section, you will create daily and weekly statistics cycles.

1. Log in to the Admin Portal and go to your game namespace dashboard.

2. Navigate to Progression & Inventory > Statistics > Cycles, then click Add Cycle.

3. Fill out the required fields. Let's start by creating a daily cycle using the configuration below:

   • Cycle Name: The name of your statistics cycle. Set it to unity-daily.
   • Cycle Description: The description of your statistics cycle. Set it to Unity Daily Statistics Cycle.
   • Start Date: The date when this cycle starts. Set it to the current date.
   • End Date: Leave this empty to make the cycle valid indefinitely.
   • Cycle Type: Set it to Daily.
   • Reset Time: The time when the cycle resets. Set it to 00:00, so it resets at the beginning of each day.

4. Click Add, and you will see your new statistics cycle listed.

5. Next, add your statistics to the new statistics cycle. From the statistics cycle list, click the new cycle name to open its details.

6. Scroll down until you see the Statcode List table. This table lists the statistics managed by the cycle. Click the Stat Code button to add your statistics.

7. In the pop-up window, add all the statistics you created in the Stat Tracking module. Once done, click Add.

8. Now you’ve set up the daily statistics cycle. Next, repeat the step 2-7 to configure the weekly cycle using the following configuration:

   • Cycle Name: Set it to unity-weekly
   • Cycle Description: Set it to Unity Weekly Statistics Cycle
   • Start Date: Set it to the current date.
   • End Date: Leave it empty to make the cycle valid indefinitely.
   • Cycle Type: Set it to Weekly
   • Reset Day: Set it to Monday
   • Reset Time: Set it to 00:00

9. Congratulations! You have successfully configured both daily and weekly statistics cycles in the Admin Portal.

Configure challenges in the Admin Portal

In this section, you will configure challenges and its goals, requirements, and rewards using the statistics and reward configurations you've created in the previous section.

Sample challenge configuration values

In this section, you will configure challenges and their goals, requirements, and rewards using the statistics and reward configurations you created in the previous section.

• All Time Challenge

  Field	Value
  Challenge Name	Unity All Time
  Challenge Code	unity-alltime
  Rotation Type	None
  Goals Name	Reach 4000 High Score in Any Game Mode
  Goal Code	highestscore-4000-anygamemode-alltime

  • Goal Requirement Groups

    Group	Requirement	Stat Code	Operator	Amount
    1	Statistic Code	unity-highestscore-singleplayer	Greater Than or Equal to	4000
    2	Statistic Code	unity-highestscore-elimination	Greater Than or Equal to	4000
    3	Statistic Code	unity-highestscore-teamdeathmatch	Greater Than or Equal to	4000

  • Rewards

    Reward Type	Item Name	Amount
    Entitlement	1 Byte Gem	100

• Daily Challenge

  Field	Value
  Challenge Name	Unity Daily
  Challenge Code	unity-daily
  Rotation Type	Daily
  Assignment Rule	Unscheduled
  Goals Name	Reach 1000 High Score in Any Game Mode
  Goal Code	highestscore-1000-anygamemode-daily

  • Goal Requirement Groups

    Group	Requirement	Stat Code	Cycle Name	Operator	Amount
    1	Statistic Code and Cycle	unity-highestscore-singleplayer	unity-daily	Greater Than or Equal to	1000
    2	Statistic Code and Cycle	unity-highestscore-elimination	unity-daily	Greater Than or Equal to	1000
    3	Statistic Code and Cycle	unity-highestscore-teamdeathmatch	unity-daily	Greater Than or Equal to	1000

  • Rewards

    Reward Type	Item Name	Amount
    Entitlement	1 Byte Coin	2000

• Weekly Challenge

  Field	Value
  Challenge Name	Unity Weekly
  Challenge Code	unity-weekly
  Rotation Type	Weekly
  Assignment Rule	Unscheduled
  Goals Name	Reach 2000 High Score in Any Game Mode
  Goal Code	highestscore-2000-anygamemode-weekly

  • Goal Requirement Groups

    Group	Requirement	Stat Code	Cycle Name	Operator	Amount
    1	Statistic Code and Cycle	unity-highestscore-singleplayer	unity-weekly	Greater Than or Equal to	2000
    2	Statistic Code and Cycle	unity-highestscore-elimination	unity-weekly	Greater Than or Equal to	2000
    3	Statistic Code and Cycle	unity-highestscore-teamdeathmatch	unity-weekly	Greater Than or Equal to	2000

  • Rewards

    Reward Type	Item Name	Amount
    Entitlement	1 Byte Coin	6000

Configuration challenges and goals

Now, let’s use the sample configuration values from the previous section to set up challenges in the Admin Portal.

1. Log in to the Admin Portal and go to your game namespace dashboard.

2. Navigate to Engagement > Challenges > Configurations, then click Create Challenge.

3. In the new menu, under the Challenge Configuration tab, refer to the example values provided earlier to fill out the following fields:

   • Challenge Name: The name of the challenge.
   • Challenge Code: The unique identifier for the challenge.
   • Start Date: The date when the challenge starts. Set it to the current time.
   • End Date: The date when the challenge ends. You can set it to any time or choose Never.
   • Rotation Type: The challenge rotation/period. Options include None, Daily, Weekly, and Monthly.
   • Reset Time: The time when the challenge rotation/period resets.
   • Assignment Rule: How goals are assigned for each rotation. You can set it to Fixed, Randomized, Always Display All (Unscheduled), or Custom.

4. In the Goals and Rewards tab, add new challenge goals by clicking the Create Goals button. Use the example values provided earlier to complete the fields:

   • Goal Name: The name of the goal.
   • Goal Code: The unique identifier for the goal.
   • Status: Whether the goal is enabled for the challenge.
   • Description: A brief explanation of the goal.
   • Requirements: The conditions required to complete the goal. Requirements can be grouped using Groups. Each requirement in a single group must be fulfilled to complete that group. If you have multiple groups, each one functions independently. There are two ways to organize requirements:
     • OR: If the goal can be completed by fulfilling any one of the groups, add multiple groups using the Add Group button.
     • AND: If the goal requires all listed requirements, use a single group and add multiple requirements using the Add Requirement button.
   • Rewards: The rewards granted upon completing the goal.

5. Make sure to configure all of the challenges, goals, requirements, and rewards using the example values provided earlier by repeating the step 2-4.