Recipes and Crucible

Last updated Jul 27, 2026

Recipes and Crucible

SoapsAdmin’s recipe system registers custom workbench, furnace, blast furnace, smoker, campfire, stonecutter, and smithing recipes. As of 1.7.0, ingredients and results can be vanilla materials or Mythic/Crucible items.

Module: recipes in modules.yml. Config: recipes.yml.

Commands

Command Description
/sa recipe / /sa recipes Open browser / help
/sa recipe create Start wizard
/sa recipe edit <id> Edit existing
/sa recipe delete <id> Remove
/sa reload recipes Reload recipes.yml

Manage permission: soapsadmin.recipe.manage (and craft permissions as configured per recipe).

Recipe Types

Type Station
SHAPED Crafting table (exact layout)
SHAPELESS Crafting table (any order)
FURNACE / BLASTING / SMOKING / CAMPFIRE Cooking
STONECUTTING Stonecutter
SMITHING_TRANSFORM / SMITHING_TRIM Smithing table (SMITHING = alias for transform)

Vanilla vs Crucible Items

Reference Example
Vanilla material DIAMOND_SWORD, STICK
Crucible / Mythic item crucible:MySword
Aliases mythic:MySword, mm:MySword
YAML alias field result.crucible: MySword

Crucible ingredients register as Bukkit ExactChoice so NBT/identity must match. Results clone the Mythic item stack (optional name/lore/enchant overlays from the recipe).

Requires MythicMobs (and typically MythicCrucible) at runtime. See Integrations.

Example

recipes:
  crucible_blade:
    type: SHAPED
    result:
      material: crucible:LegendaryBlade
      amount: 1
      # optional overlays:
      # name: "<gold>Forged Blade</gold>"
    shape:
      - " I "
      - " I "
      - " S "
    ingredients:
      I: crucible:MagicIngot
      S: STICK
    permission: ""
    cost:
      economy: money
      amount: 100
    discoverable: true
    category: Tools

Recipe Wizard GUI

/sa recipe create → guided panels:

  1. Type — pick recipe type
  2. Result — material / Crucible id, amount, name, lore, enchants
    • Use Held Item — auto-detects Crucible/Mythic from main hand
    • Live preview of the resolved stack
  3. Ingredients — shape/map/list/input/smithing slots
    • Held-item capture for key A, shapeless add, cooking/smithing inputs
  4. Metadata — permission, economy cost, category, discoverable
  5. Confirm — save to recipes.yml and register with Bukkit

Unresolved Crucible ids are warned in chat; save validation requires all refs to resolve while Mythic is loaded.

Costs and Permissions

Per-recipe:

permission: soapsadmin.recipe.craft.special
cost:
  economy: money
  amount: 50

Craft is blocked without permission or insufficient balance (bypass: soapsadmin.recipe.bypass-cost).
Paid recipes must be crafted one-at-a-time (shift-click is blocked so the cost cannot be undercharged).

Set enabled: false in recipes.yml to keep definitions for editing without registering them with Bukkit.

Browser

/sa recipes browses discoverable recipes by category. Crucible results show their real item icon when Mythic can resolve the id.

After Mythic pack updates

If you change Mythic/Crucible item definitions, run /sa reload recipes or /sa reload all so registered ExactChoice stacks refresh.

Rare Crucible recipes can use a permission: entry in recipes.yml. The wizard can set result/ingredients from the held item or by typing crucible:ItemId.

Discord