Do I need mods to add a custom crafting recipe?

No. Vanilla Minecraft Java Edition reads custom recipes from datapacks since version 1.13 — no mods required. CraftTweaker (1.12.2) and MineTweaker (1.7.10) are only needed for older modded packs.

Where do I put the recipe file in Minecraft 1.21+?

Inside your datapack at data/ /recipe/ .json. The folder is recipe (singular) on Minecraft 1.21 and newer; on 1.20.x and earlier it is recipes (plural).

Why doesn't my custom recipe work after updating to 1.21?

The most common cause is the folder name — Minecraft 1.21 renamed recipes to recipe (singular). 1.21 also stopped accepting the old { item: ... } ingredient wrapper, so each key must be a bare string like minecraft:diamond. Run /datapack list to confirm the pack loaded and /reload to apply changes.

How do I add a custom recipe to a Minecraft server?

Drop the datapack folder into /world/datapacks/ and run /reload from an operator account, or restart the server. The folder structure is identical to single-player.

Can I make a custom recipe without writing JSON?

Yes. The AlaCraft Custom Crafts Generator lets you build the recipe on a visual 2×2 or 3×3 grid and download the ready file — it writes the correct JSON, CraftTweaker, or MineTweaker code for you.

What pack_format number should pack.mcmeta use?

It depends on the version — 48 for Minecraft 1.21 to 1.21.1, 57 for 1.21.2, 61 for 1.21.4. Each update can change it (1.21.9+ use min_format and max_format), so check the Pack format table on minecraft.wiki for your exact version.

Custom Minecraft Recipe: Make One & Add It to a Server

Your crafting projects

There are no active projects, to create your first project you need to “Log in to your account”

How to Make a Custom Minecraft Recipe and Add It to a Server

A custom crafting recipe is a player-defined rule that turns a set of ingredients into an item. On Minecraft Java 1.21+ you add one with a datapack — a small folder holding a recipe JSON file. The AlaCraft Custom Crafts Generator builds that file visually and exports a vanilla datapack plus CraftTweaker and MineTweaker scripts.

This guide covers a method-by-version decision table, the anatomy of a recipe datapack (pack.mcmeta and a JSON example), the "recipes vs recipe" folder trap in 1.21, installing on a world and a server, modded-pack recipes, and a troubleshooting checklist.

This page needs JavaScript for the interactive guide. Open the generator: https://alacraft.day/en/custom-crafts

Minecraft and all related materials are trademarks and copyrights of Mojang Studios © 2009–2026. This site is not an official Minecraft product and is not affiliated with or endorsed by Mojang Studios or Microsoft Corporation.

How to Make a Custom Minecraft Recipe

Datapacks, CraftTweaker & MineTweaker — one guide