Hard pity mode on lootboxes

What's new

A new PityMode enum says how a hard pity guarantee is delivered on the open it lands on:

• exclusive — the guarantee replaces the regular roll. This is the default.
• inclusive — the guarantee is delivered on top of the regular roll.

It surfaces as a mode field in two places, both read-only:

• pity.mode in the lootbox settings of an item or store item, next to steps and repeat_last.
• mode on each entry of the player-facing mechanics list, next to opens_count, threshold, and guaranteed_groups. This is what daily reward responses carry.

There is no request field — the mode is configured in the dashboard, and the API reports it.

Impact

A client that shows pity progress can now tell the player what hitting the threshold gets them: under exclusive the guaranteed reward is the open, under inclusive it comes alongside whatever the roll produced. Before, the two were indistinguishable over the API.

Changes

Resource	Change
get_items	Added mode to lootbox pity in the response
get_all_store_items, get_store_items, create_store_item, update_store_item, bulk_update_store_items	Added mode to lootbox pity in the response
get_daily_rewards, get_daily_reward, create_daily_reward, update_daily_reward, copy_daily_reward	Added mode to the hard pity mechanic on reward lootboxes in the response

Upgrade

• No action required. The field defaults to exclusive, which is how hard pity already behaved.
• Clients decoding these responses against a strict generated model should regenerate.

도움이 필요하세요?
통합팀에 문의하십시오 [email protected]