Non-repeating lootbox rewards
What's new
A new RewardMode enum (repeating or non_repeating) is exposed as reward_mode on lootbox nested items, defaulting to repeating. Read models additionally return is_won, which is true once the player has already won a non_repeating item.
Impact
Lootbox payloads now say whether an entry can drop more than once, and whether the player has already claimed it — so clients can mark one-time rewards as collected instead of tracking that state themselves. Both fields are additive and default to the previous behavior.
Changes
| Resource | Change |
|---|---|
| get_items | Added reward_mode and is_won to lootbox nested items |
| get_all_store_items, get_store_items, create_store_item, update_store_item, bulk_update_store_items | Added reward_mode and is_won to lootbox nested items |
| get_daily_rewards, get_daily_reward, create_daily_reward, update_daily_reward, copy_daily_reward | Added reward_mode and is_won to lootbox nested items |
| Components | Added the RewardMode schema |
Upgrade
- No action required. Read
reward_modeandis_wononly if you want to surface one-time rewards differently in your UI.
Need help?
Contact our integration team at integration@aghanim.com