5.1.0

The minimum compatible version requirement rarely changes between updates. Using the latest release is recommended.

⚠️ Breaking Changes

• [Package Rename] Several packages have been significantly renamed and reorganized. Projects that reference specific package paths will require import updates.

✨ New Features and Enhancements

• [New Feature] Added AdjacentRecipe: a recipe that requires input items to be placed adjacent to one another — a weakly shape-constrained recipe type.
• [Enhancement] Simplified constructors for several classes to reduce boilerplate in common use cases.

🛠 Fix

• Fixed an issue where item replacement after a craft did not work correctly when a customized crafting UI layout was applied.
• Fixed a critical bug in shapeless recipe matching where a recipe slot with no valid candidates was silently skipped instead of causing the match to fail. This allowed invalid ingredient combinations to incorrectly succeed and prevented some inputs from being consumed.

✨ New Features and Enhancements

• [New Feature] Added ReplaceableResultSupplier interface: writes items back into crafting UI slots after a craft, enabling ingredient transformation (e.g. returning a modified tool) and byproduct placement patterns.
• [New Feature] Added ResultSupplier.Context.CallMode enum (CRAFT / ICON): allows supply() implementations to distinguish a real craft from an icon-generation call (e.g. in the AllCandidateUI display), replacing the old isMultipleDisplayCall field.
• [New Feature] Added CraftInputInterruptEvent: fired when a player interacts with input slots or closes the CraftUI while a craft process is in progress.
• [New Feature] Added PreventDoubleCraftEvent: fired when a player attempts to start a new craft while one is already running.
• [Enhancement] Added PartialSearch API: asynchronous partial recipe match search for crafting hints and autocomplete suggestions. Supports both shaped and shapeless recipes.
• [New Feature] Added CVanillaRecipe.fromTransmute(): converts a vanilla TransmuteRecipe into a CVanillaRecipe, enabling transmute recipes to be used with PartialSearch and other CustomCrafter features. Each ingredient's RecipeChoice is converted to a CMatterPredicate via RecipeChoice.test(), so NBT and exact-item constraints are preserved.

🛠 Fix

• Fixed a race condition in ONLY_FIRST search mode that could return an empty result even when a matching recipe existed.
• Fixed isAsync() returning an inverted value in CMatterPredicate.Context and CRecipePredicate.Context.
• CompletableFuture tasks now consistently run on virtual threads.

🛠 Fix

• UI processing order

✨ New Features and Enhancements

• [Enhancement] Async interruption support
• [Enhancement] Faster rendering in AllCandidateUI
• [Enhancement] Folia support

5.0.19

✨ New Features and Enhancements

• [Enhancement] Search speed for shapeless recipes is now faster.

🛠 Fix

• Event internal fix