Durability Preservation Attributes

A mod that adds player attributes which give a percentage chance to prevent durability loss on equipment.

The mod currently adds these attributes:

• durability_preservation_attributes:durability_save_chance
• durability_preservation_attributes:armor_durability_save_chance
• durability_preservation_attributes:shield_durability_save_chance
• durability_preservation_attributes:weapon_durability_save_chance
• durability_preservation_attributes:projectile_durability_save_chance
• durability_preservation_attributes:break_durability_save_chance
• durability_preservation_attributes:use_durability_save_chance

What The Mod Does

Each attribute represents a chance from 0.0 to 1.0 to retain durability upon the usage of equipment:

• 0.0 = 0% chance to save durability
• 0.25 = 25% chance to save durability
• 1.0 = 100% chance to save durability

What each attribute affects:

• durability_save_chance: a global durability save chance added to every category below
• armor_durability_save_chance: armor durability loss when the player takes damage
• shield_durability_save_chance: shield durability loss when the player blocks damage
• weapon_durability_save_chance: durability loss when the player attacks a living entity with a damageable melee weapon
• projectile_durability_save_chance: durability loss when the player uses projectile weapons such as bows and crossbows
• break_durability_save_chance: durability loss from breaking blocks with damageable tools
• use_durability_save_chance: durability loss from using damageable items, such as flint and steel and other right-click style item uses

The global attribute is additive with the category-specific attributes.

Examples:

• durability_save_chance = 0.10 and armor_durability_save_chance = 0.10 gives armor a total save chance of 0.20 (20% chance)
• durability_save_chance = 0.25 and break_durability_save_chance = 0.40 gives block breaking a total save chance of 0.65 (65% chance)

The total cannot go over 1.0 (100% chance)

Applying The Attributes With Commands

Minecraft's /attribute command can be used to set these values directly on a player.

General format:

/attribute <target> <attribute_id> base set <value>

Examples:

/attribute @s durability_preservation_attributes:durability_save_chance base set 0.10
/attribute @s durability_preservation_attributes:armor_durability_save_chance base set 0.20
/attribute @s durability_preservation_attributes:shield_durability_save_chance base set 0.35
/attribute @s durability_preservation_attributes:weapon_durability_save_chance base set 0.15
/attribute @s durability_preservation_attributes:projectile_durability_save_chance base set 0.50
/attribute @s durability_preservation_attributes:break_durability_save_chance base set 0.25
/attribute @s durability_preservation_attributes:use_durability_save_chance base set 0.40

You can also read the current value:

/attribute @s durability_preservation_attributes:break_durability_save_chance get

And reset a value back to zero:

/attribute @s durability_preservation_attributes:use_durability_save_chance base set 0.0

How It Works Behind The Scenes

This mod is server-authoritative and event-driven.

• Armor and shield durability are handled through NeoForge durability-related events.
• Melee, projectile, block-breaking, and item-use durability are handled by taking a short-lived snapshot of the relevant ItemStack, letting vanilla or modded logic run, and then restoring the original damage value if the durability-save roll succeeds.
• The preservation roll is based on the player's global durability_save_chance plus the relevant category-specific attribute, and the combined result is clamped to the 0.0 to 1.0 range.
• Attribute values are synced, so modifiers from commands, gear, datapacks, or other mods can affect them.
• The mod does not scan inventories every tick. It only tracks a small pending restore state for players who have just performed a relevant action.

Server Behavior And Synchronization

The mod is designed to work correctly on servers.

• Durability decisions are made on the server.
• Restore logic runs on the server after the relevant action completes.
• This avoids client-authoritative durability changes and reduces the risk of client/server desync.

Mod Compatibility

The mod is written to work with vanilla items and with modded items that use the normal NeoForge or vanilla durability paths.

This includes most modded:

• armor
• shields
• melee weapons
• bows
• crossbows
• tools
• damageable right-click items

Important compatibility note:

If another mod bypasses normal durability hooks and directly mutates item damage entirely in custom code, no event-based compatibility layer can guarantee interception. In practice, items that follow standard Minecraft or NeoForge behavior should work correctly.

Performance

The mod is lightweight by design.

• No continuous inventory scanning
• No per-player background processing beyond a tiny pending restore pass after relevant actions
• Only reacts when the player performs durability-affecting actions

For normal gameplay, performance impact should be minimal.