## **ShopShelves – Admin Shops & Player-Owned Shops**<\/p>\n
The Plugin version can be read about at the SpigotMc page.<\/p>\n
Client side mod that improves the shopping experience!! WIITS<\/p>\n
<\/p>\n
**ShopShelves** transforms the new **Shelf Block** (added in Minecraft 1.21.9) into flexible, server-friendly shops! This powerful server-side Fabric mod for Minecraft 1.21.9 allows administrators to create permanent, fixed-price shops and gives players the ability to set up their own chest-linked “Player Shelves” with custom prices, all powered by a configurable in-game economy.<\/p>\n
## **Pictures explained:**
\n**The Following pictures depict the ingame shelf blocks in order:**<\/p>\n
Buy Shop | Sell Shop | Buy & Sell Shop | Custom Label | Player Shop<\/p>\n
Statistics Book \u2192 Shows the total money earned \/ lost per slot’s item.<\/p>\n
Custom Price GUI \u2014 shift right-click a shelf to set custom prices per slot.<\/p>\n
Customer-friendly viewer GUI to inspect the full item (potions, enchantments, etc.)<\/p>\n
      ### \ud83d\udcac Primary Support Channel (Preferred)<\/p>\n **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.<\/p>\n ### \ud83c\udd98 Urgent Private Messaging (PM) Policy<\/p>\n While we prefer all issues to be handled via the Discord server first, you are welcome to PM me directly under **specific urgent circumstances**:<\/p>\n * **Allowed Reason:** Your server is **crashing** or experiencing **critical, game-breaking errors** directly related to one of my mods\/plugins. 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!<\/p>\n<\/details>\n —<\/p>\n For mod developers, **ShopShelves** exposes shop shelf functions via the `ShopshelvesApi` class.<\/p>\n “`java import me.andy.shopshelves.logic.ShopHelper; import java.util.Optional; \/** private static final ShopshelvesApi INSTANCE = new ShopshelvesApi();<\/p>\n private ShopshelvesApi() {}<\/p>\n public static ShopshelvesApi getInstance() { \/** \/** \/**  **Required Mod: EcoBal Economy API**<\/p>\n —<\/p>\n ## Features<\/p>\n ### Robust Shop Types ### Custom Shop Labels ### Dynamic Item Pricing ### Statistics Book ### Advanced Text Display & Aesthetics ### Shop Management & Protection —<\/p>\n ## Commands<\/p>\n * `\/shops`, `\/shopshelves` \u2014 Displays the main help page with clickable commands. ### Global Pricing Commands (Requires `shopshelves.itemprice`): ### Custom Price Stamp Command (Requires `shopshelves.price`): —<\/p>\n ## Permissions<\/p>\n * `shopshelves.command` \u2014 Access to the base `\/shops` help command. *(Default: all players)* —<\/p>\n ## Modpack Policy<\/p>\n * You **ARE PERMITTED** to include ShopShelves in any modpack. New advanced way of admin shops and playershops. ShopShelves and PlayerShelves<\/p>\n","protected":false},"featured_media":138824,"template":"","meta":{"_minecraft_slug":"shopshelves","_minecraft_project_id":"SmwrUlZx","_minecraft_author":"official.andy","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":2661,"_minecraft_follows":23,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"shopshelves.zip","_minecraft_size_bytes":3308284,"_minecraft_version_count":19,"_minecraft_updated_at":"2026-05-15T18:13:22.540866Z","_minecraft_date_created":"2025-10-19T07:18:02.323572Z","_minecraft_date_modified":"2026-05-01T06:08:23.335455Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/shopshelves","_minecraft_icon_attachment_id":138824,"_minecraft_imported_at":"2026-06-08T05:13:13+00:00","_minecraft_import_hash":"ba67624493b0b6e5bd67eba885bdafc7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,97,89,126,90,127,128,129,123],"mod_loader":[130,99,132,133,134],"minecraft_version":[40,41,82,83,167,163],"class_list":["post-138823","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-fabric","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_loader-bukkit","mod_loader-fabric","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n <\/p>\n\ud83d\udce7 Contact Me & Support Information<\/summary>\n
