Files
spigot-inventory-helper/design/user-stories/us-003-sort-inventories.md
T
2026-09-04 11:02:53 -04:00

1.6 KiB

type, title, description, status
type title description status
User Story US-003: Sort containers and player inventory Let players use a Sorting Stick to consolidate and organize supported storage or their main inventory. backlog

US-003: Sort containers and player inventory

As a player holding a Sorting Stick, I want to sort storage containers or my main inventory so that related items are consolidated and organized automatically.

Acceptance criteria

  • Using the Sorting Stick on a chest sorts the complete chest inventory.
  • Using it on either half of a double chest sorts the combined inventory.
  • Using it on a barrel sorts that barrel.
  • Using it without targeting a supported container sorts the player's main storage slots.
  • Player hotbar, armor, and off-hand slots are not changed during player-inventory sorting.
  • Compatible partial stacks are consolidated without exceeding item stack limits.
  • Remaining stacks are placed in a deterministic, documented order.
  • Sorting preserves item quantities and all item metadata exactly.
  • Sorting respects cancelled interactions and normal container-access protections.
  • Unsupported or inaccessible targets fail safely without changing an inventory.
  • Sorting provides concise player feedback without opening the target container.
  • Automated tests cover single chests, double chests, barrels, player inventory boundaries, stack consolidation, metadata preservation, and rejected interactions.