Seams and Stitches

Summary

This mod adds interactive sewing to Minecraft. It introduces a Tailoring Bench where players craft items by stitching along seam paths in a minigame. Hit more stitches within the timing window to produce higher-quality results. Mastering a pattern unlocks Quick Craft, letting you skip the minigame for repeat crafts. How many completions are required before mastery is unlocked is configurable per recipe.

A Needle and Scissors are required to use the bench. Both are craftable.

Quality Tiers

Each completed craft is graded based on the fraction of stitches hit and how precisely they were timed:

If fewer stitches are hit than the poor threshold, the craft fails entirely and no item is produced.

Quality tiers can grant per-attribute bonuses defined in quality_bonuses. Attribute values are set explicitly per tier, replacing the item's vanilla default for that attribute.

Instructions for Use

1. Folder Structure

To add custom sewing recipes, place them in the following path inside your modpack or data pack:

modpack_name/
└── data/
    └── seamsandstitches/
        └── recipe/

2. JSON Recipe Structure

Each custom recipe must be its own individual JSON file and can be named anything you like.

Top-level fields:

Seam fields:

Quality breakpoints fields (quality_breakpoints):

Quality bonus fields (quality_bonuses is a list of these):

The quality bonus replaces the item's vanilla default for that attribute rather than adding to it.

Supported attributes:

Generic

Player

3. Example Recipe

{
  "type": "seamsandstitches:sewing_pattern",
  "texture": "minecraft:textures/item/leather_helmet.png",
  "output": {
    "id": "minecraft:leather_helmet",
    "count": 1
  },
  "ingredients": [
    { "item": "minecraft:leather" },
    { "item": "minecraft:leather" },
    { "item": "minecraft:leather" },
    { "item": "minecraft:leather" },
    { "item": "minecraft:leather" }
  ],
  "seams": [
    {
      "id": "crown",
      "path": [[4,11],[3,10],[3,9],[3,8],[3,7],[3,6],[3,5],[4,4],[5,3],[6,3],[7,3],[8,3],[9,3],[10,3],[11,4],[12,5],[12,6],[12,7],[12,8],[12,9],[12,10],[11,11]],
      "speed": 2
    },
    {
      "id": "left_strap",
      "path": [[6,4],[6,5],[6,6],[7,7],[6,7],[5,8],[5,9],[5,10],[5,11]],
      "speed": 2
    }
  ],
  "quality_breakpoints": {
    "poor": 0.25,
    "well": 0.5,
    "expert": 0.75,
    "master": 1.0
  },
  "quality_bonuses": [
    {
      "attribute": "minecraft:generic.armor",
      "slot": "head",
      "poor": 0,
      "well": 1,
      "expert": 2,
      "master": 3
    }
  ]
}

4. Upgrade Recipe (Container Content Transfer)

When upgrading a container item — such as a wallet or shulker box — use deferred_ingredients to keep the source item in the bench until the craft completes, and transfer_contents to carry its stored contents onto the new item.

The deferred ingredient index refers to its position in the ingredients array (0-based). In the example below, index 0 is the copper wallet.

{
  "type": "seamsandstitches:sewing_pattern",
  "texture": "lightmanscurrency:textures/item/wallet/wallet_copper.png",
  "output": {
    "id": "lightmanscurrency:wallet_iron",
    "count": 1
  },
  "ingredients": [
    { "item": "lightmanscurrency:wallet_copper" },
    { "item": "minecraft:iron_ingot" },
    { "item": "minecraft:iron_ingot" }
  ],
  "deferred_ingredients": [0],
  "transfer_contents": true,
  "seams": [
    {
      "id": "stitching",
      "path": [[4,4],[5,4],[6,4],[7,4],[8,4],[9,4],[10,4],[11,4],[11,5],[11,6],[11,7],[11,8],[10,9],[9,9],[8,9],[7,9],[6,9],[5,9],[4,9],[4,8],[4,7],[4,6],[4,5]],
      "speed": 2.0
    }
  ]
}

How it works:

• The copper wallet (index 0) stays in the bench when the minigame starts. If the player cancels, the wallet is returned.
• On successful completion, the wallet's stored items are copied onto the iron wallet output — only the inventory is transferred; the output keeps its own component configuration.
• The remaining ingredients (iron ingots) are consumed immediately when the craft starts as normal.

5. Custom Ingredient Types

seamsandstitches:item_variation

Matches a base ingredient only when a specific data marker is present (or absent) on the item. Useful for distinguishing items that share an item ID but differ in internal state — for example, toolbelts of different slot capacities that are all toolbelt:belt.

Fields:

Absence matching — omitting component_value lets you target the "default" state of an item that gains a component only after being upgraded:

{
  "type": "seamsandstitches:item_variation",
  "base": { "item": "toolbelt:belt" },
  "component_key": "toolbelt:belt_size"
}

Matches any toolbelt:belt that has no belt_size component (the base, un-upgraded belt).

Value matching — specify component_value to require a specific value:

