Tinkerfold Guide

🔧 What is Tinkerfold?

✨ Feature highlights

• 🔪 7 forms in 1 item: Knife, Pickaxe, Axe, Shovel, Hoe, Loppers and Torch, plus a closed folded form
• ❤️ One shared durability pool: switching forms never repairs or damages the tool
• 🪄 Separate enchantments per tool: each form only takes its own kind and remembers them while folded
• 💎 3 tiers: Iron, Diamond and Netherite, upgraded at the smithing table with every enchantment kept
• 🔥 Torch mode: a torch-bright dynamic light (level 14) , in the main hand or the offhand
• 🌿 Loppers: shear leaves, vines, cobwebs and grass
• 🌱 Hoe and Shovel: till dirt and flatten paths with right-click
• 🔧 Repairs at an anvil with iron ingots, and takes Mending
• 🖐️ Offhand ready: every form can be held in the offhand
• 🧩 TinkerFold has been designed with cross-addon compatibility in mind, supporting blocks from other addons wherever possible.

🗺️ Guide contents

1. 🛠️ Crafting
2. 🔄 Switching tools
3. 🧰 The tools
4. ❤️ Durability, repair and Mending
5. 🪄 Enchanting (and how enchants stay on each tool)
6. 💎 Tiers and upgrading
7. 🖐️ Offhand, tooltips and other-addon blocks
8. 📊 Stats at a glance
9. ⚠️ Known limits and troubleshooting

🛠️ Crafting

A new Tinkerfold is one shapeless recipe in the crafting table, and it comes out as a closed TinkerFold. Diamond and Netherite versions are never crafted directly. They are upgrades (see Tiers and upgrading).

🔧 Tinkerfold (closed, Iron)

Shapeless, any arrangement, 8 items:

💡 Enchanted ingredients are not carried into the multi-tool. Craft with plain tools.

📋 Upgrade Template

That is 3 Iron Ingots and 1 Red Dye, in a 2x2 square anywhere on the grid. You need one template for each upgrade step.

💎 Diamond Plating

Diamond Plating is the addition item for the Iron to Diamond upgrade.

🔄 Switching tools

Right-click with a Closed Tinkerfold to open the Folding menu, then tap the form you want. How you open it depends on whether the tool is folded or unfolded.

• 🚫 Sneak + right-click on a Unfolded TinkerFold opens the Folding Menu.
• 📖 Every menu button shows its own Tinkerfold icon for that tool and tier.
• 📦 Fold Closed appears in the menu while a tool is unfolded. Use it to fold back up and to prepare for upgrades.
• 🔇 Switching plays a click sound. 

💡 Switching keeps durability, custom name, lore and the item's other data. Enchantments are swapped to the new tool's own set (see Enchanting).

🧰 The tools

Each form works like its vanilla counterpart, with a few Tinkerfold rules. Base attack damage is for the Iron tier. Diamond adds +1 and Netherite adds +2.

📌 Form notes

• ⛏️ Pickaxe, Axe, Shovel: mining speed is 8 (Iron), 10 (Diamond) or 12 (Netherite). Tool tier tags are set so they harvest what the matching vanilla tool would.
• 🌾 Hoe: tilling is handled by the script. 
• 🥄 Shovel: paths are also script-driven.
• ✂️ Loppers: shear leaves, vines, cobweb and grasses, costing 1 durability each. Tall grass drops 2. Loppers dig 2 speed points slower than the other tools.
• 🔥 Torch: places an invisible level 14 light block at your body, the same brightness as a normal torch. It moves with you every 2 ticks and is removed when you put the torch away, scroll off it, switch tool, change dimension or leave the game.
• ⚔️ Knife: breaking blocks with it costs 2 durability, as the sword does in vanilla.

🐚 Hoe and Shovel use scripted interaction, so the arm swing animation may not play when tilling or making paths. The action still works.

❤️ Durability, repair and Mending

Every form draws from one durability pool, so wear follows the Tinkerfold, not the form. Mine with the Pickaxe, switch to the Axe, and the Axe starts with the damage the Pickaxe left.

📉 What costs durability

• ⛏️ Breaking a block with the Pickaxe, Axe or Shovel: 1
• 🗡️ Breaking a block with the Knife: 2
• ⚔️ Hitting an entity: 2
• ✂️ Each Loppers shearing: 1
• 🌾 Each tilled block (Hoe) or path made (Shovel): 1

🛡️ Unbreaking

Unbreaking works per tool. Each form uses the Unbreaking level on that form's own enchantments, with a 1 in (level + 1) chance to be charged. Unbreaking III on the Pickaxe does not protect the Axe.

🔨 Repairing:

At an anvil

1. Fold or unfold the Tinkerfold as you like. Any form repairs the shared pool.
2. Put the Tinkerfold (regardless of tool tier) in the first anvil slot and Iron Ingots in the second.
3. Each ingot restores a quarter of the tier's maximum durability.

🌟 Mending

