Configuring hidden achievements

Last updated on December 14, 2023

Overview​

AccelByte Gaming Services (AGS) includes achievement services that empower you to create hidden achievement configurations. A hidden achievement is an achievement that is not shown to the player when they are locked. They are typically kept as a secret and not revealed to the player until they are unlocked.

In this guide, you will learn how to utilize the visibility option to configure hidden achievements. Light Fantastic

Goals​

  • Provide an understanding and overview about achievement configurations.
  • Provide an understanding of how to utilize visibility options in the achievement configurations for hidden 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 (optional).

Configure hidden achievements​

To allow you to flexibly choose whether this achievement will be incremental or non-incremental, a hidden achievement is not dependent on the user statistic tracking. If you choose incremental, you can follow the guide for tracking global statistics to set up a statistic configuration to store the attribute you want to track.

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. On the Achievement page, click the Add Achievements button.

    AGS Admin Portal 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

    • Check the Incremental box for an incremental achievement, or leave the box unchecked for a non-incremental achievement. If you’re creating an incremental achievement, input the Goal Value and a Statcode of the statistic associated with this achievement.

    • For Hidden Achievement, you need to make sure the Visibility is set to Hidden

    Select Achievement Menu Visibility

    • 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.

      New achievement optional fields

  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:

Last updated on

On this page