> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/mantic-generators.md).

# Mantic Generators

**ManticGenerators — The Ultimate Customisable Generator Plugin**

ManticGenerators is a lightweight, fully configurable plugin for Spigot/Paper servers (1.8+) that lets you place custom, timer-based passive-income generators for literally any reward. Unlike farm-style block generators, there's nothing to mine or grow — every generator is a placed structure that pays out on an interval using a simple, config-driven give-command, so it plugs directly into your economy, tokens, XP, crate key, or custom plugin setup.

## Key Features

* Unlimited generator types — add a new `.yml` file to the `generators` folder and it's live
* Works with any give-command (Vault economy, tokens, XP, crate keys, custom items, your own plugin's currency)
* Fully custom appearance per generator: middle block, corner block, stairs, plus player-head textures and legacy damage values for resource pack support
* Tiered upgrade system with configurable cost scaling per generator type
* Live holograms showing tier, generation amount, collected balance, and next-drop countdown
* "Your Generators" GUI: paginated list of every generator a player owns, with live location/balance and dynamic per-type pending balance breakdown
* One-click Collect All / Remove All
* Per-generator menu with live info panel, collect, upgrade, and remove actions
* Optional glow effect and full colour-code/placeholder support in titles, lore, and holograms

If you join our test server at test.mantic.dev, then turn around, you can view the generators.
