Hard pity mechanics on lootbox settings

What's new

Public lootbox settings carry an optional mechanics array describing the mechanics configured for a lootbox. The one type available today is hard_pity, which reports opens_count (opens accumulated in the current pity step), threshold (opens required to reach the next guaranteed prize), and guaranteed_groups — the groups and nested items guaranteed once the threshold is hit.

Impact

Daily reward responses that embed a lootbox now signal whether a pity mechanic is attached to it, so a hub or client can show a "guaranteed in N opens" hint instead of treating every lootbox as pure chance. On these endpoints the array mainly reports that the mechanic exists; the per-player opens_count progress is only meaningful where the lootbox itself is fetched.

Changes

Resource	Change
get_daily_rewards, get_daily_reward, create_daily_reward, update_daily_reward, copy_daily_reward	Added mechanics to the lootbox_settings of lootboxes nested in daily reward and extra reward items
Components	Added the HardPityMechanicRead schema

Upgrade

• No action required. mechanics is optional, and a lootbox with no mechanics configured omits it or returns an empty array.
• If you render lootbox contents, read guaranteed_groups to show what the next pity threshold awards, and compare opens_count against threshold for progress.

Need help?
Contact our integration team at [email protected]