1.3 KiB
1.3 KiB
type, title, description, status
| type | title | description | status |
|---|---|---|---|
| User Story | US-004: Automatically replace broken tools | Move an equivalent inventory tool into the player's hand when their current main-hand tool breaks. | done |
US-004: Automatically replace broken tools
As a player, I want an equivalent tool moved into my hand when my current tool breaks so that I can continue working without searching my inventory.
Acceptance criteria
- When a player's main-hand tool breaks, the plugin searches the player's inventory for a replacement.
- A replacement must have the same tool type and material as the broken tool; for example, a diamond pickaxe replaces only a diamond pickaxe.
- Eligible replacements may come from the main storage inventory or another hotbar slot.
- The replacement is moved into the currently selected hotbar slot.
- Existing durability, enchantments, custom names, persistent data, and other metadata on the replacement are preserved.
- No unrelated item is moved when an equivalent replacement is unavailable.
- Off-hand tool breakage does not replace the main-hand item.
- Cancelled damage or break events do not trigger replacement.
- Automated tests cover matching, unavailable replacements, hotbar and main-storage candidates, metadata preservation, and off-hand behavior.