Durability Repair Items

Durability Repair Items

Internal repair consumables and the public durability API.

Applies to: Nord Inventory v2.0.0

Durability repair items

Nord Inventory can create internal usable items that restore durability on a specific target item without relying on another script.

Admin Studio

In Behavior → Use behavior, keep the handler on Internal (Nord) and set:

• Item effect: Restore durability
• Target item: choose an item that has durability enabled
• Restore amount: percentage points restored per successful use
• Remove on use: enable it if the repair item should be consumed

Nord only consumes the repair item when durability was actually restored.

Lua definition

['weapon_cleaning_kit'] = {
    label = 'Weapon Cleaning Kit',
    weight = 250,
    stack = true,
    close = true,
    use = {
        duration = 3500,
        actionText = 'Repairing with {item}',
        remove = 1,
        repair = {
            item = 'weapon_pistol',
            amount = 25
        }
    }
}

Server-authoritative behavior

When the repair item is used successfully, Nord Inventory:

1. validates that the configured target definition exists and uses durability;
2. searches the player's inventory for matching target instances;
3. selects the most damaged matching instance;
4. restores the configured amount without exceeding the target maximum;
5. consumes the repair item only after a real repair is applied;
6. updates inventory watchers immediately.

The same effect works with weapons and normal items because both use the standard metadata.durability state.

Safe failure cases

The use is rejected without consuming the repair item when:

• the player does not have the configured target item;
• the target definition does not use durability;
• every matching target is already at maximum durability;
• the repair configuration is invalid.

If several copies of the target exist, the most damaged copy is repaired first.

Runtime registration example

External resources can register repair items through the normal runtime API:

exports.nord_inventory:RegisterItem('pistol_cleaning_kit', {
    label = 'Pistol Cleaning Kit',
    weight = 200,
    stack = true,
    close = true,
    use = {
        duration = 3000,
        remove = 1,
        repair = {
            item = 'weapon_pistol',
            amount = 30
        }
    }
})

The repair itself remains server-authoritative inside Nord Inventory.