This is an old revision of the document!
Table of Contents
How maps are selected
Pool eligibility, freshness, player feedback, and mode-specific preferences work together to select maps.
| Availability | All lobbies; filters vary by room |
|---|---|
| Documentation status | Current behavior |
| Behavior reference | v6.6.16 · reviewed 2026-09-28 |
Selection starts with the active source catalog and the room's configured filters: game mode, key count where applicable, difficulty, playable length, pass-count policy, age policy when enabled, and availability. .pool gives the current room settings.
Freshness and preference
The bot avoids recent played or skipped maps, excludes maps already reserved in the visible playlist, and spaces songs. Player feedback affects weighting. Mania also has structural preferences and experimental farm evidence. Structural-style exhaustion fallback does not bypass the active eligibility filters.
Availability
Unavailable maps are temporarily quarantined so the bot can rotate past repeated failures. Expiry allows later rechecks rather than permanently declaring the map unavailable. An empty source switch preserves the previous working pool.
Why the pool changes
The catalog, active difficulty range, and filters all influence eligible counts. Research coverage grows over time; experimental classifications can change after validation. See fallback and repeated maps.
Sparse catalog expansion
A separate sparse-pool mechanism can progressively broaden playable length and configured ranked-map age while retaining star-rating, pass-count, quality, status, key-mode, and download boundaries. It prefers the original candidates before expanded ones. This catalog expansion is different from style exhaustion fallback, which softens style evidence within the resulting eligible catalog.
Worked example
Type .pool to inspect the active range and filters. A style or source request still has to find eligible maps inside the applicable selection policy.
Limitations
Sparse-catalog expansion and style exhaustion fallback are separate mechanisms. Research evidence and pool counts can change.
Related articles
See a related guide and all features.