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

# Overview

Welcome! This guide covers installing Mythic Trials, understanding how per-player chamber progression works, and configuring tiers, Mythic gates, seasons, and rewards.

The core idea: **each Trial Chamber becomes a personal difficulty ladder.** Players clear a chamber to raise their tier in it; the next run scales to that tier; better loot waits at the top. Reach tier 20 and — where you've allowed it — break into the Mythic prestige range.

## What it actually does

Vanilla Trial Chambers are one-and-done: clear a chamber once, loot the vaults, and there's little reason to return. MythicTrials turns each chamber into **renewable, scaling endgame content**.

The whole loop:

* Every player starts at **tier 1 (T1)** in every chamber.
* **Clearing** a chamber — your group finishing every trial spawner's waves within one reset cycle — raises your tier in *that* chamber by one: **T1 → T20**, then, where the owner allows it, the prestige range **M1 → M5** ("Mythic").
* As your tier climbs, that chamber's mobs get tougher **for you** — scaling across **health, melee damage, spell damage, resistance, and speed**, with smarter behaviour layered on (gear-adaptive AI, anti-heal, themed rooms, optional bosses). An anti-one-shot guardrail keeps it hard, never cheap.
* **Rewards scale with the difficulty**: higher tiers pay out more — bonus XP, economy currency, crate keys, seasonal loot — plus per-chamber leaderboards and seasons.

Because each player carries their **own tier per chamber**, a veteran at T15 and a newcomer at T1 can run the exact same chamber side by side, each at the difficulty they've earned. (Parties resolve to one shared tier — lowest by default, so nobody gets thrown to the wolves.)

**A quick picture:** two friends run a chamber for the first time and both reach T2; next time the mobs hit a little harder. They keep at it to T15, and that chamber is now a genuine gauntlet *for them*, dropping far better loot. A new player walking into the same chamber still starts at T1 and gets the gentle version. Everyone gets a fair, personal progression curve out of content that was previously one-and-done.

It hooks into BetterTrialChambers's chamber-clear event, so it works on **every registered chamber automatically** — no per-chamber setup to get started. (Mythic M1–M5 are opt-in per chamber, gated behind your own custom loot.)

## Where to start

1. [**Installation**](/plugins/mythic-trials/installation.md) — Drop the JAR in, restart, verify.
2. [**How progression works**](/plugins/mythic-trials/how-it-works.md) — Tiers, scaling, clearing, party resolution. Read this first; it's the whole plugin in one page.
3. [**config.yml**](/plugins/mythic-trials/config-yml.md) — Tier telegraph, update checker, debug toggle.
4. [**tiers.yml**](/plugins/mythic-trials/tiers-yml.md) — The band-based difficulty curve, per-mob tuning, and anti-cheese guardrails.
5. [**chambers.yml**](/plugins/mythic-trials/chambers-yml.md) — Opening chambers for Mythic tiers with custom loot.
6. [**seasons.yml**](/plugins/mythic-trials/seasons-yml.md) — Date-driven loot rotations.
7. [**rewards.yml**](/plugins/mythic-trials/rewards-yml.md) — The four chamber-clear reward channels.
8. [**Commands & permissions**](/plugins/mythic-trials/commands-and-permissions.md) — Quick reference.
9. [**The Admin GUI**](/plugins/mythic-trials/admin-gui.md) — Tour of `/tcpmt menu`.
10. [**The Mob Editor**](/plugins/mythic-trials/mob-editor.md) — Custom mob templates, tier/chamber assignments, bosses, and scoped anti-cheese tactics.
11. [**messages.yml**](/plugins/mythic-trials/messages-yml.md) — Translating the player-facing text.
12. [**Integrations**](/plugins/mythic-trials/integrations.md) — VaultCrates, WildSpawners, Vault, PlaceholderAPI.
13. [**Troubleshooting & FAQ**](/plugins/mythic-trials/troubleshooting.md) — Common gotchas.

## What this plugin needs

* **Paper / Folia 1.21.7+** (the admin GUI uses Paper's Dialog API)
* **Java 21+**
* **BetterTrialChambers v1.6.1+** — the free base plugin this builds on

Full requirements, the why-this-version detail, and the optional add-ons (VaultCrates, WildSpawners, Vault, PlaceholderAPI) are covered in [**Installation**](/plugins/mythic-trials/installation.md).

## Getting help

The Discord linked from the marketplace product page is the fastest way to get an answer. When asking, include:

* Plugin version (shown in the startup banner in the server console)
* Server software + version (`Paper 1.21.7`, `Folia 1.21.8`, etc.)
* The relevant config snippet
* The full console log around the moment the issue happened
* Steps to reproduce (if possible — not always required)