Booster Packs & Rarity Rules

How pack opening, rarityRules, and configbooster.lua work

Booster pack behaviour is defined in configs_settings/configbooster.lua. Each pack gives 6 cards from cards matching the pack's brand in configcards.lua.

Config file split

• configbooster.lua — Config.BoosterBoxes + Config.BoosterPacks + rarityRules
• configcards.lua — which cards exist and their brand/rarity
• configshop.lua — shop prices (packs/boxes sold in shop)

rarityRules explained

Every pack type (Regular, Mythic, Legendary) has its own rarityRules table. Each rarity tier uses three fields:

max

Max copies of that rarity in one pack open. Example: Legendary max = 1 means you cannot pull two Legendaries from the same pack.

chance

Roll weight for that tier. Normal/Uncommon use higher values. For packGate = true tiers, chance is a percentage (0.02 ≈ 1 in 5000 per slot attempt).

packGate

false = always eligible (Normal/Uncommon fill most slots). true = tier only enters the pool if the chance roll succeeds (Rare+ jackpot slots).

-- Standard jg_warlords pack (low high-tier odds)
rarityRules = {
  Normal      = { max = 6, chance = 12,     packGate = false },
  Uncommon    = { max = 3, chance = 5,      packGate = false },
  Rare        = { max = 1, chance = 0.02,   packGate = true  }, -- ~1 in 5000
  Epic        = { max = 1, chance = 0.02,   packGate = true  },
  Legendary   = { max = 1, chance = 0.0167, packGate = true  }, -- ~1 in 6000
  Holo        = { max = 1, chance = 0.0167, packGate = true  },
  OriginalArt = { max = 1, chance = 0.0143, packGate = true  }, -- cards with style = 'OriginalArt'
}

Pack tiers

Regular packs

e.g. jg_warlords_pack. Mostly Normal/Uncommon; Rare+ possible but very low odds via packGate rolls.

Mythic packs

e.g. jg_warlords_pack_mythic. Better chance values (~1/1000 Rare/Epic).

Legendary packs

e.g. jg_warlords_pack_legendary. Best odds; jg_warlords legendary includes guaranteedcards for 2 Legendary or Holo pulls.

Booster boxes

Each box contains 6 packs of the matching type. Config.BoosterBoxes maps box item → pack item + display images. Players need inventory space for packs when opening a box.

Requirements & tips

• Players need 6 free inventory slots to open one pack
• Card brand in configcards.lua must match pack brand
• OriginalArt cards use style = 'OriginalArt' in configcards.lua (not rarity = OriginalArt)
• Auto rarity cards (rarity = 'Auto') ignore pack rarityRules — see Auto Rarity docs
• Tune pity in config.lua (Config.Pity) separately from per-pack rarityRules

Documentation