📋1.2.0

Changelog for xBattlepass 1.2.0 (Sep 03, 2025)

💪 Major Changes

• Players who claimed free rewards can now go back and claim premium rewards once they obtain a premium pass

🖼️ GUI Changes

• Added two new tier options in config.yml:

  • unlocked-free - When only the free reward is available to claim

  • premium-required - When free rewards are claimed but there is a locked premium reward

• Added three new reward format options in config.yml:

  • missing-premium-rewards-format

  • claimed-free-rewards-format

  • claimed-premium-rewards-format

---

🗨️ Lang Changes

• Added new lang.yml entries for free and premium pass type

---

• Added:

  • %max_tiers% - The maximum number of tiers within the battlepass

  • %pass_type% - The type of battlepass (Free or Premium)

  • %start_date% - The start date of the battlepass

  • %end_date% - The end date of the battlepass

---

🌐 External Placeholders

• Added:

  • %<id>_max_tiers% - The maximum number of tiers within the battlepass

  • %<id>_max_tiers_numeral% - The maximum number of tiers within the battlepass (in numerals)

  • %<id>_pass_type% - The type of battlepass (Free or Premium)

---

🧰 API Changes

• Added new PlayerPostRewardEvent

• Renamed PlayerRewardEvent ➝ PlayerPreRewardEvent

• Added ReceivedTierStates:

  • RECEIVED

  • RECEIVED_FREE

  • NOT_RECEIVED

---

🐛 Fixes

• Reward claim message will no longer send if reward conditions are not met

• Fixed %player% not working in player heads

• Fixed some rewards having inconsistent formatting or wrong item IDs