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:

Tier	Lore	Behavior
Poor	"Poorly sewn by <player\>"	Minimum passing threshold — item produced with lowest bonus values
Well	(none)	Base result — no lore added
Expert	"Expertly crafted by <player\>"	Hit rate meets the expert threshold
Master	"Masterfully crafted by <player\>"	Every stitch hit within the perfect window

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:

Key	Description
`type`	Must be `"seamsandstitches:sewing_pattern"`
`texture`	Path to the item texture used as the sewing canvas (e.g., `"minecraft:textures/item/leather_helmet.png"`)
`output`	Object with `id` (`"mod_id:item_name"`) and `count`
`ingredients`	List of ingredient objects (`{ "item": "mod_id:item_name" }`), shapeless and order-independent
`seams`	List of seam definitions (see below)
`requires_pattern`	(Optional) Recipe ID the player must have unlocked before this recipe appears in the bench
`quality_breakpoints`	(Optional) Per-recipe quality thresholds (see below). Falls back to the global `poorThreshold` config value
`quality_bonuses`	(Optional) List of attribute bonuses applied per quality tier (see below)
`deferred_ingredients`	(Optional) List of 0-based ingredient indices that are not consumed when the craft starts. These items remain in the bench during the minigame and are consumed only on successful completion. If the craft is cancelled they are returned.
`transfer_contents`	(Optional, default `false`) When `true`, all DataComponents from the first deferred ingredient are copied onto the output via transmutation. Use this for upgrade recipes where a container item (e.g. a wallet or shulker box) should pass its stored contents to the upgraded output. Vanilla containers (shulker boxes, bundles) are detected automatically even without this flag; set it explicitly for modded containers.
`crafts_to_master`	(Optional, default `1`) Number of successful minigame completions required before Quick Craft is unlocked for this recipe. While progress is below the threshold, the preview panel shows `X/N` where X is the current count.

Seam fields:

Key	Description
`id`	Unique name for this seam segment (e.g., `"collar"`, `"left_sleeve"`)
`path`	Array of `[x, y]` pixel coordinates (0–15 for a 16×16 texture) tracing the seam line
`speed`	Float — traversal speed in path-index units per second (e.g., `2.0`)
`lead_in`	Seconds before the first stitch reaches the needle
`lead_out`	Seconds the seam lingers after the last stitch passes
`perfect_window`	Half-window (path units) for a perfect hit — determines Expert/Master quality

Quality breakpoints fields (quality_breakpoints):

Key	Default	Description
`poor`	`0.25`	Minimum hit fraction to produce any item. Below this the craft fails
`well`	`0.5`	Minimum hit fraction for Well quality
`expert`	`0.75`	Minimum hit fraction for Expert quality
`master`	`1.0`	Fraction of stitches that must be within `perfect_window` to achieve Master

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

Key	Description
`attribute`	The attribute to modify (e.g., `"minecraft:generic.armor"`)
`slot`	(Optional) Equipment slot group: `"head"`, `"chest"`, `"legs"`, `"feet"`, `"main_hand"`, `"off_hand"`, `"armor"`, `"any"`
`poor`	Attribute value applied at Poor quality
`well`	Attribute value applied at Well quality
`expert`	Attribute value applied at Expert quality
`master`	Attribute value applied at Master quality

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

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,
      "lead_in": 0.4,
      "lead_out": 0.4,
      "perfect_window": 0.05
    },
    {
      "id": "left_strap",
      "path": [[6,4],[6,5],[6,6],[7,7],[6,7],[5,8],[5,9],[5,10],[5,11]],
      "speed": 2,
      "lead_in": 0.4,
      "lead_out": 0.4,
      "perfect_window": 0.05
    }
  ],
  "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,
      "lead_in": 0.4,
      "lead_out": 0.4,
      "perfect_window": 0.05
    }
  ]
}

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 contents are transmuted onto the iron wallet output before the copper wallet is consumed.
The remaining ingredients (iron ingots) are consumed immediately when the craft starts as normal.

Configuration

Config file: config/seamsandstitches-common.toml

Default Recipes

