Bingo Item Pools

How The Pools Work

Pools are defined in pools.yml. Each pool has two kinds of entries:

• items: a flat list of materials. Each item listed is a potential card slot.
• categories: named groups of related materials. A category resolves to a single random item from its list when a card is generated. This prevents a card from filling up with several near-duplicate items.

Sampling rule: every pool entry, meaning each item and each whole category, can be picked at most once per card. A category counts as one entry regardless of how many materials it contains.

Difficulty Merging

When a player picks a non-easy difficulty, the chosen pool is merged with the pool one step easier.

• easy uses easy.
• medium uses medium + easy.
• hard uses hard + medium + easy.
• grindy uses grindy + hard + medium + easy.

Easy and medium both define a COLOURS category. When merged, these stay as separate category entries, one per pool, so a higher difficulty card can roll one item from each.