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.