Getting started
Three blocks do all the work. Craft a book with a stick for the in-game handbook. JEI or EMI (optional) show every recipe, melting and casting step.
Patterns & parts
3 planks over 2 sticks. Put in a blank pattern and click the part you want to carve. Patterns are reusable.
Pattern + material makes a part: wood, stone, flint, bone, bamboo, blaze rods, diamonds, string, leather, honeycomb, chain.
Metal parts
Bricks around a furnace, glass on top. Burns any furnace fuel. Ores melt into double metal.
Metals (copper, iron, gold, alloys, netherite) are cast into parts with gold casts.
Assemble & refit
A stick over a crafting table, with planks at the sides and below. Three parts make a tool.
Put a tool in to swap a part, repair it, add a modifier, or remove one with a sponge.
Tools never break. At 1 durability a tool is worn: no drops and no damage bonus, and it mines at hand speed until you repair it.
Tools
Every tool is one head, one handle and one binding (swords use a guard). Damage, speed, durability and harvest tier come from the parts.
| Tool | Parts | Notes |
|---|---|---|
| Pickaxe · Axe · Shovel · Hoe | head + handle + binding | Axes strip logs, shovels make paths, hoes till. |
| Sword | blade + handle + guard | Sweeping attacks; cuts cobwebs. |
| Hammer | hammer head + tough handle + tough binding | Mines 3×3 (5×5 and 7×7 with Expanded). |
| Excavator | excavator head + tough handle + tough binding | Digs 3×3. |
| Broad Axe | broad axe head + tough handle + tough binding | Fells whole trees. |
Sneak to mine a single block with heavy tools. Heavy parts cost more: big heads take 8 material, tough handles and bindings take 3.
Materials
Heads set the base stats, handles multiply them and bindings add a bonus. Every material brings a trait, and traits from several parts stack. cast means the Smeltery is required.
| Material | Head (dur / speed / atk / tier) | Handle | Trait |
|---|---|---|---|
| Wood | 60 / 2 / 0 / wood | ×1.0 | Ecological: slowly repairs itself |
| Stone | 130 / 4 / 1 / stone | – | Stonebound: mines faster as it wears |
| Flint | 150 / 5 / 1.25 / stone | – | Jagged: hits harder as it wears |
| Bone | 100 / 4.5 / 1.25 / stone | ×1.1 dur | Resilient: 10% free uses |
| Bamboo | – | ×0.85 dur, ×1.15 speed | Lightweight |
| Blaze rod | – | ×1.1 speed, ×1.1 atk | Blazing: ignites targets |
| Copper cast | 210 / 5 / 1 / stone | ×1.05 dur | Dwarven: faster the deeper you are |
| Iron cast | 280 / 6 / 2 / iron | ×1.35 dur | Magnetic: drops fly to you |
| Gold cast | 64 / 12 / 0 / gold | ×1.1 speed | Lustrous: double tool XP |
| Rose gold cast | 200 / 9 / 1 / iron | ×1.05 speed | Enhanced: +1 upgrade slot |
| Amethyst bronze cast | 300 / 6.5 / 1.5 / iron | ×1.1 dur | Crumbling: soft blocks break much faster |
| Diamond | 1561 / 8 / 3 / diamond | – | Sturdy: 10% free uses |
| Netherite cast | 2031 / 9 / 4 / netherite | ×1.25 dur, ×1.15 atk | Fireproof: won't burn |
Bindings & guards
| Material | Bonus | Trait |
|---|---|---|
| String | – | – |
| Leather | +15% durability | Tanned |
| Honeycomb | +5% mining speed | Waxed |
| Chain | +10% durability | Reinforced: counts as one level of Reinforced |
Smeltery
A single block with its own tank. Add fuel and things to melt; metals pool in the tank, alloys mix by themselves, and the selected metal is poured into whatever cast you put in.
Melting
Ingots, nuggets, blocks, raw ores and ore blocks. Ores give ×2 (configurable). Old iron, gold and netherite gear melts back down too.
Click a metal in the tank to pour it; shift-click to dump it. Hoppers work: items go in the top, fuel in the sides, output comes out the bottom.
Alloys
Rose gold = 3 copper + 1 gold
Amethyst bronze = copper + amethyst
Netherite = 4 netherite scrap + 4 gold
Casts
Pour gold onto any pattern to make a reusable gold cast of that part (2 ingots). Gold poured onto any ingot makes an ingot cast.
Casting
With a cast in place, the selected metal becomes that part or ingot. With no cast, it's cast into a storage block.
Levels, slots & expansion braces
Mining with the right tool or landing a melee hit earns tool XP. New tools have 3 upgrade slots and 1 ability slot.
Every level
+1 upgrade slot and +2% durability and mining speed. Max level 10 by default.
Levels 5 & 10
+1 ability slot each.
Expansion braces
Apply Copper, then Gilded, then Astral at the Tool Station. Each adds an upgrade slot (Astral adds an ability slot too). They're permanent and use no slot.
Copper Expansion Brace
Gilded Expansion Brace
Astral Expansion Brace
Modifiers
Add ingredients at the Tool Station. Many modifiers need several items per level, and partial progress is saved on the tool. Each level takes one slot of its type. A sponge removes the newest modifier. Storage blocks count as 9 items (quartz blocks as 4).
| Modifier | Slot | Per level | Max | Effect |
|---|---|---|---|---|
| Haste | upgrade | 16 redstone | 5 | +20% mining speed per level |
| Sharpness | upgrade | 16 quartz | 5 | +0.75 attack damage per level |
| Reinforced | upgrade | 2 obsidian | 5 | 15% chance per level to ignore wear |
| Luck | upgrade | 32 lapis | 3 | Fortune and Looting |
| Fiery | upgrade | 12 blaze powder | 2 | Sets targets on fire |
| Knockback | upgrade | 8 slime balls | 2 | Knocks targets back |
| Magnetic | upgrade | 1 compass | 1 | Drops fly straight to you |
| Expanded | upgrade | 4 pistons | 2 | Wider area for heavy tools |
| Diamond | upgrade | 1 diamond | 1 | +500 durability, small speed/damage boost, diamond tier |
| Emerald | upgrade | 1 emerald | 1 | +50% head durability, at least iron tier |
| Netherite | upgrade | 1 netherite ingot | 1 | Needs Diamond. +20% durability, +10% speed, netherite tier, fireproof |
| Silky | ability | 1 golden apple | 1 | Silk Touch (not with Luck or Autosmelt) |
| Autosmelt | ability | 4 blaze rods | 1 | Smelts what you mine |
| Siphoning | ability | 4 ghast tears | 3 | Swords and axes heal you for 5% of melee damage per level |
| Mending | ability | 16 bottles o' enchanting | 1 | Repairs itself from XP you pick up |
Enchanting tables, books and anvil merging don't work on Workshop tools: the Tool Station is the upgrade path. The anvil can still rename them.
WT BeeBlock Workshop
A separate optional addon with two hive-themed modifiers: Waxed durability protection and Honeybound slowing hits. Works with vanilla honeycomb and honey bottles, plus Forestry and Productive Bees if installed.
About the addon Addon on CurseForge
For pack makers & addon authors
Most balance lives in datapacks and config, so packs can change it without code.
Datapack recipe types
wt_workshop:material marks an item as a tool material and says how much it counts for (e.g. 9 nuggets = 1).
wt_workshop:melting defines what an item melts into. Set ore: true to apply the ore multiplier.
wt_workshop:alloying defines alloys from molten inputs.
Config
serverconfig/wt_workshop-server.toml sets slot counts, max level, the XP curve, the per-level bonus, ore multiplier, tank size, tree size, expansion tiers, Siphoning tuning and per-material head durability and speed.
Java addon API
Register namespaced modifiers with net.wtworkshop.api.AddonModifiers. The Tool Station, tooltips, JEI/EMI pages, partial progress, slots and optional per-tool art are handled for you. See ADDON-API.md. The BeeBlock addon is the worked example.
Recipe viewers
JEI and EMI are optional. When either is installed, WT Workshop adds pages for parts, casting, melting, alloys, modifiers and expansions.
Install & support
Installing
Put the jar in mods on both client and server. Keep only one WT Workshop jar. Back up your world before updating, as this is a beta.
Tools and parts from older versions convert automatically when they're in your inventory.
Found a bug?
Open an issue on GitHub with your Minecraft, NeoForge and WT Workshop versions, steps to reproduce, and latest.log or the crash report.