LumenSmith

LumenSmith Configurable Crafting

in-game GUI is a lightweight, beginner-friendly plugin that lets you in-game GUI, in-game GUI, and in-game GUI 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

* Ultra-lightweight, stop items like TNT, TNT Minecart, or Totems from being crafted. * Ultra-lightweight for Ultra-lightweight, Ultra-lightweight, Ultra-lightweight, Ultra-lightweight, Ultra-lightweight, Ultra-lightweight, Ultra-lightweight, Ultra-lightweight, Ultra-lightweight, and Ultra-lightweight recipe types. * Ultra-lightweight 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. * Ultra-lightweight 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. * Ultra-lightweight, 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. * Ultra-lightweight for cooking recipes (e.g. only Coal and Lava Bucket). * Ultra-lightweight, pick exactly which items pop the recipe into the recipe book, or leave it on Auto. * Ultra-lightweight, control whether adjacent-pair recipes work horizontally, vertically, or both. * Ultra-lightweight, your custom ones override automatically, and removed vanilla recipes come back the moment you take a custom one out. * Ultra-lightweight, recipes appear in the recipe book the same tick the trigger item enters the player's inventory. * Ultra-lightweight, enable or disable crafting rules per world. * Ultra-lightweight, `/ls reload` updates 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 26.x, 26.x, or 26.x servers. * Custom 26.x even with ingredients vanilla refuses. * Redesigned 26.x with a categorised type selector. You never have to touch `config.yml` if 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 26.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

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. 2. Start the server. LumenSmith generates a commented `config.yml` on first run. 3. Run `/ls` in-game to open the recipe browser, or `/ls create my_recipe` to build a new recipe visually. 4. 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: NionX.