OBSIDREL / DOCS

Documentation

Guides, tutorials and technical references for the Obsidrel ecosystem.

DocumentationComplete recipes: all eight types and real projects

Complete recipes: all eight types and real projects

Obsidrel loads standalone recipes from plugins/Obsidrel/resources/recipes/. Each top-level ID is a recipe. Start with vanilla inputs; then reference Obsidrel items, blocks and furniture.

Basic shaped crafting

Create resources/recipes/my-recipes.yml:

yaml
my_pickaxe:
  enabled: true
  type: SHAPED
  result: DIAMOND_PICKAXE
  amount: 1
  shape:
    - 'DDD'
    - ' S '
    - ' S '
  ingredients:
    D: DIAMOND
    S: STICK

Each grid letter maps to an ingredient. Spaces represent empty slots and must be preserved. Shapes may have up to three equal-width rows of 1–3 characters.

Advanced: all eight real Showcase recipes

These complete definitions ship in resources/showcase/recipes/gallery.yml. Custom inputs depend on official Showcase items/blocks: keep their definitions and assets installed.

yaml
showcase_gallery_shaped:
  type: SHAPED
  result: obsidrel:showcase_void_elixir
  amount: 1
  shape:
    - ' A '
    - 'ABA'
    - ' G '
  ingredients:
    A: AMETHYST_SHARD
    B: obsidrel:showcase_runic_block
    G: GLASS_BOTTLE

showcase_gallery_shapeless:
  type: SHAPELESS
  result: obsidrel:showcase_ember_tonic
  amount: 1
  ingredients:
    - HONEY_BOTTLE
    - BLAZE_POWDER
    - obsidrel:showcase_ancient_stone

showcase_gallery_smelting:
  type: SMELTING
  result: AMETHYST_SHARD
  input: obsidrel:showcase_ancient_stone
  amount: 2
  experience: 0.5
  cooking-time: 120

showcase_gallery_blasting:
  type: BLASTING
  result: AMETHYST_SHARD
  input: obsidrel:showcase_crystal_ore
  amount: 4
  experience: 0.8
  cooking-time: 60

showcase_gallery_smoking:
  type: SMOKING
  result: GLASS_BOTTLE
  input: obsidrel:showcase_void_elixir
  amount: 1
  experience: 0.1
  cooking-time: 80

showcase_gallery_campfire:
  type: CAMPFIRE
  result: BLAZE_POWDER
  input: obsidrel:showcase_ember_tonic
  amount: 1
  experience: 0.1
  cooking-time: 200

showcase_gallery_stonecutting:
  type: STONECUTTING
  result: obsidrel:showcase_runic_block
  input: obsidrel:showcase_ancient_stone
  amount: 2

showcase_gallery_smithing:
  type: SMITHING
  result: obsidrel:showcase_obsidian_katana
  amount: 1
  template: NETHERITE_UPGRADE_SMITHING_TEMPLATE
  base: DIAMOND_SWORD
  addition: obsidrel:showcase_runic_block
TypeWorkstationType-specific fields
SHAPEDCrafting gridshape, mapped ingredients
SHAPELESSUnordered craftingListed/mapped ingredients, max 9
SMELTINGFurnaceinput, experience, cooking-time
BLASTINGBlast furnaceCooking fields
SMOKINGSmokerCooking fields
CAMPFIRECampfireCooking fields
STONECUTTINGStonecutterinput
SMITHINGSmithing tablebase, addition, template (1.20+)

Advanced: material tags and ingredient counts

A SHAPELESS map may repeat an ingredient across slots:

yaml
wood_torches:
  type: SHAPELESS
  result: TORCH
  amount: 4
  ingredients:
    wood:
      item: '#minecraft:planks'
      amount: 2
    coal:
      item: COAL
      amount: 1

Alternative ingredients: minecraft:diamond, DIAMOND, obsidrel:showcase_runic_block or an existing #namespace:tag. Custom IDs use exact item identity.

Permissions and integrations

permission guards grid crafting and recipe discovery, not every automatic cooking/smithing/stonecutting operation. Standalone recipe definitions do not have general actions/conditions fields. Use documented item mechanics or triggers; see Actions and conditions.

Validate

  1. Back up YAML, save, run /obsidrel reload.
  2. Check console for unresolved IDs, unknown ingredients or malformed rows.
  3. Test with the right workstation; smithing templates depend on Minecraft version.
  4. A missing result texture is a pack issue, not a recipe type issue.

See Recipes field reference.

Was this article helpful?Loading ratings…

Help us improve Obsidrel documentation. One vote per account and article. Discord AI feedback can also contribute when the answer cites this article.