Prospectus

Paper plugin for Minecraft servers running Shopkeepers. Lets players search for shops by item and check their own shop stock.

Requirements: Paper 26.1.2+, Shopkeepers 2.27.0+

---

Commands

Command	Description
/who sells <item>	List shops selling the item, sorted cheapest per unit first
/who buys <item>	List shops buying the item
/stocks	Show your own shops and which trades are out of stock
/stocks <player>	Show another player's shop stock

Results are paginated (5 per page) with clickable arrows. Hovering item amounts shows the full item tooltip. Hovering the owner name or distance shows coordinates. Shops within the configured radius are highlighted in-world with a glowing outline visible through walls.

---

Permissions

Node	Default	Description
prospectus.who	true	Use /who sells and /who buys
prospectus.stocks	true	Use /stocks to view own shops
prospectus.stocks.others	op	Use /stocks <player>
prospectus.tp	op	Click a shop entry in chat to teleport to it
prospectus.excluded	false	Hides the holder's shops from all search results

---

Config

plugins/Prospectus/config.yml is created on first run. Options:

settings:
  include-admin-shops: true
  excluded-permission: "prospectus.excluded"
  blacklisted-players: []        # list of UUIDs to exclude
  highlight:
    enabled: true
    radius: 32
    duration-seconds: 30
  regions:
    enabled: false
    list: []                     # cuboid filters: {world, minX, minY, minZ, maxX, maxY, maxZ}