Hidden Shop Items & Discovery System

[FirebrickRed]

Summary

Shop items that are hidden from players until discovered through keywords, reputation, or investigation checks. Enables secret inventory and roleplay-driven shopping.

Phase: 3 - Advanced Features
Systems: Shop System, Interaction, DM Tools

Prerequisites

• Native Villager Trade GUI Shop System #75 - Native Villager Trade GUI Shop System (MUST be completed first)

Goals

• YAML configuration for visible vs hidden items
• Reveal methods: keyword, reputation flag, investigation check
• /dmentity shop <entity> view --dm - DM sees all items
• /dmentity shop <entity> reveal <item> - Manually reveal
• /dmentity condition <entity> set <flag> - Set reputation flags
• DM notes for roleplay hints

YAML Format

id: mysterious_trader
name: "Hooded Merchant"

shop:
  visible_items:
    - item: healing_potion
      price: 50
      
  hidden_items:
    # Keyword reveal
    - item: potion_of_invisibility
      price: 200
      reveal_keyword: "invisibility"
      reveal_method: dialogue
      dm_note: "Nervous about illegal goods"
      
    # Reputation reveal
    - item: magic_sword
      price: 500
      reveal_condition: "merchant_trusts_party"
      reveal_method: reputation
      
    # Investigation reveal
    - item: stolen_necklace
      price: 300
      reveal_method: investigation
      dc: 15
      dm_note: "Hidden in back room"

DM Commands

# View full shop (including hidden)
/dmentity shop mysterious_trader view --dm
> Visible: Healing Potion (50 GP)
> Hidden (keyword): Potion of Invisibility (200 GP)
> Hidden (reputation): Magic Sword (500 GP)
> Hidden (investigation DC 15): Stolen Necklace (300 GP)

# Manually reveal item
/dmentity shop mysterious_trader reveal potion_of_invisibility
> "Potion of Invisibility" now visible

# Set reputation flag
/dmentity condition mysterious_trader set merchant_trusts_party
> Magic Sword now visible in shop

Roleplay Example

Player: "Do you have anything... exotic?"
DM: [Sees keyword "invisibility" hint in notes]
DM: /dmentity shop mysterious_trader reveal potion_of_invisibility
DM (in-character): "Well... if you're asking, I might have something special."
Player: [Opens shop, sees new item]

Next Steps

No immediate next steps - complements existing shop system.

Related Issues

• Native Villager Trade GUI Shop System #75 - Shop System (prerequisite)
• Shop Price Adjustment System (DM-Only) #76 - Price Adjustments (works together)
• Entity Stat Block Display #74 - Stat Block Display (can show hidden items to DM)