> 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/better-trial-chambers/getting-started/readme.md).

# Welcome

BetterTrialChambers makes Minecraft's Trial Chambers reusable on a multiplayer server: every player gets their own vault loot, chambers reset on a schedule, and spawners are protected from griefing. It can find and manage every natural chamber in your world with no per-chamber setup.

***

## Features

* **Automatic resets.** Chambers restore on a schedule, with warnings before each reset.
* **Per-player vaults.** Every player gets their own loot roll and cooldown. Optional `SHARED` mode for one reward per vault, server-wide.
* **Protection.** Block break/place, container access, mob griefing, PvP. WorldGuard-aware and claim-plugin-aware (Residence, Lands, GriefPrevention).
* **Statistics and leaderboards.** Vaults opened, mobs killed, chambers completed, time spent.
* **Custom loot.** Multi-pool tables, command rewards, potions, tipped arrows, custom-plugin items (Nexo, ItemsAdder, Oraxen, CraftEngine, MythicCrucible), resource-pack items via `custom-model-data`.
* **Auto-discovery.** Opt-in. Finds and registers natural chambers automatically, no WorldEdit needed.
* **Admin GUI.** `/trial menu` covers everything without editing YAML.
* **Spawner wave tracking.** Boss bar shows progress during a fight.
* **Spectator mode.** Dead players can watch teammates finish.
* **Custom mob providers.** MythicMobs, EliteMobs, EcoMobs, LevelledMobs, InfernalMobs, Citizens.
* **PlaceholderAPI.** 20+ placeholders for scoreboards, holograms, tab lists.
* **Full translation.** Every user-facing string is in `messages.yml`.

***

## Requirements

* **Minecraft 1.21.1+.** Use the `-mc26` build for Minecraft 26.0 to 26.2, or the `-mc263` build for 26.3.
* **Paper, Folia, Purpur, or Pufferfish.**
* **Java 21+** (Minecraft 26.3 servers run on Java 25).
* *Optional:* WorldEdit / FAWE, WorldGuard, Residence / Lands / GriefPrevention, AdvancedEnchantments, PlaceholderAPI, Vault, LuckPerms, Nexo / ItemsAdder / Oraxen / CraftEngine / MythicCrucible.

***

## Where to go next

[installation.md](/plugins/better-trial-chambers/getting-started/installation.md) - Install the JAR and start the server.

[quick-start.md](/plugins/better-trial-chambers/getting-started/quick-start.md) - Run `/trial setup`, turn on auto-discovery, done.

[basic-configuration.md](/plugins/better-trial-chambers/getting-started/basic-configuration.md) - The settings most servers change.

[config.yml.md](/plugins/better-trial-chambers/configuration/config.yml.md) - Full `config.yml` reference.

[loot.yml.md](/plugins/better-trial-chambers/configuration/loot.yml.md) - Loot tables: pools, custom items, command rewards.

[your-first-chamber.md](/plugins/better-trial-chambers/getting-started/your-first-chamber.md) - Register a chamber by hand (superflat / custom worldgen).

[troubleshooting.md](/plugins/better-trial-chambers/troubleshooting/troubleshooting.md) - Known issues and their fixes.

***

## Premium add-ons

They require BetterTrialChambers and are sold on [ESMP.fun](https://esmp.fun/).

[**MythicTrials**](https://esmp.fun/plugins/mythic-trials) - Per-player chamber progression + Mythic difficulty tiers

[**Vault Crates**](https://esmp.fun/plugins/vault-crates) - Crate system built on real Trial Vault blocks

[**Wild Spawners**](https://esmp.fun/plugins/wild-spawners) - Custom Trial Spawners for Better Trial Chambers

***

## Support

* [**GitHub Issues**](https://github.com/ESMP-FUN/BetterTrialChambers/issues) - bug reports, feature requests
* [**Discord**](https://dc.esmp.fun) - community support, announcements
* [**Modrinth**](https://modrinth.com/plugin/trialchamberpro) - downloads and release notes

Source-available, free to use, no redistribution (see [LICENSE](https://github.com/ESMP-FUN/BetterTrialChambers/blob/master/LICENSE)).

***

[![Servers](https://img.shields.io/endpoint?url=https%3A%2F%2Ffaststats.dev%2Fapi%2Fshields%2Fbetter-trial-chambers%3Fmetric%3Dservers%26color%3Dorange%26icon%3D1\&style=flat)](https://faststats.dev/project/better-trial-chambers)