Battle Pass¶
Battle Pass is a compelling game mechanic that rewards players as they progress through various levels or challenges. Commonly seen in games like "Brawl Stars" or "Royal Match," it incentivizes continued play and often includes both free and premium reward tracks.

Built-in Battle Pass Template¶
As a part of LiveOps package, Balancy provides built-in template for creating battle or season pass types of LiveOps events.
Battle Pass Config¶
Battle Pass config is a document with complex structure which had dedicated UI for convenient working with its settings. It defines progression requirements, levels, and reward lines.
- Reward Tracks: Different tracks (e.g., Free Track, Premium Track) with rewards for each level
- Progression System: Score-based advancement through levels
- Reward Status: Tracks what rewards are available, claimed, or locked

There can be as many Battle Pass configs as you may need.
There can be as many reward tracks as you may need inside one Battle Pass. Each reward track can be locked by its own individual Access Item. Player must have required Access Item in the Inventory to unlock claming rewards from the respective track.
There can be as many levels as you may need. Level progression is common for all tracks and uses specific Progression Item for counter. This specified item will be stored in Player's Inventory. There are 3 options for its logic:
- Collect - Level progress is incremented when new Progression Item is being put into the Inventory. After that it doesn't matter how many of them player owns.
- Spend - Level progress is incremented when existing Progression Item is being removed from the Inventory. After that it doesn't matter how many of them player still owns.
- Own - Level progress is synchronized with the amount of Progression Items player currently has in the Inventory.
Only one type of Item with its amount can be put as reward for a particular level. If you need to give more than one item, you must consider creating chest-like system, which will be able to store any amount of item, inheriting it from built-in Item base template, and the use such a chest as a reward.
Battle Pass Game Event¶
To activate Battle Pass, use built-in Battle Pass Game Event. It has parameter Battle Pass Config, where you can assign your config document to.

Select Battle Pass Event type when creating new Game Event from Dashboard.

You can change template type of regular Game Event to Battle Pass Event later via context menu.

Integration¶
- Subscribe to Balancy Callbacks to get live notifications about Battle Passes.
- Learn how to work with Battle Passes via code here.