> 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

Wild Spawners lets you place trial spawners anywhere on your map, not only inside Trial Chambers, and choose the mobs they summon.

Each spawner comes from a **preset**: its name, its mobs, and a few switches. You give the spawners out with `/ws give`, by hand or from a shop or crate, and players place them wherever they like.

* Vanilla mobs, or mobs from MythicMobs, EliteMobs, EcoMobs, LevelledMobs, InfernalMobs or Citizens
* Floating text above each spawner: its name, owner, and a countdown while it cools down
* Players can mine a spawner and move it; it keeps its cooldown and whether it was ominous
* Optional owner-only mining for spawners you sell
* Mobs are walked back when they stray, so waves don't get stuck
* Optional crate key drops through VaultCrates
* Everything is set up in an in-game menu: `/ws gui`

## Where to start

1. [Installation](https://esmp-fun.gitbook.io/plugins/wild-spawners/installation.md): put the jar in and check it loaded.
2. [Your first spawner](https://esmp-fun.gitbook.io/plugins/wild-spawners/your-first-spawner.md): make a preset, give it to yourself, place it.
3. [wild-presets.yml](https://esmp-fun.gitbook.io/plugins/wild-spawners/wild-presets-yml.md): every preset setting.
4. [Custom mobs](https://esmp-fun.gitbook.io/plugins/wild-spawners/custom-mobs.md): mobs from other plugins.
5. [Giving out spawners](https://esmp-fun.gitbook.io/plugins/wild-spawners/distributing-spawners.md): shops, crates, rewards.
6. [The admin menu](https://esmp-fun.gitbook.io/plugins/wild-spawners/admin-gui.md): a tour of `/ws gui`.
7. [Commands and permissions](https://esmp-fun.gitbook.io/plugins/wild-spawners/commands-and-permissions.md)
8. [config.yml](https://esmp-fun.gitbook.io/plugins/wild-spawners/config-yml.md): floating text, mining, keeping mobs close, updates.
9. [Mining and moving spawners](https://esmp-fun.gitbook.io/plugins/wild-spawners/mining-and-redeploy.md)
10. [messages.yml](https://esmp-fun.gitbook.io/plugins/wild-spawners/messages-yml.md): changing or translating the text players see.
11. [VaultCrates](https://esmp-fun.gitbook.io/plugins/wild-spawners/vaultcrates-integration.md): crate key drops.
12. [Troubleshooting](https://esmp-fun.gitbook.io/plugins/wild-spawners/troubleshooting.md)

## Getting help

Ask in the Discord linked from the store page. Include:

* the Wild Spawners version (`/ws version`)
* your server software and version, like `Paper 1.21.8` or `Paper 26.3`
* the preset or config part you changed
* the console log from around the moment it went wrong
* which mob plugins you use, and their versions
