Repository navigation
Home
eGens is a next-gen Gens / Tycoon plugin for Paper and Folia servers running Minecraft 1.21.x. Players place generator blocks that periodically drop loot; admins curate the experience through tiered upgrade chains, an event system, shops, sellwands, and integrations with the Vault / PlaceholderAPI / hologram / protection ecosystem.
This site is the operator-facing manual. Every page describes only what server admins need to configure or run; internal plugin architecture lives in the plugin source repository.
| Page | What it covers |
|---|---|
| Install | Server prerequisites, dropping the jar, first boot, default world layout. |
| Permissions | Every permission node the plugin registers, with LuckPerms-style examples. |
| Storage | MySQL vs SQLite trade-offs, connection strings, migration on first boot. |
| Page | What it covers |
|---|---|
| Command index | One-glance cheat sheet of every /egens subcommand and the /sell shortcut. |
| Admin commands |
give, reload, backup, profile, debug, event, sellwand, ... |
| Player commands |
menu, shop, info, upgrade, repair, sell, sellall, settings, help. |
| Page | What it covers |
|---|---|
config.yml |
Top-level keys: storage, generator defaults, generation, corruption, upgrade, events, sellwand, stacking, sell-all, limits, backup, worlds, anti-dupe, GUI, performance, profiler, integrations, update-checker, bStats, locale, debug. |
events.yml |
Server-wide and personal events, auto-trigger schedule, stacking, bossbar styling. |
gui/*.yml |
Inventory layouts for the main hub, shop, settings, generator menus. |
sellwands.yml |
Sellwand presets — multiplier, use count, item appearance. |
Localization (lang/*.yml) |
Bundled locales (id_ID, en_US) and how to add a new one. |
| Page | What it covers |
|---|---|
| Generator overview | How tiers, chains, drops, upgrades, durability, and corruption fit together. |
| Premade tier chains | What ships out of the box: vanilla_chain.yml, mob_chain.yml, elemental_chain.yml. |
| Custom tiers | Build your own chain in YAML — no Java required. |
Drops registry (drops.yml) |
Material, weight, amount, presentation, price, craftability. |
| Balance guide | Tweak tick interval, capacity, durability, repair cost, and shop price without breaking progression. |
| Page | What it covers |
|---|---|
| Vault | Economy + permissions; what happens when Vault is missing. |
| PlaceholderAPI | Using PAPI placeholders inside drop conditions, event triggers, and GUIs. |
| Holograms | DecentHolograms, FancyHolograms, HolographicDisplays, and native (display-entity) fallback. |
| Protections | WorldGuard, GriefPrevention, Lands, Towny — auto-detection and override. |
| Page | What it covers |
|---|---|
| Backups | Auto-snapshots, manual /egens backup, retention, restore. |
| Performance | Tick-jitter, async loot rolls, hologram refresh rate, profiler. |
| Metrics (bStats) | What we report, how to opt out. |
| Troubleshooting | Common errors and their fixes. |
| FAQ | Frequently asked questions. |
eGens is built by @epromite. If the plugin saves you time on your server, a one-time tip on Ko-fi is the single best way to keep it maintained:
- Bug reports & feature requests — Modrinth project page.
- Chat — https://discord.gg/pM4atmCVS6.