Lootbox pity settings replaced by per-player mechanics
What's new
Public lootbox settings no longer carry the pity object. Pity is now reported through the mechanics array introduced on 2026.08.06, and that array has moved up one level: it sits on the lootbox itself rather than only inside lootbox_settings.
The two arrays hold the same HardPityMechanicRead entries but answer different questions. The one on lootbox_settings describes what is configured for the lootbox; the new one on the lootbox reports the mechanics active for the player the response was fetched for, and is empty when none apply.
Impact
Public lootboxes are embedded in daily reward responses, so this affects the nested lootbox objects returned by the daily reward endpoints. A client reading lootbox_settings.pity gets nothing back and must read mechanics instead. The replacement is more useful than the field it removes: pity published the raw ladder of configured steps, while the hard_pity entry in mechanics reports the step in play — threshold, the player's opens_count toward it, and the guaranteed_groups awarded when it is hit.
Changes
| Resource | Change |
|---|---|
| get_daily_rewards, get_daily_reward, create_daily_reward, update_daily_reward, copy_daily_reward | Removed pity from the lootbox_settings of nested public lootboxes, in both daily_rewards and extra_reward_items |
| get_daily_rewards, get_daily_reward, create_daily_reward, update_daily_reward, copy_daily_reward | Added mechanics to the nested public lootbox object itself, listing the mechanics active for the player |
| Components | PublicLootboxSettings dropped its pity property; PitySettings is now referenced only by the internal LootboxSettings schema |
Upgrade
- Replace reads of
lootbox_settings.pitywith thehard_pityentry ofmechanicson the lootbox. Where you previously walkedpity.stepsto find the next threshold, readthresholdandguaranteed_groupsdirectly, and compareopens_countagainstthresholdfor progress. - Treat a missing or empty
mechanicsarray as "no pity on this lootbox" — the same meaning an absentpityobject had.
Need help?
Contact our integration team at integration@aghanim.com