Getting Started

Stylish Shop puts a full-screen, Persona-5-flavored shop UI on top of your FoundryVTT NPCs. Configure an NPC actor once with categories, items, prices, and a theme, and players can walk up to that NPC and trade with a single keypress.

This chapter covers what you need to install, how to make your first shop, and the three ways a player can enter a shop. Deeper subjects (the config window, themes, currency, selling, the directory, system support, and the public API) are covered in their own chapters.

What This Module Does

One NPC equals one shop. Pick an actor, fill its categories with items, and that actor now holds a shop.
Eight built-in visual themes (four Grid layouts, four Character layouts) plus extra palettes per theme.
Works with system currencies (D&D 5e gp/sp/cp etc.), library-defined virtual currencies, and Smartphone Widget bank accounts.
Players buy and sell directly from the shop UI. Every transaction is validated by the GM client before it touches an actor sheet or inventory.

Who Uses It

Role	What they do
GM	Configures the NPC as a shop, builds categories, sets prices and themes, decides currency and selling rules.
Player	Opens the shop with their own character to buy and sell.
GM Preview	Opens any shop without a buyer character to check the layout. Purchase buttons stay locked.

Requirements

Item	Value
FoundryVTT compatibility	V13 minimum, V14 verified, V14 maximum (`minimum: 13`, `verified: 14`, `maximum: 14`).
Required module	GlitchSmith Library 0.5.0 or later.
Supported game systems	Built-in adapters: D&D 5e, PF1, PF2e, Daggerheart, SFRPG, Shadowrun 5e, Project FU, SWADE, WFRP 4e. Any other system works through Item Price Paths (Chapter 4).
Languages	English, Korean.

If GlitchSmith Library is disabled or older than 0.5.0, the module shows a permanent red error notification at world load and currency operations stop working. The library provides the shared currency and sheet-helper layer that every GlitchSmith module relies on.

Make Your First Shop

The fastest path. Have an NPC actor ready (or create a new one).

Open the NPC's actor sheet from the sidebar.
Click the Shop Settings button (store icon) at the top right of the sheet header. This button is GM-only.
The shop is created automatically with defaults and the Shop Config window opens:
- Layout Character, theme Default.
- Four starter categories: Weapons, Armor, Consumables, Misc.
- A theme-appropriate identity (NPC name, subtitle, greeting line).
Open the Categories & Items tab. Drag items from the sidebar (or compendium) into a category's drop zone. To add many at once, use the Bulk import link above the drop zone.
Click Save at the bottom of the window.
Click Open / Restore Preview to see what players will see. Purchase buttons stay disabled in preview, so it is safe to look around.