Toolsmith

Old Version Notices

Keeping these around just in case it's still useful for some! For most people, use the most recent version, and these likely won't effect you!

Before updating to 1.1.4!

If you edited the configs already and wish to keep your settings, copy the config files out of the config folder before you update and start the game! Configs will now automatically update and regenerate themselves with every new mod version! This makes it easy for everyone, no more having to manually reset them, unless you want to make changes everything is handled automatically! If you wish to make changes, just look in Toolsmith.json at the very top to turn this off. If you run a server, any changes to your configs should be sync'd with clients now.

 

Quick notice for version 1.1.0+!

If you used Toolsmith before this, I HIGHLY recommend that you back up your save before updating just in case, as a good bit of the core functionality has been reworked and made more dynamic! Also please delete your old config files and let the mod make new ones, default settings have changed a good deal, and old settings can be bad or cause trouble! If you are loading up an old world from before 1.1.0, you will need to run the Remapper that should pop up when you join, and then restart your game after it finishes. If you are on a server, your server admin has to do this and restart the server! Mod page has been updated with the new info, and I am in the middle of adding in the requested Handbook pages as well! Cause of this rewrite, I wanted to get it done and out along with a bunch of fixes, and mechanics have changed so now I can spend time writing better handbook info pages.

I wanted first and foremost to make it a system that instead rewards the player for interacting with it instead of penalizing, and most importantly, will work out of the box with any mod's tools so long as it is configured properly. To this point, if there are any mods you find do not work immediately, let me know and I can add compatability to the default configs! All tool and part detection and stat lines are fully exposed in the Config files, so adding compat or tweaking things should be as easy as just editing them. It should also be possible to add in your own materials for handles or bindings as you please, or adjust the default settings I set up! If you opt to stick to the vanilla method of just using sticks and no binding material? Your handles and bindings will have the same durability as a vanilla tool of the same teir. The main change on top of this is that your tool's head will be more durable (currently 5x vanilla tool tier durability), and if you keep it well maintained, it will last for a very, very long time.

This loops back to the second driving goal, a more 'realistic' feel for your tools. A real tool could stay functional for generations if it was well-kept, and as a friend of mine joked around with, 'If I bought an axe and it broke after chopping down three large trees, I'd be pissed! I'd demand my money back!' A big change Toolsmith makes is a deliberate step away from that more 'Survival Crafter' idea of consumable tools, and tries to make something a bit more like Valheim if you have played that. The cost is shifted a little away from the metal, and more to the handles and binding materials of your choice.

Tools now have a second visual bar on them if they are not blunt! This second bar represents how sharp the tool is, and it is important to keep your tools from getting blunted if they aren't already supposed to be. For a quick overview, Sharpness will wear down as you use the tool just like Vanilla Durability, but as it lowers, the efficiency of the tool will slowly decrease. When you use a fully sharp tool, there is a small period where none of the parts - should it have multiple parts - will take any damage. This doesn't last too long as that level of sharpness will quickly deteriorate, but it is a reason to fully sharpen them when you choose to! After this though, the handle and bindings of a tool will take damage again, but until the head gets more dull it still might be able to go without chipping or taking durability hits.

As the tool gets more dull through use, this chance to damage the head will go up until it is always happening on every use - to remedy this, you will want to hone your tool on a Grindstone or Whetstone! While your tool gets more use and becomes duller, it slowly incurrs a steady chance of acquiring a Drawback. Drawbacks are small debuffs that will effect one part of the tool or another, like the head chipped a nasty chunk out of it and is at risk of more damage to that spot, or maybe a fracture starts to form in the metal and if you keep straining it, it could entirely crack apart. ( -- Drawbacks are not currently implemented yet, but are in progress! -- )

The durability bar still functions like it should, but for a Tinkered Tool it will visually display whatever durability is the lowest in your tool. That means if you use a Handle that is almost broken in a fresh tool, it will reflect that!

These are both used to re-sharpen a tool, in exchange for damaging the Tool or Tool's Head durability! The Grindstone can be used any time and won't really wear down since it's such a large chunk of stone, but Whetstones on the other hand are a more portable form of sharpening your tools. They are knapped from any knappable stone to make a flat surface on which to try and hone your tools, but they tend to wear out fairly quickly and only last about three full sharpens before you'll have to grab another. There will be upgrades to these to come that last longer, or provide a better curve for the damage and resulting in less durability damage overall, but they are in progress. For now, it is better to sharpen once and for a long time, as the longer you sharpen your tool for, the less damage it will take. But if you frequently oversharpen your tools, you will find them wearing down a lot faster!

