RecipeBook – Addon for zMenu

RecipeBook Plugin

RecipeBook is a powerful and flexible Minecraft plugin for managing custom recipes, crafting menus, and player storage. It supports multiple crafting types, integrates with popular item plugins, and provides advanced menu configuration for an enhanced gameplay experience.

Update – What's New

• Shaped recipes now support a new line durability_lost_by_craft, allowing you to define durability loss for ingredients.
• Fixed a cache issue that prevented some recipes from displaying correctly.
• Integrated bStats to collect anonymous usage statistics (number of users, server version, etc.).
• Added a brand new Wiki with documentation and examples.
• Added support for EcoItems and ExecutableItems (ei:<item_id>).
• Plugin renamed to RecipeBook. The old folder will be automatically renamed to match the new plugin name.

Features

- Custom recipes ( shaped, shapeless, furnace, blast furnace, smoker, campfire, stonecutter, smithing table)
- Advanced menu configuration for crafting and storage
- Integration with Nexo, ItemsAdder, Oraxen, ZItems, ZHead
- Asynchronous crafting and RAM caching for performance
- Batch saving and logging (console, file, Discord, JSON)
- Discord webhook notifications
- Player storage and crafting queue management
- Permission-based actions and messages

Custom Recipe Examples

> Each recipe type has its own YAML format. Below are examples you can use directly in your configuration files:

Stonecutter:

<recipe_id>:
  result:
    item: "minecraft:stone"
    amount: 2
  input:
    item: "minecraft:cobblestone"

Smoker:

<recipe_id>:
  result:
    item: "minecraft:stone"
  input:
    item: "minecraft:cobblestone"
  experience: 0.1
  cooking_time: 100

Smithing Table:

<recipe_id>:
  copy_trim: false                        # Retain armor trim from base item?
  keep_durability: true                   # Retain base item durability?
  copy_pdc: false                         # Copy PersistentDataContainer?
  copy_enchantments: true                 # Copy enchantments?
  result:
    item: "minecraft:stone"
  template:
    item: "minecraft:redstone"
  base:
    item: "minecraft:cobblestone"
  addition:
    item: "minecraft:coal"

Shapeless:

<recipe_id>:
  result:
    item: "minecraft:stone"
    amount: 1
  ingredients:
    A:
      item: "minecraft:cobblestone"
      amount: 2

Shaped:

<recipe_id>:
  result:
    item: "minecraft:stone"
  ingredients:
    A:
      item: "minecraft:cobblestone"
    B:
      item: "minecraft:coal"
  pattern:
    - " A "
    - " B "
    - " A "

Furnace:

<recipe_id>:
  result:
    item: "minecraft:stone"
  input:
    item: "minecraft:cobblestone"
  experience: 0.1
  cooking_time: 200

Campfire:

<recipe_id>:
  result:
    item: "minecraft:stone"
  input:
    item: "minecraft:cobblestone"
  experience: 0.1
  cooking_time: 100

Blast Furnace:

<recipe_id>:
  result:
    item: "minecraft:stone"
  input:
    item: "minecraft:cobblestone"
  experience: 0.1
  cooking_time: 100

Requirements

- Minecraft server (Spigot/Paper/Purpur)
- Java 21+

Quick Start

1. Download RecipeBook and place the jar in your server's plugins folder.
2. Start your server to generate the default configuration files.
3. Edit config.yml in plugins / RecipeBook to customize settings, database, and menu options.
4. Reload the plugin with /recipebook_zmenu reload or restart your server if you edited the database settings..

Placeholders & Integration

RecipeBook supports dynamic placeholders to personalize messages, logs, and menus:
%player%, %log_items%, %recipebook_outputItemAmount%, and more.

- Compatible with: PlaceholderAPI for advanced integration.

Player Storage System

When crafting, players are temporarily locked out of their items.

- If a player disconnects during crafting, the required ingredients are returned to them instead of the final item.
- Withdraw actions:
- Left-click: withdraws 1 item
- Right-click: withdraws 1 stack
- Shift + Click: withdraws all
- Shift + Right-click: empties all (requires permission)

Commands & Permissions

Main command:
/recipebook_zmenu

Reload commands:
- /recipebook_zmenu reload — reloads everything
- /recipebook_zmenu reload config — reloads the config only
- /recipebook_zmenu reload menus — reloads all menus
- /recipebook_zmenu reload recipes — reloads all recipes

Permission required: recipebook.zmenu.reload

Support

Getting Help:
For support, bug reports, and feature requests, contact me:

Discord: kyubi8319