\n* **Requirement:** You must be the **owner** of the server.
\n* **Time Zone:** I am operating in the **(CET\/CEST) Time Zone**.
\n* **PM Hours:** Please only send private messages between **10:00 AM and 10:00 PM (Brussels Time)**.<\/p>\n\ud83d\udee0\ufe0f API Integration Guide: The ShopshelvesApi<\/summary>\n
\npackage me.andy.shopshelves.api;<\/p>\n
\nimport me.andy.shopshelves.util.ShopShelf;
\nimport net.minecraft.block.entity.BlockEntity;
\nimport net.minecraft.block.entity.ShelfBlockEntity;
\nimport org.jetbrains.annotations.Nullable;<\/p>\n
\nimport java.util.UUID;<\/p>\n
\n * Public API for the ShopShelves mod.
\n * Other mods should use this class to safely check and interact with ShopShelves entities.
\n *\/
\npublic final class ShopshelvesApi {<\/p>\n
\n return INSTANCE;
\n }<\/p>\n
\n * Checks if a given BlockEntity is an active ShopShelf (any mode other than NONE).
\n *\/
\n public boolean isShopShelf(@Nullable BlockEntity blockEntity) {
\n if (!(blockEntity instanceof ShelfBlockEntity) || !(blockEntity instanceof ShopShelf shopShelf)) {
\n return false;
\n }
\n return shopShelf.getShopMode() != ShopHelper.ShopMode.NONE;
\n }<\/p>\n
\n * Gets the current shop mode for a BlockEntity, if it is an active ShopShelf.
\n *\/
\n public Optional
\n if (blockEntity instanceof ShopShelf shopShelf && isShopShelf(blockEntity)) {
\n return Optional.of(shopShelf.getShopMode());
\n }
\n return Optional.empty();
\n }<\/p>\n
\n * Gets the UUID of the owner of the shop, if it is an active ShopShelf.
\n *\/
\n public Optional
\n if (blockEntity instanceof ShopShelf shopShelf && isShopShelf(blockEntity)) {
\n return shopShelf.getOwner();
\n }
\n return Optional.empty();
\n }
\n}
\n“`<\/p>\n<\/details>\n
\n* **Admin Shops (Buy \/ Sell \/ Dual):** Admins can set up persistent shops using the Shelf Block for **buying**, **selling**, or **dual** trade. Admin shops are never restricted by the world allowlist and cannot be broken from the front face’s item slots.
\n* **Player Shops (PlayerShelves):** Players can create their own shops by **Sneaking + Placing** a Shelf Block against a chest, barrel, or copper chest.
\n * Automatically links to the container, including **double chests**, for stock management.
\n * Supports **custom prices** set per slot via the in-game Price GUI (shift right-click the shelf).
\n * Configurable **single-type mode**: lock a player shop to one item type across all three slots with a shared price, or allow each slot to hold a different item independently.
\n * Limits player shop creation based on **permission nodes** and a configurable **default limit**.
\n * When the linked container is broken, the player shelf automatically resets to a plain vanilla shelf \u2014 no leftover floating text or stale data.<\/p>\n
\n* Shop owners and admins can set a **custom floating label** on any shelf via the Price GUI.
\n* Labels support **legacy color codes** (`&c`, `&l`, etc.), **hex color codes** (`&#RRGGBB`), and a **newline marker** (`n` or `&n`) to split the label across two lines.
\n* Surrounding spaces around `n` \/ `&n` are stripped automatically.
\n* The **length limit** (`label_max_length` in `config.yml`, default 64) counts only visible characters \u2014 color codes and the newline marker are ignored entirely.
\n* **Bracket formatting** for both admin and player shelf labels is fully configurable per type in `messages.yml`, including open\/close bracket text, color, and a `brackets_per_line` toggle:
\n * `true` (default) \u2014 brackets wrap every line.
\n * `false` \u2014 opening bracket on the first line only, closing bracket on the last line only.
\n* Right-click the label button in the Price GUI to **clear the label instantly**, without closing the GUI.<\/p>\n
\n* **Global Pricing (`pricing.yml`):** Set default **buy** and **sell** prices for items, including data-rich items like **potions**, **enchanted books**, **goat horns**, and **player heads**.
\n* **Custom Price Stamps:** Use the `\/shops price` command to apply a one-time price stamp to a held item. That item can then configure a PlayerShelf or set custom slot prices on Admin Shops.
\n* **Flexible Pricing Ratios:** Define prices based on quantity (e.g., $10 for 64 dirt) using the `amount` argument; the shop calculates the correct unit price per transaction.
\n* **In-GUI Price Editing:** Shift right-click any shelf to open the Price GUI and adjust buy\/sell prices with increment\/decrement buttons or by typing an exact value in chat.
\n* **Price Reset:** Reset any slot’s custom price back to config defaults from within the Price GUI. In single-type mode, resetting clears all three slots at once with a clean, slot-agnostic confirmation message.<\/p>\n
\n* Open the **Stats Book** from the viewer GUI or the price GUI to see a full breakdown of **total money earned and lost** per slot for both Admin Shops and Player Shelves.
\n* Profit and loss are tracked separately per slot and persist through server restarts.<\/p>\n
\n* **Dynamic Floating Text:** Shop information is displayed using **Minecraft Text Display Entities**, which automatically update when stock changes, prices are modified, or a shop goes “Out of Order.”
\n* **Customizable Scaling:** Configure the scale of the main mode display, amount display, and price display independently (values 1\u201310).
\n* **Range Control:** Independently set the **render distance** (in blocks) for the main shop display and the price display.
\n* **Two Price Display Modes:**
\n * **`TRIPLEPRICE`:** Shows the price per slot \u2014 ideal for multi-item Admin Shops.
\n * **`SINGLEPRICE`:** Shows one merged price for the shelf \u2014 forced for Player Shelves.
\n* **Rich Text Formatting:** All display text and chat messages support legacy color codes and hex color codes throughout.
\n* **Item Language:** Localize item names in displays using any Minecraft locale (`en_us`, `de_de`, `fr_fr`, etc.), fetched asynchronously from GitHub on startup.<\/p>\n
\n* **Player Shop Limits:** Restrict the number of PlayerShelves a player can create using permission nodes (e.g., `shopshelves.playershelves.5` for a limit of 5) or grant unlimited creation.
\n* **World Allowlist:** Restrict player shop creation to specific worlds. Admin shops are never affected by this list.
\n* **Admin Mode:** Operators enter a special “Admin Mode” (`\/shops admin`) to bypass all shop protections and quickly configure shops.
\n* **Break Protection:** The front-face item slots of both Admin Shops and Player Shelves cannot be broken by clicking within the 8\u00d716 pixel slot area \u2014 owners and admins must target the top or bottom band of the shelf face to break it.
\n* **Container Protection:** Linked containers are protected from non-owners and cannot be broken while linked to a PlayerShelf.
\n* **Explosion Immunity:** Shop shelves and their linked containers are immune to TNT, creepers, fireballs, and wither explosions.
\n* **Config Auto-Migration:** On every startup, both `config.yml` and `messages.yml` are automatically updated to add any new keys introduced in an update \u2014 old config files are never broken or reset.
\n* **Config Reload:** Use `\/shops reload` to refresh all settings, prices, and messages without a server restart.
\n* **Full Update:** Use `\/shops update` to re-render all floating text displays across all worlds.<\/p>\n
\n* `\/shops admin` \u2014 Toggles admin mode to bypass shop protection and configure shops.
\n* `\/shops reload` \u2014 Reloads `config.yml`, `pricing.yml`, and `messages.yml`.
\n* `\/shops update` \u2014 Forces a re-render of all floating text displays.
\n* `\/shops mode [mode_name]` \u2014 Views or sets the **Message Delivery Mode** (`CHAT` | `ACTIONBAR` | `BOTH`) or **Price Display Mode** (`SINGLEPRICE` | `TRIPLEPRICE`).<\/p>\n
\n* `\/shops itemprice` \u2014 Shows the current global price settings for the held item.
\n* `\/shops itemprice
\n * `
\n * `
\n* `\/shops price
\n * Note: Only one stamped item is allowed in a player’s inventory at a time.<\/p>\nClick to view all permission nodes and their descriptions<\/summary>\n
\n* `shopshelves.admin` \u2014 Usage of `\/shops admin` mode. *(OP Level 2)*
\n* `shopshelves.reload` \u2014 Usage of `\/shops reload`. *(OP Level 2)*
\n* `shopshelves.update` \u2014 Usage of `\/shops update`. *(OP Level 4)*
\n* `shopshelves.mode` \u2014 Usage of `\/shops mode`. *(OP Level 4)*
\n* `shopshelves.itemprice` \u2014 Usage of `\/shops itemprice` to manage global pricing. *(OP Level 2)*
\n* `shopshelves.price` \u2014 Usage of `\/shops price` to create custom price stamps. *(OP Level 2)*
\n* `shopshelves.playershelf` \u2014 Allows a player to create PlayerShelves. *(OP Level 0 by default)*
\n* `shopshelves.playershelves.unlimited` \u2014 Grants unlimited PlayerShelf creation. *(OP Level 4)*
\n* `shopshelves.playershelves.
\n* `shopshelves.setlabel` \u2014 Allows setting a custom label on a shop. *(OP Level 2)*
\n* `shopshelves.setlabel.color` \u2014 Allows using color codes and hex colors in custom labels. *(OP Level 4)*<\/p>\n<\/details>\n
\n* Credit is appreciated but not strictly required.
\n* Please do not modify the mod’s JAR file directly.
\n* The modpack itself, or access to this mod within the modpack, **must not be sold**.<\/p>\n","protected":false},"excerpt":{"rendered":"