SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedAdmin & protection

ShopShelves

by official.andy · for Minecraft

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

5.9KDownloads
27d agoLast updated
LicenseRef-All-Rights-ReservedLicense
Bukkit · Fabric +3Loaders

About ShopShelves

From Modrinth

New 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

Read the full description on Modrinth →

Highlights

From source data

Game 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

LoaderGame versionsNewest
Bukkit1.21.9 to 26.3 (8 versions)26.3
Paper1.21.9 to 26.3 (8 versions)26.3
Purpur1.21.9 to 26.3 (8 versions)26.3
Spigot1.21.9 to 26.3 (8 versions)26.3
Fabric1.21.9 to 26.3 (7 versions)26.3

From 6 recorded builds of ShopShelves.

Recent builds

BuildReleasedGame versionsLoaders
Spigot_Paper_Purpur_1.0.162026-10-251.21.9 to 26.3 (8 versions)Bukkit, Paper, Purpur, Spigot
Spigot_Paper_Purpur_1.0.152026-10-011.21.9 to 26.3 (8 versions)Bukkit, Paper, Purpur, Spigot
1.0.142026-09-2626.3Fabric
Fabric_1.0.142026-09-081.21.9 to 1.21.10 (2 versions)Fabric
Fabric_1.0.142026-09-081.21.11Fabric
Fabric_1.0.142026-09-0826.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 catalog
Listed on Modrinth as “Mods”

Admin & protection

Permissions, moderation, anti-cheat and land protection for the people running the server.

Works on a server

From source side support

Modrinth 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

ShopShelves, answered

Generated from the mod’s own source data.

Do my players need to install ShopShelves?

Modrinth lists server-side support for ShopShelves as optional: it can run on a server, but isn’t required there.

Which loaders does it support?

Bukkit, Fabric, Paper, Purpur and Spigot.

Is it free?

Yes. ShopShelves is free to download from Modrinth. Its license is LicenseRef-All-Rights-Reserved.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run ShopShelves on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add ShopShelves in one click.