> 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/config-yml.md).

# config.yml

The lightweight main settings file. Most of the plugin's behaviour lives in the dedicated YAMLs (`tiers.yml`, `chambers.yml`, etc.); this file covers the few cross-cutting toggles.

## License

There's nothing to configure here — **your licence is embedded in the JAR you downloaded.** No key to paste, no activation step. The plugin reads the embedded licence automatically on startup.

```yaml
license:
  marketplace: "esmp"   # esmp | voxel | builtbybit — this is auto-managed
```

* **`marketplace`** — which store the copy came from, used only for licence verification. esmp.fun downloads set this automatically; you normally never touch it.

If a download ever fails to verify, **re-download the JAR from your purchase page** (esmp.fun, or whichever store you bought it from) — the fresh copy re-embeds your licence.

## Tier telegraph

When scaled mobs first spawn in a chamber, players inside see a title showing the chamber's tier (e.g. \*\* T13\*\*), so they know what difficulty they're stepping into. Shows **once per player per visit** — the marker clears when the player leaves the chamber, so re-entering telegraphs again.

```yaml
telegraph:
  enabled: true
  fade-in-ticks: 10
  stay-ticks: 50
  fade-out-ticks: 20
```

* **`enabled`** — turn the whole thing off if you'd rather players figure the tier out from the fight itself.
* **`fade-in-ticks` / `stay-ticks` / `fade-out-ticks`** — title timing. 20 ticks = 1 second.

The title text and the colour-by-tier behaviour are localisable via [messages.yml](/plugins/mythic-trials/messages-yml.md) (`announce.tier-telegraph-*`).

## Player feedback (sounds + subtitles)

In-chamber feedback that complements the per-player action-bar HUD (controlled via `/tcpmt hud`). Tunable independently — for example, you can ship the HUD but keep the server silent.

```yaml
feedback:
  sounds-enabled: true
  subtitle-on-wave: true
  wave-pip-volume: 0.6
  wave-pip-pitch: 1.4
  chamber-cleared-volume: 1.0
  chamber-cleared-pitch: 1.0
```

* **`sounds-enabled`** — plays a pip (`block.note_block.bell`) on each wave completion and a celebration (`ui.toast.challenge_complete`) on a full chamber clear. Audible only to players inside the chamber.
* **`subtitle-on-wave`** — flashes a brief subtitle reading *"N/M spawners cleared"* on every wave completion. Skipped at tier 1 (where nothing is scaled).
* **`wave-pip-*` / `chamber-cleared-*`** — fine-grained volume and pitch controls. Defaults aim for "noticeable but not annoying."

Both `sounds-enabled` and `subtitle-on-wave` only fire in chambers at tier 2 or higher.

## Updates

*(Reworked in 1.1.0.)* MythicTrials can check esmp.fun for new versions and, if you let it, download and install them for you.

```yaml
update:
  mode: notify
  check-interval-hours: 6
```

**This only applies to esmp.fun licences.** The update check authenticates with your licence key against esmp.fun's update API, and a download is **your own watermarked build** — checksum-verified, the current jar backed up, and the new one staged into the server's update folder to install on the next restart. Copies from other stores skip update checks entirely; download new versions from your marketplace as usual. Servers on MC 26.x automatically receive the `-mc26` build.

* **`mode`** — how far the updater goes on its own. Each mode includes the ones above it:
  * `off` — no update checks at all.
  * `check-only` — check silently; results only via `/tcpmt update status`.
  * `notify` (default) — also announce available updates in the console and to admins (`tcpmt.admin`) on join.
  * `download` — also allow `/tcpmt update download` to fetch, verify and stage an update for the next restart.
  * `auto-stage` — download, verify and stage new versions automatically.
* **`check-interval-hours`** — hours between automatic checks. Minimum `1`, default `6`.

In `notify` nothing is ever written to disk. See [Commands](/plugins/mythic-trials/commands-and-permissions.md) for the `/tcpmt update` subcommands (`check`, `download`, `restore`, `ignore`, `status`).

## Command

```yaml
command:
  claim-mt-alias: true
```

*(0.1.4+)* Forces the short `/mt` alias to route to Mythic Trials even when another plugin registered an `mt` command first — Bukkit normally hands a contested alias to whichever plugin loaded first, which made `/mt` silently reach the wrong plugin on some servers (while `/tcpmt` worked fine). The displaced plugin keeps its namespaced form. Disable if you'd rather keep the other plugin's `/mt`.

## Progression

```yaml
progression:
  default-tier: "T1"
```

* **`default-tier`** *(0.1.3+)* — the tier every player starts at in any chamber they have no stored record for yet. Accepts `T1`–`T20` or `M1`–`M5`; invalid values fall back to `T1` with a startup warning. Set it to `T2` (or higher) to skip the vanilla-scaling floor server-wide. Players who already have stored progression are unaffected, and `/tcpmt reload` picks up changes without a restart.

## Debug

```yaml
debug:
  verbose-logging: false
```

When `true`, the plugin logs verbose information about tier resolution, scaling application, and progression events. Useful when diagnosing why a chamber clear didn't bump a tier, or why a loot override resolved to the table it did. Off in normal operation.

***

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