There are a few ways you can put together your Tinkered Tools now!

To build any Tinkered Tool, you can take the Tool Head you want and hold it in your main hand, then place a Handle material in your offhand. Now just hold rightclick to bundle them together and you will produce a single item, a Head and Handle pair! This intermediary step lets you set aside a head with a handle before you make the full tool, but they do not stack. When you want to actually construct the two into your tool proper, you can optionally grab a Binding material and hold that in your offhand once again and hold rightclick while holding the Part Pair in your main hand just like before. Even without a binding this works - and after a bit of crafting, you'll have a complete tool!

When you have a Saw, you can craft yourself a Workbench, and those slots in the middle of the table can be used to craft tools. Take a look at the icons and the In-World tooltips when you glance at any slot for which part goes where, and once you have all your parts in their slots, take a hammer and right click any of them a few times to craft your tool together!

If you wish to use the Grid Crafting method, it must be enabled in the mod settings. This is disabled by default just to clear up RAM and lower the boot time for the server, since it was only going to be growing bigger and bigger with the shear number of recipes being created. If enabled, procedurally generated recipes for every handle, head and binding are created so any combination can be used to construct a Tool.

To Deconstruct your tools before they break, all you have to do is take the tool in question to your Grindstone or your Workbench. If you are using your workbench, look at the Vise to the left side of the workbench and hold rightclick on it with the tool you wish to deconstruct. If you are choosing to use your Grindstone, you can just do the same but anywhere on the block. No matter what method you choose to use, if your Binding material is damaged at all you will be unable to recover it successfully since it needs to be damaged to take apart the head from the handle without breaking those pieces any. So please be aware if you make any mistakes constructing your tool, be sure to take it back apart before you use it!

Or a metal-based smithed tool!

You will need a Workbench to start a proper reforge as you need a nice surface and some extra tools (supplied from the toolbox on the Workbench itself) to prepare the item and get it ready for reforging. Over to the right of the Workbench, infront of the Toolbox, is the proper place for it. If you have a tool head or smithed tool that has less then 90% durability remaining in it, just put it down on your workbench and grab your smithing hammer to give it a nice whack with Rightclick to properly prepare it for reforging. This will convert it back into a Smithing Recipe workpiece, but you will notice that based on the amount of damage that the tool sustained before this, some portions of the metal head will be missing and need replacing or that a bit of metal has been bent out of shape. This is where Smithing Plus comes in handy! Using it's Smithing with Bits you can easily patch this up without using a full ingot and in return your head will be almost brand new once more!

See the above dropdown for how to use your Workbench to Craft!

These types of tools are the main meat of the mod! These tools are where you can put more care and effort into producing them, make a better proper handle, give it a grip, maybe even treat the wood, and finally secure that head on better with a proper binder. There are a few options for putting them together, so for now pick whatever you please. Because vanilla has no requirements for binding materials, you can opt to not use one - and instead just have to slap that tool head back on the handle when it comes off again. Just check the tooltips for the Heads and Handles to see their remaining durability percentage when your tool might fall apart. In addition to this, all valid Handles, Bindings and Tool Heads will have tool tips added to them that indiciate what part they are as well as if they are looking to be in a decent condition or not. Check the dropdowns for a bit more on each of these part types! Generally they are organized with the cheapest and weakest at the top, and the more expensive and better options following.

If any of these three main parts (Head, Handle or Binding) hit zero durability, the tool will fall apart, but if the Head or Handle still have durability you can reuse them. As mentioned before in the Bindings section, if they have not been used to below a certain window they can be reused again. This should cover most of everything about Tinkered Tools!

Smithed Tools are both tools that you may create through smithing that result in the finished tool upon completion - or any more specific tool that does not follow the conventions of having different parts like a handle or a binding, where those would not make sense to use. Some examples of each are the Vanilla Shears and Chisel, since they are produced fully as soon as you finish their smithing recipe, and some modded tools like the Rolling Pins from Expanded Foods, or the Creaser from Art of Growing. They represent a more singular tool that doesn't have varied parts, but those that still can benefit from the Sharpness and Reforging (where applicable) will be able to!

These tools are still crafted in their own ways, but they can also be considered a Blunt Tool just like Tinkered Tools can. If you have a Blunt Smithed tool, it functions the same as a Blunt Tinkered Tool!

