Configuring progressive achievements

Last updated on February 12, 2024

Overview​

AccelByte Gaming Services (AGS) features an achievement service that empowers you to have progressive achievements within your game. By using a single tracking attribute and creating a set of achievements, it allows players to unlock or achieve certain goals through incremental or cumulative actions. Progressive achievements provide a sense of accomplishment by breaking down larger objectives into smaller, more-achievable goals.

in-game progressive achievement example

In this guide, you will learn how to configure progressive achievements by utilizing incremental achievement configuration.

Goals​

  • To provide an understanding and overview about achievement configurations.
  • To provide an understanding on how to utilize single tracking attributes to unlock multiple achievements.

Prerequisites​

  • Access to the AGS Admin Portal.
  • Access to AGS Achievement API documentation.
  • Access to AGS Statistics API to configure the required information.

Progressive achievement configuration​

Before configuring the progressive achievements, you need to define the attribute that you want to use. The attribute can be stored in user statistic. You can follow the guide on tracking game-wide global statistics to configure user statistics. Examples of attributes you can store include number of wins, experience points, and many others.

Once the statistics configuration is set up, you can use it to create the progressive achievements.

Progressive achievements utilize incremental achievement configuration. Each configuration will only have a single goal value to achieve so that you need to configure multiple incremental achievement configurations with the single tracking attributes and different goal values.

Here are some examples of single tracking attributes to unlock multiple achievements configuration:

StatCodeNameAchievement CodeDescriptionGoal Value
totalwinsNewbienewbieWin 100 match100
totalwinsRising StarrisingstarWin 500 match500
totalwinsBecome A LegendlegendWin 2500 match2500

Use the following steps to set up a progressive achievement configuration from the Admin Portal.

  1. Go to the Game Management section and select the Achievement menu.

    navigate to achievements in AGS admin portal

  2. In the Achievement window, click the Add Achievement button.

    click add achievement button

  3. The Add New Achievement form will appear. Fill the Code with the allowed format, and also the achievement Name.

    add new achievement form

    • For Progressive Achievements, select Incremental. You will be required to input the Goal Value and a StatCode of the statistic associated with this achievement.
    note

    The Goal Value should not exceed the max value. The max value is defined in the statistic configuration.

    new achievement settings part 1

    • Fill in a Description. Then, select a Locked Icon that will be displayed for players who do not have this achievement yet, and an Unlocked Icon which will display when the achievement is unlocked

    • There are also optional fields that you can use such as Tags and Custom Attributes to store additional information for your achievement if needed.

    new achievement settings part 2

  4. Click Add to complete. Your new configuration will be added to the list.

  5. Repeat the process until you have all of the achievement configurations for all of the Goal Values that you designed are set up.

Further Reading​

After you set up the achievement configurations, you can use it to integrate with your game. You can follow the documentation below:

Achievement service is also able to cover some other use cases other than progressive achievement. Please find the other documentation below to explore other use cases:

Last updated on

On this page