Mastering Armor Tweaker: Customize Every Piece of Gear in Minecraft
Have you ever wished you could tweak your iron chestplate to offer a little more protection, or make diamond boots as enchantable as gold? Perhaps you wanted to nerf an overpowered armor set without rewriting the entire game. Armor Tweaker is the mod that puts that power in your hands, using the familiar CraftTweaker scripting system. It goes far beyond simple stat adjustments, letting you redefine armor materials, create brand-new material types, and even change how armor looks and gets repaired. If you love fine-tuning every aspect of your Minecraft experience, this mod belongs in your toolkit.
What Makes Armor Tweaker Stand Out
Unlike some other tweaking mods that only scratch the surface, Armor Tweaker digs deep into armor mechanics. It works on individual items rather than entire material classes, so you can have two iron helmets with completely different stats. The mod uses .zs scripts, meaning you can adjust values on the fly without restarting your game or editing config files manually. And because it integrates with CraftTweaker, you can combine it with other tweaks for a fully customized world.
Key Features at a Glance
- Per-item armor stat changes: Modify defense amount, durability, and toughness for any specific piece of armor without affecting others of the same material.
- Material property overhaul: Change the texture name (visual appearance), max damage factor, enchantability, and even the repair material for an entire armor material.
- Custom armor materials: Create entirely new materials with unique stats, allowing you to have, say, iron boots with high enchantability and an iron chestplate with low enchantability while both still look like iron.
- Defense per slot: Set separate damage reduction values for feet, legs, chest, and head, giving you granular control over protection.
- Repair material control: Specify which item is used to repair armor on an anvil. Want to stop players from fixing diamond gear with diamonds? Just set the repair material to something rarer.
- JEI compatibility: Changing repair materials automatically updates Just Enough Items anvil recipes, so players can see exactly what they need.
Getting Started with Armor Tweaker Scripts
If you’ve ever used CraftTweaker, the syntax will feel like second nature. The mod adds a few new ZenScript classes: ItemArmor for tweaking individual items and ArmorMaterial for modifying or creating materials. You can also use the in-game chat commands /minetweaker armor items to list all armor pieces with their stats, and /minetweaker armor materials to see every material’s properties. This makes debugging and planning your changes incredibly straightforward.
Example: Buffing a Leather Helmet
Here’s how you might turn a humble leather cap into a formidable piece of headgear:
import mods.vanilla.ItemArmor;
var leatherHelmet = ItemArmor.get(<minecraft:leather_helmet>);
leatherHelmet.material = <armorMaterial:DIAMOND>;
leatherHelmet.damageReduceAmount = 5;
leatherHelmet.maxDamage = 200;
leatherHelmet.toughness = 2;
With these lines, the leather helmet now behaves like diamond armor in terms of material properties, offers 5 defense points (2.5 full armor icons), has 200 durability, and gains 2 toughness. The visual appearance remains leather, but the underlying stats are completely transformed.
Example: Redefining a Material’s Core Properties
Maybe you want all gold armor to look like iron, be more durable, and require feathers for repairs. That’s a material-level change:
var materialLeather = <armorMaterial:LEATHER>;
materialLeather.textureName = "minecraft:gold";
materialLeather.maxDamageFactor = 10;
materialLeather.damageReductionAmountArray = [2, 5, 6, 2];
materialLeather.enchantability = 25;
materialLeather.toughness = 3;
materialLeather.repairMaterial = <minecraft:feather>;
Now every piece of leather armor will render with the gold armor texture, have its durability multiplied by 10, protect feet/legs/chest/head with 2/5/6/2 points respectively, be highly enchantable, and require feathers to mend.
Example: Creating a Brand-New Armor Material
The real magic happens when you invent materials from scratch. The ArmorMaterial.add() function lets you define a name, texture, durability modifier, protection array, enchantability, and toughness. For instance:
import mods.vanilla.ArmorMaterial;
var magicIron = ArmorMaterial.add("MAGIC_IRON", "minecraft:gold", 20, [3, 6, 7, 3], 25, 1);
Now you can assign magicIron to any armor piece, and it will look golden, have 20x base durability, and provide solid protection with excellent enchantability. This material can be used across multiple items, each inheriting these baseline values.
Installation and Compatibility Notes
Armor Tweaker requires both CraftTweaker and MTLib to function. Simply place the mod files into your mods folder alongside these dependencies. While the mod is lightweight, a few quirks exist due to how Minecraft handles armor rendering. Assigning the minecraft:leather texture to a non-leather material will make the armor appear as white-dyed leather—a side effect of vanilla code, not a bug. Similarly, leather armor that uses a material other than “leather” cannot be dyed. If you keep both the material and texture as leather, the armor remains dyeable. For players who want a streamlined modding experience, the foxygame.net launcher offers a convenient way to install Armor Tweaker directly from its menu, automatically resolving dependencies and keeping your mods organized without any manual file hunting.
As for compatibility, the mod plays nicely with JEI, updating anvil repair recipes on the fly. It does not use coremods, so conflicts with other tweaking mods are minimal. If you need to prevent players from repairing vanilla armor with its default material, simply set the repair material to something extremely rare—like a nether star—since you cannot completely remove the default repair item.
Why Armor Tweaker Belongs in Every Modpack
Balancing armor in a modded environment can be a nightmare. One mod adds gear that trivializes survival, while another introduces materials that feel underwhelming. Armor Tweaker gives pack makers and server admins the precision they need to level the playing field. It’s equally useful for solo players who want to role-play or experiment with unconventional armor setups. Because everything runs through scripts, you can share your configurations easily and iterate without restarting the game. Whether you’re nerfing the overpowered, buffing the underused, or just having fun with cosmetic armor swaps, this mod turns you into the ultimate armorer of your Minecraft world.