Test Nexo durability and repair materials on expendable tools

Applies to: Nexo; match the linked maintainer documentation to your installed platform and release.
Documentation checked 9 November 2026.

A tool can have the right appearance while wearing out or repairing incorrectly. Separate maximum damage, current damage and allowed repair materials during a controlled trial.

Check the installed content

Nexo manages custom content through item definitions, resource-pack files and optional mechanics. A correct item identifier does not prove that the client received the matching pack. Follow the documentation for your installed build and keep its generated assets with the source definitions.

Work through the change

1. Record the tool ID and expected durability and repair policy. Check the component reference against the exact Minecraft version, because available item components differ between releases.
2. Create a disposable staging tool with only the relevant durability settings. Obtain a fresh copy and perform a repeatable task that normally consumes durability.
3. Test the intended repair material through the supported vanilla interaction. Include a material that should fail, and check whether the repaired tool keeps its name and other components.
4. Repeat with a copied older tool and inspect the difference. Add other custom mechanics only after the simplified tool wears and repairs as designed.

Verify the result

The tool should lose the intended amount of durability and accept only the planned repair path. Its identity and unrelated enchantments should remain intact after a valid repair.

If the result differs

If the tool never takes damage, inspect its unbreakable or conflicting component settings. If repairs remove custom identity, isolate the anvil or integration behaviour before increasing durability values.

Keep a recovery path

Restore the previous definition and retain the disposable comparison tools for diagnosis. Keep valuable player equipment out of the test; editing a definition does not necessarily reverse damage already stored on an item.

References and related help

Check the maintainer reference: Nexo documentation.

Before changing live data, read how to keep a completed recovery copy. For startup errors, use the log collection guide.