AbyssalLib Help

Default Recipe Types

Recipe types define the structure, required ingredients, and resulting items for various crafting mechanics within the server. Below is a list of all default recipe types included and parsed by AbyssalLib.

(Note: The id, type, and disabled properties are global to all recipes and are omitted from the parameter tables below).

Understanding Recipe Choices

Throughout the recipe documentation, you will see fields requiring a Recipe Choice.

A Recipe Choice represents the valid inputs for a single crafting slot. It is always formatted as a list, even if there is only one valid item. This allows you to easily accept multiple variations of an item (e.g., accepting either Coal or Charcoal) for the same ingredient slot.

# Example of a Recipe Choice accepting multiple items: input: - "minecraft:coal" - "minecraft:charcoal" # Example of a Recipe Choice accepting only one item (must still be a list): input: - "minecraft:diamond"

CustomShapedRecipe

ID: minecraft:shaped

Defines a standard crafting table recipe where the exact arrangement of items in the grid is strictly required.

Parameter

Information

shape

A list of strings representing the crafting grid rows (e.g., ["###", " | ", " | "]).

ingredients

A map linking the characters used in the shape list to a Recipe Choice.

result

The serialized item stack produced when crafted.

group

(Optional) A string used to group similar recipes together in the recipe book.

category

(Optional) The recipe book category tab (e.g., EQUIPMENT, BUILDING).

replace

(Optional) Boolean determining if this should overwrite a pre-existing recipe with the same ID.

CustomShapelessRecipe

ID: minecraft:shapeless

Defines a crafting table recipe where the items can be placed anywhere in the grid.

Parameter

Information

ingredients

A list of Recipe Choices. Because a Recipe Choice is already a list, this field requires a nested list format. For example, [["minecraft:coal", "minecraft:charcoal"], ["minecraft:stick"]] requires one slot of coal/charcoal and one slot of sticks.

result

The serialized item stack produced when crafted.

group

(Optional) A string used to group similar recipes together in the recipe book.

category

(Optional) The recipe book category tab.

replace

(Optional) Boolean determining if this should overwrite a pre-existing recipe with the same ID.

CustomFurnaceRecipe

ID: minecraft:furnace

Defines a standard smelting recipe for a Furnace block.

Parameter

Information

input

The Recipe Choice required to be smelted.

result

The serialized item stack produced when smelting is complete.

cooking_time

The time it takes to smelt the item, measured in ticks (20 ticks = 1 second).

exp

The amount of experience points dropped when taking the result out of the furnace (Float).

group

(Optional) A string used to group similar recipes together in the recipe book.

category

(Optional) The cooking book category tab (e.g., FOOD, BLOCKS).

replace

(Optional) Boolean determining if this should overwrite a pre-existing recipe with the same ID.

CustomBlastingRecipe

ID: minecraft:blasting

Defines a smelting recipe exclusively for the Blast Furnace block.

Parameter

Information

input

The Recipe Choice required to be blasted.

result

The serialized item stack produced.

cooking_time

The time it takes to process the item, measured in ticks.

exp

The amount of experience points dropped.

group

(Optional) A string used to group similar recipes.

category

(Optional) The cooking book category tab.

replace

(Optional) Boolean determining if this should overwrite a pre-existing recipe.

CustomSmokingRecipe

ID: minecraft:smoking

Defines a cooking recipe exclusively for the Smoker block.

Parameter

Information

input

The Recipe Choice required to be cooked.

result

The serialized item stack produced.

cooking_time

The time it takes to cook the item, measured in ticks.

exp

The amount of experience points dropped.

group

(Optional) A string used to group similar recipes.

category

(Optional) The cooking book category tab.

replace

(Optional) Boolean determining if this should overwrite a pre-existing recipe.

CustomCampfireRecipe

ID: minecraft:campfire

Defines a cooking recipe for the Campfire block.

Parameter

Information

input

The Recipe Choice required to be cooked on the campfire.

result

The serialized item stack popped off the campfire when finished.

cooking_time

The time it takes to cook the item, measured in ticks.

exp

The amount of experience points dropped.

group

(Optional) A string used to group similar recipes.

category

(Optional) The cooking book category tab.

replace

(Optional) Boolean determining if this should overwrite a pre-existing recipe.

CustomStonecuttingRecipe

ID: minecraft:stonecutting

Defines a conversion recipe for the Stonecutter block.

Parameter

Information

input

The Recipe Choice required to be placed in the stonecutter.

result

The serialized item stack produced.

group

(Optional) A string used to group similar recipes together.

replace

(Optional) Boolean determining if this should overwrite a pre-existing recipe.

CustomSmithingTransformRecipe

ID: minecraft:smithing_transform

Defines an equipment upgrade recipe for the Smithing Table block.

Parameter

Information

base

The Recipe Choice of the base equipment being upgraded (e.g., Diamond Chestplate).

template

The Recipe Choice of the smithing template required.

addition

The Recipe Choice of the material being applied (e.g., Netherite Ingot).

result

The serialized item stack produced by the upgrade.

copy_components

(Optional) If true, preserves data components like enchantments, damage, and custom names from the base item.

replace

(Optional) Boolean determining if this should overwrite a pre-existing recipe.

CustomPotionMix

ID: minecraft:potion_mix

Defines a custom recipe for the Brewing Stand.

Parameter

Information

input

The Recipe Choice required in the bottom slots (typically a potion with specific data components).

ingredient

The Recipe Choice required in the top brewing slot.

result

The serialized item stack replacing the input bottles when finished.

replace

(Optional) Boolean determining if this should overwrite a pre-existing recipe.

CustomTransmuteRecipe

ID: minecraft:transmute

A specialized crafting recipe type representing the transformation of a base item using a catalyst material.

Parameter

Information

input

The Recipe Choice being transmuted.

material

The Recipe Choice of the catalyst triggering the transmutation.

result

The serialized item stack produced.

group

(Optional) A string used to group similar recipes.

category

(Optional) The crafting book category tab.

replace

(Optional) Boolean determining if this should overwrite a pre-existing recipe.

05 June 2026