![CraftingLib](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/social-preview-1280x640.png) # CraftingLib 4.0 **Custom recipes for every station, on every Bukkit server from 1.8 to the latest Paper.** One API — the version differences are handled for you. [GitHub](https://github.com/P1otrulla/CraftingLib) · [bStats](https://bstats.org/plugin/bukkit/CraftingLib/34932) · [Buy Me a Coffee](https://buymeacoffee.com/piotrulla) > ⚠️ CraftingLib is a **developer library**, not a standalone plugin. Shade it into your plugin. ```java this.craftingLib.getRecipeManager().registerRecipe(BukkitRecipes.shaped("super-pickaxe") .withPattern("DDD", " S ", " S ") .withIngredient('D', Material.DIAMOND_BLOCK, 3) .withIngredient('S', Material.STICK) .withResult(superPickaxe) .build()); ``` ## ✨ Features - **Every recipe type** — shaped, shapeless, furnace / blast furnace / smoker / campfire, brewing, stonecutter, smithing, anvil and grindstone - **Exact matching** — compare ingredients by full item data (name, lore, enchantments, NBT), material only, or `PersistentDataContainer` only - **Ingredient amounts** — e.g. *3 diamond blocks per slot*; shift-click crafts as many as possible - **2x2 & 3x3 grids** — small recipes work in the player inventory, patterns can sit anywhere and be mirrored - **Recipe book** — discovery, groups, categories (tabs), and on Paper 1.21+ a proper autofill that places exact items and amounts - **Replace vanilla recipes** — remove or block recipes with the same result or input - **Crafter support** (1.21+) — custom recipes work in the autocrafter - **Capability-based version adapters** — features are detected at runtime, not from version strings, so forks and backports just work - **okaeri-configs** — every recipe type can be stored in and loaded from YAML - **Fail-fast API** — immutable recipes, validating builders, error messages that name the recipe and the problem ## 🎬 Showcase

Shaped crafting — custom items, amounts per slot, mirroring

![Ruby pickaxe](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/03_ruby_pickaxe.gif) ![Ruby axe](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/01_ruby_axe.gif) ![Ruby sword](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/02_ruby_sword.gif) ![Mirrored](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/04_ruby_axe_mirrored.gif)

Replacing vanilla recipes

![Torch](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/05_torch.gif)

Shapeless crafting — 3x3 and 2x2 (player inventory)

![Bread](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/06_bread_2_wheat.gif) ![Shapeless 2x2](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/07_ruby_shapeless_2x2.gif)

Furnace, blast furnace, smoker, campfire

![Furnace](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/13_ruby_ore_furnace.gif) ![Blast furnace](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/14_ruby_ore_blast_furnace.gif) ![Smoker](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/15_jerky_smoker.gif) ![Campfire](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/16_leather_campfire.gif)

Smithing table

![Smithing](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/08_ruby_blade_smithing.gif)

Stonecutter

![Redstone stonecutter](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/09_redstone_stonecutter.gif) ![Stone bricks stonecutter](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/10_stone_bricks_stonecutter.gif)

Grindstone

![Grindstone sword](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/11_grindstone_ruby_sword.gif) ![Grindstone diamond](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/12_grindstone_diamond.gif)

Anvil

![Anvil](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/18_sharpened_sword_anvil.gif)

Brewing (Paper)

![Brewing](https://raw.githubusercontent.com/P1otrulla/CraftingLib/master/assets/17_ruby_elixir_brewing.gif)

## 📦 Installation ```kotlin repositories { maven("https://repo.eternalcode.pl/releases") } dependencies { implementation("dev.piotrulla:craftinglib-bukkit:4.0.0") // optional: YAML serialization of recipes implementation("dev.piotrulla:craftinglib-bukkit-okaeri-serdes:4.0.0") } ``` Remember to **relocate** the library when shading, so two plugins with different versions don't clash: ```kotlin tasks.shadowJar { relocate("dev.piotrulla.craftinglib", "your.plugin.libs.craftinglib") } ``` ## 🚀 Quick start ```java public final class ExamplePlugin extends JavaPlugin { private BukkitCraftingLib craftingLib; @Override public void onEnable() { this.craftingLib = BukkitCraftingLib.create(this); this.craftingLib.getRecipeManager().registerRecipe(BukkitRecipes.shaped("better-torches") .withPattern("C", "S") .withIngredient('C', Material.COAL) .withIngredient('S', Material.STICK) .withResult(Material.TORCH, 8) .replaceVanillaRecipes(true) .build()); } @Override public void onDisable() { this.craftingLib.shutdown(); } } ``` | Manager | Recipe | |---|---| | `getRecipeManager()` | shaped / shapeless crafting | | `getSmeltingManager()` | furnace, blast furnace, smoker, campfire | | `getBrewingManager()` | brewing stand | | `getStonecuttingManager()` | stonecutter | | `getSmithingManager()` | smithing table | | `getAnvilManager()` | anvil | | `getGrindstoneManager()` | grindstone | ## 🧩 Version support | Feature | Available from | |---|---| | Shaped / shapeless, ingredient amounts | 1.8 | | Anvil | 1.11 | | Keyed recipes (`NamespacedKey`) | 1.12 | | Recipe discovery, recipe book groups | 1.13 | | Blast furnace, smoker, campfire, stonecutter, `PERSISTENT_DATA` | 1.14 | | Smithing table | 1.16 | | Grindstone | 1.19.3 | | Crafter, recipe book autofill (Paper) | 1.21 | | Brewing (`PotionMix`) | Paper only | Requires **Java 11+**. Unsupported functional features fail fast with a clear reason; cosmetic ones are skipped silently. ## 📖 Documentation All builders, match modes, recipe book options and the YAML format: **[GitHub README](https://github.com/P1otrulla/CraftingLib)** ## 📜 License **LGPL-3.0** — use it in any plugin, open or closed source, free or paid. Only changes to CraftingLib itself must be published. --- Found a bug or have an idea? Open an issue on [GitHub](https://github.com/P1otrulla/CraftingLib/issues).