> ## Documentation Index
> Fetch the complete documentation index at: https://mbcz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 3TSpawner

> Physical, virtual, and cluster spawners with shop, sell, upgrades, and holograms for Paper and Purpur.

**3TSpawner** is a hybrid spawner economy plugin. Players place physical spawners, run virtual spawners without blocks, or form clusters that share storage, XP, and upgrades — then collect and sell loot through one Vault-backed loop.

## Modes

* **Physical** — placeable spawner blocks with stacking, break preserve, and TextDisplay holograms.
* **Virtual** — inventory-style spawners with merge-same-type and per-player limits.
* **Cluster** — nearby same-type physical stacks share one storage/XP/upgrade pool (default radius 16).

## Compatibility

3TSpawner targets **Paper / Purpur / Folia `1.20.6` through year-based `26.x`** and requires **Java 21+**.

Region-safe scheduling is built in (`folia-supported: true`). Run `/3ts doctor` on your host to confirm Folia detection.

> [!NOTE]
>
> Paid builds require a license key in `config.yml`. Claim product id `3TSPAWNER` in Discord, then paste the key before production use.

## Quick commands

```text theme={null}
/3ts
/3ts shop
/3ts virtual
/3ts storage
/3ts sell
/3ts doctor
```

## Documentation sections

> [card] [Installation](https://mbcz.mintlify.site/3tspawner/installation.md)
>
> Java, Paper/Purpur, Vault, license key, and first doctor check.

> [card] [Commands](https://mbcz.mintlify.site/3tspawner/commands.md)
>
> Player and admin commands plus permission tables.

> [card] [Configuration](https://mbcz.mintlify.site/3tspawner/configuration.md)
>
> config.yml and split YAML files for economy, shop, menus, and more.

> [card] [Physical spawners](https://mbcz.mintlify.site/3tspawner/physical-spawners.md)
>
> Place, stack, break, holograms, offline progress, lag-safety.

> [card] [Virtual spawners](https://mbcz.mintlify.site/3tspawner/virtual-spawners.md)
>
> Virtual list, merge, and limits.

> [card] [Clusters](https://mbcz.mintlify.site/3tspawner/clusters.md)
>
> Radius, shared storage/XP/upgrades, capacity × stack.

> [card] [Shop](https://mbcz.mintlify.site/3tspawner/shop.md)
>
> Dual catalog, auto-fill, or disable the shop for quest/key servers.

> [card] [Migration](https://mbcz.mintlify.site/3tspawner/migration.md)
>
> JSON, CSV, world scan, and SmartSpawner import.

> [card] [FAQ](https://mbcz.mintlify.site/3tspawner/faq.md)
>
> License, Folia, shop toggle, and SmartSpawner convert.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.