NormalShops

1. Hold any wooden sign and right-click a chest or barrel to open the creation GUI.
2. Place your price (what buyers pay) and products (what they receive) in the designated areas.
3. Click Create Shop to finalize.

Editor controls (create / change product menus):

• Left-click with an item to place it in a slot.
• Right-click with an empty hand to halve the amount in a slot.
• Right-click with the same item as the slot to increase the amount by one.

After creation, right-click your shop block as the owner (or trusted player) to open the access menu: choose Open Editor for management or Open Trade for the buyer-facing experience.

• villager-trading-menu: true (default): Buyers interact through a merchant window. Multi-product bundles appear as a highlighted chest recipe (contents stored in block state meta) with preview-only rows using a barrier as the fake “price” so the real product stays obvious.
• false: Buyers use the classic BuyMenu chest GUI instead.

Out of stock: Buyers can still open the trade view for transparency. The title reflects stock state (e.g. in stock vs out of stock). For non-admin shops, fulfilling trades is blocked when there is nothing to deliver — no ghost purchases.

Impressions: Opening buy/trade flows can increment lifetime impressions for conversion analytics.

• Internal stock is stored as a logical list with pagination (45 item slots per page + prev/next/info/back to editor).
• One player at a time may view a shop’s stock GUI to reduce exploit surface.
• Opening stock is blocked while another player has an active villager trade session on that shop (and vice versa).
• Revision counters detect external changes (e.g. a sale while editing) and refresh or invalidate stale views.
• Stockpile-backed removal still integrates with Transaction logic.

• Collect opens a dedicated earnings inventory instead of dumping everything into the player’s inventory at once.
• Owners take partial withdrawals; bundles can stack in the GUI for readability.
• The top (earnings) inventory is withdraw-only — players cannot deposit or shift-click into earnings slots; their own inventory remains freely movable.
• Same single-viewer and revision philosophy as stock.

• Stockpiles: Connect additional chests to supply sold items. Optional protect-stockpiles keeps foreign players from opening linked chests (bypass: normalshops.bypass-stockpile).
• Earnings piles: Central chests that aggregate payouts from multiple shops (subject to limits in config.yml).
• Tethers: Optional particle / rope visualization while linking (visualize-tethers).
• Double chests: Pile locations are canonicalized so left/right halves resolve to one logical pile.

• Menu colors, custom shop names (length-limited), sale text on displays.
• Frame & glass displays with lights, layering, and “move to top” style controls.
• Per-shop notifications and low-stock warnings in settings.
• Unlimited stock mode exists for special cases (gated behind normalshops.unlimited-stock — intentionally dangerous on economy servers).

Shift + right-click a shop with normalshops.delete to open the admin / delete hub — including on your own shops.

CoreProtect (optional): If CoreProtect is present and its API is enabled, NormalShops records interaction-style logs for creates, deletes, buys (GUI & villager), stockpile changes, earnings collection, connects/disconnects, and more — while also appending structured lines to in-plugin history for the GUI.

• Editor session lock: Only one management session “owns” deep edits at a time; submenus respect the same lock messaging.
• Management access checks on open and click: if a trusted player is removed while online, GUIs stop accepting actions and can close safely.
• Stock / earnings revisions + exclusive viewers reduce race windows between GUIs, merchants, and async saves.
• Fulfillment checks on villager trades ensure stock is actually removed before counting revenue or sales.