LumenSmith 0.1.5 for Paper's new 26.x API line. Same feature set as the 1.21.11 build, recompiled against Paper API `26.1.2.build.63-stable`. Use this jar only if your server is running a Paper / Purpur build that uses the new versioning scheme. Identical source tree, identical behaviour, just a different API target so the jar resolves the correct symbols on the new API. For the full feature list and bug-fix notes, see the 1.21.11 jar's changelog on this version page.

LumenSmith 0.1.5 for Paper / Purpur 1.21.x. **New** * Brewing recipe type. Custom (ingredient, bottle) pairs produce custom potions, including ingredients vanilla refuses like logs or blocks. A 20-second brew animation plays, blaze powder is consumed, and the bottles are replaced just like vanilla. * Recipe browser quick actions. Nether Star opens the creator with a chat prompt for the key. TNT (admin only) toggles Delete Mode, shift-click a recipe to remove it. Barrier switches to a Blocked Outputs view of `remove_by_output`. * Reorganised recipe creator with a categorised type selector (Crafting / Cooking / Stonecutting / Smithing / Brewing). * Custom unlock triggers. Pick exactly which materials pop a recipe into the recipe book, or leave it on Auto. * `/ls` with no arguments now opens the recipe browser directly. * Instant auto-unlock. Recipe-book entries appear the same tick the trigger item enters the player's inventory. **Fixes** * Right-clicking a lit campfire with a custom ingredient now places the item correctly. * Strict NamespacedKey map prevents vanilla recipes from inheriting a custom recipe's permission or cooldown. * Cooldown autosave builds its snapshot on the main thread, writes async, no ConcurrentModificationException risk. * Reload restores removed vanilla recipes automatically when the matching custom recipe is gone. * Adjacent-pair rotations now share a recipe group so all placements unlock together. * Result-slot cooldown / permission / max-craft checks now fire for SWAP_OFFHAND (F) and drop (Q) clicks too. **Hardening** * GUI delete now requires `lumensmith.admin`, same as `/ls delete`. * Tab completion respects permissions, non-admins no longer see recipe keys via `/ls delete <TAB>`. * Inventory routing migrated to `InventoryHolder`-based dispatch, future-safe against the deprecated `view.getTitle()` API.

# LumenSmith v0.1.4 — Major Update --- ## New Features ### In-Game Recipe Creator (`/ls create <key>`) - Full click-based GUI recipe builder — no YAML editing needed - Supports **all 9 recipe types**: shaped, shapeless, furnace, blasting, smoking, campfire, stonecutting, smithing transform, and adjacent pair - Click a slot, then click any item in your inventory to assign materials - **Type selector** — pick your recipe type visually, change it anytime - **Result amount control** — set output amount from 1-64 with +/- buttons (always starts at 1 when picking an item) - **Cooking controls** — adjust cooking time (+/-50 ticks) and experience (+/-0.1) directly in the GUI - **Fuel selector** — restrict which fuels are allowed for cooking recipes (click to add fuels, right-click to clear) - **Direction option** — for adjacent pair recipes, choose horizontal, vertical, or both placement directions - Auto-generates `auto_unlock_on` from ingredients - Saves directly to `config.yml` and reloads instantly ### Recipe Editing - **Edit button** in recipe detail view (writable book icon) — loads existing recipe into the creator with all data pre-filled - Supports editing all recipe types including shaped grid layout, cooking settings, fuel restrictions, and direction - Saves changes in-place (replaces old config entry) ### Recipe Deletion - **Delete button** in recipe detail view (TNT icon) — removes recipe from config with one click - Instantly reloads after deletion ### Adjacent Pair Direction - New `direction` config field for adjacent pair recipes: `horizontal`, `vertical`, or `both` (default) - Controls which placement orientations are registered - Fully configurable from both YAML and the in-game creator --- ## Bug Fixes ### Smelting Output Fix - Fixed critical bug where custom cooking recipe outputs were blocked by `remove_by_output` - Example: custom "Crying Obsidian -> Obsidian" recipe was blocked because OBSIDIAN was in the blocked outputs list - Custom recipes now correctly bypass the vanilla output blocker ### Fuel Enforcement Fix - Switched from `FurnaceSmeltEvent` to `FurnaceBurnEvent` for fuel checking - `FurnaceBurnEvent` fires **before** fuel is consumed, making `getFuel()` reliable - Prevents infinite smelting loops when wrong fuel was used ### Ingredient Display Deduplication - `/ls recipes` browser and detail view now groups duplicate ingredients - Shows `STONE x9` instead of listing STONE nine separate times - Applies to both shapeless and shaped recipe displays --- ## Performance Optimizations ### O(1) Fuel Index Lookup - Pre-built `cookingFuelIndex` map in RecipeLoader (built once during config load) - `CookingBlockListener.onBurn` now uses direct map lookup instead of iterating all recipes - Reduces furnace burn event processing from O(n) to O(1) where n = total recipe count ### Memory Leak Prevention - Creator sessions are now cleaned up on `PlayerQuitEvent` - Prevents session map from growing unbounded when players disconnect without closing the GUI ### Existing Optimizations - Pre-computed static messages in BlockCraftListener (no string processing on hot paths) - Debounced recipe book rescanning with `pendingRescan` set + 2-tick delay - `boolean[]` indexed by `Material.ordinal()` for O(1) material presence checks in UnlockListener - Immutable `List.copyOf` / `Map.copyOf` for cached recipe data --- ## Permissions | Permission | Description | |---|---| | `lumensmith.admin` | Access to `/ls reload`, `/ls rescan`, `/ls list`, `/ls delete` | | `lumensmith.create` | Access to `/ls create`, edit, and delete recipes from GUI | --- ## Config Changes New optional fields for cooking recipes: ```yaml custom_recipes: - key: "my_smelt" type: "furnace" input: "CRYING_OBSIDIAN" experience: 1.0 cooking_time: 200 allowed_fuels: # NEW — restrict fuel types - COAL - LAVA_BUCKET result: item: "OBSIDIAN" amount: 1 ``` New optional field for adjacent pair recipes: ```yaml - key: "my_pair" type: "adjacent_pair" items: ["DIAMOND_BLOCK", "GOLD_BLOCK"] direction: "horizontal" # NEW — horizontal, vertical, or both (default) result: item: "NETHERITE_BLOCK" amount: 1 ``` --- **Full Changelog**: v0.1.3 -> v0.1.4

