!(https://cdn.modrinth.com/data/cached_images/3a6cc0729452d7f3457e12353d21d82f44948b3a.png)
[!(https://img.shields.io/badge/Modrinth-eGens-00AF5C?logo=modrinth&logoColor=white)](https://modrinth.com/plugin/egens)
[!(https://img.shields.io/badge/Paper-1. 21.x-1f7be8)](https://papermc.io/)
[!(https://img.shields.io/badge/Folia-supported-7c5cff)](https://papermc.io/software/folia)
[!(https://img.shields.io/badge/Java-21-f89820?logo=openjdk&logoColor=white)](https://adoptium.net/temurin/releases/?version=21)
[!(https://img.shields.io/badge/ko--fi-Tip%20the%20author-ff5e5b?logo=ko-fi&logoColor=white)](https://ko-fi.com/epromite/tip)
A drop-in, production-ready generator plugin for modern Minecraft
servers. Place a generator block, watch it tick, sell the loot,
upgrade the tier, repeat. Built for the 1. 21 era from day one, with
first-class support for both Paper and Folia.
## !(https://cdn.modrinth.com/data/cached_images/02834f2109ec82f33079186ba249c60f907aa6b0.png)
> Looking for documentation? Full docs live at
> . Open the Wiki tab for
> the same content in a sidebar layout.
## Why eGens
- Paper and Folia, same jar. Every scheduler call goes through
a Folia-aware wrapper. Region threads on Folia, world thread on
classic Paper — no separate builds.
- 28 premade tiers, no Java required. Three themed chains
ship out of the box (vanilla, mob, elemental). Replace, extend,
or author entirely new chains in YAML.
- Anti-dupe by construction. Every drop is stamped with a
persistent-data id; every sell, every sellwand use, every
generator tick goes through a per-resource lock. The audit log
catches the cases where a clever player tries anyway.
- MySQL multi-instance. Point every game server in your
network at the same database, keep the per-row lock turned on,
and generators behave consistently across all of them.
- Backup service built in. Periodic `VACUUM INTO` snapshots
for SQLite or `mysqldump`-driven dumps for MySQL, with
retention pruning. Manual `/egens backup` works in console.
- Profiler built in. `/egens profile` renders a top-N hot
scope digest when you need to chase a tick spike. Zero
overhead when disabled.
## What ships out of the box
### 28 premade tiers across 3 chains
- Vanilla chain (10 tiers): wood → stone → copper → iron →
gold → redstone → lapis → diamond → emerald → netherite.
- Mob chain (10 tiers): zombie → skeleton → spider → creeper
→ enderman → blaze → ghast → witch → shulker → wither.
- Elemental chain (8 tiers): earth → water → fire → air →
ice → lightning → ender → void.
Each tier has its own MiniMessage display name, lore template,
material, tick interval, capacity, durability, drop list, shop
price, and repair formula. All tunable per-tier in YAML.
### Five generator events
- Sell multiplier — 2× every `/sell`, `/sellall`, sellwand
sale for the event window.
- Drop amount — multiply stack sizes produced per tick.
- Drop tier — generators temporarily roll the next-tier's
loot table.
- Speed boost — generators tick faster (hard-capped so a
misconfigured value can't burn a region thread).
- Mixed up — every tick rolls a random registered tier's loot.
Auto-rotation runs in the background. Admins can also `/egens
event grant ` for personal events with a configurable
per-player slot cap.
### Sellwand presets
Three bundled wands (starter, veteran, master) with multipliers
1. 5×, 2. 5×, 5. 0×. Anti-dupe stamp on every minted wand. Right-click
a chest, barrel, or shulker to sell its contents through the drops
registry. Configurable per-server via `sellwands.yml`.
### Drops registry
A single `drops.yml` defines every sellable item in the server.
Sellable custom-head drops are first-class — every drop is keyed by
id, not material, so two visually identical items with different
ids can have different prices, lore, and craft rules. Drops can be
flagged `craft: false` to make them sellable-only currency tokens.
## Integrations
| Plugin | Use |
|---|---|
| Vault | Required for upgrade, repair, shop, sell, sellwand. Auto-detected. |
| PlaceholderAPI | Consumed in drop conditions and event triggers. |
| DecentHolograms / FancyHolograms / HolographicDisplays | Floating nameplates. Falls back to native vanilla display entities. |
| WorldGuard / GriefPrevention / Lands / Towny | Region protection — generators respect claim build perms. |
| HeadDatabase | Optional source of custom head textures for tier icons. |
| ItemsAdder / Oraxen | Custom-model item materials pass through unchanged. |
| ShopGUIPlus / EconomyShopGUI | Delegate the shop layer if you prefer your own. |
| DeluxeSellwands | Coexists peacefully — built-in sellwand can be disabled. |
## Commands at a glance
```
/egens menu Open the hub.
/egens shop Buy generators.
/egens info Inspect the targeted ge