Output	Ingredients	Quality Bonuses
Book	3x Paper, 1x Leather	—
Painting	1x White Wool, 8x Sticks	—
Leather Helmet	5x Leather	Armor (head): Poor 0 / Well 1 / Expert 2 / Master 3
Leather Chestplate	8x Leather	Armor (chest): Poor 0 / Well 1 / Expert 2 / Master 3
Leather Leggings	7x Leather	Armor (legs): Poor 0 / Well 1 / Expert 2 / Master 3
Leather Boots	3x Leather, 1x String	Armor (feet): Poor 0 / Well 1 / Expert 2 / Master 3
Leather Horse Armor	12x Leather	—

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.

Option	Default	Description
`enableRecipeOverrides`	`true`	Globally enables or disables all recipe overrides
`override_<recipe_id>`	`true`	Per-recipe toggle (only active when overrides are enabled globally)

Overridable recipe IDs:

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

General Options

Option	Default	Description
`poorThreshold`	`0.25`	Global minimum hit fraction (0.0–1.0) required to produce any item. Individual recipes can override this via `quality_breakpoints.poor`
`vanillafyUI`	`false`	When `true`, the Tailoring Bench UI uses the classic vanilla gray style instead of the dark UI

Debug Options

Option	Default	Description
`showPixelCoordinates`	`false`	When enabled, hovering over the sewing canvas shows `[x, y]` pixel coordinates under the cursor. Useful when designing seam paths for custom recipes

Dye Basin

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

How to use:

Fill the basin with a water bucket.
Right-click with a dye item to load a color — the water tints to match.
Right-click with an item that has a registered dye_bath recipe for that color. The item sits on the washboard ridge.
Right-click empty-handed three times to dunk the item into the dye.
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:

Key	Description
`type`	Must be `"seamsandstitches:dye_bath"`
`ingredient`	Ingredient object (`{ "item": "..." }` or `{ "tag": "..." }`) matching the item to be dyed
`dye`	Lowercase dye color name (e.g., `"red"`, `"light_blue"`)
`result`	Object with `id` and `count` — the item produced
`copy_components`	(Optional) When `true`, copies all DataComponents from the input onto the output. Use for container items (backpacks, etc.) to preserve stored contents
`apply_dye_color`	(Optional) When `true`, writes the dye's RGB value to the vanilla `minecraft:dyed_color` component on the output. Use for leather armor and other vanilla-dyed items
`result_from_input`	(Optional) When `true`, uses the input item as the base for the output via transmutation rather than creating a fresh result stack. Implies content transfer
`dye_int_components`	(Optional) List of `DataComponentType<Integer>` IDs to write the dye's RGB value into. Use for modded items that store color in their own components rather than `minecraft:dyed_color`
`display_rotation`	(Optional) `[x, y, z]` pre-rotation in degrees applied to the held item before the basin renderer tilts it onto the washboard. Defaults to `[0, 0, 0]`, which is correct for most items. Use `[-90, 0, 0]` for flat items like carpet whose natural face points upward
`display_translation`	(Optional) `[x, y, z]` offset in the washboard's slope-aligned frame, in blocks. Use to compensate for off-center models — e.g., carpet sits near y=0 in its cube, so `[0, 0.234, 0]` lifts it onto the slope surface
`display_scale`	(Optional, default `1.0`) Uniform scale applied to the item rendered on the washboard. Lower this if a full-sprite item clips through the basin's sides

Default Dye Bath Items

The following vanilla items are supported out of the box. Support is included for the minecraft:dyeable tag, so any mod item added to that tag is compatible.

Item
Leather Helmet
Leather Chestplate
Leather Leggings
Leather Boots
Leather Horse Armor
Wolf Armor
Wool
Carpet

The vanilla crafting-table recipe for dyeing leather armor is disabled when enableDyeBasinOverrides is true (the default), requiring the Dye Basin instead.

Custom Dyeing Recipes

Modded container dyeing — dyes a Sophisticated Backpacks backpack red while preserving its contents. Uses result_from_input to transmute the existing item (keeping all stored data) and dye_int_components to write the dye color into the backpack's own color component:

{
  "neoforge:conditions": [
    { "type": "neoforge:mod_loaded", "modid": "sophisticatedbackpacks" }
  ],
  "type": "seamsandstitches:dye_bath",
  "ingredient": { "item": "sophisticatedbackpacks:backpack" },
  "dye": "red",
  "result_from_input": true,
  "dye_int_components": ["sophisticatedcore:main_color"],
  "display_rotation": [0, 0, 90],
  "display_translation": [0.2, 0, 0]
}

Seams & Stitches