Lootboxes & Probabilities#

Items purchased from the shop are stored in the user's global inventory. The most prominent items are Lootboxes (Crates), which contain randomized rewards ranging from coins to exclusive cosmetic items.

Probability Mechanics#

Each crate possesses a specific loot table categorizing items into Common, Rare, Epic, and Legendary tiers. A secure server-side Random Number Generator (RNG) rolls against weighted probabilities every time a crate is opened.

Pity System#

To prevent extreme bad luck, the system implements a "pity timer." If a user opens a set number of crates without receiving a high-tier reward, the probabilities dynamically scale up in their favor. Eventually, if they continue to fail, a rare item is guaranteed to drop on their next roll, resetting the pity timer.