As mentioned above, a Blunt tool is a separate classification from a Smithed one or a Tinkered one. While for those two a tool can be one or the other, any tool can be Blunt in addition. The main difference between a blunt tool and a regular one is right in the name, this tool doesn't really use sharpness to determine it's effectiveness. Instead it has a consistant chance to damage itself upon being used, and this chance does not fluctuate as you use the tool, barring any Drawbacks that may change this. By default the chance to actually damage a blunt tool is a small 2% chance on any use to damage either the tool itself or the tool head, but if you have a Tinkered Tool or anything with parts, this only effects the blunted part in question - and the others will still take durability damage. So watch your bindings and handles on your smithing hammers, but the head should last a long time! In addition, any metal tool can still be reforged when the durability gets low so you can always keep around your favorite smithing hammer or wrench.

Toolsmith.json

Some of these options are either out of date or moved around now, another rewrite of the configs happened moving them into the JSON files under Assets/(Mod Domain)/Config/Toolsmith - Check these for examples on how you add your own Json files for easy compat!

---

This file contains the core config options for the mod, turning on and off certain settings, adjusting some values, and the core registering of what actually constitutes a 'Tool' in the Mod's system. Always the registering of a tool and parts will be contained in the bottom portion of the file so the important and simple settings remain on top. The current simpler settings are as follows:

• PrintAllParsedToolsAndParts - Default: false, if enabled will print debug information to the log about everything the mod parsed as the various tools and parts. Helps if you are looking to configure the settings for more mods yourself!
• DebugMessages - Default: false, if enabled Toolsmith will print general debug messages throughout the mod. Please check the source code to see what is logged if curious.
• HeadDurabilityMult - Default: 5.0, accepts any decimal value. This value is multiplied against the Tool's base Vanilla durability to determine a Tool Head's maximum durability. Set it to 1.0 for a Tool Head to have strictly vanilla numbers, but this does not change Handle or Binding Durabilities. It's recommended to at least have it set to 2 or 2.5 if you want to take full advantage of the current best tools and bindings without having to Grindstone your toolhead multiple times, but I found 5 seems to work for how I like things. Don't set it negative!
• GrindstoneSharpenPerTick - Default: 5, this value is the amount of durability repair per tick of the Grindstone and only accepts integer values. Set it higher to use the Grindstone faster, or lower if you want to make it take longer to grind a tool back into shape. Don't set it negative!

 

Now after this point is where the config gets more complicated and can be ignored unless you are looking to add compatability yourself to other mod's tools, or add functional parts to handles or bindings. Generally this part of the config shouldn't be touched unless you know what you are doing, and this section is what is important to regenerate now and again if you are looking to update the default config settings. Any time inherent mod compatability is added, it will be changing this section most likely. I won't include the default strings for these because it would be a wall of settings, it would be better to just let the mod regenerate a fresh config file if you wish to take a peek at the settings! It's also going to be a bit more technical in the explanations as well, it helps if you understand the layout of the base game's Json files for items and blocks. The first five settings use Regex to parse through the loaded items in the game while looking for what validates as a 'tool', and which kind it is. For these five settings, if you want to add an entry, just follow the default example and add a | before the ) and followed by your additional string to compare with.

• ToolHeads - This string contains various key fragments of the code to detect a tool's head. Vanilla's Axe Code is just 'axe' while the Axe Head is 'axehead', so it goes through all the found TinkerableTools and finds recipes that are used to craft them, then looks at the ingredients to determine what ingredient's code contains any of the strings in this bunch. Since an Axe in vanilla is made from a GridRecipe of an "axehead" and a "stick", it will match with the "head" in the default string to determine that this item is the Tool's Head used to craft this tool.

 

These three strings dictate what the mod looks for and considers a tool.

• TinkerableTools - These Tools are the ones that can be crafted like a Vanilla Axe or Pickaxe, a tool that takes a handle and a head. Any that match with these strings will be considered a valid Tinkered Tool as explained above! This only needs the Code of the tool's item, and it will match with all variants of that tool. Sometimes it may help to be a bit more specific in some cases and also include parts of the variants as well, an example of this is in the Stone Quarry compat. All of their Chisel tools are the same base 'chisel' item definition with variants for each tool, "chisel-finishing" or "chisel-wedge" for example, but these are specifically Tinkerable Tools and not Smithed (single part) Tools. Toolsmith looks for Tinkered Tools first and then Smithed Tools second, so entries in this string will match first and exclude that tool from being checked for if it is a Smithed Tool.
• SinglePartTools - This is very similar to the above setting, except that it will be matched with tools that are Smithed Tools. Since this checks only after Toolsmith determines it is not a Tinkerable Tool, there's no need for adding anything that is already being matched with something on the Tinkerable Tools string, but it shouldn't cause any problems. It is important to remember that since this checks only after it has been determined something is not a Tinkered Tool, that can be used to filter more specific cases into Tinkerable Tools first and the rest can hit a more generic Code here. These tools again just operate on a single durability value of the tool, so it can be used to catch any item with durability that you wish to add the Grindstone or other mechanics to.
• BluntHeadedTools - This string is used to check after Toolsmith has found a Tool, and checks if a tool is a Blunt Tool - one that's head won't be damaged from general use. Mainly for Hammers and Wrenches in vanilla, but it can also be used to just tell the mod not to damage this tool's head (or tool entirely if a Smithed Tool) on use, but it still will take use damage on the Handle and Bindings if it has them. While it's called 'blunt' headed tools, it can be used to simply tell Toolsmith to not allow for the Grindstone to interact with this tool in cases it might not really make sense. No matter what type of tool it is, it will compare against this string, so all types of tools can be 'Blunt'.

 

