Last Updated: 10/9/2021, 2:48:26 AM

# Season Pass

# Overview

Season Pass is a service that provides a tiered reward structure that grants special rewards to players that participate in limited-time challenges. As a player earns XP in the challenge, they will unlock tiers and get to claim rewards.

The Season Pass feature is built from three main components: Seasons, Passes, and Tiers.

  • A Season is a limited-time event that includes special challenges and rewards for players.
  • A Pass is an item that grants players access to a certain class of rewards available during a season event. Passes can be freely granted to players, or can be made available for purchase. Passes are represented by items you create, but they do not have to be actual in-game items granted to players.
  • A Tier is a level that players occupy during participation in a season event. Players can move up into new tiers by gaining XP or by purchasing access to higher tiers. Players will be granted a reward each time they clear a tier. Tiers are represented by items you create, but they do not have to be actual in-game items granted to players.

The in-game Season Pass experience will be managed by the game client, which will retrieve a season’s structured data through the SDK that can then be cached for the player.

Season passes can be managed through the AccelByte Admin Portal. You can create seasons and their associated passes and tiers, as well as associate store items to rewards that players can unlock and then claim for each pass or tier.

# Prerequisites and Permissions

# Prerequisites

# Create Season Pass Specific Items

Before you can create a Season event, make sure you make any pass or tier items you’ll need for the event in a draft store. Season pass items do not have to be in a published store to be used by a Season; in fact we recommend creating the items for them in a draft store so that you can edit or delete them easily. Of course if you want to make premium passes or tier level-ups available for purchase, those pass and tier items will need to be available in your published store. To learn how to create season pass items, see the Catalog documentation.

# Permissions

Permissions are used to grant access to specific resources within our services. Make sure your account has the following permissions before you attempt to manage season pass in the Admin Portal.

Usage Permission Tag Action
Grant XP to the Player Using the Server API ADMIN:NAMESPACE:{namespace}:USER:{userId}:SEASONPASS Update
Level a Player Up in Tier ADMIN:NAMESPACE:{namespace}:USER:*:SEASONPASS Read, Update
Unlock a Premium Pass for a Player ADMIN:NAMESPACE:{namespace}:USER:*:SEASONPASS [READ, UPDATE] Read, Update

Permissions work slightly differently depending on whether they are assigned to IAM Clients or Roles assigned to users. For more information, read the Authentication and Authorization documentation.

# Managing Seasons in the Admin Portal

# Create a Season

You can create a Season event by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. On the Season Pass page, create a new draft season by clicking the Create Season button.

    season-pass

  3. The Create New Season form appears. Fill in the required fields:

    season-pass

    • Input the Season Name.
    • Select the default language for the season in the Default Language field. After creating your season, you’ll be able to add additional languages for localization.
    • Input the date and time the season will begin in the Start Date field.
    • Input the date and time the season will end in the End Date field.
    • Choose the store that contains the tier related to this season in the Draft Store field.
    • Choose the tier that will be used for this season in the Tier Item field.
    • Input the amount of XP required to clear each tier in the Default Exp. to Clear field.
    • Select the Automatically Claim Reward option if you want players to be automatically granted the rewards they earn during the season.
  4. When you’re finished, click the Create button. The new season will be added to the list.

# Edit a Season

You can edit a Season by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to edit by opening the season’s Action menu and clicking Edit.

    season-pass

  3. The Edit Season form appears. Edit any of the fields as desired:

    season-pass

    • Change the season’s name in the Season Name field.
    • Change the default language for the season in the Default Language field.
    • Change the start date for the season in the Start Date field.
    • Change the end date for the season in the End Date field.
    • Change the store containing the tier related to the season in the Draft Store field.
    • Change the tier associated with the season in the Tier Item field.
    • Change the amount of XP needed to clear each tier in the Default Exp. to Clear field.
    • Select the Automatically Claim Reward option if you want players to be automatically granted the rewards they earn during the season.
  4. When you’re finished, click the Edit button. The season will be updated.

# Delete a Season

You can delete a Season by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to delete by opening the season’s Action menu and clicking Delete.

    season-pass

  3. A confirmation message appears. To delete the season, click the Delete button.

    season-pass

  4. When you’re finished, the season will be removed from the list.

# Clone a Season

