
一个开箱即用、适用于生产环境的现代 Minecraft 服务器生成器插件。放置生成器方块,观察其运作,出售战利品,升级层级,然后循环往复。从第一天起就专为 1.21 时代构建,并提供对 Paper 和 Folia 的一流支持。

需要文档?完整文档位于
。打开 Wiki 标签页以侧边栏布局查看相同内容。
为什么选择 eGens
- Paper 和 Folia,同一个 jar。 所有调度器调用都经过
一个感知 Folia 的包装器。Folia 上的区域线程,经典 Paper
的世界线程——无需单独的构建版本。
- 28 个预设等级,无需 Java 知识。 三套主题链条开箱即用(原版、生物、元素)。您可以替换、扩展或使用 YAML 编写全新的链条。
- 从构造上防止重复掉落。 每次掉落都会盖上持久数据 ID 戳;每次出售、每次使用出售法杖、每次生成器刻都经过针对每个资源的锁。审计日志会捕捉那些试图钻空子的玩家的情况。
- MySQL 多实例支持。 将网络中的所有游戏服务器指向同一个数据库,保持行级锁开启,生成器在所有服务器上表现一致。
- 内置备份服务。 为 SQLite 提供定期的
VACUUM INTO 快照,为 MySQL 提供由 mysqldump 驱动的转储,并带有保留期修剪功能。手动 /egens backup 在控制台中也可用。
- 内置性能分析器。
/egens profile 会在您需要追踪卡顿峰值时呈现前 N 名热点摘要。禁用时无额外开销。
开箱即用的功能
横跨 3 条链的 28 个预设等级
- 原版链(10 个等级): 木头 → 石头 → 铜 → 铁 →
金 → 红石 → 青金石 → 钻石 → 绿宝石 → 下界合金。
- 生物链(10 个等级): 僵尸 → 骷髅 → 蜘蛛 → 苦力怕
→ 末影人 → 烈焰人 → 恶魂 → 女巫 → 潜影贝 → 凋灵。
- 元素链(8 个等级): 土 → 水 → 火 → 风 →
冰 → 闪电 → 末影 → 虚空。
每个等级都有自己独立的 MiniMessage 显示名称、背景故事模板、
材质、刻间隔、容量、耐久度、掉落列表、商店价格和修复公式。所有设置均可在 YAML 中按等级调整。
五种生成器事件
- 出售倍率 — 在活动窗口期内,每次
/sell、/sellall、出售法杖出售时倍率为 2×。
- 掉落数量 — 增加每刻产生的堆叠大小倍数。
- 掉落等级 — 生成器暂时滚动下一级战利品表的掉落。
- 速度提升 — 生成器加速运行(硬限制以防止配置错误的值烧毁区域线程)。
- 随机混合 — 每刻随机滚动一个已注册等级的掉落。
自动轮换在后台运行。管理员也可以使用 /egens event grant <player> <id> 为个人事件分配权限,并可配置每位玩家的槽位上限。
出售法杖预设
三种捆绑的法杖(新手、老兵、大师),倍率分别为 1.5×、2.5×、5.0×。每次铸造的法杖都带有防重复掉落戳。右键点击箱子、 barrels 或潜影盒即可通过掉落注册表出售其内容。可通过 sellwands.yml 按服务器进行配置。
掉落注册表
单个 drops.yml 定义了服务器上所有可出售的物品。可出售的自定义头颅掉落是一等公民——每个掉落都以 ID 为键,而不是材质,因此两个视觉上相同但 ID 不同的物品可以拥有不同的价格、背景故事和制作规则。可以将掉落标记为 craft: false 使其成为仅可出售的货币代币。
集成
| 插件 |
用途 |
| Vault |
升级、修复、商店、出售、出售法杖所必需。自动检测。 |
| PlaceholderAPI |
用于掉落条件和事件触发。 |
| DecentHolograms / FancyHolograms / HolographicDisplays |
浮动名称板。回退到原生原版显示实体。 |
| WorldGuard / GriefPrevention / Lands / Towny |
区域保护——生成器尊重领地建造权限。 |
| HeadDatabase |
可选的层级图标自定义头颅纹理来源。 |
| ItemsAdder / Oraxen |
自定义模型物品材质原样通过。 |
| ShopGUIPlus / EconomyShopGUI |
如果您偏好自己的商店层,可委托处理。 |
| DeluxeSellwands |
和平共存——内置出售法杖可以禁用。 |
命令一览
/egens menu 打开中心菜单。
/egens shop 购买生成器。
/egens info 检查目标生成器。
/egens upgrade 升级等级或晋升层级(先引用,再次确认)。
/egens repair 修复损坏的生成器。
/egens sell 通过掉落注册表出售手持物品。
/egens sellall 出售背包中所有可出售的物品。
/egens settings 每位玩家的切换选项(语言环境、全息图、声音、Boss 栏)。
/egens help 按权限过滤的帮助信息。
管理员附加命令:/egens give、/egens reload、/egens backup、
/egens profile、/egens debug、/egens event、/egens sellwand。
别名:/eg、/gens。
要求
- 服务器: Paper 或 Folia,1.21 – 1.21.4。
- Java: 21+。
- 数据库: 内置 SQLite(零设置)或 MySQL / MariaDB
用于多实例网络。
- Vault: 任何涉及金钱的功能(升级、
商店、出售、出售法杖)所必需。如果没有 Vault,这些功能
会优雅地回退到“功能离线”磁贴。
安装
- 将
egens-<version>.jar 放入服务器的 plugins/ 文件夹。
- 启动服务器。eGens 会在
plugins/eGens/ 下生成其配置树。
- (可选)安装 Vault、PlaceholderAPI 和一个全息图
提供者——eGens 会自动检测所有支持的功能。
- 使用
/egens give <you> wood 1 验证,然后右键点击该方块。
完整安装说明:。
本地化
捆绑的语言环境:id_ID(印度尼西亚语,默认)和 en_US
(英语)。通过复制 lang/en_US.yml、翻译并在 config.yml 中列出标签来添加您自己的语言环境。所有面向玩家的字符串均由 MiniMessage 渲染。
文档
完整的操作员手册位于
:
- 入门指南(安装、权限、存储)
- 命令(管理员和玩家参考)
- 配置(
config.yml、events.yml、gui/*.yml、
sellwands.yml、本地化)
- 生成器(概述、预设链条、自定义等级、掉落
注册表、平衡指南)
- 集成(Vault、PlaceholderAPI、全息图、保护机制)
- 操作(备份、性能调优、指标监控、故障排除、常见问题解答)
支持开发
如果 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
. 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: .
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
:
- 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:
Every tip pays for hours of bug fixes and new feature work.
Thank you.
评论 0
登录后参与评分
还没有评论,来抢沙发吧