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:
- Type — pick recipe type
- Result — material / Crucible id, amount, name, lore, enchants
- Use Held Item — auto-detects Crucible/Mythic from main hand
- Live preview of the resolved stack
- Ingredients — shape/map/list/input/smithing slots
- Held-item capture for key
A, shapeless add, cooking/smithing inputs
- Held-item capture for key
- Metadata — permission, economy cost, category, discoverable
- Confirm — save to
recipes.ymland 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.