ShopMaster

Traditional chest-shop plugins rely on clunky sign syntax, awkward command arguments, and static walls of text. ShopMaster is built from the ground up to replace outdated trading systems with an interactive, visual, and intuitive economy experience for modern Minecraft servers.

Whether you run a community SMP, an economy-driven Survival world, or a sprawling Towny empire, ShopMaster lets players build dynamic trading posts, establish bustling shopping districts, and discover server-wide deals with zero friction.

📦 Key Highlights & Gameplay Experience Interactive Chest Setup: No signs to write manually. Hold an item, left-click any chest, pick your mode (BUY or SELL), and set your price directly via an interactive chat prompt.

Front-Facing Wall Signs: Signs latch strictly to the front face of the chest, keeping builds clean and automatically updating live stock counts, prices, and trade modes.

Compact Hovering Item Displays: A rotating, natural display item floats neatly above every chest shop so passersby instantly spot what is for sale.

Double-Chest Multi-Item Support: Split a single double chest into two separate listings—one on the left half and one on the right—while sharing the same unified inventory.

Comprehensive GUI Dashboard (/shopmastergui): Adjust percentage discounts/markups (-25% to +25%), toggle hovering displays, change bundle sizes, review trade history, and manage team permissions from a clean inventory menu.

🏛 Marketplaces & Land Claim Integration Take shop administration beyond individual chests. ShopMaster introduces Marketplaces—custom commercial zones integrated directly with your existing claim setup:

Zero-Shovel Claim Conversion: Stand inside your claimed land and type /sm claimmarketplace (or click inside the GUI). ShopMaster detects boundary polygons directly from GriefPrevention, WorldGuard, or Residence without interfering with your claiming tools.

Collective Marketplace Management: Adjust pricing across every chest shop in your shopping mall simultaneously with a single bulk discount or markup percentage.

Visitor Boundary Control: Choose whether warped buyers are kept strictly within your marketplace borders or allowed to roam into the surrounding wilderness. Trapped visitors can exit back to their origin point at any time with /sm leave.

Balanced Territory Limits: Configurable limits prevent market bloat (default: 3 marketplaces per player).

🌐 Global Server Market Catalog Eliminate endless wandering and blind price-checking:

Material-Grouped Overview: The top-level catalog groups all server listings by unique item type, displaying the best unit price, highest unit price, and total server stock available.

Deep-Dive Shop Comparison: Clicking any item opens a sorted drill-down view showing every shop selling or buying that material, ordered from cheapest to most expensive unit price.

Advanced Catalog Filters: Players can filter listings by stock status, minimum quantity, exact unit price ranges, shop owner, or marketplace name.

⚡ Balanced Warping Mechanics Shop Owners & Managers: Teleport directly to individual chest shops via GUI buttons or /sm warp <id> for quick restocking and administrative tasks.

Shoppers & Visitors: Warp directly to public marketplaces that meet owner-configured criteria, preventing players from exploiting warps to infiltrate private bases.

👥 Team Management & Secure Commerce Shop & District Delegation: Assign trusted friends or faction mates as managers on single chests or across entire commercial districts. Managers can restock and manage inventory without gaining rights to delete shops or alter ownership.

Revenue Forwarding: Route incoming trade profits to team bank accounts, faction leaders, or trusted partners.

Admin Limit Control: Enforce fair competition by configuring per-player or global chest shop caps via /sm setlimit (default: 5 shops minimum).

🛠 Setup & Requirements Drop ShopMaster.jar into your server's plugins folder.

Ensure you have Vault and any Vault-compatible economy plugin (e.g., EssentialsX, CMI, Treasury) installed.

Optional: Install GriefPrevention, WorldGuard, or Residence to enable land claim conversion.

Restart your server.

Player & Shopper Commands Available to all players on the server for browsing, buying, selling, and visiting marketplaces.

/shopmastergui (Aliases: /smgui, /sm gui, /sm menu) — Opens the main ShopMaster Dashboard GUI.

/sm catalog [page] — Opens the two-step Global Server Market Catalog GUI to browse unique items and compare shop prices.

/sm filter [material] — Opens the Catalog Search Filter GUI (filter by stock, unit price range, owner, or marketplace).

/sm compare <item> — Opens the GUI comparing all shops trading a specific material (e.g., /sm compare diamond).

/sm mpwarp <name> — Warps you to a public Marketplace (if the owner has enabled warping).

/sm leave — Teleports you out of a boundary-locked Marketplace back to your previous location.

/sm demand — Displays the top 10 most traded items across the entire server.

/sm cancel — Cancels any active chat input prompt (can also type cancel or exit directly in chat).

/sm help (Alias: /sm) — Displays the in-game command reference list.

📦 Shop Owner & Manager Commands Available to players with the shopmaster.create permission (enabled by default) to manage their shops and marketplaces.

Chest Shop Creation — Hold any item and Left-Click a chest (or half of a double chest) to start the interactive setup for a new shop. Requires the shopmaster.create permission.

/sm claimmarketplace — Converts the land claim you are currently standing in (GriefPrevention, WorldGuard, or Residence) into a Marketplace. Requires shopmaster.create.

/sm marketplace (Alias: /sm mp) — Opens the "My Marketplaces" GUI. Requires shopmaster.create.

/sm shopgui [shopId] (Alias: /sm moreoptions) — Opens your chest shops list GUI, or jumps directly to a specific shop's Settings GUI. Requires shopmaster.create or manager status.

/sm warp <shopId> — Teleports you directly on top of your individual chest shop. Restricted strictly to the shop's owner and assigned managers.

/sm stats — Shows your personal business statistics, including total completed trades, items traded, and gross revenue. Requires shopmaster.stats.

/sm customer — Toggles Customer Test Mode on and off so you can test buying and selling on your own chest shops. Requires shopmaster.create.

🛡️ Server Admin Commands Restricted to Server Operators (OP) or staff granted the shopmaster.admin permission node.

/sm setlimit default <number> — Sets the default maximum chest-shop limit for all players on the server (the minimum enforced limit is 5). Requires shopmaster.admin.

/sm setlimit <player> <number> — Sets a custom maximum chest-shop limit for a specific player (e.g., /sm setlimit PlayerName 25). Requires shopmaster.admin.

/sm claimcheck — Toggles whether a land-claim plugin is strictly required when no external claim plugin is installed on the server. Requires shopmaster.admin.

Admin Bypass (Passive Feature) — Automatically grants permission to open any shop chest, manage or delete any player's shop or marketplace via GUI, bypass shop creation limits, and walk freely past marketplace boundary locks. Requires shopmaster.admin