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.

Dependencies: QualityAPI (1.3.3+) and SilverLib (1.2.1+, required by QualityAPI) are required. Project MMO, JEI and EMI are optional.

Quality Tiers

Item quality is owned by QualityAPI. Seams & Stitches only decides which QualityAPI tier a craft earns; the tier's tooltip, colour, crafter name, durability and mining-speed scaling, granted enchantments and attribute bonuses all come from QualityAPI and its data.

Each completed craft is scored on two rates, both a fraction of the pattern's total stitches:

• hit rate: stitches landed at all
• perfect rate: stitches landed inside the target's inner (green) ring

A pattern's quality_tiers ladder maps those rates to tiers; the craft takes the highest band whose thresholds it meets on both counts. Below the easiest band's hit_rate the craft fails and no item is produced. The default ladder, used by any pattern that does not declare its own:

quality_api:standard is QualityAPI's level-0 tier, so an item that lands there is left plain and still stacks with ordinary items. Tier ids are plain resource locations: tiers a datapack or another mod adds to QualityAPI work with no code change.

What a tier does to a given item is defined in QualityAPI's quality_api:item_qualities data map, not in the recipe. This mod ships entries for leather armor and leather horse armor (data/quality_api/data_maps/item/item_qualities.json); a pack overrides or extends them by writing to the same path. Effects are added on top of the item's own stats.

Quick Craft (unlocked by mastering a pattern) skips the minigame, so its output is always plain.

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 tier band fields (quality_tiers is a list of these):

Bands can be listed in any order; the hardest one cleared wins. A pattern whose output should never carry quality (a book, a painting) can use a single quality_api:standard band: the craft can still fail below its hit_rate, but a success is always plain.

Tier effects live in QualityAPI's quality_api:item_qualities data map, keyed by item or #tag, then by tier id. Example (from this mod's leather helmet entry):

{
  "replace": false,
  "values": {
    "minecraft:leather_helmet": {
      "quality_api:fine": {
        "attributes": [ { "type": "minecraft:generic.armor", "operation": "add_value", "amount": 1.0, "slot": "head" } ]
      }
    }
  }
}

Besides attributes (type, operation, amount, slot), an effect can set durability_multiplier, mining_speed_multiplier, enchantment_levels, break_downgrade_chance and break_destroy_chance. See QualityAPI's documentation for the full schema.

Attribute ids usable as an effect type:

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_tiers": [
    { "quality": "quality_api:crude",      "hit_rate": 0.25 },
    { "quality": "quality_api:standard",   "hit_rate": 0.45 },
    { "quality": "quality_api:fine",       "hit_rate": 0.60, "perfect_rate": 0.25 },
    { "quality": "quality_api:superior",   "hit_rate": 0.75, "perfect_rate": 0.50 },
    { "quality": "quality_api:exquisite",  "hit_rate": 0.88, "perfect_rate": 0.75 },
    { "quality": "quality_api:masterwork", "hit_rate": 0.97, "perfect_rate": 0.92 }
  ],
  "crafts_to_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

Tier effects stack with QualityAPI's own per-tier durability and mining-speed multipliers.

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.

Leather Tanning

General Options

Project MMO Options ([pmmo], only used when Project MMO is installed)

Completing a sewing pattern pays the sewn item's Project MMO xp map, the same way Realms of Reverie's smithing anvil and gemcutter's table do: round(base × quality multiplier × (1 + stitch score × bonus)) × count. Which skills are paid, and how much, is entirely the pack's Project MMO data. Quick Craft pays the unscaled amount.

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 }
}

Tanning Rack

Leather no longer drops directly from animals — cows, mooshrooms, horses, donkeys, mules, llamas, and hoglins instead drop a species-specific raw hide item. Hides can only be tanned back into leather with the Tanning Rack.

Building and Using the Rack

The Tanning Rack is a 2×2×2 block made by 6 sticks and 3 planks.

Slots:

Tanning process:

1. Insert up to 4 hides, one per slot.
2. Insert lye. One lye is consumed the moment a hide begins tanning.
   • Lye is crafted from 2 Sand + 2 Bone Meal placed diagonally (2×2 grid).
3. Each slot finishes independently and converts its hide into leather.