ShopShelves icon

ShopShelves -----

New advanced way of admin shops and playershops. ShopShelves and PlayerShelves



1.21.9 - 1.21.10
ShopShelves Spigot: The Modern Display Shop Solution

The ultimate plugin for creating interactive, visually striking display shops using the Shelf Block. Transform your server's economy with elegant, lag-friendly holograms (Text Displays) that show prices, stock, and shop status in real-time!

[​IMG]

Primary Support Channel (Preferred)
Discord Server: https://discord.gg/48sZCbdHzJ

All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our Discord server. We actively monitor the server and will respond as soon as possible. This ensures that the whole community can benefit from the discussion and solutions.

---

Urgent Private Messaging (PM) Policy
While we prefer all issues to be handled via the Discord server first, you are welcome to PM me directly under specific urgent circumstances:

  • Allowed Reason: Your server is crashing or experiencing critical, game-breaking errors directly related to one of my mods/plugins.
  • Requirement: You must be the owner of the server.
  • Time Zone: I am operating in the Belgium / Brussels Time Zone (CET/CEST).
  • PM Hours: Please only send private messages between 10:00 AM and 10:00 PM (Brussels Time).

I will endeavor to answer your PM as soon as I can to be helpful and see what I can do to resolve your urgent issue. However, please understand that immediate responses are not guaranteed, and private messaging is a professional courtesy, not an entitlement. Thank you for your understanding and cooperation!

✨ Features & Highlights
  • Native Shop Block: Utilize the Shelf Block as the dedicated shop block for a clean, immersive look.
  • Lag-Friendly Text Displays: Prices and status are displayed using Minecraft's modern Text Display Entities.
    • Configurable Scaling: Adjust the size of the main, amount, and price displays via config.
    • Dynamic View Range: Set different render distances for shop text vs. price tags to optimize client FPS.
  • Dual Shop Modes: Supports Admin Shops (Infinite Stock) and Player Shops (Linked to Containers).
  • Configurable Limitations: Admins can toggle limit_playershelf_to_single_type in the config. When enabled, Player Shelves are restricted to holding only one item type across all slots, preventing confusion.
  • Vault Economy Integration: Seamless support for buying and selling items using any Vault-compatible economy plugin.
  • Flexible Pricing System:
    • Global Prices: Set default prices via pricing.yml or commands.
    • Custom Prices (Price Stamps): Use commands to create a Price Stamp item to apply unique prices to specific slots or player shops.
  • Protection & Security: Includes container protection for linked chests/barrels and anti-grief logic to prevent explosions from destroying active shops.

️ Setup & Usage

1. Admin Shop Setup
  • Place a Shelf Block.
  • Enter Admin Mode: Use /shops admin.
  • Set Mode: While sneaking, Right-Click the shelf to cycle modes: NONE -> BUY -> SELL -> DUAL.
  • Set Item/Price:
    • Global Price: Hold an item with a configured global price and Right-Click a slot.
    • Custom Price: Create a Price Stamp using /shops price <price> <type> and Right-Click the slot to apply it.

2. Player Shop Setup (PlayerShelf)
  • Place a Chest or Barrel.
  • Link Shelf: While sneaking, Right-Click the container with a Shelf item. This places the shelf and links it automatically.
  • Set Price: Create a Price Stamp via command and Right-Click your shelf to apply the price.
  • Stocking: Depending on server config, you may be limited to one item type per shelf. The plugin will prevent incompatible items from being added.

3. Interactions
  • Right-Click Slot: Buy Item.
  • Left-Click Slot: Sell Item.
  • Sneak + Click: Buy/Sell Full Stack.

Commands & Permissions

Command Permission Description
/shops shopshelves.command Opens the help menu.
/shops admin shopshelves.admin Toggles Admin Setup Mode.
/shops reload shopshelves.reload Reloads configs and refreshes displays.
/shops update shopshelves.update Forces a respawn of all shop text displays.
/shops mode <mode> shopshelves.mode Sets message output or price display modes.
/shops itemprice <price> <type> [amount] shopshelves.itemprice Sets the Global Price for the held item.
/shops price <price> <type> [amount] shopshelves.price Creates a Price Stamp item.
N/A shopshelves.playershelves.<limit> Limit max player shelves (e.g., .5, .10).
N/A shopshelves.playershelves.unlimited Allows unlimited player shelves.
N/A shopshelves.playershelf Base permission for default limits.
Resource Information
Author:
----------
Total Downloads: 66
First Release: Nov 17, 2025
Last Update: Nov 28, 2025
Category: ---------------
All-Time Rating:
3 ratings
Find more info at modrinth.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings