Files
spigot-quest-board/knowledge/user-stories/us-003-create-a-block-delivery-quest.md
T
dmg 638d2328ab
Release / release (push) Successful in 2m17s
CI / build (push) Successful in 1m4s
feat(quests): add quest creation and reward escrow
2026-09-04 23:45:00 -04:00

1.7 KiB

type, title, description, status
type title description status
User Story US-003: Create a block-delivery quest Let a player request block items while safely escrowing an inventory-funded reward. done

US-003: Create a block-delivery quest

As a player, I want to request a block material and quantity in exchange for items I already own so that another player can fulfill my request safely.

Acceptance criteria

  • A player can create a quest through a registered quest board by selecting a valid block material, a positive quantity, and reward items from their inventory.
  • Reward items must exist in the issuer's inventory and are removed only when quest creation succeeds.
  • Removed rewards are held durably in escrow by the quest system.
  • A created quest records a unique identifier, issuer UUID and current name, requested material and quantity, exact reward items, creation time, and expiration time.
  • Each quest expires exactly seven days after successful creation.
  • Invalid input, insufficient reward items, or persistence failure leaves the issuer's inventory unchanged and creates no quest.
  • When player commands are enabled, /quests create ... provides equivalent validated creation behavior with contextual autocomplete.
  • Quest state and item metadata survive server restarts without duplication or loss.
  • Automated tests verify validation, escrow, rollback, timestamps, command routing, and persistence.