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.

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.