You can clone a Season by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to clone by opening the season’s Action menu and clicking Clone.

    season-pass

  3. The Clone Season form appears. Fill in the required fields:

    season-pass

    • Input a name for the new clone in the Season Name field.
    • Input a start date for the new clone in the Start Date field.
    • Input an end date for the new clone in the End Date field.

    All other season data will be cloned from the target season.

  4. When you’re finished, click Clone. A new draft season will be created in the list.

# Add a Localization to a Season

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to add localization to and click View All in the Publishing Contents column.

    season-pass

  3. The Publishing Contents page for your season opens. To add a new localization, click the Add Language button at the top of the Localization tab.

    season-pass

  4. The Add Localization form appears. Fill in the required fields:

    season-pass

    • Select the language for the new localization in the Language field.
    • Type the localized season name in the Title field.
    • Type a localized description of the season in the Description field.
  5. When you’re finished, click Add. The localization will be added to the list.

# Delete a Localization from a Season

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to remove localization from and click View All in the Publishing Contents column.

    season-pass

  3. The Publishing Contents page for your season appears. To delete a localization, click Delete in the localization’s Action column.

    season-pass

  4. A confirmation message appears. To delete this language, click the Delete button.

    season-pass

  5. When you’re finished, the localization will be removed from the list.

# Upload a Background Image for a Season

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to add an image to and click View All in the season’s Publishing Contents column.

    season-pass

  3. The Publishing Contents page for your season appears. Open the Images tab, then click the Upload button.

    season-pass

  4. The Upload Images form appears. Click the Select Images button, select the desired image from your directory, and click Submit.

    season-pass

  5. When you are finished, the background image will be uploaded.

# Managing Passes in the Admin Portal

# Create a Pass

You can create a Pass by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to add a pass to and click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, open the Passes tab and click the Create Pass button.

    season-pass

  4. The Create New Pass form appears. Fill in the required fields:

    season-pass

    • Input unique identifier for the pass in the Pass Code field.
    • Input the position you want this pass to occupy in-game in the Display Order field. The pass with the Display Order of 1 will appear at the top of the list, 2 will appear under 1, and so on.
    • Choose the item that you want to associate with this pass in the Pass Item field.
    • Select the Automatically enrolled option if you want all players who participate in the season event to be automatically granted this pass.
    • Input the default name for the pass in the Title field.
    • Input the default description of the pass in the Description field.

    NOTE

    The Language selection is the same as the default language for the related season and cannot be changed.

  5. When you’re finished, click the Create button. The new pass will be added to the list.

# Edit Pass

You can edit a Pass by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to add a pass to and click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Passes tab and click Edit next to the pass that you want to edit.

    season-pass

  4. The Edit Pass form appears. Fill in the required fields:

    season-pass

    • Change the position of the pass in-game in the Display Order field. The pass with the Display Order of 1 will appear at the top of the list, 2 will appear under 1, and so on.
    • Change the item that is associated with the pass in the Pass Item field.
    • Select the Automatically Claim Reward option if you want all players who participate in the season event to be automatically granted this pass.
  5. When you’re finished, click the Save button. The pass will be updated.

# Delete Pass

You can delete a Pass by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to add a pass to, and click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Passes tab and click Delete next to the pass that you want to delete.

    season-pass

  4. A confirmation message appears. To delete the pass, click the Delete button.

    season-pass

  5. When you’re finished, click Delete. The pass will be removed from the list.

# Add a Localization to a Pass

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season that contains the pass you want to add a localization to, then click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Passes tab and then click View All next to the pass you want to add a localization to.

    season-pass

  4. The Publishing Contents for your pass opens. To add a new localization, click the Add Language button.

    season-pass

  5. The Add Localization form appears. Fill in the required fields:

    season-pass

    • Select the language for the new localization in the Default Language field.
    • Type the localized pass name in the Title field.
    • Type a localized description of the pass in the Description field.
  6. When you’re finished, click Add. The localization will be added to the list.

# Delete a Localization from a Pass

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season that contains the pass you want to remove a localization from, then click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Passes tab and click View All next to the pass that you want to manage.

    season-pass

  4. The Publishing Contents form appears. To delete a localization, click Delete next to that localization.

    season-pass

  5. A confirmation message appears. To delete this localization, click the Delete button.

    season-pass

  6. When you’re finished, the localization will be removed from the list.

