Rule Examples

Rule Examples

These examples match the actual advanced config format used by this version of the mod.

1. Keep vanilla behavior for fire

Use this when you want all fire-tagged damage to ignore the cap.

rules=vanilla_fire_behavior

rules.vanilla_fire_behavior.enabled=true
rules.vanilla_fire_behavior.protect=false
rules.vanilla_fire_behavior.affect_modded_armor=true
rules.vanilla_fire_behavior.damage_tags=minecraft:is_fire

2. Stronger protection against boss damage

Use this when boss-like attacks should still damage armor, but not too hard.

rules=boss_damage

rules.boss_damage.enabled=true
rules.boss_damage.protect=true
rules.boss_damage.damage_types=minecraft:dragon_breath,minecraft:wither_skull
rules.boss_damage.max_percent=0.10
rules.boss_damage.max_flat_damage=5
rules.boss_damage.minimum_damage=1
rules.boss_damage.rounding_mode=FLOOR

3. Specific item only

Use this when one exact armor piece needs its own cap.

rules=specific_item

rules.specific_item.enabled=true
rules.specific_item.protect=true
rules.specific_item.items=minecraft:diamond_chestplate
rules.specific_item.slots=chest
rules.specific_item.max_percent=0.08
rules.specific_item.max_flat_damage=3
rules.specific_item.minimum_damage=1
rules.specific_item.rounding_mode=FLOOR

4. Modded armor group by tag

Use this when a whole group of modded armor should share one rule.

rules=modded_chestplates

rules.modded_chestplates.enabled=true
rules.modded_chestplates.protect=true
rules.modded_chestplates.affect_modded_armor=true
rules.modded_chestplates.item_tags=c:armor/chestplates
rules.modded_chestplates.max_percent=0.06
rules.modded_chestplates.max_flat_damage=2
rules.modded_chestplates.minimum_damage=1
rules.modded_chestplates.rounding_mode=FLOOR

5. Allow tiny hits to do zero durability damage

Use this for soft protection rules where very small hits should sometimes do nothing.

rules=soft_rule

rules.soft_rule.enabled=true
rules.soft_rule.protect=true
rules.soft_rule.max_percent=0.02
rules.soft_rule.minimum_damage=0
rules.soft_rule.rounding_mode=FLOOR

6. Exclude one item from a broad tag rule

Use this when a whole armor tag should match except one special item.

rules=tag_rule

rules.tag_rule.enabled=true
rules.tag_rule.protect=true
rules.tag_rule.item_tags=c:armor/chestplates
rules.tag_rule.exclude_items=minecraft:netherite_chestplate
rules.tag_rule.max_percent=0.06
rules.tag_rule.max_flat_damage=2

7. Explosion-only rule

Use this when explosion-tagged damage should have its own cap.

rules=explosion_rule

rules.explosion_rule.enabled=true
rules.explosion_rule.protect=true
rules.explosion_rule.damage_tags=minecraft:is_explosion
rules.explosion_rule.max_percent=0.04
rules.explosion_rule.max_flat_damage=2
rules.explosion_rule.minimum_damage=1
rules.explosion_rule.rounding_mode=ROUND

8. Several rules together

Rules are checked in order.

The first matching rule wins.

rules=vanilla_fire,boss_damage,specific_item

rules.vanilla_fire.enabled=true
rules.vanilla_fire.protect=false
rules.vanilla_fire.damage_tags=minecraft:is_fire

rules.boss_damage.enabled=true
rules.boss_damage.protect=true
rules.boss_damage.damage_types=minecraft:dragon_breath,minecraft:wither_skull
rules.boss_damage.max_percent=0.08
rules.boss_damage.max_flat_damage=3

rules.specific_item.enabled=true
rules.specific_item.protect=true
rules.specific_item.items=minecraft:diamond_chestplate
rules.specific_item.slots=chest
rules.specific_item.max_percent=0.05
rules.specific_item.max_flat_damage=1

In that example:

• fire-tagged damage uses vanilla behavior
• dragon breath and wither skull use the boss rule
• the chestplate-specific rule only applies if no earlier rule matched first

So if you want the specific item rule to have higher priority, move it earlier in rules=....