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

# Overview

Welcome! This guide walks you through installing Wild Spawners, configuring your first preset, distributing spawners to players, and managing everything from the in-game GUI.

The pitch in one sentence: **vanilla Trial Spawners that work anywhere on your survival map**, with custom mobs, holograms, mining-and-redeploy, and griefing protection. Players already know how vanilla spawners feel; this just lets you put them outside Trial Chambers.

## Where to start

1. [**Installation**](/plugins/wild-spawners/installation.md) — Drop the JAR in, restart, verify the plugin loaded.
2. [**Your first spawner**](/plugins/wild-spawners/your-first-spawner.md) — A 5-minute walkthrough: configure a preset, give yourself a spawner, place it, fight some mobs.
3. [**Configuring wild-presets.yml**](/plugins/wild-spawners/wild-presets-yml.md) — Full reference for the preset definitions file.
4. [**Custom mobs**](/plugins/wild-spawners/custom-mobs.md) — Using MythicMobs, EliteMobs, EcoMobs, LevelledMobs, InfernalMobs, and Citizens with this plugin.
5. [**Distributing spawners**](/plugins/wild-spawners/distributing-spawners.md) — How to hand out spawners via shops, mob drops, quest rewards.
6. [**The admin GUI**](/plugins/wild-spawners/admin-gui.md) — Tour of `/tcpws gui`.
7. [**Commands & permissions**](/plugins/wild-spawners/commands-and-permissions.md) — Quick reference.
8. [**config.yml reference**](/plugins/wild-spawners/config-yml.md) — Global toggles (holograms, mining, mob tether, griefing protection).
9. [**Mining and re-deploying**](/plugins/wild-spawners/mining-and-redeploy.md) — How state-preserving mining works.
10. [**messages.yml**](/plugins/wild-spawners/messages-yml.md) — Translating or customising the player-facing text.
11. [**Integration with Vault Crates**](/plugins/wild-spawners/vaultcrates-integration.md) — Make spawner mobs drop crate keys.
12. [**Troubleshooting & FAQ**](/plugins/wild-spawners/troubleshooting.md) — Common gotchas.

## What this plugin needs

* **Paper or Folia 1.21.1+**
* **Java 21+**
* **BetterTrialChambers v1.4.0+** — the free base plugin

Full requirements — including the Minecraft 26.x build note and the optional custom-mob plugins (MythicMobs, EliteMobs, …) — are in [**Installation**](/plugins/wild-spawners/installation.md).

## Getting help

If you hit a snag the docs don't cover, the Discord linked from the marketplace product page is the fastest way to get an answer.

When asking, include:

* Plugin version (`/tcpws version` shows it)
* Server software + version (`Paper 1.21.4`, `Paper 1.21.8`, `Folia 1.21.8`, etc.)
* The relevant config snippet (`wild-presets.yml` entry, `config.yml` block)
* The full console log around the moment the issue happened
* Which custom-mob plugins (if any) you have installed, and their versions

That's usually enough to diagnose almost anything.