# Upload a Background Image for a Pass

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season that contains the pass you want to upload a background image for, then click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Passes tab and click the View All next to the pass that you want to manage.

    season-pass

  4. The Publishing Contents page for your pass appears. Click the Image tab, then click the Upload button.

    season-pass

  5. The Upload Images form appears. Click the Select Images button, select the desired image from your directory, then click Submit.

    season-pass

  6. When you are finished, the background image will be uploaded.

# Create a Reward

You can create a Reward by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to add a reward to, then click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Rewards tab.

    season-pass

  4. In the Reward tab, click the Create Reward button.

    season-pass

  5. The Create New Reward form appears. Fill in the required fields:

    season-pass

    • Input a unique identifier for the code in the Reward Code field.
    • Choose the Reward Item Type. The options are Items, Coins, and Bundles. For more information about item types, see the Catalog documentation.
    • Choose the item that will be awarded to players in the Reward Item field.
    • Type the quantity of the item to be awarded to players in the Reward Item Quantity field.
    • Upload a Thumbnail image for the item.
  6. When you’re finished, click the Create button. The new Reward will be added to the list.

# Edit a Reward

You can edit a Reward by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to add a reward to, then click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Rewards tab.

    season-pass

  4. On the Reward tab, click Edit next to the reward that you want to edit.

    season-pass

  5. The Edit Reward form appears. Fill in the required fields:

    season-pass

    • Change the item type of the reward Reward Item Type. The options are Items, Coins, and Bundles. For more information about item types, see the Catalog documentation.
    • Change the item awarded to players in the Reward Item field.
    • Change the quantity of the item awarded to players in the Reward Item Quantity field.
    • Upload a new Thumbnail image for this item.

    IMPORTANT

    The reward’s Reward Code cannot be changed.

  6. When you’re finished, click the Save button. The Reward will be updated.

# Delete a Reward

You can delete a Reward by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to remove a reward from, then click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Rewards tab.

    season-pass

  4. On the Reward tab, click Delete next to the reward that you want to delete.

    season-pass

  5. A confirmation message appears. To delete this reward, click the Delete button.

    season-pass

  6. When you’re finished, the reward will be removed from the list.

# Managing Tiers in the Admin Portal

# Create a Tier

You can create a Tier by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to add a tier to, then click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Tiers tab.

    season-pass

  4. On the Tiers tab, click the Create Tier button.

    season-pass

  5. The Create New Tier form appears. Fill in the required fields:

    season-pass

    • Input the number of tiers you want this season to have in the QTY field.
    • Input the amount of XP a player needs to clear each tier in the Exp. to Clear field.
  6. When you’re finished, click the Create button. The new tiers will be added to the list.

# Edit a Tier

You can edit a Tier by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season that contains the tier you want to edit, then click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Tiers tab.

    season-pass

  4. In the Tiers tab, click Edit next to the reward that you want to edit.

    season-pass

  5. The Edit Tier form appears. Here you can change the Exp. to Clear for each tier.

    season-pass

  6. When you’re finished, click the Save button. The tier will be updated.

# Delete a Tier

You can delete a Tier by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season that contains the tier you want to delete, then click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Tiers tab.

    season-pass

  4. On the Tiers tab, click Delete next to the reward that you want to delete.

    season-pass

  5. A confirmation message appears. To delete this tier, click the Delete button.

    season-pass

  6. When you’re finished, the tier will be removed from the list.

# Associate Rewards with Passes and Tiers

You can associate rewards with each pass and tier combination by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season that contains the passes and tiers you want to associate to rewards, then click View in that season’s Action menu.

    season-pass

  3. On the Season Details page, click the Tiers tab.

    season-pass

  4. In the Tiers tab, click the View button next to a tier.

    season-pass

  5. The Tier No. 1 Configuration form appears. Fields will appear for each of the passes in this season. Fill in each field by choosing the rewards that you want to bind to that specific pass. You can select multiple rewards for a single pass.

    season-pass

  6. When you’re finished, click the Save button. The rewards will be tied to the pass in this tier.

# Publishing and Retiring Seasons in the Admin Portal

# Publish a Season

In order for a Season to start, it must be published before its start date. You can publish a draft Season by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Draft Season section, choose the draft season you want to publish, then click Publish in that season’s Action menu.

    season-pass

  3. The Publish Season form appears. To publish this season, type PUBLISH into the available field and click the Publish button.

    season-pass

  4. When you’re finished, the draft season will be published.

