Patience

Adds crafting time to your workstations — clicking the output slot starts a timed process instead of completing the craft instantly. Progress is shown as a visual overlay with sounds and feedback. Fully server-authoritative: the config is synced to all clients on join and reload.

⚙️ Features

Crafting Delay — Base time scales with the number of ingredients and is modified by a stack of multipliers (global, per-container, per-ingredient, per-output, per-recipe). Crafting is blocked while moving. Creative mode bypasses the delay entirely.

Experience Scaling — Crafting speed increases with XP level through a custom patience:crafting_speed attribute. The attribute is exposed to other mods for integration.

Progress Decay — When enabled, moving during a craft causes progress to drain instead of cancelling outright. Leftover progress from an interrupted craft also decays over time. When decay is disabled, any movement immediately cancels the craft and resets progress.

Minigame — An optional skill check that can trigger mid-craft. A random section of the progress overlay is designated as the success zone. When progress reaches that zone, the overlay turns yellow — clicking the output slot during this completes the craft instantly. Missing it applies a time penalty. Clicking the output slot early when no minigame zone is active also applies a penalty. Green indicates success, red indicates failure.

Hunger — Each completed craft adds exhaustion. When hunger drops below a threshold, crafting speed is penalized.

Sounds — Each workstation has a unique looping crafting sound and a completion sound. Sounds can be overridden at three levels: per container, per item, or per tag.

Screen Shake — Optional camera shake during crafting. Disabled by default.

🔨 Supported Containers

Ships with preconfigured support for 17 workstations. All can be disabled, customized, or extended via config.

Vanilla

• Player inventory (2×2)
• Crafting table
• Smithing table
• Anvil
• Grindstone
• Stonecutter
• Cartography table
• Loom

Modded

• Curios
• Inventorio
• Sawmill
• Woodworks
• Easel Does It
• Galosphere
• Clayworks
• Cold Sweat
• Hexerei

🛠️ Configuration

Config is stored in patience.json in the game's config directory. A GUI screen is available when Cloth Config is installed (Fabric/Quilt via Mod Menu, NeoForge/Forge via the mods screen). The GUI covers general settings — multiplier maps and container definitions are JSON-only.

General

• debug (default: false) — Log slot clicks, screen names, crafting state changes, and movement checks to the console
• enable_sounds (default: true) — Play crafting and completion sounds
• default_crafting_sound (default: patience:crafting) — Sound played during crafting
• default_finish_sound (default: patience:finish) — Sound played on completion
• default_penalty_sound (default: patience:penalty) — Sound played on penalty click
• default_success_sound (default: patience:success) — Sound played on minigame success
• global_time_multiplier (default: 1.0) — Multiplier applied to all craft times (0.0 - 100.0)

Experience

Speed formula: (attributeValue × baseSpeed) + (speedPerLevel × min(xpLevel, maxLevelCap))

• enabled (default: true) — Enable XP-based crafting speed scaling
• multiplier (default: 1.0) — Overall crafting speed multiplier (0.0 - 100.0)
• base_speed (default: 1.0) — Base speed before XP bonus (0.01 - 100.0)
• speed_per_level (default: 0.02) — Bonus speed per XP level (0.0 - 10.0)
• max_level_cap (default: 200) — Levels above this are ignored (0 - 30000)

Decay

• enabled (default: true) — Moving drains progress instead of cancelling the craft
• rate (default: 2.0) — Progress lost per tick while moving or idle (0.0 - 100.0)

Screen Shake

• enabled (default: false) — Camera shake during crafting
• intensity (default: 0.5) — Shake strength (0.0 - 5.0)

Hunger

• enabled (default: true) — Enable hunger exhaustion and speed penalty
• exhaustion_cost (default: 0.1) — Exhaustion added per completed craft (0.0 - 40.0)
• penalty.enabled (default: true) — Slow crafting at low hunger
• penalty.threshold (default: 6) — Hunger level that triggers the penalty (0 - 20)
• penalty.multiplier (default: 0.5) — Speed multiplier when below threshold (0.0 - 10.0)

Minigame

• enabled (default: true) — Enable the skill-check minigame
• chance (default: 0.5) — Probability of triggering per craft (0.0 - 1.0)
• window_width (default: 0.15) — Success zone size as a fraction of total progress (0.01 - 0.5)
• penalty_percent (default: 0.25) — Progress lost on failure as a fraction of remaining (0.0 - 1.0)
• penalty_cancels_craft (default: true) — Cancel the craft when penalty clicks reduce progress to zero

Multipliers

Multiplier maps allow fine-grained control over craft time. All are Map<String, Float> in the JSON. Tag keys use the # prefix (e.g., "#minecraft:planks": 1.5).

• by_mod — scale time by mod namespace (e.g., "minecraft": 1.0)
• by_item — scale time by item ID (e.g., "minecraft:stick": 0.5)
• by_tag — scale time by item tag (e.g., "#minecraft:planks": 1.5)
• by_type — scale time by recipe type (e.g., "minecraft:crafting": 2.0)
• by_recipe — scale time by specific recipe ID

These are grouped under ingredient_multipliers, output_multipliers, and recipe_multipliers objects in the JSON. Ingredient and output multipliers support by_mod, by_item, by_tag. Recipe multipliers support by_type, by_recipe.

Item Sounds

item_sounds is a Map<String, String> that overrides the crafting sound per item or tag (e.g., "minecraft:stick": "patience:crafting", "#minecraft:planks": "patience:sawmill").

Containers

The containers array holds per-workstation configuration. Each entry supports:

• enabled (boolean) — Toggle crafting time for this container
• screen_class (string) — Full Java class path of the container screen
• recipe_type (string) — Recipe type ID used for recipe multiplier lookup. If omitted, inferred from the menu type
• time_multiplier (float) — Container-specific time multiplier
• output_slot (int) — Slot index the player clicks to start crafting
• result_slot (int) — Slot index where the finished item is placed after completion (-1 = first available inventory slot)
• ingredient_slots (string) — Slot range defining which slots are scanned for ingredients (e.g., "1-9", "0,2,4", "0-2,4,6-8")
• ingredient_mode (string) — How ingredients contribute to craft time: "slot" counts each occupied slot once, "stack" multiplies by stack size, "custom" uses hardcoded mod-specific logic
• show_overlay (boolean) — Render the progress bar
• overlay_texture (string) — Texture path for the overlay
• overlay_direction (string) — Fill direction: "right", "left", "up", "down"
• overlay_x / overlay_y (int) — Overlay position offset
• overlay_width / overlay_height (int) — Overlay dimensions
• crafting_sound (string) — Override crafting sound for this container
• finish_sound (string) — Override completion sound for this container

💬 Commands

• /patience reload (Op level 2) — Reload config from disk and sync to all connected players