GUIShop

The ultimate GUI-based shop plugin for Minecraft servers. Say goodbye to confusing sign shops and chest-based systems. GUIShop provides players with an intuitive shopping experience while giving administrators complete control over pricing, items, and layout.

Fully compatible with Paper/Spigot 1.13 - 1.21.10

Features

• Easy-to-Use GUI System - Players browse shops through clean, organized inventory menus
• Multi-Page Shops - Create shops with unlimited pages for large item catalogs
• Dynamic Pricing - Optional supply/demand based pricing system
• Worth Display System - Shows item sell values directly in item lore (requires PacketEvents)
• In-Game Editor - Configure shops directly from within the game
• Command Items - Sell commands that execute when purchased
• Custom Items - Full support for enchantments, potions, fireworks, spawners, and custom NBT
• Per-Item Permissions - Restrict specific items to certain player groups
• PlaceholderAPI Support - Use placeholders in shop names and lores
• Vault Integration - Works with any Vault-compatible economy plugin

Requirements

Required:

• Java 17+
• Vault

Optional:

• PacketEvents (for worth display feature)
• PlaceholderAPI (for placeholder support)

Installation

1. Download GUIShop from SpigotMC
2. Place the JAR in your plugins folder
3. Install Vault and an economy plugin
4. Restart your server
5. Configure shops in plugins/GUIShop/shops.yml

Quick Start

# Example shop item in shops.yml
shops:
  Blocks:
    pages:
      Page0:
        '0':
          type: SHOP
          id: DIAMOND
          buy-price: 100
          sell-price: 50
          shop-name: '&bDiamond'

See the Wiki for comprehensive documentation.

Commands

Command	Description
/shop	Open the shop menu
/sell	Open the sell GUI
/value	Check item buy/sell values
/gs reload	Reload configuration
/gs edit [shop]	Enter in-game editor

Permissions

Permission	Description
guishop.use	Access to GUIShop
guishop.sell	Access to /sell command
guishop.value	Access to /value command
guishop.reload	Reload configuration
guishop.creator	In-game editor access

Documentation

• Installation Guide
• Shop Configuration
• Special Item Configurations
• Worth Display
• API Documentation

API for Developers

GUIShop provides a comprehensive API:

// Check if an item can be sold
boolean canSell = GUIShopAPI.canBeSold(itemStack);

// Get prices
BigDecimal buyPrice = GUIShopAPI.getBuyPrice(itemStack, quantity);
BigDecimal sellPrice = GUIShopAPI.getSellPrice(itemStack, quantity);

// Sell items programmatically
GUIShopAPI.sellItems(player, SellType.COMMAND, items);

// Worth display integration
GUIShopAPI.setExternalWorthCheck(player -> myPlugin.hasWorthDisabled(player));

See API Documentation for details.

Building from Source

git clone https://github.com/pablo67340/GUIShop.git
cd GUIShop
mvn clean install

The compiled JAR will be in the target folder.

Support

• GitHub Issues
• Discord Server

License

See LICENSE file.

---

Developed by pablo67340