Docs / ProAuction / Shops

Shops

Shops are admin-configured, NPC-backed entry points that open a dedicated Shop GUI (not the Auction House browser). Each shop item uses a per-item price and currency key.

Create a Shop

/ah shop create <key>
Starts the shop creation flow (setup GUI + chat prompts).
Flow
  • • Opens a setup GUI
  • • Chat prompts for entity type (example: VILLAGER)
  • • Chat prompts for shop name

Edit a Shop

/ah shop editor <key>
Opens the editor GUI for an existing shop.
Editor rules
  • • Slots 0–17 are editable (top two rows)
  • • Adding or replacing an item triggers a chat price prompt
  • • Price/currency are stored inside the item using PDC (PersistentDataContainer)

Pricing Prompt

When you add or replace an item in the shop editor, ProAuction prompts you in chat:

Format
<amount> <currencyKey>
Example
2500 rubies

Currency keys must exist in currencies.yml.

Storage

  • • shops.yml stores shop definitions and item layouts (YAML backend).
  • • Price/currency are persisted in each item via PDC, so the editor can rebuild prices reliably.

Shop NPC Behavior

Shop NPC interaction is controlled by settings.yml:

  • • Path: shops.entity.*
  • • Flags include invulnerable, silent, AI disabled, prevent despawn, cancel default interaction
Back to ProAuctionDocs