Back to mods
Armor effect customization project artwork

CurseForge · Minecraft mod

Armor effect customization

Add custom effects/enchant/potion to any armor piece through an easy configuration

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Armor effect customization release should I use?

Updated 12 months ago
Latest stable file armoreffects-1.0.1.jar
Game version 1.20.1
Loader Forge

Armor effect customization armoreffects-1.0.1.jar targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Armor effect customization required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Armor effect customization armoreffects-1.0.1.jar need?

armoreffects-1.0.1.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Armor effect customization without breaking your instance.

Built for Armor effect customization armoreffects-1.0.1.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use armoreffects-1.0.1.jar. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside armoreffects-1.0.1.jar. It opens that exact file at the source.

About this project

What does Armor effect customization add?

Armor Effects Mod

A Minecraft Forge mod that allows you to add custom effects to any armor piece through configuration. Create powerful armor sets with speed boosts, damage reduction, potion effects, and more!

Features

  • Flexible Configuration: Add effects to any armor item
  • Multiple Effect Types: Attributes, damage reduction, potion effects, and enchantments
  • Slot-Based Scaling: Different percentages for helmet, chestplate, leggings, and boots
  • Visual Tooltips: See effect percentages directly on items
  • Performance Optimized: Uses AttributeModifiers for permanent effects when possible

Configuration

The mod uses a configuration file located at config/armoreffects-common.toml. Here's how to configure it:

Slot Percentages

Configure the effect strength for each armor slot:

[effect_percentages]
helmet_percentage = 12      # Helmet effects are 12%
chestplate_percentage = 18  # Chestplate effects are 18%
leggings_percentage = 15    # Leggings effects are 15%
boots_percentage = 12       # Boots effects are 12%

Simple Rule: Whatever percentage you set is exactly what the effect will be. 12% helmet = 12% speed boost, 12% damage reduction, etc.

Item Effects

Add effects to specific armor pieces using this format:

"namespace:item_name+category:effect_id"
"namespace:item_name+category:effect_id@level"  (for potions and enchantments)

Categories

  1. attribute - Permanent stat boosts (recommended for performance)
  2. damage - Damage reduction effects
  3. potion - Potion effects (applied every 2 seconds)
  4. enchant - Enchantment effects (future feature)

Examples

items = [
    # Speed Effects (Attribute)
    "minecraft:golden_helmet+attribute:speed",
    "minecraft:golden_chestplate+attribute:speed",
    "minecraft:golden_leggings+attribute:speed",
    "minecraft:golden_boots+attribute:speed",
    
    # Damage Reduction
    "minecraft:leather_boots+damage:fall_protection",
    "minecraft:iron_helmet+damage:projectile_protection",
    "minecraft:diamond_chestplate+damage:blast_protection",
    "minecraft:netherite_helmet+damage:fire_protection",
    
    # Potion Effects (with levels)
    "minecraft:diamond_helmet+potion:minecraft:night_vision",      # Night Vision I (default)
    "minecraft:iron_chestplate+potion:minecraft:regeneration@2",   # Regeneration II
    
    # Other Attributes
    "minecraft:netherite_chestplate+attribute:attack_damage",
    "minecraft:diamond_leggings+attribute:max_health"
]

Available Effects

Attribute Effects (Recommended)

  • speed - Movement speed boost
  • attack_damage - Melee damage increase
  • attack_speed - Attack speed increase
  • armor - Armor points increase
  • armor_toughness - Armor toughness increase
  • knockback_resistance - Knockback resistance
  • max_health - Maximum health increase

Damage Reduction Effects

  • fire_protection - Reduces fire/lava damage
  • projectile_protection - Reduces arrow/projectile damage
  • blast_protection - Reduces explosion damage
  • fall_protection - Reduces fall damage (like Feather Falling)
  • magic_protection - Reduces magic damage
  • general_protection - Reduces all damage types

Potion Effects

Use any Minecraft potion effect ID:

  • minecraft:regeneration - Health regeneration
  • minecraft:night_vision - Night vision
  • minecraft:water_breathing - Water breathing
  • minecraft:fire_resistance - Fire resistance
  • And many more...

How It Works

Effect Calculation

All effects use the same simple formula: Effect Strength = Slot Percentage

Examples:

  • 12% helmet with speed → +12% Movement Speed
  • 18% chestplate with fire protection → +18% Fire Damage Reduction
  • 15% leggings with attack damage → +15% Attack Damage

Tooltips

Hover over armor pieces to see their effects:

  • Attribute effects: Gold text (e.g., "+12% Movement Speed")
  • Damage reduction: Green text (e.g., "+18% Fire Damage Reduction")
  • Potion effects: Blue text (e.g., "Night Vision")
  • Enchantments: Aqua text

Important: Attribute vs Potion Effects

Some effects can be achieved in multiple ways. Here's when to use each:

Speed Effects

  • attribute:speed - Permanent speed boost, no visual effects, best performance
  • potion:minecraft:speed@2 - Speed II potion with particles, refreshed every 2 seconds

Other Overlapping Effects

  • attribute:max_health - Permanent health boost
  • potion:minecraft:health_boost@2 - Health Boost II potion effect

Recommendation: Use attribute effects for permanent stat boosts (speed, health, damage) since they're more efficient and don't show potion particles.