# Unpublish a Season

Unpublishing is a way to take a Season down temporarily to fix a problem with it, like a legal issue. Unpublishing a season will make it so that your players cannot participate further in the season event, but the data from that event will be saved. After you have fixed the problem you can publish the Season again, and because the event data was saved, players will be able to continue their progression from before the Season was unpublished. You can unpublish a Season by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Published Season section, choose the season you want to unpublish, then click Unpublish in that season’s Action menu.

    season-pass

  3. A confirmation message appears. To unpublish this season, click the Confirm button.

    season-pass

  4. When you’re finished, the current season will be unpublished.

# Retire a Season

Seasons already have end dates, upon which players will no longer be able to participate in season events, but will still be able to claim any rewards they have already earned. Retire a Season to make it so that players can no longer claim rewards or otherwise interact with the Season. You can retire a current Season by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the Game Management section of the left navigation menu and click Season Pass.

    season-pass

  2. In the Published Season section, choose the season you want to retire, then click Retire in that season’s Action menu.

    season-pass

  3. A confirmation message appears. To retire this season, click the Confirm button.

    season-pass

  4. When you’re finished, the current season will be retired.

# Managing User Advancement through Season Events in the Admin Portal

You can manually advance a user to the next tier by following the steps below:

  1. In the AccelByte Admin Portal, choose the target game namespace. Then go to the User Management section of the left navigation menu and click Users.

    season-pass

  2. Select the search filter from the dropdown menu in the Search User panel that corresponds to the player’s account information that you have on hand. Then type that information in the text box and press Enter to search. The results of your search will appear. Browse the list to find the account you’re looking for and click View in the Action column of the account listing to open it.

    season-pass

    TIP

    Fuzzy search is allowed here, so you can find the player you’re looking for by typing just the first few characters of the player’s credential that you have.

  3. The User Overview will appear, giving you a quick look at player data such as wallet balance, ban status, and linked accounts, as well as more detailed records of the player’s activity. Open the Season Pass tab from the ribbon at the top of the page.

    season-pass

  4. On the Season Pass Information page, click the View button of the selected season pass.

    season-pass

  5. On the Season Pass Details of the User page, click the Level Up button to advance the user to the next tier.

    season-pass

  6. A confirmation message appears. To advance the user to the next tier, click the Yes, Level Up button.

    season-pass

  7. When you’re finished, this user will be advanced to the next tier.

# Implementing Season Pass using SDK

# Retrieve the Current Season Pass

The game client can query the current active Season Pass to return information, such as the Item IDs of the items used as rewards, and tier progression information such as the required XP and reward passes for each tier.

# Retrieve the Current Player’s Season Pass Progression

The game client can query a player’s season data to show the player their season progression and rewards that can be claimed.

# Grant XP to the Player using the Server API

The player can be granted XP by the Server API. The game server tracks player progression during season events. If the player completes the challenges successfully, the game server will grant XP to the player.

# Level Up in Tier

Players can move up in tier in two ways: either by gaining XP in season challenges or by buying access to tiers. If a player moves up a tier from gaining XP, their tier will be leveled up automatically, their XP will be reset to 0, and any remainder from the last tier’s XP will be added back to the player’s XP. Players can also purchase access to advanced tiers..

When a player purchases access to a new tier, the tier information will have to be retrieved if it isn’t cached. This function retrieves the tier data.

TIP

This function isn’t necessary if the tier item is cached.

Then this function enables a player to purchase access to a tier.

# Unlock a Premium Pass

Players can purchase a premium pass to gain access to additional rewards from season events..

When a player purchases a premium pass, the pass information will have to be retrieved if it isn’t cached. This function retrieves the pass data.

TIP

This function isn’t necessary if the pass item is cached.

Then this function enables a player to purchase a premium pass.

# Claim a Reward

If a season wasn’t configured to grant players earned rewards automatically, the game client needs to claim the player’s reward manually. All rewards will be processed by the Fulfillment service.

# Claim All Rewards

If a player has multiple rewards available to claim, they can be claimed all at once by the game client.

  • Using Season Pass requires you to create items, or use existing items you’ve already created. For more information about items and how to create them, see the Catalog documentation.
  • Season Pass is just one way to reward players for their engagement. For more information about rewards, see the Rewards documentation.