ShopShelves

## **ShopShelves - Admin Shops & Player-Owned Shops** (https://www.spigotmc.org/resources/shopshelves.130230/) (https://modrinth.com/mod/wiits) !(https://cdn.modrinth.com/data/cached_images/6ab7dcddfe1bfb9c4a887b5e14286460def36553.png) **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.) !(https://cdn.modrinth.com/data/cached_images/83a240115fead92b975226afaf59fe04a67db4f7.png) !(https://cdn.modrinth.com/data/cached_images/9df090184f943a215c4f37aeb29ebc16004e3541.png) !(https://cdn.modrinth.com/data/cached_images/7d4590fade322af89adc0bc33433753478a83b8e.png) !(https://cdn.modrinth.com/data/cached_images/d6053d9ba1e151e817e1ef34b38ddac71536f4ff.png) !(https://cdn.modrinth.com/data/cached_images/5b900c7efd15ee4486c259ddec6b35884b031133.png) !(https://cdn.modrinth.com/data/cached_images/c749b5e1a5b65d6b7b6580b8e4ce2ab48364ee94.png) !(https://cdn.modrinth.com/data/cached_images/0297e0bfd121848d1cdf95696bd053791d5f6502.png) !(https://cdn.modrinth.com/data/cached_images/548c52e95efe815d7bead14c444ac081081da06c.png) <details> <summary>📧 Contact Me & Support Information</summary> ### 💬 Primary Support Channel (Preferred) **All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our (https://discord.gg/48sZCbdHzJ).** 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! </details> --- <details> <summary>🛠️ API Integration Guide: The ShopshelvesApi</summary> For mod developers, **ShopShelves** exposes shop shelf functions via the `ShopshelvesApi` class. ```java 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