About ShopShelves
From ModrinthNew advanced way of admin shops and playershops. ShopShelves and PlayerShelves
ShopShelves - Admin Shops & Player-Owned Shops
Using Bukkit Spigot Paper or Purpur? To get the most accurate list of features and general information please visit the Spigot site: The Plugin version can be read about at the SpigotMc page.
Client side mod that improves the shopping experience!! WIITS
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.
Pictures explained:
The Following pictures depict the ingame shelf blocks in order:
Buy Shop | Sell Shop | Buy & Sell Shop | Custom Label | Player Shop
Statistics Book → Shows the total money earned / lost per slot's item.
Custom Price GUI — shift right-click a 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!
🛠️ API Integration Guide: The ShopshelvesApi
For mod developers, ShopShelves exposes shop shelf functions via the ShopshelvesApi class.
package me.andy.shopshelves.api;
import me.andy.shopshelves.logic.ShopHelper;
import me.andy.shopshelves.util.ShopShelf;
import net.minecraft.block.entity.BlockEntity;
import net.minecraft.block.entity.ShelfBlockEntity;
import org.jetbrains.annotations.Nullable;
import java.util.Optional;
import java.util.UUID;
/**
* Public API for the ShopShelves mod.
* Other mods should use this class to safely check and interact with ShopShelves entities.
*/
public final class ShopshelvesApi {
private static final ShopshelvesApi INSTANCE = new ShopshelvesApi();
private ShopshelvesApi() {}
public static ShopshelvesApi getInstance() {
return INSTANCE;
}
/**
* Checks if a given BlockEntity is an active ShopShelf (any mode other than NONE).
*/
public boolean isShopShelf(@Nullable BlockEntity blockEntity) {
if (!(blockEntity instanceof ShelfBlockEntity) || !(blockEntity instanceof ShopShelf shopShelf)) {
return false;
}
return shopShelf.getShopMode() != ShopHelper.ShopMode.NONE;
}
/**
* Gets the current shop mode for a BlockEntity, if it is an active ShopShelf.
*/
public Optional<ShopHelper.ShopMode> getShopMode(@Nullable BlockEntity blockEntity) {
if (blockEntity instanceof ShopShelf shopShelf && isShopShelf(blockEntity)) {
return Optional.of(shopShelf.getShopMode());
}
return Optional.empty();
}
/**
* Gets the UUID of the owner of the shop, if it is an active ShopShelf.
*/
public Optional<UUID> getShopOwner(@Nullable BlockEntity blockEntity) {
if (blockEntity instanceof ShopShelf shopShelf && isShopShelf(blockEntity)) {
return shopShelf.getOwner();
}
return Optional.empty();
}
}
Required Mod: EcoBal Economy API
Features
Highlights
From source dataGame versions
Supports 8 Minecraft versions, the newest being 26.3.
Loaders
Runs on Bukkit, Fabric, Paper, Purpur and Spigot.
Footprint
Rated a light load on a server.
ShopShelves on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
- Server side
- Optional on the server
- Server type needed
- Bukkit, Fabric, Paper, Purpur, Spigot
- Server load
- light
- Smallest plan we suggest
- Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- Spigot_Paper_Purpur_1.0.16, released 2026-10-25
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Bukkit | 1.21.9 to 26.3 (8 versions) | 26.3 |
| Paper | 1.21.9 to 26.3 (8 versions) | 26.3 |
| Purpur | 1.21.9 to 26.3 (8 versions) | 26.3 |
| Spigot | 1.21.9 to 26.3 (8 versions) | 26.3 |
| Fabric | 1.21.9 to 26.3 (7 versions) | 26.3 |
From 6 recorded builds of ShopShelves.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| Spigot_Paper_Purpur_1.0.16 | 2026-10-25 | 1.21.9 to 26.3 (8 versions) | Bukkit, Paper, Purpur, Spigot |
| Spigot_Paper_Purpur_1.0.15 | 2026-10-01 | 1.21.9 to 26.3 (8 versions) | Bukkit, Paper, Purpur, Spigot |
| 1.0.14 | 2026-09-26 | 26.3 | Fabric |
| Fabric_1.0.14 | 2026-09-08 | 1.21.9 to 1.21.10 (2 versions) | Fabric |
| Fabric_1.0.14 | 2026-09-08 | 1.21.11 | Fabric |
| Fabric_1.0.14 | 2026-09-08 | 26.1 to 26.1.2 (3 versions) | Fabric |
Dependencies
- Required: modrinth project 88mV8JJY (modrinth, not in our catalogue)
- Required: modrinth project P7dR8mSH (modrinth, not in our catalogue)
- Optional: modrinth project Vebnzrzj (modrinth, not in our catalogue)
Declared by the newest build that lists any. Required ones are installed with it on one-click installs.
Run ShopShelves on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogAdmin & protection
Permissions, moderation, anti-cheat and land protection for the people running the server.
Works on a server
From source side supportModrinth lists server-side support for ShopShelves as optional: it can run on a server, but isn’t required there.
Compatibility
- Game
- Minecraft
- Loaders
- BukkitFabricPaperPurpurSpigot
- Runs on
- Serveroptional on the server
- Game versions
- 26.3 and 7 earlier
Verified at the source
- ✓ModrinthOfficial listing, checked 2026-10-25Open ↗
- ✓Authorofficial.andy, as published on Modrinth
- ✓LicenseLicenseRef-All-Rights-ReservedFree













