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.pity with the hard_pity entry of mechanics on the lootbox. Where you previously walked pity.steps to find the next threshold, read threshold and guaranteed_groups directly, and compare opens_count against threshold for progress.
• Treat a missing or empty mechanics array as "no pity on this lootbox" — the same meaning an absent pity object had.

需要技术支持？
联系我们的集成技术团队： [email protected]