egens

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.

Looking for documentation? Full docs live at
https://github.com/epromc/egens-plugins. 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 <player> <id> 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 generator.
/egens upgrade    Upgrade level or promote tier (quote first, confirm again).
/egens repair     Repair a corrupted generator.
/egens sell       Sell the held item via the drops registry.
/egens sellall    Sell every sellable item in your inventory.
/egens settings   Per-player toggles (locale, holograms, sounds, bossbar).
/egens help       Filtered by permission.

Admin extras: /egens give, /egens reload, /egens backup,
/egens profile, /egens debug, /egens event, /egens sellwand.
Aliases: /eg, /gens.

Requirements

Server: Paper or Folia, 1.21 – 1.21.4.
Java: 21+.
Database: Built-in SQLite (zero setup) or MySQL / MariaDB
for multi-instance networks.
Vault: Required for any money-touching feature (upgrade,
shop, sell, sellwand). Without Vault, those features
gracefully fall back to "feature offline" tiles.

Installation

Drop egens-<version>.jar into your server's plugins/ folder.
Start the server. eGens generates its config tree under
plugins/eGens/.
(Optional) install Vault, PlaceholderAPI, and a hologram
provider — eGens auto-detects everything supported.
Verify with /egens give <you> wood 1 and right-click the
block.

Full setup notes: https://github.com/epromc/egens-plugins/blob/main/docs/getting-started/install.md.

Localization

Bundled locales: id_ID (Bahasa Indonesia, default) and en_US
(English). Add your own by copying lang/en_US.yml, translating,
and listing the tag in config.yml. Every player-facing string
is MiniMessage-rendered.

Documentation

The full operator manual lives at
https://github.com/epromc/egens-plugins:

Getting started (install, permissions, storage)
Commands (admin and player references)
Configuration (config.yml, events.yml, gui/*.yml,
sellwands.yml, localisation)
Generators (overview, premade chains, custom tiers, drops
registry, balance guide)
Integrations (Vault, PlaceholderAPI, holograms, protections)
Operations (backups, performance tuning, metrics, troubleshooting,
FAQ)

Support development

If eGens saves you hours of server admin work, consider dropping
a tip:

Tip on Ko-fi → ko-fi.com/epromite/tip

Every tip pays for hours of bug fixes and new feature work.
Thank you.

eGENS

📖About eGENS