{
  "type": "seamsandstitches:item_variation",
  "base": { "item": "toolbelt:belt" },
  "component_key": "toolbelt:belt_size",
  "component_value": "3"
}

Matches only a belt whose belt_size component serialises to "3". A belt with belt_size: 4 or no component at all is rejected.

Combine with deferred_ingredients and transfer_contents to build a full upgrade chain:

{
  "type": "seamsandstitches:sewing_pattern",
  "transfer_contents": true,
  "deferred_ingredients": [0],
  "display_name": "Iron Toolbelt (4 Slots)",
  "output": {
    "id": "toolbelt:belt",
    "count": 1,
    "components": { "toolbelt:belt_size": 4 }
  },
  "ingredients": [
    {
      "type": "seamsandstitches:item_variation",
      "base": { "item": "toolbelt:belt" },
      "component_key": "toolbelt:belt_size",
      "component_value": "3"
    },
    { "item": "toolbelt:pouch" },
    { "item": "materialistic:red_string" },
    { "item": "materialistic:red_string" },
    { "item": "materialistic:iron_emblem" },
    { "tag": "c:ingots/iron" }
  ],
  "seams": [ "..." ]
}

The output's belt_size: 4 component is preserved by the targeted content transfer — only the tool inventory carries over from the size-3 belt.

Configuration

Config file: config/seamsandstitches-common.toml

Default Recipes

Recipe Overrides

When enabled, the specified items can no longer be crafted at a crafting table and must instead be made at the Tailoring Bench.

Overridable recipe IDs:

• Armor: leather_helmet, leather_chestplate, leather_leggings, leather_boots, leather_horse_armor
• Items: book, painting

Dye Basin Overrides

By default the Dye Basin is the only way to dye items. The config gives per-category control over both sides of that: whether the vanilla crafting-table recipe is disabled, and whether the basin recipe itself is active.

Master switch

[dye_basin_overrides.vanilla] — re-enable individual vanilla shapeless dye recipes

Only meaningful when disableShapelessDyeRecipes is true. Set an entry to true to restore that specific vanilla recipe while keeping all others disabled.

[dye_basin_overrides.basin] — enable/disable individual basin recipes

Set to false to remove a basin recipe entirely (useful if another mod handles that item family).

All options require a game restart or /reload to take effect.

General Options

Debug Options

Dye Basin

The Dye Basin is a block for dyeing items. Craft it with any planks arranged in a U-shape with a bucket in the center (W_W / WBW / WWW).

How to use:

1. Fill the basin with a water bucket.
2. Right-click with a dye item to load a color — the water tints to match.
3. Right-click with an item that has a registered dye_bath recipe for that color. The item sits on the washboard ridge.
4. Right-click empty-handed three times to dunk the item into the dye.
5. After the third dunk, the dyed result ejects from the front face and the dye clears. The water remains for the next item.

Hold Shift + right-click empty-handed to retrieve the placed item without dyeing it.

Dye Bath Recipe Structure

Place recipe JSONs in the same data/seamsandstitches/recipe/ folder as sewing patterns.

Top-level fields:

Color output rules — exactly one of the following determines what color is applied:

Default Dye Bath Items

The following items are supported out of the box. All 16 dye colors are accepted for each family unless noted. Applying a new dye to an already-colored item re-colors it.

Any mod item added to the minecraft:dyeable tag is automatically compatible with the dyeable recipe.

Custom Dyeing Recipes

Color-pattern dyeing — one recipe covers all 16 dyes for wool. {color} is substituted with the active dye name at craft time:

{
  "type": "seamsandstitches:dye_bath",
  "ingredient": { "tag": "minecraft:wool" },
  "result_pattern": "minecraft:{color}_wool"
}

Vanilla dyed items — one recipe covers all 16 dyes for leather armor. Omitting result and result_pattern copies the input item and writes minecraft:dyed_color automatically:

{
  "type": "seamsandstitches:dye_bath",
  "ingredient": { "tag": "minecraft:dyeable" },
  "display_scale": 0.8
}

Modded container dyeing — for items that store color in their own integer data component rather than vanilla's minecraft:dyed_color, use dye_component_selectors to name those components. The input item is copied with all data components preserved, then each listed component is written with the dye's ARGB value:

{
  "neoforge:conditions": [{ "type": "neoforge:mod_loaded", "modid": "examplemod" }],
  "type": "seamsandstitches:dye_bath",
  "ingredient": { "tag": "c:example_dyeable_items" },
  "dye_component_selectors": ["examplemod:primary_color"],
  "display_scale": 0.8
}

Cross-mod color conversion — when a mod's colored item set has no white variant, use a specific dye: "white" recipe with a static result to redirect to the vanilla equivalent. Pair it with a general result_pattern recipe for the other 15 colors:

{
  "type": "seamsandstitches:dye_bath",
  "ingredient": { "tag": "examplemod:colored_items" },
  "dye": "white",
  "result": { "id": "minecraft:string", "count": 1 }
}