Performance Notes

  • Attribute effects use permanent AttributeModifiers (best performance)
  • Damage reduction is calculated during damage events (good performance)
  • Potion effects are applied every 2 seconds (moderate performance impact)

Example Configurations

Speed-Focused Golden Armor

items = [
    "minecraft:golden_helmet+attribute:speed@2",
    "minecraft:golden_chestplate+attribute:speed@2",
    "minecraft:golden_leggings+attribute:speed@2",
    "minecraft:golden_boots+attribute:speed@2"
]

Result: Full set gives 12% + 18% + 15% + 12% = 57% total speed boost

Tank Diamond Armor

items = [
    "minecraft:diamond_helmet+damage:general_protection@12",
    "minecraft:diamond_chestplate+attribute:max_health@10",
    "minecraft:diamond_leggings+damage:general_protection@12",
    "minecraft:diamond_boots+damage:fall_protection@12"
]

Result: General damage reduction + extra health + fall protection

Utility Leather Armor

items = [
    "minecraft:leather_helmet+potion:minecraft:night_vision@1",
    "minecraft:leather_chestplate+potion:minecraft:water_breathing@1",
    "minecraft:leather_leggings+attribute:speed@1",
    "minecraft:leather_boots+damage:fall_protection@15"
]

Result: Night vision, water breathing, speed, and fall protection

Complete Example: Understanding the System

Let's create a custom Diamond Speed Set to understand how everything works:

Step 1: Set Slot Percentages

[effect_percentages]
helmet_percentage = 10      # We want helmets to give 10%
chestplate_percentage = 20  # Chestplates give 20% 
leggings_percentage = 15    # Leggings give 15%
boots_percentage = 10       # Boots give 10%

Step 2: Add Speed to Diamond Armor

items = [
    "minecraft:diamond_helmet+attribute:speed@999",    # The @999 doesn't matter!
    "minecraft:diamond_chestplate+attribute:speed@1", # Neither does @1
    "minecraft:diamond_leggings+attribute:speed@5",   # Or @5
    "minecraft:diamond_boots+attribute:speed@100"     # The slot % is what counts
]

Step 3: What You Get In-Game

When you hover over the armor pieces, tooltips will show:

  • Diamond Helmet: "+10% Movement Speed" (gold text)
  • Diamond Chestplate: "+20% Movement Speed" (gold text)
  • Diamond Leggings: "+15% Movement Speed" (gold text)
  • Diamond Boots: "+10% Movement Speed" (gold text)

When you wear the full set:

  • Total Speed Boost: 10% + 20% + 15% + 10% = 55% faster movement
  • Each piece applies its effect independently
  • Effects stack together for the total boost

Step 4: Understanding the @Level Number

Important: The @level number works differently depending on the effect category:

  • Potions & Enchantments: Level matters (Speed I vs Speed II, Fire Protection I vs IV)
  • Attributes & Damage: Level is ignored, uses slot percentage
# For potions - level matters
"minecraft:diamond_helmet+potion:minecraft:speed@1"     # Speed I
"minecraft:diamond_helmet+potion:minecraft:speed@3"     # Speed III

# For attributes - level ignored, uses slot percentage  
"minecraft:diamond_helmet+attribute:speed@1"            # 10% speed (helmet %)
"minecraft:diamond_helmet+attribute:speed@999"          # 10% speed (same!)

Step 5: Mixing Effect Types

You can also mix different effects:

items = [
    "minecraft:diamond_helmet+attribute:speed@1",           # 10% speed
    "minecraft:diamond_chestplate+damage:blast_protection@1", # 20% explosion reduction  
    "minecraft:diamond_leggings+attribute:max_health@1",    # 15% health boost
    "minecraft:diamond_boots+potion:minecraft:jump_boost@2" # Jump Boost II every 2 seconds
]

Result when wearing full set:

  • 10% speed boost (permanent)
  • 20% less explosion damage (permanent)
  • 15% more max health (permanent)
  • Jump Boost II effect (refreshed every 2 seconds)

Tips

  1. Use attributes over potions when possible for better performance
  2. Adjust slot percentages to balance armor pieces as you like
  3. Stack effects by wearing multiple pieces with the same effect type
  4. Test in creative mode to fine-tune your configurations
  5. The @level number doesn't affect the final percentage - it's always the slot percentage
  6. Higher slot percentages = stronger effects, regardless of armor material

Troubleshooting

  • Effects not working: Check that enable_armor_effects = true in the config
  • Tooltips not showing: Check that display_enchantments_in_tooltip = true
  • Wrong percentages: Remember the formula is simple - slot percentage = effect percentage
  • Config not loading: Make sure the TOML syntax is correct (proper quotes, brackets, etc.)

Default Armor Effects

The mod comes with these default effects:

  • Leather Armor: Fall damage reduction (Feather Falling effect)
  • Iron Armor: Projectile damage reduction
  • Golden Armor: Speed boost (using efficient AttributeModifiers)
  • Diamond Armor: Explosion damage reduction
  • Netherite Armor: Fire damage reduction

You can modify or remove any of these by editing the config file.

Project description from CurseForge.

Pick your setup

Armor effect customization by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Armor effect customization versions and loaders

2 of 2 releases match

Looking for an older file? The official CurseForge project page is in Resources.