> For the complete documentation index, see [llms.txt](https://esmp-fun.gitbook.io/plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://esmp-fun.gitbook.io/plugins/mythic-trials/seasons-yml.md).

# seasons.yml

Seasons are date-windowed overlays that swap loot, add a difficulty bonus, and can drop limited-time crate keys. Use them for holidays, events, or rotating content.

## Format

```yaml
# Admin override — null = use the date windows. Set by /tcpmt season set.
active-override: null

seasons:
  winter-2026:
    active-from: "2026-12-01"
    active-until: "2027-02-28"
    tier-bonus: 1                       # +1 effective tier while active
    loot-override-normal: "winter-normal"
    loot-override-ominous: "winter-ominous"
    crate-key-drop:
      crate: "snowflake"
      tier: "ominous"
      chance: 0.1                       # per participant per chamber-clear
```

* **`active-from` / `active-until`** — inclusive ISO dates (`YYYY-MM-DD`). The season is active on those days and everything between.
* **`tier-bonus`** — added to the chamber's effective tier while the season runs, so mobs scale up (and rewards with them). `0` = no difficulty change.
* **`loot-override-normal` / `loot-override-ominous`** — loot table ids (defined in TCP's `loot.yml`) substituted for normal / ominous vault opens during the season.
* **`crate-key-drop`** *(optional)* — drops a Vault Crates key on chamber clear while the season is active. Silently ignored if VaultCrates isn't installed.

## How "active" is decided

1. If an **admin override** is set (`active-override`, or `/tcpmt season set <id>`), that season is active regardless of date.
2. Otherwise, the **first season whose date window contains today** is active.
3. If neither matches, no season is active.

## Loot precedence

When a player opens a vault, the loot table is chosen in this order:

1. **Mythic-tier loot** — if the player is at a Mythic tier in a chamber with a matching `chambers.yml` entry, that wins. A season never downgrades Mythic loot.
2. **Seasonal loot** — the active season's override for the vault type.
3. **Vanilla** — TCP's normal resolution.

## Managing seasons in-game

* `/tcpmt season` — show the active season.
* `/tcpmt season set <id>` — force a season active (sets `active-override`).
* `/tcpmt season clear` — drop the override, revert to the calendar.
* `/tcpmt menu` → **Seasons** — visual list; click a season to activate it, click the active one to clear the override.

{% hint style="info" %}
All referenced loot tables (`winter-normal`, etc.) must be defined in TCP's `loot.yml`. A missing table makes the vault open fail, exactly as in `chambers.yml`.
{% endhint %}

***

Next: [**rewards.yml →**](/plugins/mythic-trials/rewards-yml.md)