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.