Create and configure challenges

Last updated on October 14, 2026

Overview​

You can set up multiple challenges in the AccelByte Gaming Services (AGS) Admin Portal and control when they become active and how they're assigned to players.

This article walks you through how to create and configure a challenge in the AGS Admin Portal or with the AGS CLI, including its basic information, its active period and rotation cycles, goals, and rewards.

Prerequisites​

  • Access to the AGS Admin Portal.
  • A publisher or a game namespace.
  • Access to AccelByte Challenge service API documentation.
  • An understanding of the key concepts of the Challenge service. See Introduction to Challenges.
  • To follow the AGS CLI steps, you must have installed the AGS CLI and signed in with an account that has access to these features. See Install and sign in. The examples use a Bash shell.

View challenges​

  1. In the AGS Admin Portal, go to Engagement > Challenges. The Challenge page appears.

  2. From the list of challenges, find and click on the challenge you want to view or edit. The details page of the challenge appears.

Create a challenge​

  1. On the Challenge page, click on the + Create Challenge button at the top-right hand side of the page.

  2. In the Basic Information section, fill in the required information:

    • Basic Information

      • Challenge Name: type in a name for the challenge. This will be name of the challenge visible to your players in-game.
      • Challenge Code: create a code to identify the challenge.
      • Description: (optional) provide a description for the challenge.

    • Period

      • Start Date: set the start date and time of the challenge. You also have the option to set this to any of the following:
        • Never: the challenge will always be active and the player can complete goals at any time.
        • After: the challenge will be inactive after several periods of rotation.
      • Goals Rotation: set how the goals in the challenge will be rotated. The available options are: None, Daily, Weekly, and Monthly. For more information about these rotation options, see Goals rotation. After you configure this option, the Goals Assignment section will appear below it.

    • Goals Assignment

      • Assignment Rule: set how the goals will be assigned to players.
        • Fixed assignment: you will have to manually select which goals to assign to players in each period of rotation or cycle. You can select the time period for each goal when you create or edit goals in a challenge. See Create goals and rewards.
        • Randomized assignment: you will allow the service to randomly select which goals to assign to players in each period of rotation or cycle. For example, you've created 33 goals in a challenge and you want the Challenge service to randomly select three goals to assign to players each week.
        • Unscheduled: all goals in the challenge will be accessible to players for them to start and complete at any time during the challenge period.
      • Goals Visibility For Players: configure the visibility settings of the challenge to players.
        • Goals visible in all rotations: players can see all available goals across the rotations period.
        • Goals visible only in active rotation: players can only see available goals during active (current) rotation only.
      • Total Goals For Each Rotation: set the number of goals that will be assigned to players for the specified time period. These goals will be accessible and achievable by players within the designated period. This configuration only takes effect under the Randomized assignment rule.

  3. Click Next to go to the Goals and Rewards section. At this point, the challenge is created and added to the Challenge list with an INIT (initializing) status. You can then start adding goals to the challenge. Proceed to Create goals and rewards.

Create goals and rewards​

note

Each Challenge configuration can support a maximum of 100 Goal configurations.

  1. In the Goals and Rewards section, click on the +Create Goals button. The Create Goals form appears.

  2. On the Create Goals form, fill in the required information:

    • Goal Name: type in a name for the goal.
    • Goal Code: type in a code to identify the goal.
    • Description: provide a description for the goal.
    • Tags: create or select tags for the goal. Tags help you group and filters goals in challenges.
    • Status: enable or disable the goal. You can change the status as needed later on.
    • Requirements: add requirements for your goal. Requirements in a goal refer to what players have to complete in order to accomplish the goal. You can create combinations of requirements for a single goal using OR or AND logic. For more information about supported requirements, see Supported requirements for challenge goals.
    note

    Depending on your selected requirement, you may be required to specify parameters or conditions. For example:

    • Account Linked requires you to select a third-party app to link to the account, which depends on the enabled third-party login methods in the namespace. To learn more about third-party login methods, see Authentication.
    • Statistics requires you to add the goal value and code of the statistic that's available in the namespace. To learn more about statistics, see Statistics.
    • Achievement requires you to add the code of your preferred achievements that are available in the namespace. To learn more about achievements, see Achievements.

  3. In the Rewards section, add the Rewards you want to grant to a player after they meet the requirements. The available options are:

    • Entitlement: select this to reward items.
    • Statistics: select this to reward statistics.

  4. Click Save. The goal will be added to the Goals and Rewards list of the challenge. Repeat steps 4 to 7 to create more goals and rewards.

  5. After creating goals and rewards for the challenge, click Save.

The challenge and its goals will go live and assigned to players based on the active rotation and assignment rules you have set.

Edit or delete a challenge​

  1. On the Challenge page, find and click on the challenge you want to edit or delete. The details page of the challenge appears.

  2. At the top-right of the details page, do the following:

    • To edit the challenge, click Edit. The Edit Challenge form appears. To learn how to configure the challenge or its goals, see step 2 of the Create a challenge section and the Create goals and rewards.
    • To delete the challenge, click Delete and again on the pop-up to confirm the deletion. The challenge is deleted from the namespace.
Last updated on
On this page