KubeJS Metalworks (KubeJS Addon for Productive Metalworks)
If you have ever stared down a wall of recipe JSON just to make one stone melt into molten diamond, you already understand why this add-on exists. KubeJS Metalworks (KubeJS Addon for Productive Metalworks) is a small but mighty bridge between KubeJS and Productive Metalworks, letting modpack authors define melting, casting, alloying, and fuel recipes with short, readable scripts instead of sprawling JSON files. It targets NeoForge 1.21.1, so it slots neatly into modern modpacks built on that stack.
What This Add-On Actually Does
Productive Metalworks brings foundries, casting tables, and molten metals to your world. KubeJS Metalworks wraps that system in helper functions, so a single line of script replaces an entire recipe file. The add-on exposes a PMW object with methods for each recipe type, and you call them inside your KubeJS server scripts. That is the whole idea: less boilerplate, faster iteration, fewer typos in nested JSON brackets.
The add-on is aimed squarely at pack developers. If you are a player rather than a pack author, you will mostly notice its effects indirectly, as modpacks that use it tend to have more interesting and finely tuned metal processing chains.
Core Recipe Helpers at a Glance
Melting and Casting
Melting is as simple as calling PMW.melt(event, 'minecraft:stone', 'productivemetalworks:molten_diamond', 10), which turns one stone into 10 mB of molten diamond. Need a custom duration? Add the extra arguments and the recipe takes exactly as long as you want. Casting works the same way: PMW.itemCast handles item casts such as a blaze rod from molten blaze and a rod cast, while PMW.blockCast produces blocks, like a diamond block poured from 900 mB of molten diamond using stone as the cast.
Alloying
Alloy recipes accept a fluid list with amounts, so combining 3 parts molten copper with 1 part molten zinc into 4 parts molten brass is one compact call. Tag-based fluid references like #c:molten_copper work too, which keeps your scripts compatible with other mods that register the same tags.
Removing Recipes and Custom Fuels
You are not limited to adding content. PMW.removeId deletes a specific recipe by its ID, and PMW.removeType wipes an entire recipe category, which is handy when you want to rebuild the melting tree from scratch. There is also PMW.fuel for registering custom liquid fuels with your own temperature, speed, and consumption values, letting water or any other fluid power a foundry on your terms.
How to Install on NeoForge 1.21.1
Setup is straightforward, but order matters. Follow these steps:
- Install NeoForge 1.21.1 for Minecraft and launch the game once to generate the mods folder.
- Add KubeJS and Productive Metalworks first, since the add-on depends on both.
- Place the KubeJS Metalworks jar in your mods folder alongside them.
- Start the game or server, then write your scripts in the KubeJS server_scripts directory.
- Use
/reloadin-game to apply script changes without restarting.
When you download KubeJS Metalworks (KubeJS Addon for Productive Metalworks), double-check that the file matches your NeoForge 1.21.1 environment, because mismatched dependencies are the most common cause of a failed launch. If you would rather skip manual file juggling, the foxygame.net launcher keeps KubeJS Metalworks (KubeJS Addon for Productive Metalworks) in its add-on catalog and installs it with its dependencies in a single click.
Why Pack Authors Keep Coming Back
Script-driven recipes mean you can generate dozens of variations with loops and conditionals, something JSON simply cannot do. Changing a single number in a script updates every recipe that references it, which makes balancing a progression pack far less painful. The syntax stays close to plain English, so even players new to KubeJS can read a melting line and understand it immediately.
There is also a practical maintenance benefit. When you update Productive Metalworks, recipe IDs occasionally shift; with scripts, you fix one line instead of hunting through folders. Combined with the removal helpers, this makes full overhauls of the metal progression genuinely feasible for solo authors.
Final Thoughts
KubeJS Metalworks (KubeJS Addon for Productive Metalworks) for Minecraft is the kind of quality-of-life add-on that quietly saves hours. It does not add new machines or ores; it removes friction. For anyone building a NeoForge 1.21.1 modpack around foundries and molten metals, learning a handful of PMW calls is a worthwhile investment that pays off every time you tweak a recipe.