# LumenSmith 0.1.3 --- ### ✦ Added * **Instant recipe unlocks** players now automatically unlock custom recipes the moment they obtain any item listed in `auto_unlock_on`. * **/ls rescan** command instantly refreshes all players’ recipe books without reloading the plugin. * **World filter improvements** more stable handling when switching between `whitelistworldoff: true/false`. --- ### ✦ Fixed * Fixed a bug where players had to **rejoin** the server or restart to see newly unlocked recipes. * Fixed delayed unlocks when using `/give`, crafting, or picking up trigger items. * Fixed rare cases where crafting events didn’t update the recipe book correctly. --- ### ✦ Improved * Refined **UnlockListener** for smoother and faster detection of inventory changes. * Small cleanup and safety checks for reload and recipe validation. * Polished internal logs and better formatting for `/ls list`. --- ### ✦ Notes This version focuses entirely on real-time recipe unlocking and smoother gameplay no more relogs, no restarts. Next version (0.1.4) is coming soon, as fast as possible!

- Added full support for world_filter — LumenSmith features can now be enabled globally or restricted to specific worlds. - Added adjacent_pair recipe type: lets two items crafted side-by-side or vertically anywhere on the 3×3 grid produce a result. - Added auto_unlock_on fix — recipes now appear correctly in the green book once a player obtains any listed items. - Added /ls rescan command to re-check all online players’ inventories and unlock missing recipes instantly. - Added /ls fixbook command to clean duplicate or outdated recipe entries in players’ books. - Improved /ls list output for better readability and detailed recipe status. - Improved configuration comments and layout for a clearer, beginner-friendly setup. - Minor internal cleanup and stability improvements on Paper / Spigot 1.21.x.

Added full protection for remove_by_output items → Blocked items can no longer be clicked, shift-crafted, or taken from the crafting table. → Ingredients are not consumed, and the result slot stays empty. Added extra safety checks for drag and result slot interactions. Updated /ls help version info to v0.1.1. Improved overall crafting event handling for Paper & Spigot 1.21.x.

# LumenSmith 0.1.0 | Initial Release Added support for custom shaped and shapeless recipes via config.yml Added remove_by_output to block crafting of vanilla items (e.g., TNT, TNT Minecart) Added auto_unlock_on so recipes appear automatically in the recipe book when a trigger item is obtained Added /lumensmith command (alias /ls) /ls help – show available commands /ls list – list blocked outputs and custom recipes /ls reload – reload all recipes and configuration Added beginner-friendly configuration layout with clear comments Added automatic replacement of vanilla recipes when custom ones use the same key Added colored console summary of loaded recipes Added permission system (lumensmith.admin) Fully reload-safe and compatible with Paper, Spigot, and Purpur (1.20.x – 1.21.x)