NormalShops

# NormalShops — Player & admin guide Thanks to https://github.com/Clickism/ClickShop - Clickism ### In-world shop (storefront) <p align="center"> <img width="400" alt="Outside view of a NormalShops storefront" src="https://raw.githubusercontent.com/gamerchamper/NormalShops/main/imgs/shop.png" /> </p> ### Villager Menus used as trading <p align="center"> <img width="400" alt="Outside view of a NormalShops storefront" src="https://raw.githubusercontent.com/gamerchamper/NormalShops/refs/heads/main/imgs/trade1.png" /> </p> <p align="center"> <img width="400" alt="Outside view of a NormalShops storefront" src="https://raw.githubusercontent.com/gamerchamper/NormalShops/refs/heads/main/imgs/trade2.png" /> </p> *Custom display: item showcase, glass/base blocks, and optional sale-style floating text.* ### `/shops` — public shop browser <p align="center"> <img width="560" alt="Minecraft GUI for the /shops command" src="https://raw.githubusercontent.com/gamerchamper/NormalShops/main/imgs/shops-command.webp" /> </p> *Paginated list of in-stock shops; click entries to teleport (when enabled).* ### GUI overview (main menus) <p align="center"> <img width="720" alt="Collage of NormalShops GUI menus" src="https://raw.githubusercontent.com/gamerchamper/NormalShops/main/imgs/gui-overview.webp" /> </p> *Create/change listing, owner panel, access chooser, buy flow, stock, settings, and more.* ### Admin / delete hub (shift + right-click) <p align="center"> <img width="520" alt="NormalShops admin menu" src="https://raw.githubusercontent.com/gamerchamper/NormalShops/main/imgs/admin%20menu.webp" /> </p> *Force edit, force change owner, delete, history, emulate sale — sensitive actions require **op** in addition to `normalshops.delete`.* ### Creating a shop (walkthrough) <p align="center"> <img width="640" alt="Animated walkthrough: how to make a shop" src="https://raw.githubusercontent.com/gamerchamper/NormalShops/main/imgs/imgs_make-shop%281%29.gif" /> </p> *GIF: interact with an empty chest/barrel with a sign, set price and products, and open for business. (Exact flow matches your server’s messages and GUI version.)* ### Metrics <p align="center"> <img width="640" alt="bstats" src="https://bstats.org/signatures/bukkit/normalshops.svg" /> </p> --- ## Why NormalShops? NormalShops turns chests and barrels into **fully interactive player shops** without forcing players through obscure commands. Owners get a **polished editor**, buyers get a **clear purchase flow** (classic GUI *or* villager-style trading), and staff get **real tools** — history, emulation, ownership transfer — backed by optional **CoreProtect** integration. Whether you run a survival economy or a mini-game hub, NormalShops is built to feel **native to Minecraft**: signs, chests, sounds, and inventories players already understand. --- <br/> ## Feature overview <table> <tr> <td width="50%" valign="top"> ### Core shop experience | Capability | Description | |------------|-------------| | **Block-based shops** | Create shops on **chests** or **barrels** using a **sign** (any sign type). The container must be **empty** and **not** a double chest. | | **Price & products** | Set a currency item (and amount) plus one or more products — including custom items, heads, and NBT-heavy goods when `full-nbt-check` is enabled. | | **Buy flow** | Customers use either a **Buy GUI** or a **villager merchant** interface (configurable via `villager-trading-menu`). | | **Stockpiles** | Link remote chest inventories so sold items pull from real storage — with per-shop limits and optional **stockpile protection**. | | **Earnings** | Sales credit **internal earnings**; owners withdraw through a **paged earnings chest** (partial pickups, stacked bundles). | | **Custom displays** | Glass and item-frame style **shop displays**, themes, colors, and optional **sale text** on glass. | | **Sounds & themes** | Per-shop **buy sounds** and **menu color themes** for personality. | </td> <td width="50%" valign="top"> ### Owner & team tools | Capability | Description | |------------|-------------| | **Trusted players** | Grant **trusted** access so helpers can manage stock and settings without owning the shop. | | **Access choice menu** | Owners/trusted users pick **Editor** vs **customer trade view** so they can preview exactly what buyers see. | | **Unlimited internal stock** | Internal stock is **not capped** at 27 slots — use **paged stock chest** editing (45 slots per page + navigation). | | **Lifetime analytics** | Revenue, sales count, products sold, impressions, stock added/removed, net change, utilization, conversion rate. | | **Buyer insights** | **Unique buyers** and **top buyers** derived from real purchase history. | | **Market comparison** | See how **other shops** price overlapping products and open a **paginated competitor list**. | | **Shop info card** | Quick **stats lore** in the editor (including **total impressions**). | </td> </tr> </table> --- <