Back to mods
ShopShelves project artwork

Modrinth · Minecraft mod

ShopShelves

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which ShopShelves release matches 26.1.2?

Updated today
Best match for your filters Fabric_1.1.0
Game version 26.1.2, 26.1.1, 26.1
Loader Fabric

ShopShelves Fabric_1.1.0 targets 26.1.2, 26.1.1, 26.1 with Fabric. Installation on the client is optional. Installation on the dedicated server is optional. All 2 required mods have matching files.

Where it goes

Is ShopShelves required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

Client Optional
Dedicated server Optional
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source marks this as usable on both the client and server.

What else does ShopShelves Fabric_1.1.0 need?

Fabric_1.1.0 on 26.1.2. Every mod below is checked against that same setup.

All 2 required mods have matching files

Install Fabric API, EcoBal Economy API first. We found matching files for this game-version and loader setup.

Fabric API Needed by ShopShelves Fabric_1.1.0
required
Matching file found Matched file: 0.155.3+26.1.2
EcoBal Economy API Needed by ShopShelves Fabric_1.1.0
required
Matching file found Matched file: 1.0.2
LuckPerms Optional for ShopShelves Fabric_1.1.0
optional
Matching file found Matched file: v5.5.85-fabric

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add ShopShelves without breaking your instance.

Built for ShopShelves Fabric_1.1.0 on 26.1.2. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use Fabric_1.1.0. It targets 26.1.2, 26.1.1, 26.1 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Fabric API, EcoBal Economy API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside Fabric_1.1.0. It opens that exact file at the source.

About this project

What does ShopShelves add?

ShopShelves - Admin Shops & Player-Owned Shops

Using Bukkit, Spigot, Paper or Purpur?

The plugin version description / relevant information can be found on the SpigotMC page.

ShopShelves turns the Shelf Block into interactive, server-friendly display shops! Admins create permanent fixed-price shops, and players set up their own chest-linked Player Shelves with custom prices, all powered by the EcoBal economy. Prices, stock and shop status are shown live with lag-friendly Text Displays, and owners get notified of every sale.

Want item-for-item trades too? Check out TradeShelves, built on the same interaction and protection system and fully compatible with ShopShelves. Then make shopping even better with the WIITS client side mod!

Pictures explained:

The following pictures depict the in-game shelf blocks in order:

Buy Shop | Sell Shop | Buy & Sell Shop | Custom Label | Player Shop

Statistics Book → Shows the total money earned / lost per item slot.

Custom Price GUI → Shift right-click your shelf to set custom prices per slot.

Customer-friendly viewer GUI to inspect the full item (potions, enchantments, etc.)


📧 Contact Me & Support Information

💬 Primary Support Channel (Preferred)

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 (CET/CEST) Time Zone.
  • 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!


Required Mod: EcoBal Economy API


✨ Features & Highlights

Native Shop Block

  • Uses the Shelf Block as the shop itself: no signs, no armor stands, just a clean, immersive look.

Dual Shop Modes

  • Admin Shops (Buy / Sell / Dual): Permanent shops with infinite stock for buying, selling, or both. Admin shops are never restricted by the world allowlist.
  • Player Shops (Player Shelves): Players create their own shop by sneaking + placing a Shelf Block against a chest, barrel or copper chest.
    • Automatically links to the container, including double chests, for stock management.
    • Custom prices per slot via the in-game Price GUI.
    • Optional single-type mode (limit_playershelf_to_single_type): one item type across all three slots with a shared price, or a different item and price per slot.
    • Shows Out of Order when the linked container is missing.
    • When the linked container is broken, the shelf resets to a plain vanilla shelf, with no leftover floating text or stale data.
    • The owner's name stays on the shop display while they are offline.

Owner Notifications

  • Sale notifications: owners get a message for every sale and purchase at their shops. Sales made while they were offline are added up and shown when they join.
  • Out-of-stock notifications: owners are told when a shop runs out of stock, with the item and the shelf coordinates.
  • Open the lists any time with /shops list and /shops outofstock.

