
LumenSmith Configurable Crafting
LumenSmith 是一款轻量级、适合新手的插件,允许你通过游戏内 GUI 或简单的 config.yml 在 Paper 或 Purpur 服务器上完全禁用、替换和创建合成配方。
无需编写代码,无需数据包,也无需手动编辑配置文件,只需打开配方创建器并点击即可。
功能介绍
- 阻止原版合成输出:禁止合成 TNT、TNT 矿车或图腾等物品。
- 添加自定义配方:支持形状(shaped)、无形状(shapeless)、熔炉(furnace)、blast furnace(blasting)、烟熏炉(smoking)、营火(campfire)、切石机(stonecutting)、锻造台转换(smithing transform)、相邻对(adjacent-pair)以及酿造台(brewing-stand)等多种类型的配方。
- 自定义酿造配方:支持任何材料作为原料,包括原版通常拒绝的物品,如原木、方块和工具。播放完整的 20 秒酿造动画,消耗烈焰粉,并像原版一样替换瓶子。
- 游戏内配方创建器:提供分类的类型选择器(合成 / 烹饪 / 切石 / 锻造 / 酿造)。使用
/ls create <key>可视化构建配方,点击槽位,从背包中选择物品,调整烹饪时间、燃料限制等。无需编辑配置文件。 - 在游戏内编辑和删除配方:使用
/ls浏览你的配方,然后通过一次点击进行编辑或删除。浏览器中的快捷操作按钮可打开创建器、切换删除模式或切换到已阻止输出的视图。 - 烹饪配方的燃料限制:例如仅限煤炭和岩浆桶。
- 自定义解锁触发器:精确指定哪些物品会将配方弹出到配方书中,或者保持自动模式。
- 相邻对方向控制:控制相邻对配方是仅在水平方向、垂直方向还是两个方向都有效。
- 自动替换原版配方:你的自定义配方会自动覆盖原版配方,当你移除自定义配方时,被禁用的原版配方会立即恢复。
- 即时自动解锁:当触发物品进入玩家背包的同一刻,配方就会出现在配方书中。
- 世界过滤支持:可按世界启用或禁用合成规则。
- 即时重载:执行
/ls reload即可实时更新配方,无需重启服务器。 - 超轻量级:采用 O(1) 查找优化、预计算数据,且每 tick 零开销。
文档
所有内容均位于 Wiki 上,组织有序,方便你直接跳转到所需内容。
| 页面 | 内容说明 |
|---|---|
| 首页 | 概述、截图、快速入门指南 |
| 命令 | 所有 /ls 命令示例及游戏内 GUI 详解 |
| 配置 | 全局设置、世界过滤、已阻止的输出、完整的 config.yml 示例 |
| 配方 | 所有 10 种配方类型及其 YAML 片段和字段参考 |
| 权限 | 用于合成、管理和 GUI 访问的权限节点 |
| 更新日志 | 版本历史、变更内容、原因及迁移指南 |
| 条款 | 许可和使用条款 |
新用户?请从首页的快速入门指南开始。想立即创建一个配方?请参阅命令参考中的 /ls create。
命令一览
| 命令 | 描述 | 权限 |
|---|---|---|
/ls |
打开配方浏览器 GUI | lumensmith.gui |
/ls help |
显示命令概览 | lumensmith.gui |
/ls list |
列出已阻止的输出和自定义配方 | lumensmith.admin |
/ls reload |
实时重载 config.yml 和配方 |
lumensmith.admin |
/ls rescan |
强制更新所有玩家的配方书 | lumensmith.admin |
/ls create <key> |
打开游戏内配方创建器 | lumensmith.create |
/ls delete <key> |
从配置中删除自定义配方 | lumensmith.admin |
带截图的完整参考:命令 Wiki 页面。
支持的配方类型
| 类型 | 涵盖范围 |
|---|---|
shaped |
具有特定布局的 3x3 合成网格 |
shapeless |
任意排列,最多 9 种材料 |
adjacent_pair |
网格中相邻放置的两个方块 |
furnace |
标准熔炉冶炼 |
blasting |
高炉 |
smoking |
烟熏炉 |
campfire |
营火烹饪 |
stonecutting |
切石机 |
smithing_transform |
锻造台(模板 + 基础 + 附加材料) |
brewing |
酿造台(原料 + 瓶子变为新瓶子) |
所有类型的字段参考和 YAML 示例均可在 配方 Wiki 页面 上找到。完整的带注释 config.yml 可在 配置页面 获取。
为何使用 LumenSmith?
- 非常适合 SMP、RPG 或 自定义生存 服务器。
- 支持自定义 酿造台配方,即使原料是原版拒绝接受的。
- 重新设计的 游戏内创建器,带有分类的类型选择器。如果您愿意,甚至可以完全不触碰
config.yml。 - 若您选择使用 YAML,其格式为 100% YAML,干净且带有注释。
- 完全支持热重载,通过
/ls reload命令即可测试新配方,无需重启服务器。 - 默认阻止物品复制漏洞和合成滥用。移除自定义配方时,对应的原版配方会自动恢复。
- 兼容 Paper / Purpur 1.21.x 以及新的 26.x API 系列。
- 超轻量级,无外部依赖,控制台输出整洁。
实际效果示例

