CustomRecipes v1.5.0 - Major Update! [2025-11-21]

⚠️ Important Notice - Version 1.5.0+

If you're updating to version 1.5.0 or higher, this version introduces a new saving/migration and recipe storage system for better item metadata support.

Before updating to be safe:

1. Backup your plugins/CustomRecipes/ folder
2. Save all your recipes (they're in plugins/CustomRecipes/recipes/)
3. Read the changelog

The new system provides:

• Full durability/damage support
• Complete enchantment matching
• Enchanted book support with stored enchantments
• Backward compatibility (old recipes still work!)

Need help? Join our Discord

Added

• Vanilla Recipe Editor - Complete vanilla Minecraft recipe customization system

  • 801 vanilla recipes fully integrated (Crafting Table recipes)
  • Recipe pattern modification with preview
  • Support for multi-ingredient variants (e.g. different wood types)
  • Per-variant result customization (e.g. Suspicious Stew effects)
  • Disable/enable individual vanilla recipes
  • Recipe search system with partial name matching
  • Category filtering (Building, Decorations, Redstone, Transportation, Food, Tools, Combat, Brewing, Misc)
  • Station filtering (more stations coming soon)
  • Ingredient variant cycling for recipes with multiple options with visual numbered options
  • Result item amount adjustment (left/right click)
  • Reset to original vanilla recipe functionality

• Advanced Recipe Pattern Editor

  • Click-to-modify ingredient grid for shaped recipes
  • Type toggle between Shaped/Shapeless for vanilla recipes
  • Result item amount adjustment (left/right click)
  • Pattern preview
  • Multiple variant support per recipe (up to 10+ variants)

• Enhanced Item Editor - Expanded customization options

  • Enchantment Selector GUI - Dedicated menu for enchantment management
    • All enchantments in searchable grid layout
    • Visual level adjustment (left/right click)
    • Max level enforcement per enchantment
    • Quick max/reset with shift-click
    • Enchantment compatibility + filter toggle/enable
    • Enchantment descriptions and effects
    • Visual indicators
    • Enchantment visibility toggle (HIDE_ENCHANTS flag)
  • NBT data editor with key-value pairs
  • Custom Model Data configuration

• Recipe Pattern Editing for Custom Recipes

  • Edit existing custom recipe patterns
  • Support for shaped and shapeless pattern changes
  • Ingredient modification via crafting grid
  • Result item amount adjustment (left/right click in edit mode)
  • Save changes without recreating recipe
  • Preserves recipe metadata and settings
  • Visual indicators for edit mode

• Recipe List Enhancements

  • Edit Item Button - Quick result editing from list
  • Direct access to item editor from recipe list
  • Modify names, descriptions, enchantments without opening full editor
  • Right-click context menu for quick actions

• Recipe Editor Improvements

  • Get Result Item button - Receive configured item + Sound feedback on item receive
  • Items creating with all properties (NBT, enchantments, custom data)

• Global Recipe Management

  • Disable All Custom Recipes button in Settings
  • Enable All Custom Recipes button in Settings
  • Disable All Vanilla Recipes button in Settings (801 recipes)
  • Enable All Vanilla Recipes button in Settings (801 recipes)
  • Recipe count display (enabled/disabled/total)

• Vanilla Recipe Migration System

  • Automatic version detection and migration
  • Backup creation before updates
  • Fallback for corrupted data
  • Version tracking

• Update System Improvements

  • Periodic background update checks (every 30 minutes)
  • Real-time notifications for admins whos online
  • Automatic notification on new version discovery
  • No server restart needed to detect updates

• Station Selector GUI - Menu for choosing crafting station before recipe creation

  • Visual station selection with icons: Crafting Table, Furnace, Blast Furnace, Smoker, Stonecutter, Brewing Stand, Smithing Table, Anvil, Loom
  • "Coming soon" indicators for disabled stations
  • Grid size display per station
  • Glow effect on available stations
  • Station descriptions and status messages

• Exact Item Matching for Recipe Ingredients - Advanced crafting requirements

  • Durability/Damage support for tools and armor in recipes
  • Full enchantment matching for weapons and tools as ingredients
  • Stored enchantments support for enchanted books as ingredients
  • NBT/metadata matching in crafting grid
  • CustomModelData matching for resource pack items

Changed

• Recipe Editor GUI - Complete redesign

  • Added "Edit Recipe Pattern" button for custom recipes
  • New edit mode with separate save/cancel buttons
  • Live grid editing with amount adjustment
  • Result item editing moved to dedicated button
  • Toggle system between view/edit modes
  • Better visual feedback for editing state
  • Hidden/Visible recipe toggle

• Vanilla Recipe Storage

  • Individual YAML+JSON files per modified vanilla recipe
  • Variant-based pattern storage structure
  • Multi-variant support in vanilla-recipes.yml

• Recipe List GUI - Enhanced display

  • Plain text names without formatting artifacts
  • MiniMessage color preservation for custom names
  • Proper name/description extraction from ItemMeta
  • Status indicators (Enabled/Modified/Disabled)
  • Color-coded recipe names (Green/Yellow/Red)
  • Enhanced special properties display (enchantments, NBT, model data)
  • World restrictions shown in lore

• Settings GUI - Enhanced organization

  • Dedicated buttons for custom recipe management
  • Dedicated buttons for vanilla recipe management
  • World restriction status properly reflects active restrictions
  • Dimension-based world toggles (Overworld/Nether/End)
  • Visual counters for enabled/disabled recipes
  • Warning messages for bulk operations

• Recipe Amount System

  • Multi-ingredient amount support in shaped recipes
  • Visual amount display in recipe grids
  • Proper ingredient consumption for amounts > 1
  • Amount preservation during recipe editing

• Command System Simplification

  • Removed /cr list command (use GUI instead)
  • Removed /cr enable command (use GUI instead)
  • Removed /cr disable command (use GUI instead)
  • Removed /cr delete command (use GUI instead)
  • Kept only: /cr gui, /cr reload, /cr help

• Item Property Handling

  • ItemFlags preserved across all operations
  • HIDE_ENCHANTS flag properly applied and saved
  • Full ItemMeta cloning in all editors
  • Enchantment visibility controllable per item

[1.1.2] - 2025-11-17

Added

• Per-World Recipe System - Control recipe availability by dimension
  • Enable/disable recipes per world (Overworld, Nether, End)
  • Default world restrictions in settings GUI
  • Individual world configuration per recipe
  • Visual world selector with dimension icons
  • World list stored in recipe config files
• Runtime Update Notifications - Real-time alerts for online admins
  • Background update checking while server is running
  • Automatic notifications when new version is released
  • No server rejoin required to see updates
  • Same notification format as login messages
• Enhanced Result Item Customization
  • CustomModelData button in Edit Result Item menu
  • NBT data support button with chat input
  • Add custom tags and metadata to crafted items
  • Full item property configuration with live preview
  • Clear All button to reset customization
  • Right-click to clear and restart descriptions
• Edit Item Button in Recipe List - Quick result editing
  • Direct access to item editor from recipe list
  • Modify GUI/Crafted names, descriptions, CustomModelData, NBT, Enchantments
  • Convenient shortcut for result item changes
  • Located in each recipe's list entry

Changed

• Recipe Ingredient Matching - Enhanced metadata support
  • CustomModelData now affects ingredient matching
  • NBT tag comparison for custom items
  • Support for anvil-renamed items in recipes
  • Better item property awareness
• Recipe Information Display - Now shows complete item data
  • Displays GUI Name and GUI Description
  • Displays Crafted Name and Crafted Description
  • Shows CustomModelData if present
  • Lists all Enchantments with levels
  • Shows NBT data tags
  • Better organized information layout
• Item Editor GUI Layout - Improved organization
  • Separate sections for Crafted and GUI properties
  • Clear labeling of what appears where (crafted item vs recipe browser)
  • Better button descriptions with usage hints
  • Right-click functionality for clearing descriptions

CustomRecipes v1.1.0

🎉 Major Update - Recipe Creator & Shapeless Support

This release brings powerful new features for recipe creation and management!

✨ Added

• Shapeless Recipes - Create recipes where ingredient position doesn't matter
• Recipe Creator GUI - Create recipes directly in-game without editing files
  • Drag-and-drop interface for placing ingredients
  • Visual recipe type toggle (Shaped/Shapeless)
  • Real-time preview of result item
• Item Editor GUI - Customize item names and descriptions in-game
  • MiniMessage support for colors and formatting
  • Multi-line description editor
  • Live preview of changes
• Hidden Recipes System - Hide recipes from recipe mods (REI, JEI, etc.)
  • Recipes unlock after first craft
  • Per-player discovery tracking
• Advanced Item Storage
  • Full ItemStack serialization (NBT, PDC, CustomModelData)
  • JSON recipe format alongside YAML
  • Individual recipe files in recipes/ folder
• Update Checker - Automatic update notifications
  • Support for GitHub and Spigot sources
  • Configurable in config.yml
• bStats Integration - Anonymous usage statistics

🔄 Changed

• Recipe Storage - Recipes now save to separate files instead of main config
  • Legacy format still supported for backwards compatibility
  • Automatic migration to new format
• Recipe Deletion - Now permanently removes recipe files
  • Two-click confirmation system
  • Deletes both YAML and JSON files
• GUI Improvements
  • Better color schemes (light blue glass panes)
  • Empty slots filled with glass in recipe list
  • Improved button layouts and descriptions
• Recipe Editor - Expanded to 6-row inventory for better layout

🐛 Fixed

• Recipe patterns with empty edges now work correctly
• AIR ingredients no longer cause crashes
• Recipe enable/disable now properly syncs with files
• GUI listeners properly cleanup on close
• Chat input for item editor works reliably

📦 Migration Notes

• Old recipes in config.yml will continue to work
• New recipes are saved to plugins/CustomRecipes/recipes/
• Both .yml and .json formats are created for each recipe
• No manual migration required

---

Full Changelog: https://github.com/hikarii-dev/Custom-Recipes/compare/v1.0.0...v1.1.0

CustomRecipes

CustomRecipes allows you to create custom recipes for wide selection of workstations including: Crafting Table (Others in Future Updates)

Integrates with other plugins: (In Future)

In addition, you can switch vanilla recipes at your discretion, as well as disable and override them (In Future)

Support

For any questions or support join the Discord

Features

Recipe Management

• Shaped Recipes - Create custom 3x3 crafting grid patterns
• Custom Names & Lore - Add colored names and descriptions to crafted items
• Flexible Configuration - Easy-to-use configuration
• Bulk Crafting - Configure recipes to produce multiple items (1-64)
• Hot Reload - Reload recipes without restarting the server

GUI Interface

• Recipe Browser - View all recipes in an interactive GUI
• Recipe Viewer - Inspect individual recipe patterns visually
• Pages - Automatically creates new pages when there are a large number of recipes
• Intuitive Navigation - Easy-to-use interface for players and admins

User Experience

• MiniMessage Support - Rich text formatting with gradients and colors
• Permission System - Granular permission control

---

Usage

Commands

Command	Aliases	Description	Permission
/customrecipes help	/cr help	Show help message	customrecipes.use
/customrecipes reload	/cr reload, /cr rl	Reload configuration	customrecipes.reload
/customrecipes list	/cr list, /cr l	List all recipes	customrecipes.list
/customrecipes gui	/cr gui, /cr menu	Open recipe GUI	customrecipes.gui

Permissions

Permission	Description	Default
customrecipes.*	All permissions	op
customrecipes.use	Basic command access	true
customrecipes.reload	Reload configuration	op
customrecipes.list	View recipe list	true
customrecipes.gui	Open GUI interface	true

---

⚙️ Configuration

Basic Structure

# Enable debug logging
debug: false

# Use custom names and descriptions on crafted items
use-crafted-custom-names: true

# Keep custom names on spawn eggs when they spawn mobs
spawn-egg-keep-custom-name: false

# List of enabled recipe keys
enabled-recipes:
  - RecipeKey
  - BeeSpawnEgg

# Recipe Format:
 <RecipeKey>:                    # Recipe Name
   gui-name: "Name in GUI"       # Always shown in recipe browser GUI
   gui-description:              # Always shown in recipe browser GUI
     - "Line 1"
     - "Line 2"
   crafted-name: "Name on item"  # (Optional) Name on crafted item
   crafted-description:          # (Optional) Lore on crafted item
     - "Line 1"
     - "Line 2"
   type: SHAPED                  # Recipe type (currently only SHAPED is supported)
   recipe:                       # 3x3 crafting grid pattern
     - ITEM ITEM ITEM            # Top row
     - ITEM ITEM ITEM            # Middle row
     - ITEM ITEM ITEM            # Bottom row
   material: RESULT_ITEM         # The resulting item
   amount: 1                     # (Optional) Amount crafted (1-64), default: 1

Example Recipes

Spawn Egg Recipe

BeeSpawnEgg:
  gui-name: "<yellow>Bee Spawn Egg"
  gui-description:
    - "<gray>Craft using honey bottles"
    - "<gold>Place to spawn a bee!"
  crafted-name: "<yellow>Bee Spawn Egg"
  crafted-description:
    - "<gray>Craft using honey bottles"
    - "<gold>Place to spawn a bee!"
  recipe:
    - HONEY_BOTTLE HONEY_BOTTLE HONEY_BOTTLE
    - HONEY_BOTTLE CLOCK HONEY_BOTTLE
    - HONEY_BOTTLE HONEY_BOTTLE HONEY_BOTTLE
  material: BEE_SPAWN_EGG
  amount: 1

Bulk Crafting Recipe

GoldenAppleStack:
  gui-name: "<gold>Golden Apple Stack"
  gui-description:
    - "<gray>Bulk golden apple crafting"
    - "<yellow>Creates 8 golden apples"
  recipe:
    - GOLD_BLOCK GOLD_BLOCK GOLD_BLOCK
    - GOLD_BLOCK APPLE GOLD_BLOCK
    - GOLD_BLOCK GOLD_BLOCK GOLD_BLOCK
  material: GOLDEN_APPLE
  amount: 8

Color Codes

This plugin supports MiniMessage format for text coloring:

• <red>, <green>, <blue>, etc. - Named colors
• <#FF0000> - Hex colors
• <gradient:#FF0000:#00FF00>Text</gradient> - Gradients
• <rainbow>Text</rainbow> - Rainbow effect
• <bold>, <italic>, <underline> - Formatting

See MiniMessage Documentation for more options.

---

Roadmap

Planned Features

• [ ] Shapeless Recipes - Support for recipes without specific patterns
• [ ] Furnace Recipes - Custom smelting recipes
• [ ] Brewing Recipes - Custom potion recipes
• [ ] Smithing Recipes - Custom smithing table recipes
• [ ] Recipe Editor GUI - In-game recipe creation interface
• [ ] Recipe Export/Import - Share recipes between servers
• [ ] MySQL Support - Store recipes in database
• [ ] Per-Player Recipes - Unlock recipes per player
• [ ] Recipe Groups - Organize recipes into categories
• [ ] Recipe Dependencies - Require other recipes first

---

Installation

1. Download the latest CustomRecipes-1.0.0.jar from releases
2. Place the jar file in your server's plugins folder
3. Start your server to generate the default configuration
4. Edit plugins/CustomRecipes/config.yml to add your custom recipes or use /customrecipes gui with GUI-Create system.
5. Reload using /cr reload or restart your server

Compatibility

• Minecraft Version: 1.21+
• Server Software: Paper/Spigot/Purpur (or compatible fork)
• Java Version: Java 21+

---

Statistics

---

Made with ❤️ for the Minecraft community