Recipes Configuration

File RecipesConfiguration.yml

This file handles the configuration of the recipes for the items of this plugin. Each section in this file is interpreted by the plugin as a recipe.

There are two types of recipes:

• Shapeless

• Shaped

In case you don't know how Minecraft recipes work, below you can find an explanation of the differences between each one.

Creating Recipes

To create a recipe, you have to specify the result of the recipe, and the shape. The result being the id of an item. And the shape being the list of ingredients.

Example shapeless recipe:

example-shapeless-recipe:
  result: example-item-a
  shapeless:
  - "apple"
  - "carrot"

Example shaped recipe:

example-shaped-recipe:
  result: example-item-a
  shaped:
  - "[apple][][]"
  - "[][example-item-b][]"
  - "[][][apple]"

As you can observe in the examples above, there is a "result" entry that specifies the ID of the item the player will receive upon crafting. Additionally, there's another entry indicating whether the recipe is shapeless or shaped.

Shapeless recipes are straightforward, as they only require a list of ingredients without any specific arrangement. Shaped recipes, on the other hand, involve a bit more structure. They utilize three lines, each representing a row in the crafting table.

- "[][][]"
- "[][][]"
- "[][][]"

Each pair of square brackets ( [ ] ) represents a single slot within the crafting table. Within these brackets, you'll specify either:

• The ID of an item: This refers to the unique identifier assigned to a custom item, which you can find on the appropriate item configuration page. Click here to open Items Configuration page.

• A vanilla material: This pertains to materials built into the game, such as wood, stone, or iron. A comprehensive list of available vanilla materials can be found at this link: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html

By strategically placing these identifiers within the brackets, you'll create the desired shaped recipe patterns.

Shapeless and Shaped recipes

Shaped Recipes: Building with Precision

Imagine a crafting grid as a puzzle board. Shaped recipes present you with a specific pattern using symbols to represent different items. The key lies in placing these items exactly as shown in the pattern to unlock the crafting magic.

Key characteristics:

• Structured pattern: Each recipe has a distinct grid layout showcasing the item arrangement.

• Specific order matters: The position of each ingredient is crucial for successful crafting.

• Visual guide: The crafting grid highlights the pattern while you place items, aiding in accuracy.

Examples:

• Crafting a pickaxe: This recipe utilizes a diagonal pattern with three wooden planks and two sticks, demanding precise placement.

• Building a furnace: Here, eight cobblestones form a hollow square around an empty center, showcasing the structured nature of shaped recipes.

Shapeless Recipes: Freedom in Formulation

Forget rigid patterns! Shapeless recipes offer flexibility, allowing you to throw in the required ingredients in any order within the crafting grid. As long as you have the right components, the crafting gods will smile upon you.

Key characteristics:

• No defined pattern: The order in which you place ingredients doesn't matter.

• Ingredient list: Only the required items are specified, not their arrangement.

• Simple approach: Perfect for quick crafting without worrying about placement.

Examples:

• Creating a torch: Combine one coal and one stick in any arrangement to get your light source.

• Brewing potions: Throw in your chosen ingredients for the potion effect, and the cauldron does the rest.