• PartBlacklist - This string is checked any time Toolsmith has found something that matches any of the Tool type (Tinkered or Smithed) strings above, and is used to exclude any item from actually being matched as a Tool. This is used in the Vanilla game to prevent Toolsmith from considering a Helve Hammer from being considered a Tool, since it doesn't actually use durability, but it still has 'hammer' in it's Code.

 

Finally, these two config settings are entirely explicitly defined Dictionary entries of full Codes as the key, for respective tool parts, handle or binding - followed by any tags for the specific stat information defined in the other file.

• ToolHandlesWithStats - This entry is all items that will be considered a Handle for a Tinkered Tool. Each item needs to be defined separately and completely, the best examples to check are the handles Toolsmith adds. It needs the full Code with variants string as the Key. It may help to look at the handles Toolsmith adds for how they fit together. Unless someone is making an expansion mod for Toolsmith, you probably won't have to mess too much with this setting at all.
  • handleStats - Set this to be the same as the key defined in PartStats.json for the handle core. Used to define the base material, or tier level, of the handle. IE stick, bone, crude...
  • gripStats - Set this to be the same as the grip key you want assigned to this Handle. This is based on the variants of the handles.
  • treatmentStats - This defines if the handle has been treated or not, similarly to the grip, based on the variants of handle.
• BindingsWithStats - Similarly to the Handles, the Keys for this setting are the explicit full code for the item in question to be allowed to be considered a Binding. For now it only has one ID associated with it, the bindingStats key. This helps to define one set of stats and use it for multiple bindings easily and only have to edit just one entry to change all of their stats.

ToolsmithPartStats.json

Still in construction, sorry!

The Upcoming Secrets

Next up on the list:

• Toolsmithing Weapons and Combat Overhaul integration. Right now it just lets all weapons default to vanilla mechanics, and doesn't touch them. I'd like to change this eventually, but since I love using Combat Overhaul, accounting for that will take time and possibly some special effort! Would be nice to add some additional tweaks or modifiers to them though... Serraded Blade for bleed? Poison, perhaps? Who knows quite yet, nothing is set in stone. Maltiez added stats for the weapons based on attributes, so that means that any Tinkering done on the weapons could have an even greater effect, too!

 

Later down the line (or just constant progress now and again):

• Further out-of-the-box Mod Compatability. For at least my modpack, this has already been configured to work with everything in there and it contains some big mods like Primitive Survival and Ancient Tools, and especially QP Chisel Tools!
• Integration with the Wood Lathe mod! I REALLY want to get this working with that, because I absolutely wanted to add proper wood-turning for handles and more to Toolsmith itself, so this mod being made is AMAZING. Perhaps another set of tool handles specifically from the Lathe? Who knows! It's really cool!
• Some Misc ideas: Blacksmith Gloves, Bellows maybe, Metal Smithing Tongs... Naming your tools?
• Perhaps once weapons are working better, a method to restore the Ruined tools back, or at least use them as a blueprint or study to craft a replacement blueprint! Idea offered by v99 on the Discord!

Please read this for any answers to commonly asked questions!

How do I use the different handles? / How do I apply a binding?

Please read the tooltips on various items! I've left indications if something is a valid part, what kind of part it is, and most importantly, how to use them. Your Tool Head has instructions on using the In-Hand crafting method, and after the first step, read the tooltip on the middle step to continue and add an optional binding. If you want more info, please read the Construction And Deconstruction dropdown in General Overview above.

 

Will Weapons work with Toolsmith?

Not currently, but it is being worked on! If you want more information on it, check the Github link up above and then click on the Projects tab once there. I have set up a Roadmap with a bunch more information on what I have planned, and the goals I'm going to strive for with it!

 

