> 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

Transform Minecraft's Trial Chambers from single-use dungeons into renewable, multiplayer-ready content. Automatic resets, per-player vault loot, custom rewards, griefing protection — and it works on every natural chamber in your world without any setup per-chamber.

***

## The problem it solves

Vanilla Trial Chambers weren't designed for multiplayer. The first player takes everything, vaults stay locked forever, and griefers can destroy spawners. On a server with more than one player, chambers become single-use content almost immediately.

BetterTrialChambers fixes all of that: every player gets their own loot roll, chambers reset on a schedule, spawners are protected, and progression is tracked. The plugin can find and manage natural chambers automatically — no WorldEdit, no commands per chamber.

***

## What you can do

* **Automatic resets** — chambers restore on schedule, with warnings before the reset fires.
* **Per-player vaults** — every player gets their own loot roll with their own cooldown.
* **Full protection** — block break / place, container access, mob griefing, WorldGuard-aware, and claim-plugin-aware (Residence / Lands / GriefPrevention can't claim a chamber).
* **Statistics & leaderboards** — track 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; the plugin finds and registers every natural chamber on its own.
* **Admin GUI** — `/trial menu` handles everything. No YAML editing required.
* **Spawner wave tracking** — boss bar shows progress as players fight.
* **Spectator mode** — dead players can watch teammates finish the chamber.
* **PlaceholderAPI** — 20+ placeholders for scoreboards, holograms, tab lists.
* **Full translation support** — every user-facing string lives in `messages.yml`.

***

## Requirements

* **Minecraft 1.21.1+** (use the `-mc26` build for Minecraft 26.x)
* **Paper, Folia, Purpur, or Pufferfish**
* **Java 21+**
* *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 get the server running. Two minutes.

[quick-start.md](/plugins/better-trial-chambers/getting-started/quick-start.md) -> **Start here.** Run `/trial setup`, turn on auto-discovery, and BTC manages every natural Trial Chamber for you — no per-chamber work.

[basic-configuration.md](/plugins/better-trial-chambers/getting-started/basic-configuration.md) -> Walk through the config settings most servers actually tweak.

[config.yml.md](/plugins/better-trial-chambers/configuration/config.yml.md) -> Full `config.yml` reference. Includes the auto-discovery plug-and-play setup.

[loot.yml.md](/plugins/better-trial-chambers/configuration/loot.yml.md) -> Everything about loot tables — pools, custom items, command rewards.

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

[troubleshooting.md](/plugins/better-trial-chambers/troubleshooting/troubleshooting.md) -> Something not working? Most issues have a known cause. Check here first.

***

## Premium add-ons

BetterTrialChambers is the free foundation. Two premium modules extend it further:

[**Wild Spawners**](https://esmp.fun/) — Place trial spawners anywhere on the survival map, not just inside registered chambers. Players receive spawner items via shop plugins or staff commands, place them wherever they like, and custom-plugin mobs (MythicMobs, EliteMobs, etc.) spawn correctly. Includes configurable mining-and-redeploy (no Silk Touch required), per-spawner holograms, griefing protection, and a full in-game preset editor.

[**Vault Crates**](https://esmp.fun/) — Turn any vanilla Vault block into a loot crate. Players open crates with keys earned in-game or purchased in a shop. Supports two-tier crates (normal / ominous), weighted loot pools, per-player and server-wide reset modes, and crate-key drops from Wild Spawners mob kills. Full in-game editor included.

Both modules require BetterTrialChambers and are available on [Voxel.shop](https://voxel.shop/) and [esmp.fun](https://esmp.fun/) (Stripe + crypto, for regions where Voxel's payment processors don't operate).

***

## Support

* [**GitHub Issues**](https://github.com/ESMP-FUN/BetterTrialChambers/issues) — bug reports, feature requests
* [**Discord**](https://discord.gg/qwYcTpHsNC) — 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)). Made with Kotlin by [darkstarworks](https://github.com/darkstarworks).