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

---

🧱 Why Use LumenSmith?

• Perfect for SMP, RPG, or custom survival servers
• 100 % YAML-based configuration no coding required
• In-game recipe creator no need to touch config files
• Fully reload-safe
• Prevents duplication exploits and crafting abuse
• Ultra-lightweight runs on any server with minimal resources
• Clean console logs and professional structure

---

💬 Example in Action

---

🧾 License

All Rights Reserved © 2025
Benjamin Juhász (NionX) Creator of LumenSmith
Redistribution or modification without permission is prohibited.