The Shop Directory is a card grid of every shop a player can enter without walking up to a token. It's handy when running a town with several shops, or for abstract shops that have no NPC token. This chapter covers how to open the directory, which shops are visible to whom, what happens when a card is clicked, and how token-only shops behave differently from actor-based shops.
| Role | What they do |
|---|---|
| GM | Sees every configured shop. Can open Shop Settings directly from each card, or enter a shop as any character. |
| Player | Sees only shops with Show in Shop Directory enabled. Clicking a card enters the shop with their character. |
| From | For |
|---|---|
| Left scene controls toolbar > store icon (named Shop Directory) | Everyone. Opens the directory. |
| Game Settings > Module Settings > Stylish Shop > Shop Directory | Everyone. Opens the same directory. |
| Keybind Open Shop Directory | Everyone. No default key — bind one in Configure Controls if you want one. |
Macro API openShopWithBuyerSelection(shopId) or openShopById(shopId) |
Everyone. See Chapter 8. |
The scene controls button is a one-shot opener — pressing it opens the directory but does not keep the button visually toggled (from 1.3.0).
The directory is a grid of cards. Each card shows:
| Slot | Source |
|---|---|
| Card image | Directory Card Image (directoryArt) → NPC art (npcArt) → actor portrait → mystery-man default. The directory shows the full image without cropping. |
| Card title | The Identity Name. Accent markup (**...**) from the Identity tab is applied here too. |
| Subtitle / owner | The Subtitle and Owner Name from the Identity tab. |
| Item count | Sum of all items across the shop's categories (e.g. 42 items). |
| Badges | Public / Private / Token-Only (GM-only). |
| Gear icon (GM only) | Opens the Shop Settings for that shop directly. Works for token-only shops too. |
Cards are sorted alphabetically by shop name.
The module gathers two kinds of shops:
| Kind | Source | When it appears |
|---|---|---|
| Actor-based | Any world actor with the stylish-shop.shopConfig flag. |
Always a candidate, regardless of scene. |
| Token-based | Any unlinked token (actorLink === false) on the current scene whose token actor is a shop. |
Only when the token is on the current scene. |
Candidates are then filtered:
publicShop) enabled. Token-based candidates also require the token to not be hidden.A private shop can still be entered via the G-key on a token. Show in Shop Directory only controls the directory itself, not proximity entry.
What happens when the card is clicked depends on the user and how many characters they own.