Hoarder's Forge: Recycle and Reclaim

<h1 id="hoarders-forge-recycle-and-reclaim" data-source-line="1">Hoarder's Forge: Recycle and Reclaim</h1> <p data-source-line="3">A Vintage Story utility mod that allows you to recycle old, worn-out tools, broken tool heads, arrowheads, metal chutes, and leftover metal scraps by melting them back in the crucible to reclaim their metal value.</p> <h2 id="-features" data-source-line="5">Features</h2> <ul data-source-line="7"> <li data-source-line="7">Crucible Recycling:&nbsp;Toss damaged tools, worn toolheads, arrowheads, chutes, brackets, and padlocks directly into the crucible to melt them back into liquid metal.</li> <li data-source-line="8">Durability-Based Yield:&nbsp;Reclaimed metal dynamically scales based on the item's remaining durability, returning less metal for worn-out items and preventing exploits.</li> <li data-source-line="9">Exploit-Free Voxel Math:&nbsp;Integrates with the&nbsp;SmithingPlus&nbsp;mod to dynamically calculate yields based on the voxel recipe (proportional to a 100u ingot). All calculations round down to the nearest multiple of 5 units to mathematically eliminate metal duplication exploits.</li> <li data-source-line="10">Vanilla Fallback:&nbsp;Fully functional in vanilla Vintage Story, utilizing a robust fallback yield table (100u for basic tools, 200u for large blades/plates, and 10u for arrowheads).</li> <li data-source-line="11">Fully Configurable:&nbsp;Easily adjust the recycling loss percentage and toggle debug logging in-game or via config file.</li> </ul> <h2 id="️-commands--configuration" data-source-line="13">Commands &amp; Configuration</h2> <p data-source-line="15">The mod can be configured in-game via a configuration dialog or directly via chat commands:</p> <h3 id="-chat-commands" data-source-line="17">Chat Commands</h3> <ul data-source-line="18"> <li data-source-line="18">/hoardersforge gui: Opens the config GUI dialog (requires&nbsp;controlserver&nbsp;privilege).</li> <li data-source-line="19">/hoardersforge test: Runs client/server integration tests to verify voxel values and melting calculations.</li> </ul> <h3 id="️-keybindings" data-source-line="21">Keybindings</h3> <ul data-source-line="22"> <li data-source-line="22">Config GUI Hotkey: Unbound by default. You can assign a custom keybind in the game controls settings under the name&nbsp;"Open Hoarder's Forge Config GUI".</li> </ul> <h3 id="️-configuration-settings" data-source-line="24">Configuration Settings</h3> <p data-source-line="25">Saved in&nbsp;ModConfig/HoardersForgeConfig.json:</p> <ul data-source-line="26"> <li data-source-line="26">LossPercentage&nbsp;(default:&nbsp;0.0): The percentage of metal lost during recycling. A value of&nbsp;0.0&nbsp;yields 100% reclaim.</li> <li data-source-line="27">DebugLogging&nbsp;(default:&nbsp;false): Enables verbose logging of voxel calculations and melting results in the game log.</li> </ul> <h2 id="-inspiration--credits" data-source-line="29">Inspiration &amp; Credits</h2> <ul data-source-line="31"> <li data-source-line="31">Inspiration: This mod was inspired by MightyGooga's excellent mightysmeltables, and also Re-Smeltables mods by octeris, which pioneered the concept of melting down tools and metal items.</li> <li data-source-line="32">Special Thanks:&nbsp;Massive thanks to&nbsp;<span style="text-decoration: underline;"><span style="color: #e74c3c; text-decoration: underline;">MIghtyGooga</span> </span>for providing valuable ideas, feedback, and help during the validation of the melting mechanics and mathematical balance of this mod!</li></ul>