Using it

Pity and milestones

Pity#

Pity is per player, per crate and per rarity tier. It is set in the crate's pity: section:

pity:
  guaranteed-after:
    epic: 15
    legendary: 50
  soft-pity:
    enabled: true
    increment-percent: 1.5
    max-bonus-percent: 45.0
  • Hard pity (guaranteed-after): after that many opens without the tier, the next open is forced into that tier or a rarer one.
  • Soft pity: every open without a hit adds increment-percent percentage points to the tier's chance, capped at max-bonus-percent. The bonus also applies to rarer tiers. Soft pity follows the same tiers as guaranteed-after.
  • Hitting a tier resets its counters and those of every lower tier. Delete the whole section to turn pity off for that crate.

Rarity order comes from the tier list: the first tier is the most common, later tiers are rarer.

Rarity tiers#

Default tiers are in config.yml. A crate can override or add tiers under its own tiers::

tiers:
  common:
    display: "<#B9C2CC>Common"
    default-chance: 60.0
  rare:
    display: "<#5CE1FF>Rare"
    default-chance: 25.0
  epic:
    display: "<#B78CFF>Epic"
    default-chance: 12.0
  legendary:
    display: "<gradient:#FFD166:#FF9F5A>Legendary</gradient>"
    default-chance: 3.0

Milestones#

Bonus commands for opening a crate many times. Use at for a one-time count or every for each multiple. Commands run from the console and can use {player} and {opens}.

milestones:
  loyal:
    every: 25
    name: "<gold>Loyalty bonus"
    commands:
      - "eco give {player} 1000"
  veteran:
    at: 100
    name: "<light_purple>Veteran title"
    commands:
      - "lp user {player} permission set title.vault_veteran true"

The crate screen shows pity progress bars and the next milestone to each player.