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

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

Full reference with screenshots: Commands wiki page.

Supported Recipe Types

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

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: Terms of Service.