LumenSmithLogo1

LumenSmith Configurable Crafting

LumenSmith is a lightweight, beginner-friendly plugin that lets you disable, replace, and create crafting recipes on your Paper, Spigot, 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.

✦ What It Does

Block vanilla crafting outputs stop items like TNT, TNT Minecart, or Totems from being crafted.
Add custom recipes supports shaped, shapeless, furnace, blasting, smoking, campfire, stonecutting, smithing transform, and adjacent-pair recipe types.
In-game recipe creator 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 recipes, then edit or delete them with one click.
Fuel restrictions limit which fuels are allowed for cooking recipes (e.g. only Coal and Lava Bucket).
Adjacent pair direction control whether adjacent-pair recipes work horizontally, vertically, or both.
Auto-replace vanilla recipes your custom ones override automatically.
Instant auto-unlock recipes appear in the recipe book as soon as players obtain the required trigger items.
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. Runs on any server.

🧭 Commands

Command	Description	Permission
`/ls help`	Show command overview and version info	`lumensmith.admin`
`/ls list`	List all blocked outputs and custom recipes	`lumensmith.admin`
`/ls reload`	Reload configuration and recipes instantly	`lumensmith.admin`
`/ls rescan`	Force all players' recipe books to update	`lumensmith.admin`
`/ls recipes`	Browse all custom recipes in a visual GUI	(none)
`/ls create <key>`	Open the in-game recipe creator	`lumensmith.create`
`/ls delete <key>`	Delete a custom recipe from config	`lumensmith.admin`

🧩 Example Configuration

remove_by_output:
  - TNT
  - TNT_MINECART

custom_recipes:
  - key: "ender_eye_bundle"
    type: "shaped"
    shape: ["ABC", "DEF", "GHI"]
    ingredients:
      A: "ECHO_SHARD"
      B: "PRISMARINE_CRYSTALS"
      C: "BLAZE_POWDER"
      D: "RESIN_CLUMP"
      E: "ENDER_PEARL"
      F: "NETHERITE_UPGRADE_SMITHING_TEMPLATE"
      G: "HEART_OF_THE_SEA"
      H: "WIND_CHARGE"
      I: "TOTEM_OF_UNDYING"
    result:
      item: "ENDER_EYE"
      amount: 12
    auto_unlock_on: ["ENDER_PEARL"]

  - key: "obsidian_smelt"
    type: "furnace"
    input: "CRYING_OBSIDIAN"
    experience: 1.0
    cooking_time: 200
    allowed_fuels:
      - COAL
      - LAVA_BUCKET
    result:
      item: "OBSIDIAN"
      amount: 1

  - key: "diamond_gold_pair"
    type: "adjacent_pair"
    items: ["DIAMOND_BLOCK", "GOLD_BLOCK"]
    direction: "horizontal"
    result:
      item: "NETHERITE_BLOCK"
      amount: 1

This disables TNT crafting and adds three custom recipes: a shaped Ender Eye recipe, a furnace smelting recipe with fuel restrictions, and an adjacent-pair recipe that triggers when two blocks are placed side by side.

✦ Supported Recipe Types

Type	Description
`shaped`	3x3 crafting grid with specific layout
`shapeless`	Any arrangement, up to 9 ingredients
`furnace`	Standard furnace smelting
`blasting`	Blast furnace recipe
`smoking`	Smoker recipe
`campfire`	Campfire cooking
`stonecutting`	Stonecutter recipe
`smithing_transform`	Smithing table (template + base + addition)
`adjacent_pair`	Two blocks placed next to each other in crafting