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
/soaps→ Pools → Create (or editweekend/showcase)- Add event ids and weights
- Optional: set an auto-start When (same shape as event When)
- Enable each listed event, then enable the pool
/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