> For the complete documentation index, see [llms.txt](https://darkstarworks.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://darkstarworks.gitbook.io/plugins/mc/mt-documentation/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 TCP-VaultCrates 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/mc/mt-documentation/rewards-yml.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://darkstarworks.gitbook.io/plugins/mc/mt-documentation/seasons-yml.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.