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

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

1. Drop egens-<version>.jar into your server's plugins/ folder.
2. Start the server. eGens generates its config tree under
   plugins/eGens/.
3. (Optional) install Vault, PlaceholderAPI, and a hologram
   provider — eGens auto-detects everything supported.
4. 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.