Skip to main content

Seasons Life Cycle

Seasons allow you to customize players’ in game experience with limited time events. These events allow for more frequent content updates with the opportunity to tie in with Progression to earn unique in-game customizations.

Creating a Season in the Developer Console

Seasons are specific to games. To create a season, open a game on the Developer Console and navigate to the Seasons tab.

No seasons display

  1. Click on the Create Season button to create a new season.
  2. Fill in the information in the season creation modal, including the season start and end dates.
    note

    These dates are in the UTC timezone, and a season can only start on the hour. The earliest a season can start is the next hour. A color can be picked to help identify the season easily; this color will not be displayed to players.

  3. If you need to add additional Seasons click on the + New Season button after creating your first season.

Season creation modal

When the season has been successfully created, it will show up in the list of upcoming seasons. Click on Upcoming Seasons to expand the list and see the season that was just created. Click on a season to open season details.

Seasons list with the newly-created season

Modifying a Season

On the season’s details page, click on the season name or scheduled time to modify the season. Alternatively, click on the ellipses next to the All Seasons button and select Edit.

Season details header

This will open an edit modal where the season’s name, color, and duration can be modified.

note

If a season has already started, its start time can no longer be changed. If a season has already ended, both its start and end times cannot be changed.

If a season is currently active in production (denoted by the Active in Prod) chip, changes will only be visible in the sandbox environment until the Sync button is clicked. This will sync the changes to production. Changes to upcoming seasons will be synced to production automatically.

An active season can be paused using the Pause button. This means that the season will not show up in API requests, and players will not see the season. This allows a deployed season to be quickly taken down in case there are any issues.

note

A paused season will still take up its time slot, so no other seasons can overlap with its start and end times. To unpause a season, click on the Re-start button on the season details page.

Season unpause

Deleting a Season

Any upcoming seasons can be deleted by clicking on the ellipses on the season details page. If a season has already started, or has ended, it can no longer be deleted.

Deleting a season

Time Overrides and Testing in Sandbox

Seasons can be tested in the sandbox environment using time overrides. Time overrides sets a simulated time, which affects the API response that the game receives in the sandbox environment. Time overrides are useful for previewing your application at specific times, to observe scheduled seasons.

To access time overrides, navigate to the Sandbox tab on the seasons page.

Sandbox tab with time overrides

By default, sandbox time is synced to production time. Untoggle the Sync date with Prod to allow time overrides. The “Sandbox Date: date” text left of the toggle will turn blue now, clicking on it will open the time overrides modal.

Time overrides modal

The sandbox date can be set between the beginning of the current hour to any time in the future. Clicking on Save will set the time override in the sandbox environment. Clicking on Sync with Live will reset the time override to the real date and time.

If you set the time override to the start time of an upcoming season, that season will be shown as the active season, and should be visible in-game if it’s configured to use the sandbox environment. This does not affect the production environment.

note

This is for in-game preview only, any past seasons will still not be editable. The season details page always displays controls and statuses based on real time instead of sandbox time.

Seasons API

Please refer to the Seasons API document.

Seasons with Entry Points

Please refer to instructions for using seasons with entry points.