SimpleStore - Spigot Plugin

A simple shop plugin for Spigot 1.19.4+

Features

How to Open the Shop

1. Use the command /SimpleStore or /ss
2. Right-click air while holding an emerald in your main hand (this feature can be toggled on/off with /SimpleStore toggle)

Shop Interface

• First Two Rows (18 slots): Display items for sale
• Third Row (Bottom Row):
  • Left button (Slot 19): Previous page
  • Middle button (Slot 23): Close shop
  • Right button (Slot 27): Next page

Purchasing Items

• Left Click: Purchase 1 * amount (amount can be configured in the config file)
• Shift + Left Click: Purchase 64 * amount

Commands

Command	Permission	Description
/SimpleStore	simplestore.use	Open the shop
/SimpleStore help	simplestore.use	Display help information
/SimpleStore reload	simplestore.reload	Reload the configuration file
/SimpleStore toggle	simplestore.use	Toggle the emerald right-click feature

Permissions

• simplestore.use - Use the shop (Default: true)
• simplestore.reload - Reload the configuration file (Default: op)
• simplestore.admin - Admin permission → Access to all commands (Default: op)

Configuration File

The configuration file is located at plugins/SimpleStore/config.yml

Shop Name

shop-name: "&aSimple Shop"

Adding Items

items:
  1:  # Item ID (used for sorting)
    material: DIAMOND  # Item type
    amount: 1  # Quantity per purchase
    name: "&bDiamond"  # Display name
    lore:  # Item description
      - "&7Buy a shiny diamond"
      - "&eLeft Click: Buy x1"
      - "&eShift+Left Click: Buy x64"
    price: 5  # Price (number of emeralds)

Custom Messages

All messages can be customized in the messages section of the configuration file:

messages:
  prefix: "&a[SimpleStore] &r"
  purchase-success: "&aSuccessfully purchased &e{amount}x {item} &afor &e{price} emeralds!"
  # ... more messages

GUI Settings

You can customize navigation buttons and filler items:

gui:
  rows: 3
  previous-page-slot: 18
  next-page-slot: 26
  close-slot: 22
  # ... more settings

Installation

1. Place the downloaded JAR file into your server's plugins folder
2. Restart the server or use /reload confirm
3. Edit the plugins/SimpleStore/config.yml configuration file
4. Use /SimpleStore reload to reload the configuration

Notes

• Currently only supports using emeralds as currency
• Items are automatically paginated, with a maximum of 14 items per page
• Automatically checks player inventory space and emerald count when purchasing
• Supports Chinese text display and color codes (using the & symbol)

Color Codes

• &0 - Black
• &1 - Dark Blue
• &2 - Dark Green
• &3 - Cyan
• &4 - Dark Red
• &5 - Purple
• &6 - Gold
• &7 - Gray
• &8 - Dark Gray
• &9 - Blue
• &a - Green
• &b - Aqua
• &c - Red
• &d - Pink
• &e - Yellow
• &f - White
• &l - Bold
• &n - Underline
• &o - Italic
• &r - Reset

Current Version

• Plugin Version: 1.0
• Spigot API: 1.19.4+
• Java: 17+

Author

mcmohen