{"id":96410,"date":"2026-06-05T15:34:46","date_gmt":"2026-06-05T12:34:46","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/"},"modified":"2026-06-05T15:34:46","modified_gmt":"2026-06-05T12:34:46","slug":"lumensmith","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/","title":{"rendered":"LumenSmith"},"content":{"rendered":"<p>![LumenSmithLogo1](https:\/\/cdn.modrinth.com\/data\/cached_images\/e9d096ac6857d987d5080c2a65d40c7510518001.png)<\/p>\n<p># LumenSmith Configurable Crafting<\/p>\n<p>**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`.<\/p>\n<p>No coding. No datapacks. No config editing required, just open the recipe creator and click.<\/p>\n<p>**Full documentation and guides on the wiki**<\/p>\n<p>&#8212;<\/p>\n<p>## What It Does<\/p>\n<p>* **Block vanilla crafting outputs**, stop items like TNT, TNT Minecart, or Totems from being crafted.<br \/>\n* **Add custom recipes** for **shaped**, **shapeless**, **furnace**, **blasting**, **smoking**, **campfire**, **stonecutting**, **smithing transform**, **adjacent-pair**, and **brewing-stand** recipe types.<br \/>\n* **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.<br \/>\n* **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.<br \/>\n* **Edit &#038; 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.<br \/>\n* **Fuel restrictions** for cooking recipes (e.g. only Coal and Lava Bucket).<br \/>\n* **Custom unlock triggers**, pick exactly which items pop the recipe into the recipe book, or leave it on Auto.<br \/>\n* **Adjacent pair direction**, control whether adjacent-pair recipes work horizontally, vertically, or both.<br \/>\n* **Auto-replace vanilla recipes**, your custom ones override automatically, and removed vanilla recipes come back the moment you take a custom one out.<br \/>\n* **Instant auto-unlock**, recipes appear in the recipe book the same tick the trigger item enters the player&#8217;s inventory.<br \/>\n* **World filter support**, enable or disable crafting rules per world.<br \/>\n* **Instant reloads**, `\/ls reload` updates recipes live, no restart needed.<br \/>\n* **Ultra-lightweight**, optimized with O(1) lookups, pre-computed data, and zero per-tick overhead.<\/p>\n<p>&#8212;<\/p>\n<p>## Documentation<\/p>\n<p>Everything is on the wiki, organised so you can jump straight to what you need.<\/p>\n<p>| Page | What&#8217;s on it |<br \/>\n|&#8212;&#8212;|&#8212;&#8212;&#8212;&#8212;&#8211;|<br \/>\n| **Home** | Overview, screenshots, quick start guide |<br \/>\n| **Commands** | Every `\/ls` command with examples and the in-game GUI explained |<br \/>\n| **Configuration** | Global settings, world filter, blocked outputs, full example `config.yml` |<br \/>\n| **Recipes** | All 10 recipe types with YAML snippets and field reference |<br \/>\n| **Permissions** | Permission nodes for crafting, admin, and GUI access |<br \/>\n| **Changelog** | Version history, what changed, why, and how to migrate |<br \/>\n| **Terms** | Licence and usage terms |<\/p>\n<p>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.<\/p>\n<p>&#8212;<\/p>\n<p>## Commands at a Glance<\/p>\n<p>| Command              | Description                                | Permission          |<br \/>\n| &#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8211; | &#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212; | &#8212;&#8212;&#8212;&#8212;&#8212;&#8212;- |<br \/>\n| `\/ls`                | Open the recipe browser GUI                 | `lumensmith.gui`    |<br \/>\n| `\/ls help`           | Show command overview                       | `lumensmith.gui`    |<br \/>\n| `\/ls list`           | List blocked outputs and custom recipes     | `lumensmith.admin`  |<br \/>\n| `\/ls reload`         | Reload `config.yml` and recipes live        | `lumensmith.admin`  |<br \/>\n| `\/ls rescan`         | Force every player&#8217;s recipe book to update  | `lumensmith.admin`  |<br \/>\n| `\/ls create <key>`   | Open the in-game recipe creator             | `lumensmith.create` |<br \/>\n| `\/ls delete <key>`   | Delete a custom recipe from config          | `lumensmith.admin`  |<\/p>\n<p>Full reference with screenshots: **Commands wiki page**.<\/p>\n<p>&#8212;<\/p>\n<p>## Supported Recipe Types<\/p>\n<p>| Type                 | What it covers                                    |<br \/>\n| &#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8211; | &#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;- |<br \/>\n| `shaped`             | 3&#215;3 crafting grid with a specific layout          |<br \/>\n| `shapeless`          | Any arrangement, up to 9 ingredients              |<br \/>\n| `adjacent_pair`      | Two blocks placed next to each other on the grid  |<br \/>\n| `furnace`            | Standard furnace smelting                         |<br \/>\n| `blasting`           | Blast furnace                                     |<br \/>\n| `smoking`            | Smoker                                            |<br \/>\n| `campfire`           | Campfire cooking                                  |<br \/>\n| `stonecutting`       | Stonecutter                                       |<br \/>\n| `smithing_transform` | Smithing table (template + base + addition)       |<br \/>\n| `brewing`            | Brewing stand (ingredient + bottle to new bottle) |<\/p>\n<p>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**.<\/p>\n<p>&#8212;<\/p>\n<p>## Why Use LumenSmith?<\/p>\n<p>* Perfect for **SMP**, **RPG**, or **custom survival** servers.<br \/>\n* Custom **brewing-stand recipes** even with ingredients vanilla refuses.<br \/>\n* Redesigned **in-game creator** with a categorised type selector. You never have to touch `config.yml` if you don&#8217;t want to.<br \/>\n* 100 % YAML when you do, clean and commented.<br \/>\n* Fully reload-safe with `\/ls reload`, no restarts to test new recipes.<br \/>\n* Blocks duplication exploits and crafting abuse by default. Removed vanilla recipes restore automatically when a custom one is taken out.<br \/>\n* Runs on **Paper \/ Purpur 1.21.x** and the new **26.x** API line.<br \/>\n* Ultra-lightweight, no external dependencies, clean console output.<\/p>\n<p>&#8212;<\/p>\n<p>## Example in Action<\/p>\n<p>![HowItWorks1](https:\/\/cdn.modrinth.com\/data\/cached_images\/c68fe1ef2aa88b6e395de43775d8b4b1776fe8fc.png)<br \/>\n![HowItWorks2](https:\/\/cdn.modrinth.com\/data\/cached_images\/6ccc78f9734153dc462f7d9f49f998c0334f6927.png)<br \/>\n![HowItWorks5](https:\/\/cdn.modrinth.com\/data\/cached_images\/4a8b4bad8bbd00aa0f93344dbe7121ce71da7303.png)<br \/>\n![HowItWorks6](https:\/\/cdn.modrinth.com\/data\/cached_images\/22be112156459030622398b7fe75132ec3f517c4.png)<\/p>\n<p>More screenshots on the **Home page**.<\/p>\n<p>&#8212;<\/p>\n<p>## Quick Start<\/p>\n<p>1. Drop the matching jar into your `plugins\/` folder. Use `lumensmith-0.1.5-mc1.21.11.jar` for classic Paper 1.21.x, or `lumensmith-0.1.5-mc26.1.2.jar` for the new Paper 26.x API line.<br \/>\n2. Start the server. LumenSmith generates a commented `config.yml` on first run.<br \/>\n3. Run `\/ls` in-game to open the recipe browser, or `\/ls create my_recipe` to build a new recipe visually.<br \/>\n4. Need help? Open the **wiki** or run `\/ls help`.<\/p>\n<p>&#8212;<\/p>\n<p>## License<\/p>\n<p>All Rights Reserved \u00a9 2025 &#8211; 2026<br \/>\n**NionX**, Creator of LumenSmith.<br \/>\nRedistribution or modification without permission is prohibited.<br \/>\nFull terms: **Terms of Service**.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Configurable recipe manager: disable vanilla recipes and add your own<\/p>\n","protected":false},"featured_media":96411,"template":"","meta":{"_minecraft_slug":"lumensmith","_minecraft_project_id":"B3BY6f3D","_minecraft_author":"NionX","_minecraft_license":"LicenseRef-LumenSmith-License","_minecraft_downloads":132,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lumensmith.zip","_minecraft_size_bytes":533026,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-15T18:56:20.646139Z","_minecraft_date_created":"2025-10-12T20:19:14.029852Z","_minecraft_date_modified":"2026-05-15T15:33:01.941686Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lumensmith","_minecraft_icon_attachment_id":96411,"_minecraft_imported_at":"2026-06-05T12:34:47+00:00","_minecraft_import_hash":"686c85aca286aa5960bfeb8c44708ca6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,873,126,127,128,129,123,92],"mod_loader":[132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-96410","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-library","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>LumenSmith - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"LumenSmith - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Configurable recipe manager: disable vanilla recipes and add your own\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lumensmith\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lumensmith\\\/\",\"name\":\"LumenSmith - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lumensmith\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lumensmith\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/lumensmith-icon-94a38963d6765730594aa68eed4b2196b29d982b_96.webp\",\"datePublished\":\"2026-06-05T12:34:46+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lumensmith\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lumensmith\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lumensmith\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/lumensmith-icon-94a38963d6765730594aa68eed4b2196b29d982b_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/lumensmith-icon-94a38963d6765730594aa68eed4b2196b29d982b_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lumensmith\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"LumenSmith\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"LumenSmith - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/","og_locale":"en_US","og_type":"article","og_title":"LumenSmith - Minecraft","og_description":"Configurable recipe manager: disable vanilla recipes and add your own","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/","name":"LumenSmith - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/lumensmith-icon-94a38963d6765730594aa68eed4b2196b29d982b_96.webp","datePublished":"2026-06-05T12:34:46+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/lumensmith-icon-94a38963d6765730594aa68eed4b2196b29d982b_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/lumensmith-icon-94a38963d6765730594aa68eed4b2196b29d982b_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/lumensmith\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"LumenSmith"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/96410","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/96411"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=96410"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=96410"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=96410"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=96410"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}