Custom Recipes

Custom Recipes 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 Types

• Shaped Recipes - Create custom 3x3 crafting grid patterns with exact positions
• Shapeless Recipes - Position-independent recipes (any arrangement works)
• Bulk Crafting - Configure recipes to produce multiple items (1-64)
• Hidden Recipes - Hide from recipe viewer mods until player discovers them

Recipe Management

• Recipe Creator GUI - Create recipes in-game with drag-and-drop interface
• Recipe Editor GUI - Modify existing recipes visually
• Item Editor - Customize result items with:
  • GUI Name & Description (shown in recipe browser)
  • Crafted Name & Description (shown on crafted item)
  • CustomModelData support for resource packs
  • NBT data and custom tags
  • Enchantments with custom levels
• Per-World Restrictions - Enable/disable recipes per world (Overworld, Nether, End)
• Hot Reload - Reload recipes without restarting the server

User Experience

• Recipe Browser GUI - View all recipes in an interactive interface
• Recipe Viewer - Inspect individual recipe patterns visually
• Automatic Pagination - Handles large recipe collections
• MiniMessage Support - Rich text formatting with gradients and colors
• Permission System - Granular permission control
• Update Notifications - Automatic alerts for new versions (for admins)

---

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
/customrecipes enable <recipe>	/cr enable	Enable a recipe	customrecipes.manage
/customrecipes disable <recipe>	/cr disable	Disable a recipe	customrecipes.manage
/customrecipes delete <recipe>	/cr delete	Delete a recipe	customrecipes.manage

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
customrecipes.manage	Manage recipes (enable/disable/delete)	op
customrecipes.update.notify	Receive update notifications	op

---

⚙️ Configuration

Basic Structure

# Enable debug logging
debug: false

# Update checker settings
update-checker:
  enabled: true
  source: GITHUB
  github-repo: "hikarii-dev/Custom-Recipes"

# 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

# Ignore metadata/NBT when checking recipe ingredients
ignore-metadata: false

# World restrictions for recipes
world-restrictions:
  enabled: false
  disabled-worlds: []

# Recipe Format:
<RecipeKey>:
  gui-name: "Name in GUI"           # Always shown in recipe browser GUI
  gui-description:                  # Always shown in recipe browser GUI
    - "Line 1"
  crafted-name: "Name on item"      # (Optional) Name on crafted item
  crafted-description:              # (Optional) Lore on crafted item
    - "Line 1"
  type: SHAPED                      # SHAPED or SHAPELESS
  recipe:                           # For SHAPED recipes
    - ITEM ITEM ITEM
    - ITEM ITEM ITEM
    - ITEM ITEM ITEM
  ingredients:                      # For SHAPELESS recipes
    - MATERIAL:COUNT
  material: RESULT_ITEM
  amount: 1
  hidden: false
  type: SHAPED

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
  hidden: false
  type: SHAPED

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
  hidden: false
  type: SHAPED

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

Completed

• [✨] Shapeless Recipes - Support for recipes without specific patterns
• [✨] Recipe Editor GUI - In-game recipe creation interface
• [✨] Recipe Export/Import - Recipes saved as individual files
• [✨] Per-World Recipes - Enable/disable recipes per world
• [✨] Hidden Recipes - Discoverable recipes system

Planned Features

• [ ] Furnace Recipes - Custom smelting recipes
• [ ] Brewing Recipes - Custom potion recipes
• [ ] Smithing Recipes - Custom smithing table recipes
• [ ] 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.1..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