> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/for-ultimatequest/features/task-limits.md).

# Task Limits

Configure `config.yml -> task-limits`:

```yaml
task-limits:
  normal:
    total: 20
    categories:
      combat: 6
      gathering: 10
  scroll:
    total: 8
    categories:
      adventure: 4
      gathering: 4
  period:
    total: 12
    categories: {}
  battlepass-task:
    total: -1
    categories: {}
  categories:
    combat: -1
    gathering: -1
    uncategorized: -1
```

Types are normal, scroll, period, battlepass-task. Each has total and categories.; root task-limits.categories. caps that category across types. All applicable caps apply simultaneously. Missing/-1 is unlimited; 0 prohibits new tasks. Uncategorized tasks use uncategorized. Multiple categories count toward each cap, once toward the type total. One scroll occupies one task slot.

Completed but unclaimed tasks occupy slots. Claimed, expired, or uncarried scroll instances do not occupy active slots. Battle-pass/milestone reward containers are excluded. Period generation checks a whole batch, retaining old tasks if blocked and retrying the fixed selection. Challenges fill in configuration order as slots become available. Lowering limits does not delete existing tasks. Admin acceptance bypass still enforces limits.