更多截图请参见 主页。
快速开始
- 将对应的 jar 文件放入
plugins/文件夹。经典 Paper 1.21.x 请使用lumensmith-0.1.5-mc1.21.11.jar,新的 Paper 26.x API 系列请使用lumensmith-0.1.5-mc26.1.2.jar。 - 启动服务器。LumenSmith 会在首次运行时生成一个带有注释的
config.yml。 - 在游戏中运行
/ls打开配方浏览器,或运行/ls create my_recipe以可视化方式构建新配方。 - 需要帮助?请查阅 Wiki 或在游戏中运行
/ls help。
许可证
保留所有权利 © 2025 - 2026 NionX,LumenSmith 的创作者。 未经许可以任何形式再分发或修改均被禁止。 完整条款:服务条款。

LumenSmith Configurable Crafting
LumenSmith is a lightweight, beginner-friendly plugin that lets you disable, replace, and create crafting recipes on your Paper or Purpur server entirely through an in-game GUI or a simple config.yml.
No coding. No datapacks. No config editing required, just open the recipe creator and click.
Full documentation and guides on the wiki
What It Does
- Block vanilla crafting outputs, stop items like TNT, TNT Minecart, or Totems from being crafted.
- Add custom recipes for shaped, shapeless, furnace, blasting, smoking, campfire, stonecutting, smithing transform, adjacent-pair, and brewing-stand recipe types.
- Custom brewing recipes with any ingredient, including items vanilla normally refuses like logs, blocks, and tools. A full 20-second brew animation plays, blaze powder is consumed, and the bottles are replaced just like vanilla.
- In-game recipe creator with a categorised type selector (Crafting / Cooking / Stonecutting / Smithing / Brewing). Build recipes visually with
/ls create <key>, click slots, pick items from your inventory, adjust cooking time, fuel restrictions, and more. No config editing needed. - Edit & delete recipes in-game, browse your recipes with
/ls, then edit or delete them with one click. Quick-action buttons in the browser open the creator, toggle a Delete Mode, or switch to a Blocked Outputs view. - Fuel restrictions for cooking recipes (e.g. only Coal and Lava Bucket).
- Custom unlock triggers, pick exactly which items pop the recipe into the recipe book, or leave it on Auto.
- Adjacent pair direction, control whether adjacent-pair recipes work horizontally, vertically, or both.
- Auto-replace vanilla recipes, your custom ones override automatically, and removed vanilla recipes come back the moment you take a custom one out.
- Instant auto-unlock, recipes appear in the recipe book the same tick the trigger item enters the player's inventory.
- World filter support, enable or disable crafting rules per world.
- Instant reloads,
/ls reloadupdates recipes live, no restart needed. - Ultra-lightweight, optimized with O(1) lookups, pre-computed data, and zero per-tick overhead.
Documentation
Everything is on the wiki, organised so you can jump straight to what you need.
| Page | What's on it |
|---|---|
| Home | Overview, screenshots, quick start guide |
| Commands | Every /ls command with examples and the in-game GUI explained |
| Configuration | Global settings, world filter, blocked outputs, full example config.yml |
| Recipes | All 10 recipe types with YAML snippets and field reference |
| Permissions | Permission nodes for crafting, admin, and GUI access |
| Changelog | Version history, what changed, why, and how to migrate |
| Terms | Licence and usage terms |
New here? Start with the Quick Start guide on the home page. Want to build a recipe right now? See /ls create in the command reference.
Commands at a Glance
| Command | Description | Permission |
|---|---|---|
/ls |
Open the recipe browser GUI | lumensmith.gui |
/ls help |
Show command overview | lumensmith.gui |
/ls list |
List blocked outputs and custom recipes | lumensmith.admin |
/ls reload |
Reload config.yml and recipes live |
lumensmith.admin |
/ls rescan |
Force every player's recipe book to update | lumensmith.admin |
/ls create <key> |
Open the in-game recipe creator | lumensmith.create |
/ls delete <key> |
Delete a custom recipe from config | lumensmith.admin |
Full reference with screenshots: Commands wiki page.
Supported Recipe Types
| Type | What it covers |
|---|---|
shaped |
3x3 crafting grid with a specific layout |
shapeless |
Any arrangement, up to 9 ingredients |
adjacent_pair |
Two blocks placed next to each other on the grid |
furnace |
Standard furnace smelting |
blasting |
Blast furnace |
smoking |
Smoker |
campfire |
Campfire cooking |
stonecutting |
Stonecutter |
smithing_transform |
Smithing table (template + base + addition) |
brewing |
Brewing stand (ingredient + bottle to new bottle) |
Field reference and a YAML example for every type lives on the Recipes wiki page. A complete annotated config.yml is on the Configuration page.
Why Use LumenSmith?
- Perfect for SMP, RPG, or custom survival servers.
- Custom brewing-stand recipes even with ingredients vanilla refuses.
- Redesigned in-game creator with a categorised type selector. You never have to touch
config.ymlif you don't want to. - 100 % YAML when you do, clean and commented.
- Fully reload-safe with
/ls reload, no restarts to test new recipes. - Blocks duplication exploits and crafting abuse by default. Removed vanilla recipes restore automatically when a custom one is taken out.
- Runs on Paper / Purpur 1.21.x and the new 26.x API line.
- Ultra-lightweight, no external dependencies, clean console output.
Example in Action

