Configuring global achievements

Last updated on February 12, 2024

Overview​

AccelByte Gaming Services (AGS) includes a service that empowers you to create a global achievement (collective player stats to unlock a community achievement). It is similar to an incremental achievement, as the contributed value will be stored in the AccelByte statistics and only players who contributed can unlock the achievement once the target is reached.

In this guide, you will learn how to configure global achievements.

Goals​

  • Provide an understanding and overview about achievement configurations.
  • Provide an understanding on how to utilize global statistics for global achievements.

Prerequisites​

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

Configure global achievement​

Since it is similar to the incremental achievement, please make sure that you have already set up a global statistic configuration. You can follow the guide for tracking global statistics to set up a global statistic configuration.

Once the global statistic configuration is set up, you can use that to create the global achievement. You can set up an achievement configuration from the AGS Admin Portal by following the steps below:

  1. In the admin Portal, go to the Game Management section and select the Achievement menu.

    AGS Admin Portal click Achievement Menu

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

    AGS Admin Portal Achievement Menu click add achievements

  3. The Add New Achievements form will appear and you will be required to:

    • Fill in the Code field with information in the allowed format (e.g., hero-collector), as well as the achievement Name to make it easier for you to identify the achievement in the future. You are also required to fill in the Description to provide extra information about the achievement you created.

    Add new achievements form

    • For Global Achievement, you need to set Set as Global as active. Also, since it is similar to incremental achievements that stored contributed values in the AccelByte Statistics service, you need to make sure Incremental is set to active.

    Incremental set as global active

    • You are also required to input the Goal Value and a Statcode of the global statistic associated with this achievement.
    info

    The Goal Value should not exceed the Max. Value defined in the Statistic configuration.

    Statcode and Goal Value fields

    • You are also required to add an image for the Locked Icon. This will be displayed for players who do not have this achievement yet.
    • Add 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.

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

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