LumenSmith

!(https://cdn.modrinth.com/data/cached_images/e9d096ac6857d987d5080c2a65d40c7510518001.png)

# 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.

*(https://nionx101.github.io/LumenSmith/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 `, 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 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](https://nionx101.github.io/LumenSmith/wiki/) | Overview, screenshots, quick start guide | | [Commands](https://nionx101.github.io/LumenSmith/wiki/commands.html) | Every `/ls` command with examples and the in-game GUI explained | | [Configuration](https://nionx101.github.io/LumenSmith/wiki/configuration.html) | Global settings, world filter, blocked outputs, full example `config.yml` | | [Recipes](https://nionx101.github.io/LumenSmith/wiki/recipes.html) | All 10 recipe types with YAML snippets and field reference | | [Permissions](https://nionx101.github.io/LumenSmith/wiki/permissions.html) | Permission nodes for crafting, admin, and GUI access | | [Changelog](https://nionx101.github.io/LumenSmith/wiki/changelog.html) | Version history, what changed, why, and how to migrate | | [Terms](https://nionx101.github.io/LumenSmith/wiki/terms.html) | Licence and usage terms |

New here? Start with the [Quick Start guide](https://nionx101.github.io/LumenSmith/wiki/#quick-start) on the home page. Want to build a recipe right now? See [`/ls create`](https://nionx101.github.io/LumenSmith/wiki/commands.html#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 ` | Open the in-game recipe creator | `lumensmith.create` | | `/ls delete ` | Delete a custom recipe from config | `lumensmith.admin` |

Full reference with screenshots: [Commands wiki page](https://nionx101.github.io/LumenSmith/wiki/commands.html).

## Supported Recipe Types

| Type | What it covers | | -------------------- | ------------------------------------------------- | | `shaped` | 3