More screenshots on the Home page.
Quick Start
- Drop the matching jar into your
plugins/folder. Uselumensmith-0.1.5-mc1.21.11.jarfor classic Paper 1.21.x, orlumensmith-0.1.5-mc26.1.2.jarfor the new Paper 26.x API line. - Start the server. LumenSmith generates a commented
config.ymlon first run. - Run
/lsin-game to open the recipe browser, or/ls create my_recipeto build a new recipe visually. - Need help? Open the wiki or run
/ls help.
License
All Rights Reserved © 2025 - 2026 NionX, Creator of LumenSmith. Redistribution or modification without permission is prohibited. Full terms: Terms of Service.
下载 LumenSmith
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LumenSmith
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LumenSmith
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LumenSmith
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LumenSmith
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LumenSmith
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LumenSmith
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
LumenSmith 0.1.5,适用于 Paper 新的 26.x API 系列。
功能集与 1.21.11 构建版本相同,已针对 Paper API 26.1.2.build.63-stable 重新编译。仅当你的服务器运行使用新版号方案的 Paper / Purpur 构建时,才请使用此 jar 文件。源码树与行为完全一致,只是目标 API 不同,以便在新 API 上正确解析符号。
如需完整的功能列表和修复说明,请参阅本版本页面上 1.21.11 jar 文件的更新日志。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