What do the other two slots on the Workbench do?

They currently are semi-unused for crafting a tool, but they are intended to be used for tools that require more then 3 parts!

 

I don't like the tool models. Can you change them back?

There is an option in the Client Config file to entirely disable the multi-part rendering code, it will disable any distinction for what tools are made of what parts and return the vanilla models. Sorry you don't like it, but I can't do more then this without additional help really - the shear amount of models that would be needed for that is a lot, and to keep updating the mod while maintaining a whole ton of part models and wanting to add more capabilities and everything is just not feasible and I rather not spend the time doing that when I have other obligations and want to add actual functionalities to the mod.

If you are interested in making your own part designs for everything and need any assistance or help to understand what is needed, I more then welcome the effort and the help! Just shoot me a message on the Toolsmith Thread on the Vintage Discord or otherwise let me know, and I can help you out! It would be possible to then upload it as a separate addon mod, or otherwise incorporate it into the base mod if you wished.

Mods already confirmed working

• Ancient Tools (Adze, Wedges and Mallet)
• Primitive Survival (Cordage can be used as a Binding material)
• Stone Quarry (All the Chisels and Rubble Hammer)
• Tailor's Delight (Awls, Leather Strips as a Binding material)
• QP Chisel Tools (Every tool it adds should be accounted for! Most are 'Smithed Tools' though and can be repaired, but a good number have been registered as 'blunt' so they take low low damage. It's for decor anyway!)
• Spyglass
• In Dappled Groves (Adze and the different Axes)
• Art of Growing (Creaser, Flail and Hayfork)
• Expanded Foods (Rolling Pin, as well as the ability to Oil your handles!)
• Oils! From Seed to Substance (Linseed and Walnut Oil, and Wood Finish, can be used for handles)
• Butchery (Hide and Sinew Glue can be used as a Binding material, Bone Pickaxe is classed as a Tinker Tool)
• Wool and More (The various wool twines you can harvest can be used as Twine Binding)
• Wildcraft Trees (The woods can be used in handle-crafting for unique colors!)
• Hunting Knife
• Multitools (Paxel)
• Smithing Plus - Partners incredibly well with Jayu's smithing tweaks and additions! I highly recommend downloading that alongside!
  • It is also important to note that Smithing Plus will only take effect on a Tinkered Tool if you break the Tool's Head, not just the Handle or Binding.
  • Also you will want to adjust the Smithing Plus "BrokenToolVoxelPercent" config down to like 0.4 so that it accurately penalizes breaking a tool head, but still makes it salvagable!
• XSkills - Should also be fully compatable now, I believe! With the durability changes from a unique attribute to the vanilla one, I believe this will make every part of XSkills function with every tool! You may wish to configure the reforge durability percent to be less then 100% or else you can keep rerolling your Quality attributes for free.
• CAN Jewelry - Jewels encrusted on tools will remain on the tool head if on a Tinker Tool! Also in the Jewelry Configs there is "chance_gem_drop_on_item_broken" to configure a chance on both Reforge and Tool/Head breaking that the gems themselves will be recovered! The Gem Chisel is also classed as a Smithed Tool!

Incompatible or Other Issues

Anything in here will have more information as to why it is in here! As always, if anything changes, do let me know!

• Item Rarity - It's mostly compatable now! The only issue arises if you try to make a grid-crafted tool the rarity won't properly apply. A quick bit of testing seems to show In-hand crafted tools work fine, and seem to lose durability normally. As well as how it patches ConsumeCraftingIngredients instead of OnCreatedByCrafting causes some troubles.
• Combat Overhaul (Base) and Armory - Works without conflict, but Toolsmith's changes and additions will not effect weapons (not yet at least... Soon...)
• Weapon Pack Alpha - Just like CO and Armory, works without conflict, but the weapons are uneffected by any changes.
• Salty's Manual Tool Crafting - Not really needed, since I added similar functionality with the In-Hand crafting for tools! Doesn't conflict though from what I saw, just plays the crafting audio twice.
• RepairMe - It's not exactly required with the Grindstone in Toolsmith and the Wear mechanics. It should work from what I've been told so far. I've tried to get it functional on my end but I don't use it myself, so please let me know if something changes.

Known Issues or Bugs

• Currently Toolsmith does not effect Weapons yet, spears, falx, or CO's Armory or anything. I want to add more parts and expand on the system to include these, as for example a sword has a guard and hilt instead of a handle and binding! Plus, with CO, there can be tweaks to the usability stats... And that's hype. Currently in progress!