Price GUI

  • Owners shift + right-click their shelf to open a full price management GUI: use +/− buttons to adjust buy/sell prices per slot, or type an exact value (and amount) in chat. No commands required.
  • Reset any slot back to the global config prices with one click.
  • Chat input expires after 60 seconds; type cancel to stop.

Purchase Confirmation

  • Optional (confirm_transactions): the first click shows what you would buy or sell and for how much, a second click on the same slot confirms it.

Custom Shop Labels

  • Set a personalized floating label from the Price GUI with the name tag button: left-click to type it in chat, right-click to remove it.
  • Supports color codes (&c, &l, …), hex colors (&#RRGGBB) and a second line (\n or &n). Color support can be granted per permission.
  • label_max_length counts only visible characters. Brackets and colors are configurable separately for admin and player shops, with a brackets_per_line toggle.

Shop Viewer & Statistics

  • Customers shift + click the top edge of a shelf to open a read-only viewer with the full items (potions, enchantments, etc.).
  • The Statistics Book shows the total money earned and lost per slot. It is stored on the shelf, so it survives restarts.

Flexible Pricing System

  • Global Prices: Set default prices for any item in pricing.yml or with /shops itemprice, including potions, enchanted books, goat horns, player heads and more.
  • Custom Price Stamps: Use /shops price to stamp a one-off price onto a held item, then put it on a shelf.
  • Per-Slot Control: Each slot can have its own buy price, sell price and stack amount (e.g. $10 for 64 dirt).

Lag-Friendly Text Displays

  • Prices, stock and status are shown with Minecraft's Text Display Entities: no packet hacks, no legacy holograms. They only rebuild when something actually changes and re-sync to clients less often.
  • Configurable Scaling: Size the header, amount and price displays independently (1–10).
  • View Range: Separate render distances for shop headers and price tags.
  • Two Price Display Modes: TRIPLEPRICE (a price per slot) or SINGLEPRICE (one merged price).
  • Item Language: Localize item names with any Minecraft locale (en_us, de_de, fr_fr, …).

Web Map Markers

  • Shops show up on BlueMap, Dynmap and squaremap with the owner or label and the items for sale. Works automatically when one of those mods is installed (web_map in config.yml).

Bedrock Support (Geyser / Floodgate)

  • Bedrock players can sneak + tap the upper half of a shelf to open the shop viewer, see the buy and sell price under each item, and use the paper in the Price GUI instead of right-click. Java players are not affected.

Translations

  • Set language in config.yml. Every language gets its own messages_<language>.yml with your edits kept, and the help pages are translated too.

Protection & Security

  • Linked containers can only be opened or broken by their owner or an admin.
  • Shop shelves and their linked containers are immune to explosions, the wither and fire, and hoppers, hopper minecarts and copper golems can't take items out of or put items into active shops (container_protection).
  • Trades never lose items or money: anything that doesn't fit is dropped, and failed trades are refunded.
  • The front-face item slots can't be broken by accident: owners and admins break a shelf by hitting its top or bottom edge.

Shop Management

  • Player Shop Limits: Cap player shelves per player with permissions (e.g. shopshelves.playershelves.5) or grant unlimited.
  • World Allowlist: Restrict player shops to specific worlds with allowed_worlds or in game with /shops worlds. Admins can grant per-world or blanket bypass permissions.
  • Admin Mode: /shops admin lets operators bypass all protections and set up shops.
  • Clickable Help: /shops opens a help menu with clickable commands, without the "Confirm Command Execution" screen.
  • Update Checker: Players with shopshelves.update get a notice when a newer Fabric build is on Modrinth.
  • Config Auto-Migration: New config.yml and messages.yml keys are added automatically on updates, and your comments are kept.

Made to work with TradeShelves

Install TradeShelves next to ShopShelves and they detect each other on startup and work together:

  • One shelf, two hands: Player shops made with the main hand become ShopShelves shops and player shops made with the off-hand become trade shelves (swap it with TradeShelves_offhand). Admin shops keep using each mod's own admin mode.
  • Money and trades on one chest: An owner can put a ShopShelves shop and a trade shelf on the same chest. Other players can't use a chest that is already linked to someone else's shop.
  • One reload: /shops reload or /trades reload reloads both mods, ShopShelves first.
  • Shared permissions and limits: Optionally let TradeShelves use the ShopShelves permission nodes and player shop limit (see Compatible Settings below).
  • ShopShelves always takes priority, and both mods leave each other's shelves alone.

⚙️ Setup & Usage

1. Admin Shop Setup

  1. Place a Shelf Block.
  2. Enter Admin Mode: run /shops admin.
  3. Set Mode: while sneaking, right-click the middle of the shelf to cycle NONE → BUY → SELL → DUAL.
  4. Set Item & Price: hold an item (with a global price configured, or with a Price Stamp) and right-click a slot to fill it.
  5. Price GUI: sneak + right-click the top or bottom edge of the shelf.

2. Player Shop Setup

  1. Place a Chest, Barrel or Copper Chest.
  2. Link Shelf: while sneaking, place a Shelf Block against the container. The shelf is linked automatically. With TradeShelves installed, use your main hand (or the off-hand if the server swapped it).
  3. Set Price: shift + right-click your shelf to open the Price GUI.
  4. Stock Your Shop: add items to the linked container. The display updates automatically.

3. Customer Interactions

  • Right-click slot: buy one stack.
  • Left-click slot: sell one stack.
  • Sneak + click (admin shops): buy or sell a full stack at once.
  • Shift + click top edge: open the read-only shop viewer.
  • Bedrock: sneak + tap the upper half of the shelf to open the shop viewer.

Commands

  • /shops, /shopshelves: Opens the help menu with clickable commands.
  • /shops help admin: Opens the admin help page.
  • /shops list (/shops sales): Shows the sales collected at your shops.
  • /shops outofstock (/shops stock): Shows your shops that ran out of stock.
  • /shops admin [player]: Toggles admin setup mode for yourself or another player.
  • /shops reload: Reloads config.yml, pricing.yml and messages.yml and refreshes displays. Also reloads TradeShelves when installed.
  • /shops update: Forces a full refresh of all shop text displays.
  • /shops worlds [add|remove] <world>: Views or changes the player shop world allowlist.
  • /shops mode [mode]: Views or sets the message delivery mode (CHAT | ACTIONBAR | BOTH) or price display mode (SINGLEPRICE | TRIPLEPRICE).
  • /shops itemprice [price] [buy|sell|both] [amount]: Views or sets the global price for the held item.
  • /shops price <price> [buy|sell|both] [amount]: Stamps a custom one-off price onto the held item. Only one stamped item is allowed in your inventory at a time.

Permissions

Click to view all permission nodes and their descriptions
  • shopshelves.command: Access to /shops, the help page, /shops list and /shops outofstock. (Default: all players)
  • shopshelves.admin: Usage of /shops admin. (OP Level 2)
  • shopshelves.reload: Usage of /shops reload. (OP Level 2)
  • shopshelves.update: Usage of /shops update and receiving the update notice on join. (OP Level 2)
  • shopshelves.mode: Usage of /shops mode. (OP Level 2)
  • shopshelves.itemprice: Usage of /shops itemprice to manage global pricing. (OP Level 2)
  • shopshelves.price: Usage of /shops price to create price stamps. (Default: all players)
  • shopshelves.worlds: Usage of /shops worlds to manage the world allowlist. (OP Level 2)
  • shopshelves.playershelf: Allows a player to create player shelves. (Default: all players)
  • shopshelves.playershelves.<number>: Sets the maximum number of player shelves (e.g. shopshelves.playershelves.10). (OP Level 2)
  • shopshelves.playershelves.unlimited: Grants unlimited player shelves. (OP Level 4)
  • shopshelves.playershelf.worlds: Bypasses the world allowlist for all worlds. (OP Level 4)
  • shopshelves.playershelf.<world>: Bypasses the world allowlist for a specific world. (OP Level 4)
  • shopshelves.setlabel: Allows setting a custom shop label via the Price GUI. (OP Level 2)
  • shopshelves.setlabel.color: Allows color/formatting codes in custom shop labels. (OP Level 4)

Works with LuckPerms through the Fabric Permissions API. Without a permissions mod, the OP levels above are used.


Compatible Settings

These settings in the ShopShelves config.yml only do something when TradeShelves is installed too. ShopShelves takes priority, so it owns them.

# ─── Compatible settings (only used when TradeShelves is installed) ───
# true:  ShopShelves player shops use the main hand, TradeShelves player shops use the off-hand.
# false: the other way around.
TradeShelves_offhand: true
# true: TradeShelves uses the ShopShelves permission nodes (tradeshelves.X = shopshelves.X).
TradeShelves_permissions: false
# true: TradeShelves uses the default player shop limit from this config.
TradeShelves_ownlimit: false

Shared permissions: With TradeShelves_permissions: true, every tradeshelves.X node is checked as shopshelves.X (for example shopshelves.playershelf, shopshelves.playershelves.5), and tradeshelves.arrow becomes shopshelves.mode.


🛠️ Developer API: ShopshelvesApi

For mod developers, ShopShelves exposes shop shelf functions via me.andy.shopshelves.api.ShopshelvesApi.

ShopshelvesApi api = ShopshelvesApi.getInstance();

// Check if a block entity is an active shop of any kind
boolean isShop = api.isShopShelf(blockEntity);

// Shop mode: BUY, SELL, DUAL or PLAYERSHELF
Optional<ShopHelper.ShopMode> mode = api.getShopMode(blockEntity);

// Owner UUID of a player-owned shelf
Optional<UUID> owner = api.getShopOwner(blockEntity);

Events

Listen to me.andy.shopshelves.api.ShopShelvesEvents (Fabric API events). Return false to cancel; every event fires on the server thread before anything changes.

// A shop is about to be created
ShopShelvesEvents.SHOP_CREATE.register((player, world, pos, mode) -> true);

// A shop is about to be removed (broken or switched back to NONE)
ShopShelvesEvents.SHOP_REMOVE.register((player, world, pos, previousMode) -> true);

// A buy or sell is about to happen, before any money or item moves
ShopShelvesEvents.TRANSACTION.register((player, world, shelfPos, owner, item, amount, price, type) -> true);

Making your shelf mod compatible

ShopShelves and TradeShelves leave a shelf alone when another mod has claimed it. On Fabric every shelf mod mixes its own interface into ShelfBlockEntity, so add one of these methods to your mixin interface:

  • boolean isShelfClaimed(): return true while the shelf is yours. The simplest option.
  • getShopMode(): return an enum or String, any value except NONE.
public interface MyShelf {
    // ShopShelves / TradeShelves ignore every shelf where this returns true
    default boolean isShelfClaimed() {
        return isMyShelfActive();
    }

    boolean isMyShelfActive();
}

Return false (or NONE) when your shelf turns back into a normal shelf, and our mods will treat it as a plain shelf again.


Requirements

  • Minecraft: 26.3 (builds for older versions are in the Versions tab)
  • Loader: Fabric Loader + Fabric API (server-side only, no client install needed)
  • Required: EcoBal (economy)
  • Optional: LuckPerms + Fabric Permissions API for permission nodes
  • Optional: TradeShelves: item-for-item trades next to your shops, with the compatible settings above
  • Optional: BlueMap, Dynmap or squaremap: shop markers on your web map
  • Optional: Geyser + Floodgate: Bedrock player support

Modpack Policy

  • You ARE PERMITTED to include ShopShelves in any modpack.
  • Credit is appreciated but not strictly required.
  • Please do not modify the mod's JAR file directly.
  • The modpack itself, or access to this mod within the modpack, must not be sold.

Project description from Modrinth.

Pick your setup

ShopShelves by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

16 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

ShopShelves versions and loaders

20 of 58 releases match
Clear filters

Looking for an older file? The official Modrinth project page is in Resources.