Event Pools

Last updated Nov 2, 2026

Event Pools

Rotate or pick among saved events: weight, chance, or list order.

Defaults live in plugins/SoapsCommon/pools.yml. Full dump: Default pools.yml.

Pick modes

pick Behavior
weight Weighted random among ready events
chance Walk top to bottom; each entry rolls its % until one hits
list Next ready event after last_picked, then wrap

Admin path

  1. /soaps → Pools → Create (or edit weekend / showcase)
  2. Add event ids and weights
  3. Optional: set an auto-start When (same shape as event When)
  4. Enable each listed event, then enable the pool
  5. /soaps pools start showcase (or Right-click / Start in the editor)

Seeded pools

Id Cooldown Role
weekend 2h Three headline events
showcase 30m Wider mix for demos

Both ship disabled.

Verify

Check Passes when
Pool enabled List shows enabled dye
Events ready Each weight id exists and is enabled
Start One event runs; cooldown blocks an immediate second start

Reload: Getting Started · Engine limits: Configuration · Catalog: Examples

Still stuck? Ask about this page