SimpleShop

The simple, clean GUI shop solution for Minecraft servers

Version: v1.0.0 | API: 1.21+ | Dependencies: Vault | Optional: PlaceholderAPI, EssentialsX

Quick Start

1. Drop SimpleShop.jar into /plugins/
2. Install Vault + an economy plugin (EssentialsX, CMI, etc.)
3. Restart server
4. Use /shop to open the shop
5. Edit shop.yml to configure categories and items

Commands

/shop - Open the main shop GUI - simpleshop.use /shop help - View player help - simpleshop.help /shop sell - Open the sell GUI - simpleshop.sell /shop reload - Reload configuration - simpleshop.admin.reload /sellgui - Direct sell GUI access - simpleshop.sell

Aliases: /store, /buy, /sell, /sellmenu

Permissions

Player Permissions (Default: true) simpleshop.use - Access the shop simpleshop.sell - Sell items simpleshop.help - View help

Admin Permissions (Default: op) simpleshop.admin.reload - Reload configuration

Category Permissions (Default: false) simpleshop.category. - Access specific category

Wildcards simpleshop.admin.* - All admin permissions

Features:

Category-Based Organization

Create unlimited shop categories. Custom category names with color code support. Custom icons for each category. Permission-locked categories for VIP shops. Clean grid layout for easy browsing.

Buy & Sell System

Configure separate buy and sell prices per item. Disable buying or selling individually per item. Support for all vanilla Minecraft items. Price display in item lore. Balance checking before transactions.

GUI System

Main menu displaying all categories. Category pages with pagination support. Quantity selector with quick buttons (-64, -16, -1, +1, +16, +64). Purchase confirmation dialog for large transactions. Dedicated sell GUI for quick item selling. Clean, lag-free inventory interface.

Sell GUI

Drag items into the sell interface. See total value before confirming. Sell multiple item types at once. One-click sell all functionality.

Economy Integration

Full Vault support. Compatible with all major economy plugins including EssentialsX Economy, CMI Economy, PlayerPoints, and many more.

File Structure

plugins/SimpleShop/ config.yml - Main configuration messages.yml - All plugin messages shop.yml - Categories & items

Config Highlights

config.yml: GUI titles and appearance. Filler/border materials. Sound effects (open, click, purchase, error). Confirmation thresholds. Sell GUI toggle. Cooldown settings.

messages.yml: Fully customizable messages. Color code support. Placeholder support.

shop.yml: Category definitions. Category icons and names. Item prices (buy/sell). Custom item names and lore. Category permissions.

Support

Requires Vault + economy plugin. Tested on Paper/Spigot 1.21+.

• Report issues with this link: Issues with SimpleShop
• Suggest new features with this link: Suggest Features

Premium

Upgrade to SimpleShop Premium for advanced features including: Rotating/Daily Shops with stock limits, Command Items (sell ranks, kits, crates), Buy/Sell Limits with reset timers, In-Game Admin Editor (no config editing!), Custom Item Support (ItemsAdder, Oraxen, MMOItems), Search System across all categories, Subcategories for better organization, Transaction Logging for auditing, And many more!

If everything looks a little odd, due to markdown formatting

Thanks for the support!

Developed by waffleboiiiiii