Mending works from the tool's own enchantment slot. Enchant the tool you want Mending on, and it repairs the shared pool when you collect XP while holding that form. Mending can sit on a tool of any kind, so you can pick the one you hold most often.

You may also Repair them with my whetstone

🪄 Enchanting

Every tool keeps its own enchantments, and they stay put while you switch forms, fold the tool or upgrade its tier. Enchant the Pickaxe for mining, the Axe for chopping, the Knife for combat, and each set comes back when you switch to that form.

✅ What each form accepts

A form only offers the enchantments that suit it. The Knife never gets Efficiency and the Pickaxe never gets Sharpness.

👍 How to enchant

1. Switch to the form you want to enchant (not the closed TinkerFold and not the Torch).
2. Use an enchanting table or an anvil with enchanted books, as you would on a vanilla tool.
3. Repeat for each form. Each one is its own separate set.

🧠 How enchantments are remembered

1. When you switch away from a form, the script saves that form's enchantments on the item, filed under the form's name.
2. It then clears them and loads the enchantments saved for the new form.
3. Switch back and the first form's enchantments return, with the same levels.
4. While the tool is closed, every saved set stays safely stored on the item. The closed knife shows none, but nothing is lost.

💎 Enchantments and tier upgrades

The memory is filed by form, not by tier. An enchantment on the Iron Pickaxe is filed under "pickaxe", so it is still there on the Diamond Pickaxe and again on the Netherite one. Upgrading the closed knife swaps the item to the new tier and the stored sets go with it. Tools made before this was added are converted the first time they are switched.

🔁 Quick answers

• Do enchants get lost when I switch forms? No. They are saved and restored per form.
• Do enchants get lost when I upgrade? They are designed to carry over, and the script passed its simulated tests. The smithing-table step itself is not yet confirmed in the real game. See Known limits.
• Do Unbreaking and Mending count across tools? Unbreaking is per tool. Mending repairs the shared pool.
• Can I put Sharpness on the Pickaxe? No. Only each tool's own kind is accepted.

💎 Tiers and upgrading

Tinkerfold upgrades from Iron to Diamond to Netherite at a smithing table, and every tool inside upgrades at once.

📈 Upgrade path

1. 📦 Fold the Tinkerfold closed. Only a closed TinkerFold can be upgraded.
2. ⚒️ Iron to Diamond at a smithing table:
   • Template: Upgrade Template
   • Base: closed Iron Tinkerfold
   • Addition: Diamond Plating
   • 
3. 🔥 Diamond to Netherite at a smithing table:
   • Template: Upgrade Template
   • Base: closed Diamond Tinkerfold
   • Addition: Netherite Ingot
   • 
4. Take the result from the output slot.

🎁 What carries over

• ❤️ Durability: the new tier has a larger pool (1600, then 2400).
• 🪄 Every enchantment on every tool, because each tool's set is saved by form and not by tier
• 🏷️ Custom name and lore
• 🔧 All seven forms: Knife, Pickaxe, Axe, Shovel, Hoe, Loppers and Torch become the new tier together

⭐ What each tier changes

• 💎 Diamond: durability 1600, mining speed 10, damage +1
• 🔥 Netherite: durability 2400, mining speed 12, damage +2, and it is fireproof (it survives lava and fire as an item)
• 

⚠️ Tinkerfold must be closed to be accepted at the smithing table. An unfolded tool is a different item and will not fit the recipe.

🖐️ Offhand, tooltips and other-addon blocks

🖐️ Offhand

Every form, including the closed knife, can be held in the offhand. The Torch light works from either hand, and the item tooltip refreshes there too.

💬 Tooltips

The item info window shows an efficiency line with its value for the digging forms:

• 🪓 Axe: Chop efficiency
• ⛏️ Pickaxe: Mining efficiency
• 🥄 Shovel: Dig efficiency

The value is the tier's base speed, and it rises with Efficiency: base speed + (Efficiency level squared + 1). Other forms show no efficiency line. Tooltips update about once a second.

📊 Stats at a glance

Diamond doubles Iron's durability and Netherite triples it. Damage is the base value plus the tier bonus.

⚠️Known limits and troubleshooting

🐛 Known limits

• 🌾 Hoe and Shovel actions may show no arm swing.
• 🔥 The Torch light trails a moment behind you (about 0.1 seconds).
• 🧱 A light block occupies a space, so very fast block placing at your body may be blocked.

   

   

• 🧱 Blocks from other addons

  The digging forms break blocks from other addons as long as those blocks use the standard Minecraft tags. They are set to match the usual pickaxe, axe and shovel block tags, plus older stone, metal, wood, log, dirt, sand, gravel and grass tags. Modded ores, stone, logs and soil normally work with no setup. A block with no tags cannot be sped up by any tool, and Tinkerfold is no exception.

• 📦 Closed knife and Torch take no enchantments.

🔧 Troubleshooting

💙 Credits

Made by SoggyAndroid aka SoggyGravel. Thanks for playing! 🎉