Random Recipes

Deterministic crafting recipe shuffler for Fabric — every world, a new puzzle.

Enter a world, and all crafting table recipes are shuffled using the world seed as the random source. Same seed = same recipes forever. Different seeds = completely different recipes. Perfect for SMP — every player in the same world sees identical shuffled recipes.

Features

• Seed- deterministic shuffling — a single world seed controls all randomization, using Java Random for reproducibility
• Three-layer recipe transformation:
  1. Fisher-Yates shuffle on ingredient positions (non-empty slots only)
  2. Ingredient addition, removal (shapeless only), or replacement — 1 to 2 changes per recipe
  3. Automatic duplicate detection & conflict resolution after shuffling
• Global item pool — single-material recipes (shears, iron nuggets, pressure plates, etc.) pull candidates from every item that appears across all crafting recipes, preventing "replace iron with iron" no-ops
• Three protected defaults — wooden, stone, and iron pickaxes are always kept unchanged so the game remains playable
• Config-file extension — config/random-recipes.json lets you protect additional items by ID or specific recipe IDs
• Cross-mod compatible — automatically processes crafting recipes registered by other mods
• /reload friendly — edit the config and run /reload; changes apply instantly, no restart needed

How it works

Installation

1. Install Fabric Loader ≥ 0.15
2. Install Fabric API
3. Place the jar in .minecraft/mods/
4. Launch Minecraft 1.20.1

Configuration

Generated automatically on first run at config/random-recipes.json:

{
  "protected_output_items": [
    "minecraft:wooden_pickaxe",
    "minecraft:stone_pickaxe",
    "minecraft:iron_pickaxe"
  ],
  "protected_recipe_ids": []
}

Build from source

git clone https://github.com/Annieif/random-recipes.git
cd random-recipes
./gradlew build

Artifacts are in build/libs/random-recipes-*.jar.

Screenshots

Links

• GitHub Repository
• Issue Tracker

License

MIT